[{"_1":2,"_179":-5,"_180":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_154":155},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_88":-5,"_89":90,"_147":-5,"_148":11,"_149":17,"_150":11,"_151":-5,"_152":153},"canonicalUrl","https://hub.docker.com/r/lifailon/torapi/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","lifailon","reponame","torapi","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_43":44,"_46":47,"_48":49,"_50":11,"_51":52,"_53":54,"_55":56,"_39":31,"_28":29,"_58":59,"_60":45,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":29,"_73":74,"_79":11,"_80":81,"_85":29,"_86":87},"categories",[38],{"_39":40,"_41":42},"name","API management","slug","api-management","content_types",[45],"image","date_registered","2024-05-21T12:03:05.298961Z","description","Unofficial API (backend) for torrent trackers RuTracker, Kinozal, RuTor and NoNameClub.","is_private","last_updated","2025-07-24T12:24:51.93577Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[57],"application/vnd.oci.image.index.v1+json","pull_count",1536,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"Docker\"$ \n $\"NPM\"$ \n $\"Vercel\"$ \n $\"Swagger\"$ \n $\"Postman\"$ \n $\"Actions\"$ \n
\n
\n $\"Actions\"src=\"https://img.shields.io/github/actions/workflow/status/Lifailon/TorAPI/cd-docker-hub.yml?logo=GitHub-Actions&label=CD+Docker+Hub\"$ \n $\"Actions\"src=\"https://img.shields.io/github/actions/workflow/status/Lifailon/TorAPI/cd-vercel.yml?logo=Vercel&label=CD+Vercel\"$ \n $\"Actions\"src=\"https://img.shields.io/github/actions/workflow/status/Lifailon/TorAPI/ci-postman-tests.yml?logo=Postman&label=CI+Postman+Tests\"$ \n $\"Swagger\"src=\"https://img.shields.io/swagger/valid/3.0?specUrl=https%3A%2F%2Fraw.githubusercontent.com%2FLifailon%2FTorAPI%2Fmain%2Fswagger%2Fswagger.yaml&logo=Swagger&label=Swagger\"$ \n
\n $\"Docker\"src=\"https://img.shields.io/docker/image-size/lifailon/torapi?&color=blue&logo=Docker&label=Docker+Image\"$ \n $\"GitHub$ \n

\n\nUnofficial API (**backend**) for torrent trackers RuTracker, Kinozal, RuTor and NoNameClub. Used for fast and centralized search of distribution, receiving torrent files, magnetic links and detailed information about distribution by movie title, series or distribution identifier, and also provides news RSS feed to all providers with filtering by categories.\n\nYou can use the public and free version published on [Vercel](https://torapi.vercel.app/api/provider/list) as well as deploy it yourself on any cloud platform using **serverless** or local with [Docker](https://hub.docker.com/r/lifailon/torapi).\n\nThe **OpenAPI** specification is available on the official [Swagger Hub](https://app.swaggerhub.com/apis-docs/Lifailon/TorAPI) website.\n\nReleased under [MIT license](https://github.com/Lifailon/TorAPI/blob/rsa/LICENSE).\n\n### For what\n\nYou do not need to use a VPN when using the public version, as this service is in the gateway role, which allows you to integrate the `API` into any project without network restrictions and also use the news feed on mobile devices, for example through [ReadYou](https://github.com/Ashinch/ReadYou) or [Feeder](https://github.com/spacecowboy/Feeder). No access token and authorization in the trackers are required for the API to work.\n\nProject is inspired by ✨ [Torrent-Api-py](https://github.com/Ryuk-me/Torrent-Api-py) (previously [Torrents-Api](https://github.com/Ryuk-me/Torrents-Api)) for Russian-speaking torrent providers.\n\n### Implemented\n\n- Search by title to get current or all available distributions (from all available pages) from a specified provider (torrent tracker) or from all trackers simultaneously. Each distribution contains a unique identifier (used for **search by id**), category (used for **filtering by category**), brief information and a link to download the torrent file.\n- Get a list of categories for all providers and filter search by category.\n- Search by unique distribution identifier of the specified provider for additional information: magnetic link and hash sum for direct download through any torrent client, links to databases about cinema (Kinopoisk and IMDb) and posters, detailed description and content of the giveaways (list of files and their size).\n- Get RSS new feeds for all used providers in formats `XML`, as well as `JSON`.\n\n### Frontend\n\n#### Google Chrome Extension\n\nThe implementation of a simple user interface (like [Jackett](https://github.com/Jackett/Jackett)) is available through the Google Chrome extension 🍿 Libre Kinopoisk for simultaneously searching for distributions in all available torrent trackers and downloading content via magnet links or torrent files directly from the trackers.\n\n#### Wox Plugin\n\nTorrent [Search plugin](https://github.com/Lifailon/Wox.Plugins) for quickly searching for distributions in all available torrent trackers through the [Wox](https://github.com/Wox-launcher/Wox) interface, which is available for installation from the [plugins repository](http://www.wox.one/plugin/431).\n\n---\n\n### 🔗 Full list of available providers:\n\n| Provider name | Mirrors | Registration | Filter for search and RSS | Search by ID | RSS |\n| - | - | - | - | - | - |\n| [RuTracker](https://rutracker.org) | 3 | Yes* | Category | Yes | Native |\n| [Kinozal](https://kinozal.tv) | 3 | Yes* | Category, release year, format | Yes | *Custom* |\n| [RuTor](https://rutor.info) | 2 | No | Category | Yes | *Custom* |\n| [NoNameClub](https://nnmclub.to) | 1 | No | Category | Yes | Native |\n\n**\\*** Registration is required only when downloading a torrent file via a direct link. All distributions when searching by **id** (identifier) contain **info hash sum** and **magnet link** (already contain current list of torrent-trackers servers), which allow to immediately start loading content distribution or generate torrentfile after downloading metadata using any torrent client, for example [qBittorrent](https://github.com/qbittorrent/qBittorrent) (supports RSS and search plugins), [Transmission](https://github.com/transmission/transmission) or [Webtorrent Desktop](https://github.com/webtorrent/webtorrent-desktop).\n\nAccess to **RSS** feeds for *RuTracker* and *NoNameClub* is by redirecting the original channel. For *Kinozal* and *RuTor* providers, a casted news feed from the homepage has been implemented that supports filtering by categories.\n\n---\n\n## 🚀 Deploy\n\nYou can deploy your own public API to Vercel from this repository, just click the button below and follow the instructions:\n\n[![Vercel](https://img.shields.io/badge/Deploy-%23000000.svg?style=for-the-badge&logo=vercel&logoColor=white)](https://vercel.com/new/torapi/clone?repository-url=https://github.com/lifailon/TorAPI)\n\n## 🐳 Docker\n\n### Docker Hub\n\nThe project uses [GitHub Actions](https://github.com/Lifailon/TorAPI/actions) to build the Docker container and automatically test the functionality of all endpoints.\n\n#### Run\n\nUpload the image and run the container from the [Docker Hub](https://hub.docker.com/repository/docker/lifailon/torapi/general):\n\n```shell\ndocker run -d --name TorAPI -p 8443:8443 --restart=unless-stopped lifailon/torapi:latest\n```\n\nIf you are using a proxy server:\n\n```shell\ndocker run -d --name TorAPI -p 8443:8443 --restart=unless-stopped \\\n -e PROXY_ADDRESS=\"192.168.3.100\" \\\n -e PROXY_PORT=\"9090\" \\\n -e USERNAME=\"TorAPI\" \\\n -e PASSWORD=\"TorAPI\" \\\n lifailon/torapi:latest\n```\n\nReplace the contents of the variables for connecting to the Proxy server with your own. If you do not use authorization on the proxy server, simply do not specify these parameters when starting the container.\n\n#### Compose\n\nYou can download and use the [docker-compose](docker-compose.yml) file to build the container from Docker Hub:\n\n```shell\ncurl -sO https://raw.githubusercontent.com/Lifailon/TorAPI/main/docker-compose.yml\ncurl -sO https://raw.githubusercontent.com/Lifailon/TorAPI/main/.env.yml\n```\n\nEdit the environment variables in the [.env](.env) file (required if using a proxy server) and start the container:\n\n```shell\ndocker-compose up -d\n```\n\n### Local image\n\nYou can save an image downloaded from Docker Hub to transfer it to a machine that does not have Docker Hub access:\n\n```shell\ndocker save -o TorAPI-Docker-Image.tar lifailon/torapi\n```\n\nIn the [release files](https://github.com/Lifailon/TorAPI/releases) you can download the prepared image and boot it on your machine:\n\n```shell\ndocker load -i TorAPI-Docker-Image.tar\n```\n\nRun the container from the downloaded local image:\n\n```shell\ndocker run -d --name TorAPI -p 8443:8443 --restart=unless-stopped lifailon/torapi:latest\n```\n\n### Dockerfile\n\nYou can build the image yourself from the project's source files using [dockerfile](dockerfile).\n\nClone this repository:\n\n```shell\ngit clone https://github.com/Lifailon/TorAPI\ncd TorAPI\n```\n\nEdit variables or other settings in the `dockerfile` if necessary:\n\n```shell\nENV PROXY_ADDRESS=\"192.168.3.100\"\nENV PROXY_PORT=\"9090\"\nENV USERNAME=\"TorAPI\"\nENV PASSWORD=\"TorAPI\"\n```\n\nBuild the image and run the container:\n\n```shell\ndocker build -t torapi .\ndocker run -d --name TorAPI -p 8443:8443 --restart=unless-stopped torapi\n```\n\n## 📦 Install\n\nTo install the project and all dependencies, you can use the package manager [npm](https://www.npmjs.com/package/torapi):\n\n```shell\nnpm install -g torapi\n```\n\n## 🔨 Build\n\nClone the repository, install dependencies and start the server:\n\n```shell\ngit clone https://github.com/Lifailon/TorAPI\ncd TorAPI\nnpm install\nnpm start\n```\n\nBy default, the server will be launched on port `8443`.\n\nYou can specify a different port:\n\n```js\nnpm start -- --port 2024\n```\n\nFor development, use **nodemon** mode (restarts the server when the contents of files change):\n\n```\nnpm run dev\n```\n\n### Proxy\n\nUse a proxy for all requests:\n\n```js\nnpm start -- --port 2024 --proxyAddress 192.168.3.100 --proxyPort 9090\n```\n\nIf authorization on a proxy server is required:\n\n```js\nnpm start -- --port 2024 --proxyAddress 192.168.3.100 --proxyPort 9090 --username TorAPI --password TorAPI\n```\n\n### OpenAPI\n\n📚 Documentation is available in the **Swagger UI** at: `http://localhost:8443/docs` via module [swagger-ui-express](https://github.com/scottie1984/swagger-ui-express). The documentation is described through the [swagger-jsdoc](https://github.com/Surnet/swagger-jsdoc) library.\n\nTo create up-to-date or update Swagger documentation files in `JSON` and `YAML` format, use the command:\n\n```shell\nnpm run docs\n```\n\n## 🧪 Tests\n\nYou can run testing to quickly check the health of all endpoints in the console:\n\n```shell\nnpm start -- --test\n```\n\nDuring testing, the local server is started, a request is made to the endpoint `/api/provider/test`, the output is logged in JSON format and the server exits.\n\nChange header parameter in request:\n\n```shell\nnpm start -- --test --q \"The Rookie\"\n```\n\nParameterized tests are also available through [GitHub Actions](/.github/workflows/ci-postman-tests.yml) using [Postman](/postman-tests.json) via [newman](https://github.com/postmanlabs/newman) in `JUnit` format:\n\nTo run tests locally:\n\n```shell\nnpm install -g newman\n\nnewman run postman-tests.json \\\n --iteration-count 1 \\\n --env-var \"baseUrl=http://localhost:8443\" \\\n --env-var \"query=The Rookie\" \\\n --env-var \"queryAllPage=test\" \\\n --env-var \"categoryRuTracker=1605\" \\\n --env-var \"categoryKinozal=20\" \\\n --env-var \"categoryRuTor=10\" \\\n --env-var \"categoryNoNameClub=1318\"\n...\n┌─────────────────────────┬────────────────────┬───────────────────┐\n│ │ executed │ failed │\n├─────────────────────────┼────────────────────┼───────────────────┤\n│ iterations │ 1 │ 0 │\n├─────────────────────────┼────────────────────┼───────────────────┤\n│ requests │ 45 │ 0 │\n├─────────────────────────┼────────────────────┼───────────────────┤\n│ test-scripts │ 167 │ 0 │\n├─────────────────────────┼────────────────────┼───────────────────┤\n│ prerequest-scripts │ 154 │ 0 │\n├─────────────────────────┼────────────────────┼───────────────────┤\n│ assertions │ 169 │ 0 │\n├─────────────────────────┴────────────────────┴───────────────────┤\n│ total run duration: 32s │\n├──────────────────────────────────────────────────────────────────┤\n│ total data received: 1.95MB (approx) │\n├──────────────────────────────────────────────────────────────────┤\n│ average response time: 663ms [min: 2ms, max: 6.1s, s.d.: 1216ms] │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Other projects:\n\n- 🔎 [LibreKinopoisk](https://github.com/Lifailon/LibreKinopoisk) - Google Chrome extension that adds buttons to the Kinopoisk website and provides a **TorAPI** interface in the [Jackett](https://github.com/Jackett/Jackett) style (without the need to install a server part and use a VPN) for quickly searching for movies and series in open sources.\n\n- 🧲 [Kinozal bot](https://github.com/Lifailon/Kinozal-Bot) - Telegram bot that allows you to automate the process of delivering content to your TV using only your phone. Provides a convenient interface for interacting with the torrent tracker [Kinozal](https://kinozal.tv) and the database [TMDB](https://www.themoviedb.org) to track the release date of episodes, seasons and search for actors for each episode , as well as the ability to manage the torrent client [qBittorrent](https://github.com/qbittorrent/qBittorrent) or [Transmission](https://github.com/transmission/transmission) on your computer, being remote from home and from single interface.\n\n- ❤️ [WebTorrent Desktop api](https://github.com/Lifailon/webtorrent-desktop-api) - fork of the [WebTorrent Desktop](https://github.com/webtorrent/webtorrent-desktop) client, which added a remote control mechanism via the `REST API` based on [Express Framework](https://github.com/expressjs/express).\n\n- 📡 [Reverse Proxy .NET](https://github.com/Lifailon/rpnet) - cross-platform command-line utility for implementing a **.NET** based reverse proxy server. It is used to provide access to hosts on the network from one network interface to remote applications via **TCP**, **UDP** or **HTTP/HTTPS** protocols (`GET` and `POST` requests are supported to access external resources over the Internet) available via another network interface (e.g. via **VPN**) on your host without unnecessary configuration and with authorization support.","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":17,"_83":11,"_84":11},"read","write","admin","user","storage_size",2392827005,"orgData","recentTags",[91],{"_92":45,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_51":135,"_136":94,"_137":29,"_138":57,"_39":139,"_140":141,"_142":143,"_144":135,"_145":66,"_146":17},"content_type","creator",23112928,"digest","sha256:9b7fa74f0124acc2271539b400e6074d071450d53922a44a52f4024a2ea9edef","full_size",66564830,"id",673407519,"images",[103,119,125,131],{"_104":105,"_95":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":98,"_63":66,"_118":-5},"architecture","amd64","sha256:e5513d7c54024731d5070e6f0046ed5b77f57a2e569cc7893fa3d13a9de67076","features","","last_pulled","2026-09-15T21:19:00.72918624Z","last_pushed","2025-07-24T12:24:48.411966265Z","os","linux","os_features","os_version","size","variant",{"_104":120,"_95":121,"_107":108,"_109":122,"_111":123,"_113":114,"_115":108,"_116":-5,"_117":124,"_63":66,"_118":-5},"arm64","sha256:4b00280066be0ef99551205460dd317e3c4e71a222f5b6419de57ef89de53f11","2026-09-16T18:33:32.641607708Z","2025-07-24T12:24:47.558911858Z",66243203,{"_104":126,"_95":127,"_107":108,"_109":128,"_111":129,"_113":126,"_115":108,"_116":-5,"_117":130,"_63":66,"_118":-5},"unknown","sha256:c812855ad331bf4e4f8e62e23910b480786bbae1852422a879cacf55c7e2a680","2026-09-15T21:19:15.89110844Z","2025-07-24T12:24:49.210711622Z",1157,{"_104":126,"_95":132,"_107":108,"_109":133,"_111":134,"_113":126,"_115":108,"_116":-5,"_117":130,"_63":66,"_118":-5},"sha256:8f49c7d0236d34612ef535d679fe96c5e78bf04c1abe463b67a2a17beeffd798","2026-09-16T18:33:32.999731867Z","2025-07-24T12:24:49.74237102Z","2025-07-24T12:24:50.744053Z","last_updater","last_updater_username","media_type","latest","repository",24159798,"tag_last_pulled","2026-09-17T15:06:54.630159689Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":156,"_164":165,"_152":177,"_178":11},{"_36":157,"_43":159,"_46":47,"_48":49,"_50":11,"_51":52,"_53":54,"_55":160,"_39":31,"_28":29,"_58":59,"_60":45,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":29,"_73":161,"_79":11,"_80":163,"_85":29,"_86":87},[158],{"_39":40,"_41":42},[45],[57],{"_75":11,"_76":162},[78],{"_82":17,"_83":11,"_84":11},"tags",{"_166":64,"_167":-5,"_168":-5,"_169":170},"count","next","previous","results",[171],{"_92":45,"_93":94,"_95":96,"_97":98,"_99":100,"_101":172,"_51":135,"_136":94,"_137":29,"_138":57,"_39":139,"_140":141,"_142":143,"_144":135,"_145":66,"_146":17},[173,174,175,176],{"_104":105,"_95":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":98,"_63":66,"_118":-5},{"_104":120,"_95":121,"_107":108,"_109":122,"_111":123,"_113":114,"_115":108,"_116":-5,"_117":124,"_63":66,"_118":-5},{"_104":126,"_95":127,"_107":108,"_109":128,"_111":129,"_113":126,"_115":108,"_116":-5,"_117":130,"_63":66,"_118":-5},{"_104":126,"_95":132,"_107":108,"_109":133,"_111":134,"_113":126,"_115":108,"_116":-5,"_117":130,"_63":66,"_118":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
e5513d7c5402	linux/amd64	63.48 MB
4b00280066be	linux/arm64	63.17 MB

lifailon/torapi

Tags for lifailon/torapi