Mangarr

Mangarr downloads manga chapters from supported sources and saves them as .cbz archives. Use it for quick one-off downloads or let it run in monitor mode and fetch new chapters for you.

• Download the latest, first, specific, or all available chapters.
• Monitor series and auto-download new releases.
• Save chapters as .cbz files that work with comic and manga readers.
• Run as a native binary or with Docker.

Download the latest release for your platform from the releases page.

Available for:

• Linux (amd64, arm, arm64)
• Windows (amd64)
• macOS (amd64, arm64)
• FreeBSD (amd64)

docker pull ghcr.io/nuxencs/mangarr:latest

For Docker Compose, prepare writable host directories and start the checked-in sample with your user and group IDs:

mkdir -p config/mangarr downloads
cp config.yaml config/mangarr/config.yaml
PUID=$(id -u) PGID=$(id -g) docker compose up -d

The sample defaults to ./config, ./downloads, and the container's unprivileged user when the optional DOCKERCONFDIR, DOWNLOADDIR, PUID, or PGID variables are not set.

Check the installed version:

mangarr version

Download the latest chapter from a source:

mangarr download --help
mangarr download -d ./downloads -s tcbscans -m "One Piece"

The command returns a nonzero status when setup, discovery, selection, or any requested chapter download fails.

If you want a different source, the value you pass to -m changes by provider. Use the table below.

Create a config.yaml:

downloadLocation: "/path/to/downloads"
checkInterval: 15

monitoredManga:
  One Piece:
    source: "tcbscans"
    manga: "One Piece"

Run the monitor:

mangarr monitor -c ~/.config/mangarr

-c should point to the directory that contains config.yaml. If you omit it, mangarr also checks common default locations. Full config and override details live in docs/USAGE.md.

Comix uses a private frontend protocol. A Comix frontend update can require a Mangarr update.

User docs:

• Usage and config reference
• Security notes

Maintainer docs:

• Architecture
• Design guide
• Plans guide

This project is licensed under the MIT License. See LICENSE.

Personal use only. Respect the rights of creators and publishers, and support official releases when possible.