This is a supplimentary tool for Gotson's Komga Library software

Retriving metadata for Komga comics using AniList. The motivation behind this project is to match content with metadata in my Komga library that has been aquired from various DRM Free sources like Humble Bundle.

This project was inspired by the AniSearchKomga script.

The goal is to pull data from aniList's Manga database.

Ideal folder/series naming should be something like: Name (Year) (Optional Notes), Name (year-year) (optional Notes)

Currently the script asks the user to verify the match before committing to fetch and update the metadata of a series in komga.

You can expect the script to pull all fields from Komga. It will only update unlocked fields. When it updates a field it will lock it

pushJSON = '''
{
  "status": "%s",
  "statusLock": %r,
  "title": "%s",
  "titleLock": %r,
  "titleSort": "%s",
  "titleSortLock": %r,
  "summary": "%s",
  "summaryLock": %r,
  "publisher": "%s",
  "publisherLock": %r,
  "readingDirectionLock": %r,
  "ageRatingLock": %r,
  "language": "%s",
  "languageLock": %r,
  "genresLock": %r,
  "tagsLock": %s,
  "totalBookCountLock": %r,
  "tags": %s,
  "readingDirection": "%s",
  "ageRating": %s,
  "genres": %s,
  "totalBookCount": %s,
}
''' % (komgaSeries.status,
  komgaSeries.statusLock, 
  komgaSeries.title, 
  komgaSeries.titleLock,
  komgaSeries.titleSort,
  komgaSeries.titleSortLock,
  komgaSeries.summary,
  komgaSeries.summaryLock,
  komgaSeries.publisher,
  komgaSeries.publisherLock,
  komgaSeries.readingDirectionLock,
  komgaSeries.ageRatingLock,
  komgaSeries.language,
  komgaSeries.languageLock,
  komgaSeries.genresLock,
  komgaSeries.tagsLock,
  komgaSeries.totalBookCountLock,
  patchTags,
  komgaSeries.readingDirection,
  komgaSeries.ageRating,
  patchGenres,
  komgaSeries.totalBookCount,
  )

• Python 3 (preferably more recent version, My enviroment was python 3.9. I avoided new syntax introduced in python 3.10)
• pip - Pip for Python - https://pypi.org/project/pip/
• requests - Requests: HTTP for Humans™ - https://docs.python-requests.org/en/latest/

The script is configured by copying the config.template.py into config.py.

# Enter server and credentials here

baseURL="https://example.com" # Include protocol (ie. https:// or https://) and port (if relevant)
user=""
pass=""

Ensure there is no trailing slash in your URL

Example config:

# Enter server and credentials here

baseURL="https://192.168.21.12" # Include protocol (ie. https:// or https://) and port (if relevant)
user="[email protected]"
pass="mySecretPassword"

Once saved as config.py, using a virtual enviroment. I recommend following a tutorial like this one: Python Virtual Environments: A Primer by Real Python (not affiliated)

Pip is required. you can install depenancies with pip install -r requirements.txt

The script will be ready to run. Depending on your python installation: python getMetadata.py or python3 getMetadata.py

Save progress in file so it can be automatically skipped over

List years in matching

need to add format to identify manga from novela entries

maybe list vol number too?

Manga (South Korean) should make reading directions webtoon

FuzzyWuzzy fuzzy strings matching.

I may look into saving the data into ComicInfo.xml files. Maybe.

Per volume info may be retirved google books. Will need to define how to recognise volume numbers (ex. toyoureternity_v11.cbz)

Per volume updating is required to assign authorship to series books.