HWatch

Self-hosted NAS media subscription, downloader and Plex TV library manager โ€” powered by Go, SQLite, aria2 and Vue/TypeScript.

License Last commit Top language Stars
HWatch overview (demo mode)

Features

๐Ÿ“ก

Creator subscriptions

Full-pagination subscriptions build a complete baseline, then auto-download new works.

โฌ‡๏ธ

Persistent downloads

aria2 / wget engines, pause & resume, resumable transfers, 429 backoff with live speed.

๐ŸŽฌ

Plex TV library

tvshow.nfo, per-episode NFO, posters and thumbnails written into your existing media root.

๐Ÿงฉ

Platform adapters

Rule34Video and Hanime1 today, behind a unified adapter interface for new sources.

๐Ÿ”

Auth & audit

Admin sessions with CSRF, structured audit log, task history, notifications and health checks.

๐ŸŒ

WebAI translation

Safe JSON export of titles/tags with source-hash verification and re-import.

Quick start

Replace the NAS path in compose.yaml with your Plex media directory, then:

# docker compose
/path/on/nas/Plex-TV:/media
docker compose up -d --build
# open
http://NAS-IP:8787

Or run from source (Go 1.24, Node.js, aria2, FFmpeg):

npm install && npm run build
aria2c --enable-rpc=true --daemon=true
go run ./cmd/r34watch
  • SQLite + aria2 session in the data directory
  • Plex and HWatch read the same video files โ€” no duplicate copy
  • Create an admin account on first visit

Install

One-line install for systemd-based Linux (Debian/Ubuntu, RHEL/Fedora, Arch, openSUSE):

curl -fsSL https://raw.githubusercontent.com/Hwatch/Hwatch-Server/main/install.sh | sudo bash

Installs to /opt/hwatch, creates a hwatch systemd service on :8787 and pulls the latest release. Options are documented in the README; on non-systemd systems pass --no-service.

Documentation

Disclaimer

HWatch is an open-source, self-hosted tool for personal media management. It does not host, bundle, mirror or distribute any media or third-party content, and is not affiliated with, endorsed by or sponsored by any content source or platform. It is intended for adults only; you are solely responsible for complying with applicable laws and the terms of service of any site you access. The software is provided "as is", without warranty of any kind.