# CBZForge

CBZForge is a self-hosted comic-library web app that scrapes album metadata into CBZ archives, converts CBR, PDF, and EPUB files to CBZ, and organizes files into series folders. It is open source and self-hosted, installable on TrueNAS.

Canonical page: https://ourlocalhost.com/app/7517/cbzforge

## Description

CBZForge is a self-hosted comic-library web app that scrapes album metadata into CBZ archives, converts CBR, PDF, and EPUB files to CBZ, and organizes files into series folders.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 77 (last commit 15 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 10 (1 install platform)

## Links

- TrueNAS: https://apps.truenas.com/catalog/cbzforge/
- GitHub: https://github.com/chevalierbenoit/cbzforge

## Common questions

### How is the first administrator created?

Create the administrator account on the first-start setup page. It is the only account, and the setup page closes after it is created.

### Can libraries be added without using the onboarding assistant?

Yes. You can skip the assistant and add libraries in the admin area or through the REST API.

### What permissions do mounted libraries need when running Docker?

The image runs as UID/GID 568 by default, so mounted libraries must be writable by that user. When started as root with the repository's compose setup, the entrypoint aligns www-data with HOST_UID and HOST_GID.

### Do scraping and conversion jobs need a background worker?

Scraping and format conversion jobs run in the background. The Docker setup runs the messenger worker automatically, while a non-Docker install needs a separate terminal running the messenger consumer command.

### What folder structure does it create for renamed files?

It renames files with a template and moves them into a Series/TXX - Title.ext structure.

---
Source: Our Local Host (https://ourlocalhost.com/app/7517/cbzforge), the self-hosted and open-source app directory.
