<h1 align="center"buku</h1
<p align="center" <a href="https://github.com/jarun/buku/releases/latest"<img src="https://img.shields.io/github/release/jarun/buku.svg?maxAge=600" alt="Latest release" /</a <a href="https://repology.org/project/buku/versions"<img src="https://repology.org/badge/tiny-repos/buku.svg?header=repos" alt="Availability"</a <a href="https://pypi.org/project/buku/"<img src="https://img.shields.io/pypi/v/buku.svg?maxAge=600" alt="PyPI" /</a <a href="https://circleci.com/gh/jarun/workflows/buku"<img src="https://img.shields.io/circleci/project/github/jarun/buku.svg" alt="Build Status" /</a <a href="https://buku.readthedocs.io/en/latest/?badge=latest"<img src="https://readthedocs.org/projects/buku/badge/?version=latest" alt="Docs Status" /</a <a href="https://en.wikipedia.org/wiki/Privacy-invasivesoftware"<img src="https://img.shields.io/badge/privacy-✓-crimson" alt="Privacy Awareness" /</a <a href="https://github.com/jarun/buku/blob/master/LICENSE"<img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /</a </p
<p align="center" <a href="https://asciinema.org/a/137065"<img src="https://github.com/user-attachments/assets/6688d1eb-e268-4b00-8e8f-044803c3040f" alt="buku in action!" width="734"/</a </p
<p align="center"<ibuku in action!</i</p
Introduction
buku is a powerful bookmark manager and a personal textual mini-web.
For those who prefer the GUI, bukuserver exposes a browsable front-end on a local web host server. See bukuserver page for config and screenshots.
When I started writing it, I couldn't find a flexible command-line solution with a private, portable, merge-able database along with seamless GUI integration. Hence, buku.
buku can import bookmarks from browser(s) or fetch the title, tags and description of a URL from the web. Use your favourite editor to add, compose and update bookmarks. Search bookmarks instantly with multiple search options, including regex and a deep scan mode (handy with URLs).
It can look up broken links on the Wayback Machine. There's an Easter Egg to revisit random bookmarks.
There's no tracking, hidden history, obsolete records, usage analytics or homing.
To get started right away, jump to the Quickstart section. buku has one of the best documentation around. The man page comes with examples. For internal details, please refer to the operational notes.
buku is a library too! There are several related projects, including a browser plug-in.
Table of Contents
- Features
- Installation
- Dependencies
- From a package manager
- Release packages
- From source
- Running standalone
- Shell completion
- Usage
- Command-line options
- Colors
- Quickstart
- Examples
- Automation
- Troubleshooting
- Editor integration
- Collaborators
- Contributions
- Related projects
- In the Press