fernandocanizo / bm

Manage bookmarks in your terminal

## BM

Simple bash CLI bookmarks persisted by your ~/Dropbox, sporting a webkit2png-driven html screenshot browser, even grep the screenshots by tag and description:

$ bm view expressapp

Install

$ make install
$ make uninstall

Example

Add a bookmark:

$ bm add http://subtlepatterns.com "tiling background images" design textures

Open it later:

$ bm subtle

Search for design related bookmarks:

Usage

Usage: bm [options] [cmd]

Commands:

  # add a bookmark with the given url, description, and optional tags
  $ bm add <url> [desc] [tag...]

  # open the first bookmark matching <query>
  $ bm open <query>
  $ bm <query>

  # search the bookmarks via full-text <query>
  $ bm search <query>

  # list bookmarks available
  $ bm list
  $ bm ls
  $ bm

  # view bookmark screenshots in your default browser
  $ bm view design
  $ bm view

  # clear all bookmarks
  $ bm clear

Options:

   -V, --version   output bm version
   -h, --help      output this help information

## Screenshots

Run bm view [query] to view the bookmark screenshots in your default browser. This requires webkit2png(1) (brew install webkit2png).

Dropbox

Later I'll make it so you can tweak the path, however for now the bookmarks are persisted to ~/Dropbox/bookmarks:

$ cat ~/Dropbox/bookmarks 
https://kippt.com|bookmark management|clean white design
http://subtlepatterns.com|tiling background images|design textures
http://www.uiparade.com|ui component designs|design ui

bm's Issues

Remove clear command

There's no point in having a clear command: if you want to delete all your bookmarks just erase the directory where they are saved. Also it is possible that a bad keystroke would end up in clearing all your hard work of years categorizing urls.

But I'd like to have a remove command which deletes a single URL. Or a bunch of them if a pattern is given. In the later case command will show what will be removed and require confirmation.

Make a github page

Create branch gh-pages and add a nice page with examples.

Add categories

Tags are a cool way to group stuff. But categories allow things to be put on a tree. I'll use just the plain simple file system for this. Each category is a directory containing one or more bookmarks file.

Make everything except the URL optional on add command

Current add command requires a tag and a description. Make all of that optional. The only required thing should be the URL.

Possible idea:

bm add [-d description] [-f] [-t tag [...]] [-c category [category/subcategory/.../]]

Where:

• -d description
  adds a description text
• -f
  fetches the title from the page
• -t tag
  adds a tag. More can be added
• -c category/subcategory
  puts the link under said category

Remove image generation

Remove image generation. It's an unnecessary feature. I just want to keep a plain text bookmarks file.

Provide configuration file

Add a convenience file under .config/bmrc to provide for configuration. Create it on installation.

Make search able to look under a specific category

Modify search command to accept -c category so it searches just under a specific category tree.

Use CSV

I don't like the chosen separator | (vertical bar). Switch to ; (semi-colon) so the file becomes a comma separated value file.

Remove aliased commands

I see no point in having:

• stats | statistics
• list | ls
• open | open

Default action without any parameters should be to list. Any other action should require a command.