*ARRgh!

A self-hosted manga manager, downloader, and reader for your home server. Supports manga, manhwa, and manhua from multiple sources via a plugin system. Built to run on a NAS, Raspberry Pi, or any always-on box.

I'm a solo dev who built this for myself — tired of juggling browser tabs, download scripts, and folder structures just to keep up with series. If you find it useful or want to contribute, you're very welcome. See Contributing.

---

Features

• Browse and search manga from multiple sources simultaneously
• Chapters aggregated across all known sources — completeness doesn't depend on any one source being up to date
• Automatic download fallback — if the preferred source fails, arrgh tries the next by priority
• Source plugin system — add new sources without recompiling or redeploying
• Browse and install community plugins from the Settings UI
• Download chapters to your server for offline reading
• Real-time download progress with per-chapter percentage bars
• Web reader (paged or scroll mode)
• Multi-user support — per-user libraries with shared file storage, per-user reading progress
• Auto-download new chapters on a schedule
• Explicit content controls — admin grants access per user
• Content-type filtering — search only manga, manhwa, manhua, or all at once

---

Quick start (Docker)

curl -O https://raw.githubusercontent.com/t2vi/arrgh/main/docker-compose.yml
docker compose up -d

Open http://<your-server-ip>:8080 — the setup wizard runs on first launch.

The default Compose file includes the Mangapill and MangaDex plugins. They auto-register on first boot via PLUGIN_URLS — no manual configuration needed.

See docs/deploy/docker-compose.md for full configuration.

---

Sources

*ARRgh uses a plugin system for content sources. Each source is an HTTP server implementing the Source Plugin Protocol.

Bundled plugins

All default sources compile into a single plugin-host container — no per-plugin ports or sidecars:

Source	Content	Directory	Notes
Mangapill	Manga	plugins/mangapill/
MangaDex	Manga, Manhwa, Manhua, One-shot	plugins/mangadex/
Toonily	Manhwa	plugins/toonily/	CF-protected — uses CloakBrowser
Comick	Manga, Manhwa, Manhua	plugins/comick/	CF-protected — uses CloakBrowser
Royal Road	Novel	plugins/royalroad/
NovelFull	Novel	plugins/novelfull/	CF-protected — uses CloakBrowser

CF-protected plugins route through the CloakBrowser sidecar (stealth Chromium, source-level fingerprint patches). Plugin Host holds the CDP connection; plugins call ctx.getBrowser() via PluginContext.

Adding a source

1. Write an HTTP server implementing the Source Plugin Protocol
2. Run it (locally or as a Docker service)
3. Register it: Settings → Sources → Add (or set PLUGIN_URLS for auto-registration on startup)

Source Plugin Protocol

Every plugin must implement:

GET /info                         → { id, name, default_explicit, content_types }
GET /search?q=<query>             → [MangaResult]
GET /manga/:source_id/chapters    → [ChapterResult]
GET /chapter/:source_id/pages     → [image_url]

Optional endpoints (gracefully skipped if absent):

GET /trending
GET /manga/:source_id/meta        → { description, cover_url, chapter_count, tags? }
GET /cover?url=<encoded_cdn_url>  → raw image bytes
GET /chapter/:source_id/text      → Markdown string (novel chapters only)

/cover lets a plugin fetch CDN images with source-specific headers (e.g. custom Referer). When absent, arrgh fetches directly with a browser User-Agent.

tags in meta is a comma-separated genre string. Include "adult" to signal explicit content — arrgh sets is_explicit = true on sync and hides the title from users without Explicit Permission.

Plugins can be written in any language. See plugins/mangadex/ (API-backed) and plugins/toonily/ (scraper + CloakBrowser) for reference implementations.

---

Architecture

arrgh/
├── server/          # Rust / Axum API server
├── web/             # React + TypeScript SPA
├── plugin-host/     # Node.js plugin host (loads compiled plugin bundles)
└── plugins/         # Plugin source bundles (esbuild → single .js)
    ├── mangadex/
    ├── mangapill/
    ├── toonily/
    ├── comick/
    ├── royalroad/
    └── novelfull/

• Backend: Rust, Axum, SQLx (SQLite), Tokio
• Frontend: React 18, TypeScript, Vite, Tailwind
• Plugins: Node.js bundles loaded by plugin-host; CF-protected sources use CloakBrowser via CDP

---

Contributing

Issues and PRs are welcome. A few things to know:

• This is a personal project — I may be slow to review, but I do look at everything
• Check open issues before starting large features; comment to claim one
• Run cargo nextest run (server) and npm test (web) before submitting
• Follow the existing code style — see server/README.md and web/README.md for dev setup

No CLA, no process overhead. Just open a PR.

---

Roadmap

See ROADMAP.md.

---

License

GNU GPL v3