[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-10375":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":15,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":37,"readmeContent":38,"aiSummary":39,"trendingCount":16,"starSnapshotCount":16,"syncStatus":40,"lastSyncTime":41,"discoverSource":42},10375,"buku","jarun\u002Fbuku","jarun",":bookmark: Personal mini-web in text","",null,"Python",7140,315,79,1,0,4,23,6,69.8,"GNU General Public License v3.0",false,"master",true,[26,27,28,29,30,31,32,33,34,35,36],"bookmark","bookmark-manager","bookmarks","cli","command-line","console","organizer","privacy-aware","search","standalone","terminal","2026-06-12 04:00:49","\u003Ch1 align=\"center\">buku\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Freleases\u002Flatest\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease\u002Fjarun\u002Fbuku.svg?maxAge=600\" alt=\"Latest release\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Frepology.org\u002Fproject\u002Fbuku\u002Fversions\">\u003Cimg src=\"https:\u002F\u002Frepology.org\u002Fbadge\u002Ftiny-repos\u002Fbuku.svg?header=repos\" alt=\"Availability\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fbuku\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fbuku.svg?maxAge=600\" alt=\"PyPI\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fcircleci.com\u002Fgh\u002Fjarun\u002Fworkflows\u002Fbuku\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fcircleci\u002Fproject\u002Fgithub\u002Fjarun\u002Fbuku.svg\" alt=\"Build Status\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fbuku.readthedocs.io\u002Fen\u002Flatest\u002F?badge=latest\">\u003Cimg src=\"https:\u002F\u002Freadthedocs.org\u002Fprojects\u002Fbuku\u002Fbadge\u002F?version=latest\" alt=\"Docs Status\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FPrivacy-invasive_software\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fprivacy-✓-crimson\" alt=\"Privacy Awareness\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fblob\u002Fmaster\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-GPLv3-yellowgreen.svg?maxAge=2592000\" alt=\"License\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fa65950a9-3c82-4c6d-9184-dead83f9c759\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6688d1eb-e268-4b00-8e8f-044803c3040f\" alt=\"buku in action!\" width=\"734\"\u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Ci>buku in action!\u003C\u002Fi>\u003C\u002Fp>\n\n### Introduction\n\n`buku` is a powerful bookmark manager and a personal textual mini-web.\n\nFor those who prefer the GUI, `bukuserver` exposes a browsable front-end on a local web host server. See [bukuserver page](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Ftree\u002Fmaster\u002Fbukuserver#readme) for config and screenshots.\n\nWhen 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`.\n\n`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).\n\nIt can look up broken links on the Wayback Machine. There's an Easter Egg to revisit random bookmarks.\n\nThere's no tracking, hidden history, obsolete records, usage analytics or homing.\n\nTo get started right away, jump to the [Quickstart](#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](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fwiki\u002FOperational-notes).\n\n`buku` is a library too! There are several related projects, including a browser plug-in.\n\n### Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n  - [Dependencies](#dependencies)\n  - [From a package manager](#from-a-package-manager)\n  - [Release packages](#release-packages)\n  - [From source](#from-source)\n  - [Running standalone](#running-standalone)\n- [Shell completion](#shell-completion)\n- [Usage](#usage)\n  - [Command-line options](#command-line-options)\n  - [Colors](#colors)\n- [Quickstart](#quickstart)\n- [Examples](#examples)\n- [Automation](#automation)\n- [Troubleshooting](#troubleshooting)\n  - [Editor integration](#editor-integration)\n- [Collaborators](#collaborators)\n- [Contributions](#contributions)\n- [Related projects](#related-projects)\n- [In the Press](#in-the-press)\n\n### Features\n\n- Store bookmarks with auto-fetched title, tags and description\n- Auto-import from Firefox, Google Chrome, Chromium, Vivaldi, Brave, and MS Edge\n- Open bookmarks and search results in browser\n- Browse cached page from the Wayback Machine\n- Text editor integration\n- Lightweight, clean interface, custom colors\n- Powerful search options (regex, substring...)\n- Continuous search with on the fly mode switch\n- Portable, merge-able database to sync between systems\n- Import\u002Fexport bookmarks from\u002Fto HTML, XBEL, Markdown, RSS\u002FAtom or Orgfile\n- Smart tag management using redirection (>>, >, \u003C\u003C)\n- Multi-threaded full DB refresh\n- Manual encryption support\n- Shell completion scripts, man page with handy examples\n- Privacy-aware (no unconfirmed user data collection)\n- Can be used as a Python library ([_API documentation_](https:\u002F\u002Fbuku.readthedocs.io\u002Fen\u002Flatest\u002F?badge=latest))\n- Has a compation Web-application ([Bukuserver](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fwiki\u002FBukuserver-%28WebUI%29)) with an HTTP-based API (for personal use only)\n\n### Installation\n\n#### Dependencies\n\n| Feature | Dependency |\n| --- | --- |\n| Lang, SQLite | Python 3.10+ |\n| HTTPS | certifi, urllib3 |\n| Encryption | cryptography |\n| HTML | beautifulsoup4, html5lib |\n\nTo copy URL to clipboard `buku` uses `xsel` (or `xclip`) on Linux, `pbcopy` (default installed) on OS X, `clip` (default installed) on Windows, `termux-clipboard` on Termux (terminal emulation for Android), `wl-copy` on Wayland. If X11 is missing, GNU Screen or tmux copy-paste buffers are recognized.\n\n#### From a package manager\n\nTo install buku with all its dependencies from PyPI, run:\n\n    # pip3 install buku\n\nYou can also install `buku` from your package manager. If the version available is dated try an alternative installation method.\n\n\u003Cdetails>\u003Csummary>Packaging status (expand)\u003C\u002Fsummary>\n\u003Cp>\n\u003Cbr>\n\u003Ca href=\"https:\u002F\u002Frepology.org\u002Fproject\u002Fbuku\u002Fversions\">\u003Cimg src=\"https:\u002F\u002Frepology.org\u002Fbadge\u002Fvertical-allrepos\u002Fbuku.svg\" alt=\"Packaging status\">\u003C\u002Fa>\n\u003C\u002Fp>\nUnlisted packagers:\n\u003Cp>\n\u003Cbr>\n● \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fbuku\u002F\">PyPI\u003C\u002Fa> (\u003Ccode>pip3 install buku\u003C\u002Fcode>)\u003Cbr>\n● Termux (\u003Ccode>pip3 install buku\u003C\u002Fcode>)\u003Cbr>\n\u003C\u002Fp>\n\u003C\u002Fdetails>\n\n#### Release packages\n\nAuto-generated packages (with only the cli component) for Arch Linux, CentOS, Debian, Fedora, openSUSE Leap and Ubuntu are available with the [latest stable release](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Freleases\u002Flatest).\n\nNOTE: CentOS may not have the python3-beautifulsoup4 package in the repos. Install it using pip3.\n\n#### From source\n\nIf you have git installed, clone this repository. Otherwise download the [latest stable release](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Freleases\u002Flatest) or [development version](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Farchive\u002Fmaster.zip) (*risky*).\n\nInstall the dependencies. For example, on Ubuntu:\n\n    $ apt-get install ca-certificates python3-urllib3 python3-cryptography python3-bs4\n\nInstall the cli component to default location (`\u002Fusr\u002Flocal`):\n\n    $ sudo make install\n\nTo remove, run:\n\n    $ sudo make uninstall\n\n`PREFIX` is supported, in case you want to install to a different location.\n\n#### Running standalone\n\n`buku` is a standalone utility. From the containing directory, run:\n\n    $ chmod +x buku.py\n    $ .\u002Fbuku.py\n\n### Shell completion\n\nShell completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of [auto-completion\u002F](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fblob\u002Fmaster\u002Fauto-completion). Please refer to your shell's manual for installation instructions.\n\n### Usage\n\n#### Command-line options\n\n```\nusage: buku [OPTIONS] [KEYWORD [KEYWORD ...]]\n\nBookmark manager like a text-based mini-web.\n\nPOSITIONAL ARGUMENTS:\n      KEYWORD              search keywords\n\nGENERAL OPTIONS:\n      -a, --add URL [+|-] [tag, ...]\n                           bookmark URL with comma-separated tags\n                           (prepend tags with '+' or '-' to use fetched tags)\n      -u, --update [...]   update fields of an existing bookmark\n                           accepts indices and ranges\n                           refresh title and desc if no edit options\n                           if no arguments:\n                           - update results when used with search\n                           - otherwise refresh all titles and desc\n      -w, --write [editor|index]\n                           edit and add a new bookmark in editor\n                           else, edit bookmark at index in EDITOR\n                           edit last bookmark, if index=-1\n                           if no args, edit new bookmark in EDITOR\n      -d, --delete [...]   remove bookmarks from DB\n                           accepts indices or a single range\n                           if no arguments:\n                           - delete results when used with search\n                           - otherwise delete all bookmarks\n      --retain-order       prevents reordering after deleting a bookmark\n      -h, --help           show this information and exit\n      -v, --version        show the program version and exit\n\nEDIT OPTIONS:\n      --url keyword        bookmark link\n      --tag [+|-] [...]    comma-separated tags\n                           clear bookmark tagset, if no arguments\n                           '+' appends to, '-' removes from tagset\n      --title [...]        bookmark title; if no arguments:\n                           -a: do not set title, -u: clear title\n      -c, --comment [...]  notes or description of the bookmark\n                           clears description, if no arguments\n      --immutable N        disable web-fetch during auto-refresh\n                           N=0: mutable (default), N=1: immutable\n      --swap N M           swap two records at specified indices\n\nSEARCH OPTIONS:\n      -s, --sany [...]     find records with ANY matching keyword\n                           this is the default search option\n      -S, --sall [...]     find records matching ALL the keywords\n                           special keywords -\n                           \"blank\": entries with empty title\u002Ftag\n                           \"immutable\": entries with locked title\n      --deep               match substrings ('pen' matches 'opens')\n      --markers            search for keywords in specific fields\n                           based on (optional) prefix markers:\n                           '.' - title, '>' - description, ':' - URL,\n                           '#' - tags (comma-separated, PARTIAL matches)\n                           '#,' - tags (comma-separated, EXACT matches)\n                           '*' - any field (same as no prefix)\n      -r, --sreg expr      run a regex search\n      -t, --stag [tag [,|+] ...] [- tag, ...]\n                           search bookmarks by tags\n                           use ',' to find entries matching ANY tag\n                           use '+' to find entries matching ALL tags\n                           excludes entries with tags after ' - '\n                           list all tags, if no search keywords\n      -x, --exclude [...]  omit records matching specified keywords\n      --random [N]         output random bookmarks out of the selection (default 1)\n      --order fields [...] comma-separated list of fields to order the output by\n                           (prepend with '+'\u002F'-' to choose sort direction)\n\nENCRYPTION OPTIONS:\n      -l, --lock [N]       encrypt DB in N (default 8) # iterations\n      -k, --unlock [N]     decrypt DB in N (default 8) # iterations\n\nPOWER TOYS:\n      --ai                 auto-import bookmarks from web browsers\n                           Firefox, Chrome, Chromium, Vivaldi, Brave, Edge\n                           (Firefox profile can be specified using\n                           environment variable FIREFOX_PROFILE;\n                           Firefox profiles directory can be specified using\n                           environment variable FIREFOX_PROFILES_DIR)\n      -e, --export file    export bookmarks to Firefox format HTML\n                           export XBEL, if file ends with '.xbel'\n                           export Markdown, if file ends with '.md'\n                           format: [title](url) \u003C!-- TAGS -->\n                           export Orgfile, if file ends with '.org'\n                           format: *[[url][title]] :tags:\n                           export rss feed if file ends with '.rss'\u002F'.atom'\n                           export buku DB, if file ends with '.db'\n                           combines with search results, if opted\n      -i, --import file    import bookmarks from file\n                           supports .html .xbel .json .md .org .rss .atom .db\n                           (.json = Firefox backup; .db = another Buku DB)\n      -p, --print [...]    show record details by indices, ranges\n                           print all bookmarks, if no arguments\n                           -n shows the last n results (like tail)\n      -f, --format N       limit fields in -p or JSON search output\n                           N=1: URL; N=2: URL, tag; N=3: title;\n                           N=4: URL, title, tag; N=5: title, tag;\n                           N0 (10, 20, 30, 40, 50) omits DB index\n      -j, --json [file]    JSON formatted output for -p and search.\n                           prints to stdout if argument missing.\n                           otherwise writes to given file\n      --colors COLORS      set output colors in five-letter string\n      --nc                 disable color output\n      -n, --count N        show N results per page (default 10)\n      --np                 do not show the subprompt, run and exit\n      -o, --open [...]     browse bookmarks by indices and ranges\n                           open a random bookmark, if no arguments\n      --oa                 browse all search results immediately\n      --default-scheme S   if scheme is missing from uri, assume S\n                           when opening in browser (default http)\n      --replace old new    replace old tag with new tag everywhere\n                           delete old tag, if new tag not specified\n      --url-redirect       when fetching an URL, use the resulting\n                           URL from following *permanent* redirects\n                           (when combined with --export, the old URL\n                           is included as additional metadata)\n      --tag-redirect [tag] when fetching an URL that causes permanent\n                           redirect, add a tag in specified pattern\n                           (using 'http:{}' if not specified)\n      --tag-error [tag]    when fetching an URL that causes an HTTP\n                           error, add a tag in specified pattern\n                           (using 'http:{}' if not specified)\n      --del-error [...]    when fetching an URL causes any (given)\n                           HTTP error, delete\u002Fdo not add it\n      --export-on [...]    export records affected by the above\n                           options, including removed info\n                           (requires --update and --export; specific\n                           HTTP response filter can be provided)\n      --reorder order...   update DB indices to match specified order\n      --cached index|URL   browse a cached page from Wayback Machine\n      --offline            add a bookmark without connecting to web\n      --suggest            show similar tags when adding bookmarks\n      --tacit              reduce verbosity, skip some confirmations\n      --nostdin            do not wait for input (must be first arg)\n      --threads N          max network connections in full refresh\n                           default N=4, min N=1, max N=10\n      -V                   check latest upstream version available\n      -g, --debug          show debug information and verbose logs\n\nSYMBOLS:\n      >                    url\n      +                    comment\n      #                    tags\n\nPROMPT KEYS:\n    1-N                    browse search result indices and\u002For ranges\n    R [N]                  print out N random search results\n                           (or random bookmarks if negative or N\u002FA)\n    ^ id1 id2              swap two records at specified indices\n    O [id|range [...]]     open search results\u002Findices in GUI browser\n                           toggle try GUI browser if no arguments\n    a                      open all results in browser\n    s keyword [...]        search for records with ANY keyword\n    S keyword [...]        search for records with ALL keywords\n    d                      match substrings ('pen' matches 'opened')\n    m                      search with markers - search string is split\n                           into keywords by prefix markers, which determine\n                           what field the keywords is searched in:\n                           '.', '>' or ':' - title, description or URL\n                           '#'\u002F'#,' - tags (comma-separated, partial\u002Ffull match)\n                           '*' - all fields (can be omitted in the 1st keyword)\n                           note: tag marker is not affected by 'd' (deep search)\n    v fields               change sorting order (default is '+index')\n                           multiple comma\u002Fspace separated fields can be specified\n    v! fields              update indices in DB to match specified order\n    r expression           run a regex search\n    t [tag, ...]           search by tags; show taglist, if no args\n    g taglist id|range [...] [>>|>|\u003C\u003C] [record id|range ...]\n                           append, set, remove (all or specific) tags\n                           search by taglist id(s) if records are omitted\n    n                      show next page of search results\n    N                      show previous page of search results\n    o id|range [...]       browse bookmarks by indices and\u002For ranges\n    p id|range [...]       print bookmarks by indices and\u002For ranges\n    w [editor|id]          edit and add or update a bookmark\n    c id                   copy URL at search result index to clipboard\n    DB [name]              check existing DB list or switch to another DB\n                           (use full\u002Fdir path to switch folders)\n                           '~.' can be used as shortcut for default DB\n    ?                      show this help\n    q, ^D, double Enter    exit buku\n```\n\n#### Colors\n\n`buku` supports custom colors. Visit the wiki page on how to [customize colors](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fwiki\u002FCustomize-colors) for more details.\n\n### Quickstart\n\n1. Export `VISUAL` or `EDITOR` to point to your favourite editor. Note that `VISUAL` takes precedence over `EDITOR`.\n2. Create a sweeter shortcut with some convenience.\n\n       alias b='buku --suggest'\n3. Auto-import bookmarks from your browser(s). Please quit the relevant browsers beforehand to ensure the databases are not locked.\n\n       b --ai\n4. Manually add a bookmark (for hands-on).\n\n       b -w\n5. List your bookmarks with DB index.\n\n       b -p\n6. For GUI and browser integration (or to sync bookmarks with your favourite bookmark management service) refer to the wiki page on [System integration](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fwiki\u002FSystem-integration).\n7. Quick (bash\u002Fzsh) commands to fuzzy search with fzf and open the selection in Firefox:\n\n       firefox $(buku -p -f 10 | fzf)\n       firefox $(buku -p -f 40 | fzf | cut -f1)\n\n   POSIX script to show a preview of the bookmark as well:\n\n   ```sh\n   #!\u002Fusr\u002Fbin\u002Fenv sh\n\n   url=$(buku -p -f4 | fzf -m --reverse --preview \"buku -p {1}\" --preview-window=wrap | cut -f2)\n\n   if [ -n \"$url\" ]; then\n       echo \"$url\" | xargs firefox\n   fi\n   ```\n\n### Examples\n\n1. **Edit and add** a bookmark from editor:\n\n       $ buku -w\n       $ buku -w 'gedit -w'\n       $ buku -w 'macvim -f' -a https:\u002F\u002Fddg.gg search engine, privacy\n    The first command picks editor from the environment variable `EDITOR`. The second command opens gedit in blocking mode. The third command opens macvim with option -f and the URL and tags populated in template.\n2. **Add** a simple bookmark:\n\n       $ buku --nostdin -a https:\u002F\u002Fgithub.com\u002F\n       2648. GitHub: Let’s build from here · GitHub\n       > https:\u002F\u002Fgithub.com\u002F\n       + GitHub is where over 94 million developers shape the future of software, together. Contribute to the open source community, manage your Git repositories, review code like a pro, track bugs\n        and features, power your CI\u002FCD and DevOps workflows, and secure code before you commit it.\n\n       $ buku --nostdin -a https:\u002F\u002Fgithub.com\u002F\n       [ERROR] URL [https:\u002F\u002Fgithub.com\u002F] already exists at index 2648\n\n      `>`: URL, `+`: comment, `#`: tags\n\n      Title, description and tags will be fetched from site. Buku only stores unique URLs and will raise error if the URL already present in the database:\n3. **Add** a bookmark with **tags** `search engine` and `privacy`, **comment** `Search engine with perks`, **fetch page title** from the web:\n\n       $ buku -a https:\u002F\u002Fddg.gg search engine, privacy -c Search engine with perks\n       336. DuckDuckGo\n       > https:\u002F\u002Fddg.gg\n       + Alternative search engine with perks\n       # privacy,search engine\n    where, `>`: URL, `+`: comment, `#`: tags\n4. **Add** a bookmark with tags `search engine` & `privacy` and **immutable custom title** `DDG`:\n\n       $ buku -a https:\u002F\u002Fddg.gg search engine, privacy --title 'DDG' --immutable 1\n       336. DDG (L)\n       > https:\u002F\u002Fddg.gg\n       # privacy,search engine\n    Note that URL must precede tags.\n5. **Add** a bookmark **without a title** (works for update too):\n\n       $ buku -a https:\u002F\u002Fddg.gg search engine, privacy --title\n6. **Edit and update** a bookmark from editor:\n\n       $ buku -w 15012014\n    This will open the existing bookmark's details in the editor for modifications. Environment variable `EDITOR` must be set.\n7. **Update** existing bookmark at index 15012014 with new URL, tags and comments, fetch title from the web:\n\n       $ buku -u 15012014 --url http:\u002F\u002Fddg.gg\u002F --tag web search, utilities -c Private search engine\n8. **Fetch and update only title** for bookmark at 15012014:\n\n       $ buku -u 15012014\n9. **Update only comment** for bookmark at 15012014:\n\n       $ buku -u 15012014 -c this is a new comment\n    Applies to --url, --title and --tag too.\n10. **Export** bookmarks tagged `tag 1` or `tag 2` to HTML, XBEL, Markdown, Orgfile or a new database:\n\n       $ buku -e bookmarks.html --stag tag 1, tag 2\n       $ buku -e bookmarks.xbel --stag tag 1, tag 2\n       $ buku -e bookmarks.md --stag tag 1, tag 2\n       $ buku -e bookmarks.org --stag tag 1, tag 2\n       $ buku -e bookmarks.db --stag tag 1, tag 2\n    All bookmarks are exported if search is not opted.\n11. **Import** bookmarks from HTML, XBEL, Markdown or Orgfile:\n\n        $ buku -i bookmarks.html\n        $ buku -i bookmarks.xbel\n        $ buku -i bookmarks.md\n        $ buku -i bookmarks.org\n        $ buku -i bookmarks.db\n12. **Delete only comment** for bookmark at 15012014:\n\n        $ buku -u 15012014 -c\n    Applies to --title and --tag too. URL cannot be deleted without deleting the bookmark.\n13. **Update** or refresh **full DB** with page titles from the web:\n\n        $ buku -u\n        $ buku -u --tacit (show only failures and exceptions)\n    This operation can update the title or description fields of non-immutable bookmarks by parsing the fetched page. Fields are updated only if the fetched fields are non-empty. Tags remain untouched.\n14. **Delete** bookmark at index 15012014:\n\n        $ buku -d 15012014\n        Index 15012020 moved to 15012014\n    The last index is moved to the deleted index to keep the DB compact. Add `--tacit` to delete without confirmation.\n15. **Delete all** bookmarks:\n\n        $ buku -d\n16. **Delete** a **range or list** of bookmarks:\n\n        $ buku -d 100-200\n        $ buku -d 100 15 200\n17. **Search** bookmarks for **ANY** of the keywords `kernel` and `debugging` in URL, title or tags:\n\n        $ buku kernel debugging\n        $ buku -s kernel debugging\n18. **Search** bookmarks with **ALL** the keywords `kernel` and `debugging` in URL, title or tags:\n\n        $ buku -S kernel debugging\n19. **Search** bookmarks **tagged** `general kernel concepts`:\n\n        $ buku --stag general kernel concepts\n20. **Search** for bookmarks matching **ANY** of the tags `kernel`, `debugging`, `general kernel concepts`:\n\n        $ buku --stag kernel, debugging, general kernel concepts\n21. **Search** for bookmarks matching **ALL** of the tags `kernel`, `debugging`, `general kernel concepts`:\n\n        $ buku --stag kernel + debugging + general kernel concepts\n22. **Search** for bookmarks matching any of the keywords `hello` or `world`, excluding the keywords `real` and `life`, matching both the tags `kernel` and `debugging`, but **excluding** the tags `general kernel concepts` and `books`:\n\n        $ buku hello world --exclude real life --stag 'kernel + debugging - general kernel concepts, books'\n23. **Search** for bookmarks with different tokens for each field, and print them out sorted by the tags (ascending) and URL (descending)\n\n        $ buku --order +tags,-url --markers --sall 'global substring' '.title substring' ':url substring' :https '> description substring' '#partial,tags:' '#,exact,tags' '*another global substring'\n24. List **all unique tags** alphabetically:\n\n        $ buku --stag\n25. Run a **search and update** the results:\n\n        $ buku -s kernel debugging -u --tag + linux kernel\n26. Run a **search and delete** the results:\n\n        $ buku -s kernel debugging -d\n27. **Encrypt or decrypt** DB with **custom number of iterations** (15) to generate key:\n\n        $ buku -l 15\n        $ buku -k 15\n    The same number of iterations must be specified for one lock & unlock instance. Default is 8, if omitted.\n28. **Show details** of bookmarks at index 15012014 and ranges 20-30, 40-50:\n\n        $ buku -p 20-30 15012014 40-50\n29. Show details of the **last 10 bookmarks**:\n\n        $ buku -p -10\n30. **Show all** bookmarks with real index from database:\n\n        $ buku -p\n        $ buku -p | more\n31. **Replace tag** 'old tag' with 'new tag':\n\n        $ buku --replace 'old tag' 'new tag'\n32. **Delete tag** 'old tag' from DB:\n\n        $ buku --replace 'old tag'\n33. **Append (or delete) tags** 'tag 1', 'tag 2' to (or from) existing tags of bookmark at index 15012014:\n\n        $ buku -u 15012014 --tag + tag 1, tag 2\n        $ buku -u 15012014 --tag - tag 1, tag 2\n34. **Open URL** at index 15012014 in browser:\n\n        $ buku -o 15012014\n35. List bookmarks with **no title or tags** for bookkeeping:\n\n        $ buku -S blank\n36. List bookmarks with **immutable title**:\n\n        $ buku -S immutable\n37. **Append, remove tags at prompt** (taglist index to the left, bookmark index to the right):\n\n        \u002F\u002F append tags at taglist indices 4 and 6-9 to existing tags in bookmarks at indices 5 and 2-3\n        buku (? for help) g 4 9-6 >> 5 3-2\n        \u002F\u002F set tags at taglist indices 4 and 6-9 as tags in bookmarks at indices 5 and 2-3\n        buku (? for help) g 4 9-6 > 5 3-2\n        \u002F\u002F remove all tags from bookmarks at indices 5 and 2-3\n        buku (? for help) g > 5 3-2\n        \u002F\u002F remove tags at taglist indices 4 and 6-9 from tags in bookmarks at indices 5 and 2-3\n        buku (? for help) g 4 9-6 \u003C\u003C 5 3-2\n38. List bookmarks with **colored output**:\n\n        $ buku --colors oKlxm -p\n39. Add a bookmark after following all permanent redirects, but only if the server doesn't respond with an error (and there's no network failure)\n\n        $ buku --add http:\u002F\u002Fwikipedia.net --url-redirect --del-error\n        2. Wikipedia\n           > https:\u002F\u002Fwww.wikipedia.org\u002F\n           + Wikipedia is a free online encyclopedia, created and edited by volunteers around the world and hosted by the Wikimedia Foundation.\n40. Add a bookmark with tag `http redirect` if the server responds with a permanent redirect, or tag shaped like `http 404` on an error response:\n\n        $ buku --add http:\u002F\u002Fwikipedia.net\u002Fnotfound --tag-redirect 'http redirect' --tag-error 'http {}'\n        [ERROR] [404] Not Found\n        3. Not Found\n           > http:\u002F\u002Fwikipedia.net\u002Fnotfound\n           # http 404,http redirect\n41. Update all bookmarks matching the search by updating the URL if the server responds with a permanent redirect, deleting the bookmark if the server responds with HTTP error 400, 401, 402, 403, 404 or 500, or adding a tag shaped like `http:{}` in case of any other HTTP error; then export those affected by such changes into an HTML file, marking deleted records as well as old URLs for those replaced by redirect.\n\n        $ buku -S :\u002F\u002Fwikipedia.net -u --url-redirect --tag-error --del-error 400-404,500 --export-on --export backup.html\n\n42. Print out a single **random** bookmark:\n\n        $ buku --random --print\n\n43. Print out 3 **random** bookmarks **ordered** by netloc (reversed), title and url:\n\n        $ buku --random 3 --order ,-netloc,title,+url --print\n\n44. Print out a single **random** bookmark matching **search** criteria, and **export** into a Markdown file (in DB order):\n\n        $ buku --random -S kernel debugging --export random.md\n\n45. Swap positions of records #4 and #5:\n\n        $ buku --swap 4 5\n\n46. Update indices in all bookmarks to match specified order:\n\n        $ buku --reorder ,-netloc,title,+url\n\n47. More **help**:\n\n        $ buku -h\n        $ man buku\n\n### Automation\n\nInteractive workflows can be automated using expect. Issue [#368](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fissues\u002F368) has a working example on automating auto-import.\n\n### Troubleshooting\n\n#### Editor integration\n\nYou may encounter issues with GUI editors which maintain only one instance by default and return immediately from other instances. Use the appropriate editor option to block the caller when a new document is opened. See issue [#210](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fissues\u002F210) for gedit.\n\n### Collaborators\n\n- [Arun Prakash Jana](https:\u002F\u002Fgithub.com\u002Fjarun)\n- [Alexey Gulenko](https:\u002F\u002Fgithub.com\u002FLeXofLeviafan)\n- [Rachmadani Haryono](https:\u002F\u002Fgithub.com\u002FrachmadaniHaryono)\n- [Johnathan Jenkins](https:\u002F\u002Fgithub.com\u002Fshaggytwodope)\n- [SZ Lin](https:\u002F\u002Fgithub.com\u002Fszlin)\n\nCopyright © 2015-2026 [Arun Prakash Jana](mailto:engineerarun@gmail.com)\n\u003Cbr>\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fgitter.im\u002Fjarun\u002Fbuku\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgitter\u002Froom\u002Fjarun\u002Fbuku.svg?maxAge=2592000\" alt=\"gitter chat\" \u002F>\u003C\u002Fa>\u003C\u002Fp>\n\n### Contributions\n\nMissing a feature? There's a rolling [ToDo List](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fissues\u002F484) with identified tasks. Contributions are welcome! Please follow the [PR guidelines](https:\u002F\u002Fgithub.com\u002Fjarun\u002Fbuku\u002Fwiki\u002FPR-guidelines).\n\nSee also our documentation here \u003Ca href=\"http:\u002F\u002Fbuku.readthedocs.io\u002Fen\u002Fstable\u002F?badge=stable\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocs-stable-brightgreen.svg?maxAge=2592000\" alt=\"Stable Docs\" \u002F>\u003C\u002Fa>\n\n### Related projects\n\n- [bukubrow](https:\u002F\u002Fgithub.com\u002FSamHH\u002Fbukubrow), WebExtension for browser integration\n- [oil](https:\u002F\u002Fgithub.com\u002FAndreiUlmeyda\u002Foil), search-as-you-type cli front-end\n- [buku_run](https:\u002F\u002Fgithub.com\u002Fcarnager\u002Fbuku_run), rofi front-end\n- [pinku](https:\u002F\u002Fgithub.com\u002Fmosegontar\u002Fpinku), a Pinboard-to-buku import utility\n- [buku-dmenu](https:\u002F\u002Fgitlab.com\u002Fbenoliver999\u002Fbuku-dmenu), a simple bash dmenu wrapper\n- [poku](https:\u002F\u002Fgithub.com\u002Fshanedabes\u002Fpoku), sync between Pocket and buku\n- [Ebuku](https:\u002F\u002Fgithub.com\u002Fflexibeast\u002Febuku), Emacs interface to buku\n- [diigoku](https:\u002F\u002Fgithub.com\u002Fdppdppd\u002Fdiigoku), buku importer for Diigo\n- [BukuBot](https:\u002F\u002Fgit.xmpp-it.net\u002Fsch\u002FBukuBot), Chat bot for XMPP with an extended visual interface\n\n\n### Videos\n\n- [Buku: Take Your Bookmarks Everywhere You Go](https:\u002F\u002Fwww.youtube.com\u002Fembed\u002F9HzEHrUBQXE)\n- [Buku is a great open-source bookmark manager](https:\u002F\u002Fwww.youtube.com\u002Fembed\u002F7VxgKMWm-J8)\n\n### In the Press\n\n- [2daygeek](http:\u002F\u002Fwww.2daygeek.com\u002Fbuku-command-line-bookmark-manager-linux\u002F)\n- [Hacker Milk](https:\u002F\u002Fhackermilk.blogspot.com\u002F2020\u002F01\u002Fhow-to-manage-your-browsers-bookmarks.html)\n- [It's F.O.S.S.](https:\u002F\u002Fitsfoss.com\u002Fbuku-command-line-bookmark-manager-linux\u002F)\n- [LinOxide](https:\u002F\u002Flinoxide.com\u002Flinux-how-to\u002Fbuku-browser-bookmarks-linux\u002F)\n- [LinuxUser Magazine 01\u002F2017 Issue](http:\u002F\u002Fwww.linux-community.de\u002FLU\u002F2017\u002F01\u002FDas-Beste-aus-zwei-Welten)\n- [Make Tech Easier](https:\u002F\u002Fwww.maketecheasier.com\u002Fmanage-browser-bookmarks-ubuntu-command-line\u002F)\n- [One Thing Well](http:\u002F\u002Fonethingwell.org\u002Fpost\u002F144952807044\u002Fbuku)\n- [Open Source For You](https:\u002F\u002Fopensourceforu.com\u002F2018\u002F05\u002Fbuku-a-bookmark-manager-in-the-command-line\u002F)\n- [ulno.net](https:\u002F\u002Fulno.net\u002Fblog\u002F2017-07-19\u002Fof-bookmarks-tags-and-browsers\u002F)\n","buku 是一个强大的书签管理和个人文本迷你网站工具。它使用 Python 编写，支持命令行界面（CLI），具有隐私保护、便携式数据库和无缝 GUI 集成等核心功能。用户可以通过 buku 导入浏览器书签，从网页获取标题、标签和描述，并使用自己喜欢的编辑器来添加、编辑和更新书签。此外，buku 提供了多种搜索选项，包括正则表达式和深度扫描模式，方便快速查找书签。它还支持查找失效链接并通过 Wayback Machine 恢复。buku 适用于需要高效管理书签且注重隐私保护的用户，尤其适合经常使用命令行工具的技术人员。",2,"2026-06-11 03:28:02","top_topic"]