Skip to content

Resurrection of TorrentWatch-X automatic RSS/Atom torrent episode downloader (broadcatcher) with the extra capability of handling anime torrents

License

Notifications You must be signed in to change notification settings

dchang0/torrentwatch-xa

Repository files navigation

torrentwatch-xa

torrentwatch-xa is an anime/manga/light novel/TV show broadcatcher or PVR that regularly monitors multiple subscribed public RSS/Atom feeds for the latest "Favorite" serialized torrents and downloads them automatically. It is an actively-developed, high-quality resurrection of the popular but long-abandoned TorrentWatch-X.

As a fork of TorrentWatch-X, torrentwatch-xa handles Western live-action show titles containing commonly-used season x episode or date-based numbering styles. It is specially designed to also handle the widely-varying numbering styles used by anime, manga, and light novel fansubbing crews and also features all the bugfixes and code cleanup that TorrentWatch-X so badly needed.

torrentwatch-xa twxa ScreenShot 1

To auto-download Favorite torrents, torrentwatch-xa controls a local or remote Transmission BitTorrent client via Transmission RPC and/or saves .torrent files or magnet links as files locally. The latter allows the use of any BitTorrent client (not just Transmission) that can watch directories for .torrent files or magnet links to automatically start those torrents.

torrentwatch-xa is a single-page web app designed to run on Apache httpd 2.4 and up with PHP 5.7 and up and certain PHP modules. See INSTALL.md for the list of prerequisite software. While official support is only for specific LINUX distributions, you should be able to run torrentwatch-xa on any OS, any architecture, and any web server so long as the PHP installation has all the functions needed.

torrentwatch-xa is extremely lightweight and can run decently on even a $5 Raspberry Pi Zero. The web UI works on any modern web browser that has Javascript enabled, including smartphone and tablet browsers.

Common setups:

  • Local: torrentwatch-xa and Transmission run together on the same LINUX desktop, server, or NAS; downloaded content is stored on this one device. The ODROID HC1, HC2, or HC4 with a large capacity SATA drive is perfect for this use case--quiet, fast, and easy to directly install torrentwatch-xa and transmission-daemon on.
  • Remote: torrentwatch-xa runs on a low-power computer (usually a home-theater single-board computer running Kodi) or virtual machine and remotely controls Transmission running on a separate NAS that stores the downloaded content.

Status

I've posted 1.9.2 with the changes listed in CHANGELOG.md.

I finally got around to adding a bunch of additional pattern detection algorithms and fixing a few of the existing ones. As always, it is possible that older working pattern detectors will break due to the changes.

Please report any bugs using Github Issues.

If you like, buy me a coffee for those late-night torrentwatch-xa programming stints at Ko-Fi or CoinDrop.

Documentation

See:

  • INSTALL.md for detailed installation steps or important notes if you are upgrading from a prior version.

  • USAGE.md for usage notes and an explanation of some design decisions.

  • TROUBLESHOOTING.md for detailed troubleshooting steps and explanations of design decisions and common issues.

  • Known bugs are tracked primarily in the TODO.md and CHANGELOG.md files. Tickets in GitHub Issues will remain separate for accountability.

Credits