meellm/memanga repository overview

⁠MeManga

MeManga is an automatic manga downloader with a desktop app and a power-user CLI.

This Docker image packages the CLI-only version of MeManga with the Playwright Firefox runtime included, so it is useful for headless servers, NAS boxes, Raspberry Pi systems, and cron-style manga update automation.

The image does not include the desktop GUI runtime.

⁠Quick Start

docker pull meellm/memanga:latest
docker run --rm meellm/memanga:latest --help

Check the configured environment and library state:

docker run --rm meellm/memanga:latest status

⁠Persist Config And Downloads

MeManga stores config/state in /home/memanga/.config/memanga and downloads in /home/memanga/Downloads/MeManga.

mkdir -p memanga-data/config memanga-data/downloads

docker run --rm \
  -v "$PWD/memanga-data/config:/home/memanga/.config/memanga" \
  -v "$PWD/memanga-data/downloads:/home/memanga/Downloads/MeManga" \
  meellm/memanga:latest status

The container runs as UID 1000. If your bind-mounted folders are not writable by UID 1000, run:

sudo chown -R 1000:1000 memanga-data

⁠Common Commands

List tracked manga:

docker run --rm \
  -v "$PWD/memanga-data/config:/home/memanga/.config/memanga" \
  -v "$PWD/memanga-data/downloads:/home/memanga/Downloads/MeManga" \
  meellm/memanga:latest list

Open the interactive config editor:

docker run --rm -it \
  -v "$PWD/memanga-data/config:/home/memanga/.config/memanga" \
  -v "$PWD/memanga-data/downloads:/home/memanga/Downloads/MeManga" \
  meellm/memanga:latest config

Check for new chapters and automatically download them:

docker run --rm \
  -v "$PWD/memanga-data/config:/home/memanga/.config/memanga" \
  -v "$PWD/memanga-data/downloads:/home/memanga/Downloads/MeManga" \
  meellm/memanga:latest check --auto

⁠Tags

Stable release tags are published as:

• latest - newest stable release
• 0.4.0 - exact release version
• 0.4 - latest patch release in the 0.4 series
• sha-<commit> - immutable source commit tag

For reproducible automation, pin an exact version tag such as:

docker pull meellm/memanga:0.4.0

⁠Supported Platforms

• linux/amd64
• linux/arm64

⁠What Is Included

• MeManga CLI
• Playwright Firefox runtime for JS-heavy manga sources
• CLI dependencies needed for downloading, conversion, state tracking, and Kindle/email delivery

⁠What Is Not Included

• Desktop GUI
• PySide6 GUI runtime
• Any cloud service or hosted account system

⁠Links

• GitHub: https://github.com/meellm/MeManga⁠
• Releases: https://github.com/meellm/MeManga/releases⁠
• Documentation: https://github.com/meellm/MeManga/blob/main/docs/Guide.md⁠