Skip to content
AniDB UDP API client written in Python
Branch: master
Clone or download
Latest commit b166bfe Aug 5, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.pytest_cache/v/cache Version 1.50 - persistent connection. May 1, 2019
.vscode Ed2k library Feb 7, 2018
anidbcli Version 1.52 Aug 5, 2019
docs Added documentation Feb 9, 2018
tests Updated unit tests for the new version. Sep 4, 2018
.gitignore Update tags in Feb 9, 2018
LICENSE Initial commit Dec 13, 2017 Fix for PyPi Feb 9, 2018
README.rst Fix readme rst errors. Aug 5, 2019
requirements.txt Fix for PyPi Feb 9, 2018 Rename file operation + tests Feb 9, 2018 Version 1.52 Aug 5, 2019



Anidbcli is a simple command line interface for managing your anime collection on your local computer or NAS (using only ssh).


  • Python 3.6 or newer (version 3.5 seems to work as well)

Key features

  • ed2k hashing library utilizing multiple cores
  • adding anime to mylist
  • utilize data from anidb to move/rename the files
  • moves/renames the subtitle and other files with same extension
  • encryption


The package can be installed automatically using pip.

pip install anidbcli
pip install --upgrade anidbcli #update

Package can be also installed from source like this.

python install

After installation anidbcli can be invoked like a python module

python -m anidbcli

or directly by typing following in the command line



The basic syntax is

anidbcli [OPTIONS] ed2k/api [OPTIONS] ARGS

If you want to just generate ed2k links for mkv and mp4 files recursively for given folders and copy them to clipboard, use:

anidbcli -r -e mkv,mp4 ed2k -c "path/to/directory" "path/to/directory2"
  • -r is recursive
  • -e comma separated list of extensions, that are treated as anime files

To add all mkv files from directory resursively to mylist use:

anidbcli -r -e mkv api -u "username" -p "password" -k "apikey" -a "path/to/directory"

Optionally, if you don't provide password or username, you will be prompted to input them.

anidbcli -r -e mkv api -k "apikey" -a "path/to/directory"
Enter your username: "username"
Enter your password: "password"

To rename all mkv and mp4 files in directory recursively using data from api you can call

anidbcli -r -e mkv,mp4 api -u "username" -p "password" -k "apikey" -sr "%ep_no% - %ep_english% [%g_name%]" "path/to/directory"
  • "-r" rename using provided format string
  • "-s" prepend original file path to each renamed file. Without this flag the files would me moved to current directory.
Also along with the parameter "-r" you can use one of the following parameters:
  • "-h" Create hardlinks instead of renaming.
  • "-l" Create softlinks instead of renaming.
  • "-t" Save session info instead of logging out (session lifetime is 35 minutes after last command). Use for subsequent calls of anidbcli to avoid api bans.

Anidbcli should be called with all the parameters as usual. If the session was saved before more than 35 minutes, a new session is created instead.

You can also move watched anime from unwatched directory to watched directory and add it to mylist at the same time using following command.

anidbcli -r -e mkv,mp4 api -u "username" -p "password" -k "apikey" -xr "watched/%a_english%/%ep_no% - %ep_english% [%g_name%]" "unwatched/anime1" "unwatched/anime2"
  • "-x" Delete empty folders after moving all files away.

NOTE: All files with same name and different extension (fx. subtitle files) will be renamed/moved as well.

Selected usable tags:
  • %md5% - md5 hash of file.
  • %sha1% - sha1 hash of file.
  • %crc32% - crc32 hash of file.
  • %resolution% - file resolution, for example "1920x1080"
  • %aired% - Episode aired date. Only option that needs "--date-format" option. You can find list of available tags at
  • %year% - Year, the anime was aired. Can be a timespan, if the anime was aired several years "1990-2005" etc.
  • %a_romaji% - Anime title in romaji.
  • %a_kanji% - Anime title in kanji.
  • %a_english% - English anime title.
  • %ep_no% - Episode number. Prepends the necessary zeros, fx. 001, 01
  • %ep_english% - English episode name.
  • %ep_romaji% - Episode name in romaji.
  • %ep_kanji% - Episode name in kanji.
  • %g_name% - Group that released the anime. fx. HorribleSubs.
  • %g_sname% - Short group name.

Complete list of usable tags in format string:

%fid%, %aid%, %eid%, %gid%, %lid%, %status%, %size%, %ed2k%, %md5%, %sha1%, %crc32%, %color_depth%,
%quality%, %source%, %audio_codec%, %audio_bitrate%, %video_codec%, %video_bitrate%, %resolution%,
%filetype%, %dub_language%, %sub_language%, %length%, %aired%, %filename%, %ep_total%, %ep_last%, %year%,
%a_type%, %a_categories%, %a_romaji%, %a_kanji%, %a_english%, %a_other%, %a_short%, %a_synonyms%, %ep_no%,
%ep_english%, %ep_romaji%, %ep_kanji%, %g_name%, %g_sname%, %version%, %censored%
You can’t perform that action at this time.