Skip to main content

Index and search browser bookmarks from the command line.

Works with Chrome and Firefox.

Install

pip install marcus

(hint: use --user to install into ~/.local/bin/)

Then run marcus (or ~/.local/bin/marcus) with no arguments to get help.

Index your bookmarks

The first time you run this it will take a while, depending on how many bookmarks you have.

$ marcus --index ~/.config/chromium/Default/Bookmarks
Start 2017-01-12 21:20
Indexing 10 / 1081 bookmarks
Indexing https://www.mozilla.org/en-US/firefox/central/ (0 / 1081) 0% done
Indexing http://www.ubuntu.com/ (1 / 1081) 0% done
...

To find a list of bookmark files belonging to the current user:

$ marcus --find-bookmark-files

Firefox on Linux example:

$ marcus --index ~/.mozilla/firefox/*.default/places.sqlite

Automated indexing

Edit your user’s crontab with crontab -e and then add a line at the bottom like this:

17 * * * * $PATH-TO-BINARY/marcus --index ~/.config/chromium/Default/Bookmarks >> $HOME/.marcus.log 2>&1

Which will run the indexer every hour at 17 minutes past the hour. Pages which have already been indexed will not be indexed again.

Patches welcome. Enjoy!

Metadata

Release files for marcus 0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for marcus 0.6
File Size Uploaded Provenance Actions
marcus-0.6.tar.gz 5.8 kB Without provenance Details for marcus-0.6.tar.gz

Release files / marcus-0.6.tar.gz

Download URL marcus-0.6.tar.gz
Size 5.8 kB
Tags Source
SHA-256 checksum
How to use checksums
bc6c78079ec131304cccb0590f1fdcfd3e641b1574bc131d33b7640a5468c5f2
BLAKE2b-256 checksum
How to use checksums
8c4ce088f6957e257e6af8751251bcf6b3d4a9a79184cac9e55e24cdc157bb71
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for marcus 0.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page