Skip to content

About

Unified Cyberpunk Torrent Meta-Search Engine & Live Streaming Client

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

3 Commits

Folders and files

Repository files navigation

🐒 TortuTorrent

Unified Torrent Meta-Search Engine & Live Web Streaming Client

License: MIT Node.js Express.js WebTorrent UI Style


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.


πŸ“‹ Table of Contents


⚑ Key Features

  • πŸ” 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.

πŸ—οΈ Architecture & Engine Overview

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
Loading

πŸ”Œ Supported 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

πŸ’» Prerequisites

  • 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)

πŸš€ Installation & Quick Start

1. Clone the repository

git clone https://github.com/robinandreoni/TortuTorrent.git
cd TortuTorrent

2. Install dependencies

npm install

3. Start the application

On Windows (1-Click):

Double click start.bat (it checks dependencies, launches the server, and opens your browser automatically).

Or via Terminal (Windows, macOS, Linux):

npm start

For development with hot-reload:

npm run dev

4. Open in browser

Navigate to: http://localhost:3000


πŸ“– Usage Guide

  1. Search: Enter the title of what you are looking for in the main search bar.
  2. Language Filter:
    • Select ITA to prioritize Italian releases.
    • Select ALL for global international results.
  3. Category Filter: Filter by Tutti (All), Film (Movies), Serie TV, Musica, Giochi, or Software.
  4. 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 .torrent metadata file directly to your computer.

🌐 REST API Endpoints

TortuTorrent exposes a clean JSON API that can be consumed by external applications:

1. Search Torrents

GET /api/search?q={query}&lang={ita|all}&cat={category}

Parameters:

  • q (required): Search term.
  • lang (optional): Language mode (ita or all, 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"
    }
  ]
}

2. Stream Media

GET /api/stream?magnet={magnet_url}&fileIndex={index}

Streams the selected file using HTTP 206 Partial Content (supports standard browser video seeking).


πŸ“ Project Structure

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

πŸ“„ License

This project is licensed under the MIT License β€” see the LICENSE file for details.
Created by Robin Andreoni & Tortuga Italia.

About

Unified Cyberpunk Torrent Meta-Search Engine & Live Streaming Client

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages