Skip to main content

Simple CLI for managing your anime collection using AniDB UDP API.

Project description

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

Requirements

  • 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

Installation

The package can be installed automatically using pip.

pip install anidbcli

Package can be also installed from source like this.

python setup.py install

After installation anidbcli can be invoked like a python module

python -m anidbcli

or directly by typing following in the command line

anidbcli

Quickstart

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"
Where
  • -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"
Where

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"
Where
  • “-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.

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"
Where
  • “-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 https://docs.python.org/3.6/library/time.html#time.strftime.
  • %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%

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
anidbcli-1.35.tar.gz (10.1 kB) Copy SHA256 hash SHA256 Source None Sep 4, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page