Easily backups your media lists from 15 sites and counting with async compability in mind.

AniList 🍥📔 / 🔐⌛	Anime-Planet 🍥📔 / 👥📸	Annict 🍥 / 🔐📸⌛🌐	Bangumi 🍥📔🎮📺 / 🔐📸🌐	Kaize 🍥📔 / 👥📸🧼
Kitsu 🍥📔 / 🔐📸	MangaDex 📔 / 🔐	MangaUpdates 📔 / 🔐📸	MyAnimeList 🍥📔 / 👥🔐📸	Notify 🍥 / 👥📸
Otak Otaku 🍥 / 👥📸🌐	Shikimori 🍥📔 / 🔐📸🌐	SIMKL 🍥📺🎬 / 🔐📸	Trakt 📺🎬 / 🔐📸⌛	VNDB 🎮 / 🔐📸

For now, there are no sites that are supported with caveats, yay!

• aniDB — 🍥 / 🔐📨
  Due to limited UDP API commands, bokusu will only be able to send an export request and read your mail to check if the export is ready. You need to manually download the export file from the mail every 2 weeks.
• aniSearch — 🍥📔📺🎬 / 👥🌐🏃
• Doujinshi.info — 📔 / 🔐📸
• Goodreads — 📖 / 👥⌛📸
• IMDb — 📺🎬 / 👥📸🏃
• Kinopoisk — 📺🎬 / 👥🌐📸
• Kinorium — 📺🎬 / 👥🌐📸
• Kurozora (former Aozora) — 🍥📔🎮 / 🔐📸
• Last.fm — 🎵 / 🔐⌛📸
• ListenBrainz — 🎵 / 🔐⌛📸
• LiveChart.me — 🍥 / 🔐🏃
• MyDramaList — 📺🎬 / 👥📸
• MyShows — 📺🎬 / 👥🌐📸
• Nautiljon — 🍥📔📺🎬 / 👥🌐📸🏃
• RAWG — 🎮 / 👥
• The Movie Database — 📺🎬 / 📸
• WakuWaku — 🍥 / 👥📸

If you want to see a site that is not listed here, please open an issue and we'll see what we can do.

Bokusu offers multiple export file formats to choose from, so you can choose the one that is most suitable for your use case. In most cases, you only need MAL-flavored XML format so you can import it to other sites that support importing from MAL.

Before you can use Bokusu, you need to install the following:

• Python 3.10 or higher, recommended to install 3.11 instead as it is the only version that is fully tested and supported.

We also recommend installing the following for better experience:

• pipx for installing Bokusu without polluting your system and easily upgrade or uninstall it.
• Keyring daemon/service/agent available in your system, such as gnome-keyring (or related keyring daemon for your desktop environment) for Linux, or Windows Credential Manager for Windows. Required IF you want to use Bokusu locally, otherwise you can use Bokusu in a CI/CD environment (such as GitHub Actions) and provide the secrets as environment variables. This is required to store your Keepass kdbx password and does not want to pass Password via program args.

After installing the above, you can install Bokusu by running the following command:

pip install bokusu

To use Bokusu, you need to configure it first. You can do so by running the following command:

bokusu setup

This will ask you to enter your credentials for each site you want to backup, and create a configuration file for you. The configuration file will be stored in your user directory (~/.bokusu), and will be used by bokusu to authenticate you when you run the backup command.

Follow the instructions on the screen to complete the setup, or visit the wiki for more information.

If you want to change your credentials, you can run following command:

bokusu accounts --edit
# If you're geeky enough, you can use following command instead to launch via
# Keepass
bokusu accounts --edit-keepass

Or, if you want to change your configuration, you can run the following command:

bokusu config --edit

Bokusu is a command-line tool, so you need to run it in a terminal.

You can also call the program using box as an alias for bokusu if you want to save some keystrokes... but it's not recommended if you have Box (that one cloud storage service) CLI app installed in your system.

bokusu
# or, if you explicitly set an alias for bokusu
box
# or
python -m bokusu

This will show you the help message and the available commands.

Bokusu is licensed under GPL Affero v3.0 or later (AGPL-3.0+) due to heavy dependency of AnimeAPI API for remapping IDs across sites.

We recommend you to use the program as-is and not integrating it to your other open source project/suite, since it will force your project to be licensed under AGPL-3.0+ as well unless the project is copylefted under GPL-3.0+ or compatible GPL licenses.

We are not a lawyer, so please consult your lawyer to make sure you are not violating the license.