TortuTorrent brings together 13+ public torrent search engines and community providers into a single, high-speed meta-search interface with in-browser sequential streaming (HTTP 206 Partial Content), smart title sanitization, and seeder-health ranking.
Note
DISCLAIMER & LEGAL NOTICE
TortuTorrent is an open-source indexing tool, search aggregator, and WebTorrent client. It does not host, upload, or own any torrent files or media content. It searches publicly available DHT nodes and indexers. Users are solely responsible for verifying the legal rights and copyright permissions of any media they access, stream, or download.
- Key Features
- Architecture & Engine Overview
- Supported Providers
- Prerequisites
- Installation & Quick Start
- Usage Guide
- REST API Endpoints
- Project Structure
- License
- π 13+ Engine Aggregator: Parallel querying across major international indexers and dedicated Italian community sources with smart deduplication.
βΆοΈ In-Browser Live Streaming: Powered by WebTorrent and Express HTTP 206 Partial Content streaming. Watch videos or listen to audio tracks sequentially while downloading without waiting for full completion.- π§ Smart Query Optimizer (
smartQuery.js): Automatically cleans noisy search inputs, removes resolution tags (1080p,x264,WEBRip), detects target categories, and executes multi-variant waterfall queries to prevent false "0 results". - π Health & Seeder Sorting: Real-time extraction of seeders, leechers, file size, and upload dates to surface the highest quality, most active torrents first.
- π Italian & International Modes: One-click toggle between Italian-focused indexing and global multi-language search.
- π¨ Cyberpunk Dark Interface: Responsive UI with ambient neon accents, instant magnet copy, detailed file inspector, and built-in HTML5 player modal.
flowchart TD
USER["User Web Browser"] <-->|REST API + HTTP 206 Stream| SERVER["Express.js Server (server.js)"]
subgraph ENGINE ["TortuTorrent Engine Core"]
SMART["SmartQuery Engine<br>(NLP & Tag Sanitizer)"]
AGGR["Aggregator Service<br>(Parallel Scrapers)"]
CLIENT["WebTorrent Client<br>(Sequential Streaming)"]
SESSION["Session & Cache Manager"]
end
SERVER <--> SMART
SMART <--> AGGR
SERVER <--> CLIENT
AGGR <--> SESSION
subgraph PROVIDERS ["External Public Indexers"]
P1["BitSearch"]
P2["1337x"]
P3["YTS"]
P4["EZTV"]
P5["The Pirate Bay"]
P6["Nyaa"]
P7["FitGirl"]
P8["CorsaroNero"]
P9["SolidTorrents"]
end
AGGR <-->|HTTP / Axios / Cheerio| PROVIDERS
| Provider | Focus / Category | Protocol |
|---|---|---|
| BitSearch | General / High Speed | REST / Web Scraper |
| 1337x | Movies, TV, Games, Apps | HTML Scraper |
| YTS | HD Movies (720p, 1080p, 4K) | Direct API |
| EZTV | TV Shows & Series | Direct API |
| The Pirate Bay (TPB) | General / Classic Index | Scraper |
| Nyaa | Anime & Asian Media | RSS / XML Feed |
| FitGirl Repacks | PC Games & Repacks | HTML Scraper |
| SolidTorrents | Clean DHT Index | REST API |
| CorsaroNero & Italian Providers | Italian Audio & Subtitles | HTML Scraper |
- Node.js: version 18.0.0 or higher (Download Node.js)
- npm: included with Node.js
- Any modern web browser (Chrome, Firefox, Brave, Edge, Safari)
git clone https://github.com/robinandreoni/TortuTorrent.git
cd TortuTorrentnpm installDouble click start.bat (it checks dependencies, launches the server, and opens your browser automatically).
npm startFor development with hot-reload:
npm run devNavigate to: http://localhost:3000
- Search: Enter the title of what you are looking for in the main search bar.
- Language Filter:
- Select ITA to prioritize Italian releases.
- Select ALL for global international results.
- Category Filter: Filter by Tutti (All), Film (Movies), Serie TV, Musica, Giochi, or Software.
- Action Buttons on Results:
βΆοΈ Stream: Opens the integrated video/audio player to play the file immediately.- π§² Magnet: Copies the magnet link to your clipboard.
- β¬οΈ Download: Downloads the
.torrentmetadata file directly to your computer.
TortuTorrent exposes a clean JSON API that can be consumed by external applications:
GET /api/search?q={query}&lang={ita|all}&cat={category}Parameters:
q(required): Search term.lang(optional): Language mode (itaorall, default:ita).cat(optional): Category filter (all,movies,series,music,games,software).
Response Example:
{
"total": 42,
"query": "Ubuntu Desktop",
"results": [
{
"title": "ubuntu-24.04-desktop-amd64.iso",
"size": "5.8 GB",
"seeders": 1250,
"leechers": 85,
"magnet": "magnet:?xt=urn:btih:...",
"provider": "bitsearch"
}
]
}GET /api/stream?magnet={magnet_url}&fileIndex={index}Streams the selected file using HTTP 206 Partial Content (supports standard browser video seeking).
TortuTorrent/
βββ config/
β βββ accounts.config.json # Optional provider credentials & cookies
β βββ providers.config.json # Provider endpoints and timeout settings
βββ data/
β βββ sessions.json # Active session storage
βββ downloads/ # Directory for completed downloads
βββ engine/
β βββ aggregator.js # Multi-provider concurrent execution
β βββ dhtResolver.js # DHT InfoHash to Magnet resolution
β βββ dohClient.js # DNS over HTTPS resolver
β βββ sessionManager.js # Cookie & authentication manager
β βββ smartQuery.js # Query sanitizer and NLP parser
β βββ torrentClient.js # WebTorrent client wrapper
βββ providers/ # Individual search provider adapters
β βββ bitsearch.js
β βββ corsaronero.js
β βββ eztv.js
β βββ fitgirl.js
β βββ nyaa.js
β βββ solidtorrents.js
β βββ tpb.js
β βββ yts.js
βββ public/ # Frontend client (HTML5 / Cyberpunk CSS / JS)
β βββ assets/
β βββ css/style.css
β βββ js/app.js
β βββ index.html
βββ stream_cache/ # Buffer storage for active streaming sessions
βββ server.js # Express server entry point
βββ start.bat # 1-click Windows launcher
βββ package.json
βββ README.md
This project is licensed under the MIT License β see the LICENSE file for details.
Created by Robin Andreoni & Tortuga Italia.