Metron-Tagger
Quick Description
A command-line tool to tag comic archives with metadata from metron.cloud.
Installation
PyPi
Or install it yourself:
$ pipx install metron-tagger
There are optional dependencies which can be installed by specifying one or more of them in braces e.g. metron-tagger[7zip]
The optional dependencies are:
- 7zip: Provides support for reading/writing to CB7 files.
- pdf: Provides support for reading/writing to PDF files.
FAQ
What comics formats are supported?
- Metron-Tagger supports CBZ, CBR, CBT, CB7 (optional), and PDF (optional) comics.
How to enable RAR support?
- It depends on the unrar command-line utility, and expects it to be in your
$PATH.
NOTE: unrar only supports reading archives, so you will need to convert the archive to a cbz to write to it. To do so you can use
-z, --export-to-cbzand if you want you can remove the orginal .cbr archive with--delete-originalafter successful conversion.
Help
usage: metron-tagger [-h] [-r] [-o] [-m] [-c] [--id ID] [-d] [--ignore-existing] [--accept-only] [--missing] [-s] [-z] [--validate] [--remove-non-valid] [--delete-original] [--duplicates] [--migrate] [--version]
path [path ...]
Read in a file or set of files, and return the result.
positional arguments:
path Path of a file or a folder of files.
options:
-h, --help show this help message and exit
-r, --rename Rename comic archive from the files metadata. (default: False)
-o, --online Search online and attempt to identify comic archive. (default: False)
-m, --metroninfo Write, delete, or validate MetronInfo.xml. (default: False)
-c, --comicinfo Write, delete, or validate ComicInfo.xml. (default: False)
--id ID Identify file for tagging with the Metron Issue Id, or restrict directory matches to issues from a specific Metron Series Id. (default: None)
-d, --delete Delete the metadata tags from the file. (default: False)
--ignore-existing Ignore files that have existing metadata tag. (default: False)
--accept-only Automatically accept the match when exactly one valid match is found. (default: False)
--skip-multiple Skip files that have multiple matches instead of prompting for selection. (default: False)
--missing List files without metadata. (default: False)
-s, --sort Sort files that contain metadata tags. (default: False)
-z, --export-to-cbz Export a CBR (rar) archive to a CBZ (zip) archive. (default: False)
--validate Verify that comic archive has a valid metadata xml. (default: False)
--remove-non-valid Remove metadata xml from comic if not valid. Used with --validate option (default: False)
--delete-original Delete the original archive after successful export to another format. (default: False)
--duplicates Identify and give the option to delete duplicate pages in a directory of comics. (Experimental) (default: False)
--migrate Migrate information from a ComicInfo.xml into a *new* MetronInfo.xml (default: False)
--version Show the version number and exit
Examples
To tag all comics in a directory with MetronInfo.xml that don't already have one:
metron-tagger -om --ignore-existing /path/to/comics
To remove any ComicInfo.xml from a directory of comics:
metron-tagger -dc /path/to/comics
To validate any metadata, ComicInfo.xml and MetronInfo.xml, would be done by running the following:
metron-tagger -cm --validate /path/to/comics
To write MetronInfo.xml metadata from comics with ComicInfo.xml data, and migrate data for comics that don't exist at the Metron Comic Database:
metron-tagger -om --migrate /path/to/comics
To remove duplicate pages from comics (which should be only ran on a directory of weekly release since we scan all the pages within a comic), would be done by running the following:
metron-tagger --duplicates /path/to/weekly/comics
Bugs/Requests
Please use the GitHub issue tracker to submit bugs or request features.
License
This project is licensed under the GPLv3 License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file metron_tagger-4.11.0.tar.gz.
File metadata
- Download URL: metron_tagger-4.11.0.tar.gz
- Upload date:
- Size: 70.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
241ca71f731fb262165e280014f21d670db725222097b66efe0e1a31066710f7
|
|
| MD5 |
db9e36d2199eaaf9c0727954b6053398
|
|
| BLAKE2b-256 |
887fb0eb92cfcba5ed5317058bcde59ec58c7804399557a90eec637a74f5fb6c
|
File details
Details for the file metron_tagger-4.11.0-py3-none-any.whl.
File metadata
- Download URL: metron_tagger-4.11.0-py3-none-any.whl
- Upload date:
- Size: 52.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64e430fca928c63947313457149c09788ac8d0f5df78e036edf16c25a1b73f27
|
|
| MD5 |
28a8015418866d2116eb0025e84bdb40
|
|
| BLAKE2b-256 |
58e808e3e4150e81f861839d6ffbc04094e909135735898d65e58b66e9cd34e3
|
