A bookmark bot powered by buku.
Go to file
2024-06-03 18:46:55 +03:00
bukubot Improve deletion by using buku function delete_resultset() 2024-06-03 18:46:55 +03:00
LICENSE Add files license and pyproject. 2024-04-05 15:36:01 +00:00
pyproject.toml Refactor file structure. 2024-05-31 12:18:59 +03:00
README.md Add instructions to run the bot without prompts. 2024-05-31 13:59:50 +03:00

Bookmarks bot for XMPP


BukuBot is a bookmarks bot for the XMPP communication network.

BukuBot is a powered by buku and slixmpp.


XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.

Visit XMPP for more information about the XMPP protocol and check the list of XMPP clients.

BukuBot is primarily designed for XMPP (aka Jabber), yet it is built to be extended to other protocols.


  • Search - Filter and search bookmarks by keywords and tags.
  • Portable - Export and import bookmarks to buku database, HTML, Markdown, Orgfile, or XBEL.
  • Simultaneous - BukuBot is designed to handle multiple contacts, including groupchats, Simultaneously.
  • Visual interface - Interactive interface for XMPP using Ad-Hoc Commands,


BukuBot as appears with Cheogram.

Chat: Search Ad-Hoc: Commands Ad-Hoc: Browse Ad-Hoc: Add Ad-Hoc: Edit bookmark Ad-Hoc: Seach

Getting Started


It is possible to install BukuBot using pip and pipx.

pip inside venv

$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install git+https://git.xmpp-it.net/sch/BukuBot


$ pipx install git+https://git.xmpp-it.net/sch/BukuBot
$ pipx uninstall bukubot
$ pipx install git+https://git.xmpp-it.net/sch/BukuBot


Start by executing the command bukubot and enter Username and Password of an existing XMPP account.

$ bukubot

You can also start BukuBot as follows:

$ bukubot --jid ACCOUNT_JABBER_ID --password ACCOUNT_PASSWORD

It is advised to use a dedicated extra account for BukuBot.

BukuBot works with any XMPP chat client; if you want to make use of the visual interface which BukuBot has to offer (i.e. Ad-Hoc Commands), then you are advised to use Cheogram, Converse, Gajim, monocles chat, Movim, Poezio, Profanity, Psi or Psi+.


Please join our support groupchat whether you want help, discuss new features or just greet us.


Schimon (Author).


MIT license.

Schimon Zackary, 2024