BDneX french comics tagger and library manager (POF at this stage)

Motivation

Contrary to music tagging, there is no agreed standard vocabulary for comics tagging in general. However the ComicRack standard is used by most library managers such as Komga

A few teams are working on metadata for American comics, such as comic tagger This tool retrieves data from the ComicVine REST API Comic Vine. However it is mostly for american comics, and only the most famous french ones are represented.

BDneX comes here to hopefully fill the gap, with search capabilities of metadata, which then can be added to CBZ and CBR file format.

Why doing this? On big libraries, it becomes easy then to find a book, based on its genre, community score, author, colorist, penciller!

Read List can then be generated and more easily shared accross the community as based on metadata and not an obscure filename.

Current Features

• retrieve sitemaps from bedetheque.com
• levenhstein fuzzy string matching to find album name on external website (since no API is available)
• alternatively, there is currently a duckduckgo search, but will probably be deprecated
• Parse content of webpage with beautifulSoup
• convert parsed metadata into ComicInfo.xsd template
• Image comparaison between online cover and archive cover to bring confidence into creating metadata file

Roadmap (?)

Further Feature(?):

• SQLight database to keep record of already processed data
• Interactive mode
• catalog manager
• renaming convention, based on user conf in ~/.local/bdnex/bdnex.ini
• add more "API", fmor bdfuge ...
• resume

Get inspiration from beets music manager: beets

Installation

It is recommended to create a virtual environmnent with Conda

conda env create --file=environment.yml
conda activate bdnex

User mode:

pip install .

Dev mode:

pip install -e .[dev]

Examples:

bdnex -f /tmp/  # folder containing albums

2022-07-22 02:22:28,605 - INFO     - bdnex.ui - Processing /tmp/dummy.cbz
2022-07-22 02:22:28,605 - INFO     - bdnex.lib.bdgest - Searching for "dummuy"" in bedetheque.com sitemap files
2022-07-22 02:22:28,605 - DEBUG    - bdnex.lib.bdgest - Searching for "dummy"" in bedetheque.com sitemap files [FAST VERSION]
2022-07-22 02:22:28,605 - DEBUG    - bdnex.lib.bdgest - Merging sitemaps
2022-07-22 02:22:32,993 - DEBUG    - bdnex.lib.bdgest - Match album name succeeded
2022-07-22 02:22:32,993 - DEBUG    - bdnex.lib.bdgest - Levenhstein score: 53.333333333333336
2022-07-22 02:22:32,993 - DEBUG    - bdnex.lib.bdgest - Matched url: https://m.bedetheque.com/BD-dummy.html
2022-07-22 02:22:32,993 - DEBUG    - bdnex.lib.bdgest - Parsing JSON metadata from already parsed web page ~/.local/share/bdnex/bedetheque/albums_json/BD-dummy.json
2022-07-22 02:22:33,002 - INFO     - bdnex.lib.bdgest - Converting parsed metadata to ComicRack template
2022-07-22 02:22:33,011 - DEBUG    - bdnex.lib.cover - Cover ~/.local/share/bdnex/bedetheque/covers/Couv_dummy.jpg already downloaded
2022-07-22 02:22:33,011 - INFO     - bdnex.lib.cover - Checking Cover from input file with online cover
2022-07-22 02:22:33,442 - INFO     - bdnex.lib.cover - Cover matching percentage: 44.9264705882353
2022-07-22 02:22:33,442 - INFO     - bdnex.lib.comicrack - Add ComicInfo.xml to /tmp/dummy.cbz
2022-07-22 02:22:33,442 - INFO     - bdnex.lib.comicrack - Create ComicInfo.xml
2022-07-22 02:22:33,444 - INFO     - bdnex.lib.comicrack - Successfully appended ComicInfo.xml to /tmp/dummy.cbz
2022-07-22 02:22:33,445 - INFO     - bdnex.ui - Processing album done
...