{"id":29631951,"url":"https://github.com/stabldev/torrra","last_synced_at":"2026-01-03T13:13:10.625Z","repository":{"id":303535361,"uuid":"1014780508","full_name":"stabldev/torrra","owner":"stabldev","description":"A Python tool that lets you find and download torrents without leaving your CLI. ","archived":false,"fork":false,"pushed_at":"2025-07-16T15:14:26.000Z","size":4261,"stargazers_count":210,"open_issues_count":5,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-17T05:29:17.703Z","etag":null,"topics":["libtorrent-python","python-cli","torrent","torrent-downloader"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/torrra","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stabldev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-06T12:02:20.000Z","updated_at":"2025-07-16T15:56:31.000Z","dependencies_parsed_at":"2025-07-08T06:49:18.640Z","dependency_job_id":"49b48335-958a-4112-ae23-41887348a2cd","html_url":"https://github.com/stabldev/torrra","commit_stats":null,"previous_names":["stabldev/torrra"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/stabldev/torrra","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stabldev%2Ftorrra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stabldev%2Ftorrra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stabldev%2Ftorrra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stabldev%2Ftorrra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stabldev","download_url":"https://codeload.github.com/stabldev/torrra/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stabldev%2Ftorrra/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265772836,"owners_count":23825911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["libtorrent-python","python-cli","torrent","torrent-downloader"],"created_at":"2025-07-21T12:43:56.211Z","updated_at":"2026-01-03T13:13:10.620Z","avatar_url":"https://github.com/stabldev.png","language":"Python","funding_links":["https://www.buymeacoffee.com/stabldev"],"categories":["Python","\u003ca name=\"torrent\"\u003e\u003c/a\u003eTorrent"],"sub_categories":[],"readme":"# Torrra - “rrr”\n\n\u003e A Python tool that lets you search and download torrents without leaving your CLI.\n\n[![Python Versions](https://img.shields.io/pypi/pyversions/torrra?style=flat-square)](https://pypi.org/project/torrra/)\n[![PyPI](https://img.shields.io/pypi/v/torrra?style=flat-square)](https://pypi.org/project/torrra/)\n[![AUR Version](https://img.shields.io/aur/version/torrra?style=flat-square)](https://aur.archlinux.org/packages/torrra)\n[![Pepy Total Downloads](https://img.shields.io/pepy/dt/torrra?style=flat-square\u0026color=blue)](https://pypi.org/project/torrra/)\n[![CI Status](https://img.shields.io/github/actions/workflow/status/stabldev/torrra/ci.yml?style=flat-square)](https://github.com/stabldev/torrra/actions/workflows/ci.yml)\n[![Docs](https://readthedocs.org/projects/torrra/badge/?version=latest\u0026style=flat-square)](https://torrra.readthedocs.io/)\n[![License](https://img.shields.io/github/license/stabldev/torrra?style=flat-square)](https://github.com/stabldev/torrra/blob/main/LICENSE)\n\n![demo](./docs/_static/demo.gif)\n\n_Torrra_ provides a streamlined command-line interface for torrent search and downloads, powered by Jackett/Prowlarr and Libtorrent. Built with Textual, it offers a beautiful\nTUI with pause/resume support - all without leaving your terminal.\n\n**Full documentation**: https://torrra.readthedocs.io/en/latest/\n\n## Installation\n\n```bash\npipx install torrra\n# or uv tool install torrra\n```\n\nOther options: [`AUR`](https://aur.archlinux.org/packages/torrra), [`standalone binaries`](https://github.com/stabldev/torrra/releases), [`Homebrew`](https://github.com/Maniacsan/homebrew-torrra) or [`Docker`](https://hub.docker.com/r/stabldev/torrra).\n\n[See full install options →](https://torrra.readthedocs.io/en/latest/installation.html)\n\n## Quick Usage\n\n### 1. Interactive Search\n\nLaunch `torrra` with an indexer.\n\n```bash\ntorrra # if default indexer is configured\n# or torrra jackett\n# or torrra jackett --url http://localhost:9117 --api-key \u003cyour_api_key\u003e\n```\n\n\u003e Replace `\u003cyour_jackett_api_key\u003e` with your actual Jackett API key.\n\n### 2. Direct Search\n\nYou can bypass the initial welcome screen and search\\\nfor torrents directly from your command line using the `search` command:\n\n```bash\ntorrra search \"arch linux iso\"\n# or torrra search \"arch linux iso\" --no-cache\n```\n\n### 3. Direct Download\n\nYou can download torrents directly from `magnet URIs` or `.torrent` files\\\nwithout searching using the `download` command:\n\n```bash\ntorrra download \"magnet:?xt=urn:btih:...\"\n# or torrra download \"/path/to/file.torrent\"\n```\n\n[Full Usage guide →](https://torrra.readthedocs.io/en/latest/usage.html)\\\n[See full CLI \u0026 TUI guide →](https://torrra.readthedocs.io/en/latest/usage.html#text-user-interface-tui-controls)\n\n## Configuration\n\nFor persistent settings, `torrra` uses a `config.toml` file where you can configure your indexers, download paths, and themes. This avoids the need to pass arguments on every run.\n\nFor example, to set up Jackett as your default indexer:\n\n```bash\n# set your Jackett URL and API key\ntorrra config set indexers.jackett.url http://localhost:9117\ntorrra config set indexers.jackett.api_key \u003cyour_api_key\u003e\n\n# set Jackett as the default indexer\ntorrra config set indexers.default jackett\n```\n\nNow you can simply run `torrra` to start searching:\n\n```bash\ntorrra # default indexer will be used\n```\n\n[Learn more about configuration →](https://torrra.readthedocs.io/en/latest/configuration.html)\n\n## Features\n\n- Search with [`Jackett`](https://github.com/Jackett/Jackett) or [`Prowlarr`](https://github.com/Prowlarr/Prowlarr)\n- Download torrents directly with pause/resume support\n- Beautiful and responsive TUI built with [`Textual`](https://textual.textualize.io/)\n- Customizable themes (dark, light, and more)\n- Smart config + opt-in caching for fast searches\n- Native support for Linux, macOS, and Windows\n\n[Full feature list →](https://torrra.readthedocs.io/en/latest/#features)\n\n## Contributing\n\nContributions are welcome and greatly appreciated!\\\nWhether it's reporting a bug, submitting a feature request, or writing code, we value your help.\n\n- **Found a bug or have an idea?** [Open an issue](https://github.com/stabldev/torrra/issues/new/choose) to let us know.\n- **Want to contribute code?** Check out the [Contributing Guide](https://torrra.readthedocs.io/en/latest/contributing.html),\\\n  to learn how to set up your development environment and submit a pull request.\n\n## License\n\n[MIT](LICENSE) © 2025 ^\\_^ [`@stabldev`](https://github.com/stabldev)\n\n## Like my work?\n\nThis project needs a ⭐ from you. Don't forget to leave a ⭐\\\nIf you found this helpful, consider supporting me with a coffee.\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/stabldev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstabldev%2Ftorrra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstabldev%2Ftorrra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstabldev%2Ftorrra/lists"}