h2hdb 0.11.0.0

A simple H@H database

H2HDB

Description

The H2HDB is a comprehensive database for organising and managing H@H comic collections. It offers a streamlined way to catalogue your comics, providing key information such as GID (Gallery ID), title, tags and more, ensuring your collection is always organised and accessible.

---

Features

• Add new galleries to the database
• Comporess H@H's galleries to a folder
• Record the removed GIDs in a separate list
• Write document (need?)

---

Installation and Usage

1. Install uv. It manages the Python version and dependencies for you.

2. Install the required packages.

   uv pip install h2hdb
   

3. Run the script.

   uv run python -m h2hdb --config [json-path]
   

Config

{
    "h2h": {
        "download_path": "download",
        "cbz_max_size": 768,
        "cbz_grouping": "flat",
        "cbz_sort": "no",
        "cbz_scrub_batch_size": 100
    },
    "database": {
        "sql_type": "mariadb",
        "host": "localhost",
        "port": 3306,
        "user": "root",
        "password": "password",
        "database": "h2h"
    },
    "logger": {
        "level": "INFO"
    }
}

• h2h.download_path: H@H download path. The default is download.
• h2h.cbz_path: directory for CBZ output. Unset (the default) disables CBZ output entirely; if given, it must be a non-empty path ("" is rejected).
• h2h.cbz_max_size: maximum image size. The default is 768.
• h2h.cbz_grouping: flat, date-yyyy, date-yyyy-mm, or date-yyyy-mm-dd. The default is flat.
• h2h.cbz_sort: no, upload_time, download_time, gid, title, pages, or pages+[num]. The default is no.
• h2h.cbz_scrub_batch_size: number of CBZ files to integrity-check (and transparently rebuild if corrupted) per insert_h2h_download run. 0 disables scrubbing. The default is 100.
• database.sql_type: mariadb or sqlite. The default is mariadb. Existing config files that still use mysql must update this field.
• database.host, database.port, database.user, and database.password are only used for mariadb.
• database.database: for mariadb, this is the database name. For sqlite, this is the path to the database file.
• logger.level: one of NOTSET, DEBUG, INFO, WARNING, ERROR, or CRITICAL.

---

Q & A

• Why are some images missing from the CBZ-files?

H2HDB does not compress images that are considered spam according to certain rules. If you encounter any images that you believe should have been included, please report the issue.

• Why are some images in some CBZ files and not in other CBZ-files?

H2HDB learns the spam rule from the previous CBZ files. If you kill the CBZ files containing these images, the new CBZ files will not contain these images.

---

Credits

The project was created by Kuan-Lun Wang.

---

License

This project is distributed under the terms of the GNU General Public Licence (GPL). For detailed licence terms, see the LICENSE file included in this distribution.