https://github.com/jeremywrnr/booker

:bookmark: tab-complete chrome bookmarks
https://github.com/jeremywrnr/booker

autocompletion bookmark bookmarks chrome ruby zsh

Last synced: 26 days ago
JSON representation

:bookmark: tab-complete chrome bookmarks

• Host: GitHub
• URL: https://github.com/jeremywrnr/booker
• Owner: jeremywrnr
• Created: 2015-10-11T20:01:38.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2023-01-31T07:32:58.000Z (almost 2 years ago)
• Last Synced: 2024-05-14T00:02:58.150Z (6 months ago)
• Topics: autocompletion, bookmark, bookmarks, chrome, ruby, zsh
• Language: Ruby
• Homepage: http://rubygems.org/gems/booker
• Size: 1.32 MB
• Stars: 12
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# :bookmark: booker

[![Build Status](https://app.travis-ci.com/jeremywrnr/booker.svg)](https://app.travis-ci.com/jeremywrnr/booker)

[![MIT](https://img.shields.io/npm/l/alt.svg?style=flat)](http://jeremywrnr.com/mit-license)

a CLI chrome bookmark parser, with tab completion.

![Screencast](http://i.imgur.com/yydqb3m.gif)

## setup

    [sudo] gem install booker

    booker --install

Alternatively, the installation can be done incrementally:

    booker -i comp # adding tab completion (ZSH only)

    booker -i conf # generate default config (~/.booker.yml)

    booker -i book # locating bookmarks file

## :bookmark: `booker` usage

##### bookmark completion

    booker [your_search_term]

##### opening a website

    booker github.com/jeremywrnr/booker

##### using a search engine

    booker how to use the internet

## about

This is a tool that allows you to tab complete (in zsh only) google chrome (gc)

bookmarks, and then open them in the browser of your choice. gc stores the

users bookmarks in a large json file locally, so this can be read/parsed by the

tool, and combined with an autocompletion mechanism (i used a zsh script, in

completion) to easily open your bookmarks from the command line.

I was inspired by the `kill` autocompletion that ships with oh-my-zsh, where

you are shown a list of the current processes, and you can tab through to

select which one you'd like to kill. The completion actually is somewhat

complex - if I search for 'System', it will only show processes whose name or

group match against that, but it tab through these matches numeric process IDs,

which is the argument that `kill` actually takes. I learned that zsh

autocompletion has a large learning curve, despite the good amount of

documentation out there on it.

## config

You can also edit the `~/.booker.yml` config file manually.

booker will also try to determine which command should be used to open your

browser based on your operating system, but you can also explicitly choose

which command you want use, by adding the following:

    :browser: 'your-browser-command '

## development / testing

There are some tests in `/spec`. If you clone this repo you can run them with

`rake`. There is also a Makefile to install the gem, so you can run `make` and

that will build the gem locally. To develop the zsh completion script, clone

this repo, and run this command in `/completion`:

    make && unfunction _booker && autoload -U _booker

## todos

- parse all args, then if number open bookmark

- tab completion for other shells (bash, fish)

- support opening multiple bookmarks: 1 1 1

- fix failure on link w/ parens

- implement more rspec testing

- support other browsers? (firefox, safari)