Skip to content

janpstrunn/bmark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bmark: A simple bookmark manager

A simple bookmark manager that aims to be simple, while not keeping in your way in the long-term.

bmark is inspired by similar tools like buku and bmm. It also uses SQLite as the backend.

This tool was created, because I feel both buku and bmm offer unnecessary features. So I made bmark with the bare minimum features you would expect a bookmark manager to have.

Features

  • Add bookmarks
    • Include title, tag and notes
  • Delete bookmarks or tags
  • Edit bookmarks or tags
  • Import from or export to HTML format (compatible with Firefox bookmarks)
  • List bookmarks with queries
  • List only URL

This tool follows the UNIX philosophy. Extra functionalities like opening in the browser or piping to fzf and rofi may be done by the user.

Requirements

  • sqlite3

Installation

git clone https://github.com/janpstrunn/bmark
cd bmark && mv src/bmark $HOME/.local/bin
chmod +x $HOME/.local/bin/bmark

Usage

bmark | A simple bookmark manager

Usage:
  bmark FLAG <FLAG_INPUT> COMMAND INPUT
  bmark -h | bmark help

Commands:
  delete ID or URL                        Delete a bookmark
  edit FIELD=VALUE URL TAG TITLE NOTES    Edit a bookmark
  export                                  Export bookmarks to HTML file
  help                                    Displays this message and exits
  import                                  Import bookmarks from HTML file
  insert URL TAG TITLE NOTES              Insert a new bookmark
  list URL TAG TITLE NOTES                List all bookmarks

Flags:
  -h                            Displays this message and exits
  --help                        Displays this message and exits
  --note <NOTE>                 Query for NOTE
  -r                            List only the URL
  -s                            List will match given query
  --tag <TAG>                   Query for TAG
  --title <TITLE>               Query for TITLE
  --url <URL>                   Query for URL

Examples:
  bmark insert URL TAG TITLE NOTES
  bmark --tag "TAG" --note "NOTE" list URL TITLE

Scripting

Pipe URLs to fzf and open in the browser

bmark -r list | fzf -m | xargs -I {} xdg-open "{}"

Notes

This script has been tested exclusively on a Linux machine.

License

This repository is licensed under the MIT License, allowing for extensive use, modification, copying, and distribution.

About

🔖 A simple bookmark manager

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published