2019-10-05 07:31:12 -07:00
|
|
|
[![Build Status](https://travis-ci.org/comictagger/comictagger.svg?branch=develop)](https://travis-ci.org/comictagger/comictagger)
|
2019-10-05 07:09:04 -07:00
|
|
|
[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/comictagger/community)
|
|
|
|
[![Google Group](https://img.shields.io/badge/discuss-on%20groups-%23207de5)](https://groups.google.com/forum/#!forum/comictagger)
|
|
|
|
[![Twitter](https://img.shields.io/badge/%40comictagger-twitter-lightgrey)](https://twitter.com/comictagger)
|
|
|
|
[![Facebook](https://img.shields.io/badge/comictagger-facebook-lightgrey)](https://www.facebook.com/ComicTagger-139615369550787/)
|
2018-09-19 13:05:39 -07:00
|
|
|
|
2019-10-05 07:09:04 -07:00
|
|
|
# ComicTagger
|
|
|
|
|
|
|
|
ComicTagger is a **multi-platform** app for **writing metadata to digital comics**, written in Python and PyQt.
|
|
|
|
|
2019-10-06 07:01:33 -07:00
|
|
|
![ComicTagger logo](https://raw.githubusercontent.com/comictagger/comictagger/develop/comictaggerlib/graphics/app.png)
|
2019-10-05 07:09:04 -07:00
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
* Runs on macOS, Microsoft Windows, and Linux systems
|
|
|
|
* Get comic information from [Comic Vine](https://comicvine.gamespot.com/)
|
|
|
|
* **Automatic issue matching** using advanced image processing techniques
|
|
|
|
* **Batch processing** in the GUI for tagging hundreds or more comics at a time
|
|
|
|
* Support for **ComicRack** and **ComicBookLover** tagging formats
|
|
|
|
* Native full support for **CBZ** digital comics
|
|
|
|
* Native read only support for **CBR** digital comics: full support enabled installing additional [rar tools](https://www.rarlab.com/download.htm)
|
|
|
|
* Command line interface (CLI) enabling **custom scripting** and **batch operations on large collections**
|
|
|
|
|
2019-10-05 07:31:12 -07:00
|
|
|
For details, screen-shots, release notes, and more, visit [the Wiki](https://github.com/comictagger/comictagger/wiki)
|
2019-10-05 07:09:04 -07:00
|
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
### Binaries
|
|
|
|
|
2019-10-05 07:31:12 -07:00
|
|
|
Windows and macOS binaries are provided in the [Releases Page](https://github.com/comictagger/comictagger/releases).
|
2019-10-05 07:09:04 -07:00
|
|
|
|
|
|
|
Just unzip the archive in any folder and run, no additional installation steps are required.
|
|
|
|
|
|
|
|
### PIP installation
|
|
|
|
|
|
|
|
A pip package is provided, you can install it with:
|
|
|
|
|
|
|
|
```
|
2021-10-21 21:58:20 -07:00
|
|
|
$ pip3 install comictagger[GUI]
|
2019-10-05 07:09:04 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
### From source
|
|
|
|
|
2021-10-21 21:58:20 -07:00
|
|
|
1. Ensure you have a recent version of python3 installed
|
|
|
|
2. Clone this repository `git clone https://github.com/comictagger/comictagger.git`
|
|
|
|
3. `pip3 install -r requirements_dev.txt`
|
|
|
|
4. Optionally install the GUI `pip3 install -r requirements-GUI.txt`
|
|
|
|
5. Optionally install CBR support `pip3 install -r requirements-CBR.txt`
|
|
|
|
6. `python3 comictagger.py`
|