0 purchases
bman 0.9
bman
A command line bookmark manager.
Installation
Note: you need Python 3.
> pip install bman
After that, should have a bman command available.
> bman
Usage: bman [OPTIONS] COMMAND [ARGS]...
Your command line bookmark manager.
Options:
-h, --help Show this message and exit.
Commands:
add Adds a new entry
ls Lists stored entries
rm Removes an entry
Usage
Add a bookmark
The quickest way to add an url is:
> bman add https://google.com
But maybe you prefer to add a tiny description to the bookmark:
> bman add https://google.com "The google homepage"
Or, better, add some tags to help you organize all this mess:
> bman add https://google.com "The google homepage" search,homepage,faang
List bookmarks
You can query all your bookmarks with the ls command:
> bman ls
https://github.com
Date: 2023-07-01T20:49:29.273570
Description: The github homepage
Tags: ['code', 'homepage', 'faang']
https://google.com
Date: 2023-07-01T20:51:49.173430
Description: The google homepage
Tags: ['search', 'homepage', 'faang']
Of course, once you start adding bookmarks is not feasible to get a dump of all entries every time you use ls. You can use a filter:
> bman ls goog
https://google.com
Date: 2023-07-01T20:51:49.173430
Description: The google homepage
Tags: ['search', 'homepage', 'faang']
The filter works on all fields.
Search by tag:
> bman ls search
https://google.com
Date: 2023-07-01T20:51:49.173430
Description: The google homepage
Tags: ['search', 'homepage', 'faang']
By date:
> bman ls 2023-07
https://github.com
Date: 2023-07-01T20:49:29.273570
Description: The github homepage
Tags: ['code', 'homepage', 'faang']
https://google.com
Date: 2023-07-01T20:51:49.173430
Description: The google homepage
Tags: ['search', 'homepage', 'faang']
The ls command accepts some more interesting options worth exploring:
Usage: bman ls [OPTIONS] [FILTER]
Lists stored entries
Options:
--format [only-url|full|json] Set the output format
--use-regex Treat the search filter as a regex pattern
--fields TEXT Comma separated list of fields to show (and
to apply filter to)
-h, --help Show this message and exit.
Removing bookmarks
I know, I know...you rarely delete bookmarks. Neither me. But when you need to, better to have a way to do it :-)
> bman rm http://google.com
And that's it.
Editing bookmarks
bman doesn't allow direct edition, but you can add a bookmark twice to update it's entry:
For example, returning to the previous example, if you already had http://google.com in your library...
> bman add http://google.com "The _don't be evil_ company"
Url already exists in the library. Please, use --force to update it with the new values.
As you see, you need to pass the --force flag:
> bman add http://google.com "The _don't be evil_ company" --force
Data location
By default bman stores all the data under the ~/.bman/ directory. This can be overrided setting the BMAN_ROOT_PATH environment variable.
Under that directory, you'll find:
config.json for configuration settings (there's barely anything configurable right now, to be fair)
library.json with all your bookmarks.
I chose JSON for all data representation to make it easier to work with it using standard tools, if I need to.
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
There are no reviews.