Skip to content

Repository files navigation

Tormammu

Tormammu's home screen, showing the search bar on first launch

Tormammu is a Windows desktop application for searching and downloading torrents. It's a graphical app you install and run like any other Windows program — not a terminal tool. Search across a curated list of sources, see what's available, and download with one click, with an optional handoff to Sonarr for TV.

Tormammu search results for a TV episode, showing per-source status chips and Download / Add to Sonarr buttons on each result

Install on Windows

  1. Go to the Releases page and download Tormammu Setup 1.0.0.exe.
  2. Run the installer.
  3. Choose the normal per-user install (no administrator rights needed).
  4. Launch Tormammu from the Start Menu or Desktop shortcut.
  5. Type a search and press Search.
  6. Click Download on the result you want.

No other software is required to search and download.

Downloads and Library

Tormammu's Library page listing completed downloads with their size and sharing status

By default, downloads are saved to:

C:\Users\<your-username>\Downloads\tormammu

You can change this at any time in Settings → Download location; only new downloads use the new folder.

While a download is running you can pause, resume, or cancel it from the Downloads page. Once it finishes, it moves into your Library, where you can see everything you've downloaded and its seeding status.

Tormammu can keep seeding a completed download so others can get it too — this is controlled by the automatic seeding setting and can be turned off per-download or globally.

Search sources

Tormammu checks a curated list of torrent sources on every search. Sources can be temporarily unavailable depending on your network — when that happens, Tormammu marks that source as unavailable and keeps showing results from every source that did respond, rather than failing the whole search.

Sonarr integration

Sonarr is separate, optional TV-library software. Tormammu talks to it in two independent ways.

Monitoring shows and episodes is a Sonarr feature — Tormammu does not manage your show library or decide what to download on its own.

1. Direct: send one release from Tormammu

Tormammu TV result → Add to Sonarr → Sonarr → qBittorrent

Search in Tormammu, find a TV release, and click Add to Sonarr. Sonarr receives that one release and hands it to its download client to fetch.

2. Automatic: Sonarr searches Tormammu

Sonarr monitors shows/episodes → Sonarr searches Tormammu through Torznab
→ Tormammu searches its configured sources → Sonarr picks a release
→ qBittorrent downloads it → Sonarr imports it

Once Tormammu is added as an indexer in Sonarr, Sonarr can search it automatically for whichever shows and episodes you've told Sonarr to monitor — the monitoring itself is configured entirely in Sonarr.

One-time setup — add Tormammu as an indexer in Sonarr (Settings → Indexers → Add → Torznab):

Field Value
URL http://127.0.0.1:9162
API Path /api
API key leave blank (the default localhost setup doesn't need one)

Tormammu starts its Torznab service automatically whenever the desktop app is running, and stops it when you close Tormammu. Normal users never need to run a terminal command for this.

qBittorrent

qBittorrent is a separate download client that actually performs downloads Sonarr sends it — it is not part of Tormammu. Sonarr needs a download client configured (qBittorrent is the common choice); install and set it up yourself, then point Sonarr at it. Tormammu does not bundle Sonarr or qBittorrent.

Settings

  • Download location — where downloads are saved.
  • Automatic seeding — keep sharing completed downloads.
  • Sonarr connection — the URL and API key Tormammu uses for Add to Sonarr (this is separate from the Torznab indexer setup above, which is configured inside Sonarr).

Troubleshooting

A source shows "Unavailable" That source didn't respond. Results from other sources are still shown; try again later.

Sonarr can't reach Tormammu's indexer Tormammu's Torznab service only runs while Tormammu is open — launch Tormammu and re-test the indexer in Sonarr.

A release sent to Sonarr never downloads Check that qBittorrent is running and that it's set up as Sonarr's download client.

Sonarr shows "not connected" in Tormammu's Settings Double-check the Sonarr URL and API key in Tormammu match what Sonarr is actually running on.

Developer setup

This section is for building Tormammu from source — normal users installing the app do not need Node.js, npm, or any of this.

npm install
npm run dev

npm run dev builds and launches the desktop app from source.

npm run typecheck
npm test
npm run build
npm run build:desktop
npm run package:windows

npm run package:windows produces the Windows installer under release/ (gitignored — it's a build output, not part of the source tree).

Version

Tormammu v1.0.0

Responsible use

Tormammu is a search tool. You're responsible for complying with the copyright laws that apply to you and for only downloading content you're authorized to obtain. This is not legal advice.

About

A Windows desktop torrent search and download app with multi-source search, Library, seeding, and optional Sonarr integration.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages