bookmark-tk 0.1.0

Bookmark Toolkit

Bookmark Toolkit (btk)

Bookmark Toolkit (btk) is a command-line tool for managing and analyzing bookmarks. It provides features for importing, searching, editing, and exporting bookmarks, as well as querying them using JMESPath.

Installation

To install btk, you can use pip:

pip install btk

Usage

To see how to use it, type:

btk --help

Commands

• import: Import bookmarks from various formats, e.g., Netscape Bookmark Format HTML file.

  btk import oldbookmarks --format netscape --output bookmarks
  

• search: Search bookmarks by query.

  btk search mybookmarks "statistics"
  

• list-index: List the bookmarks with the given indices.

  btk list-index mybookmarks 1 2 3
  

• add: Add a new bookmark.

  btk add mybookmarks --title "My Bookmark" --url "https://example.com"
  

• edit: Edit a bookmark by its ID.

  btk edit mybookmarks 1 --title "Updated Title"
  

• remove: Remove a bookmark by its ID.

  btk remove mybookmarks 2
  

• list: List all bookmarks (including metadata).

  btk list mybookmarks
  

• visit: Visit a bookmark by its ID.

  btk visit mybookmarks 103
  

• merge: Perform merge (set) operations on bookmark libraries.

  btk merge union lib1 lib2 lib3 --output merged
  

• cloud: Generate a URL mention graph from bookmarks.

  btk cloud mybookmarks --output graph.png
  

• reachable: Check and mark bookmarks as reachable or not.

  btk reachable mybookmarks
  

• purge: Remove bookmarks marked as not reachable.

  btk purge mybookmarks --output purged
  

• export: Export bookmarks to a different format.

  btk export mybookmarks --output bookmarks.csv
  

• jmespath: Query bookmarks using JMESPath.

  btk jmespath mybookmarks "[?visit_count > \`0\`].title"
  

Example JMESPath Queries

• Get all starred bookmarks:

  btk jmespath mybookmarks "[?stars == \`true\`].title"
  

• Get URLs of frequently visited bookmarks:

  btk jmespath mybookmarks "[?visit_count > \`5\`].url"
  

• Get bookmarks that contain 'wikipedia' in the URL:

  btk jmespath mybookmarks "[?contains(url, 'wikipedia')].{title: title, url: url}"
  

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please submit a pull request or open an issue if you have suggestions or improvements.

Author

Developed by Alex Towell.