/akari

python program to manage and automatically tag your image library

Primary LanguagePythonMIT LicenseMIT

Tag your anime photos effortlessly

img

akari is a work in progress python program to manage anime artwork

  • It uses iqdb to reverse-search images and tags your images automatically
  • You can add new tags or remove tags manually
  • You can select some tags and filter your images accordingly
  • Has a built in image viewer for fullscreen viewing

Requirements

  • requests
  • BeautifulSoup 4
  • PyQt5

Installation

For user installation, simply run:

pip3 install --user akari

Then add $HOME/.local/bin to your $PATH:

echo PATH=\"\$PATH:\$HOME/.local/bin\" >> $HOME/.bashrc
source $HOME/.bashrc

Alternatively, you can do a system wide installation:

sudo pip3 install akari

Usage

usage: akari [-h] [-s /path/to/dir] [-g] [-v] [-r] [-f]

optional arguments:
  -h, --help            show this help message and exit
  -s /path/to/dir, --scan /path/to/dir
                        Scan directory for new images
  -g, --gui             Start the GUI
  -v, --version         Displays the version
  -r, --rename          Rename the image if tags are detected
  -f, --force           force akari to identify the image

Configuration

The configuration file is in

  • Linux/Mac:$HOME/.config/akari/config.conf
  • Windows:C:\Users\${Username}\.config\akari
    • change ${Username} to your PC's username

Including the following part:

Common

Common part is under the title of [Common]

Key Value Default
http_proxy your http proxy server's url none
https_proxy your https proxy server's url none
format rename format,only active when using -r ${char}+${general}
general_num_limit the limit of amount of tag general 5

Format Placeholder

Placeholder Detail Example
${character} Placeholder for Character tag inui_toko
${general} Placeholder for General tag 1girl
${artist} Placeholder for Artist tag mizuki_hitoshi
${copyright} Placeholder for Copyright tag touhou
${meta} Placeholder for Meta tag translated

TODO