README.md

---
title: Torrent2Space
emoji: 🌊
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
---

# Torrent2Space 🌊

A **Seedr-style** torrent client that runs entirely on HuggingFace Space disk — no Google Drive, no external storage.

## How it works

1. Paste a **magnet link** or upload a **.torrent file**
2. Select which files you want
3. Hit **Start Download** — the torrent downloads to the Space's local disk
4. When done, **download** the files directly to your computer from "My Files"

## API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| `POST` | `/api/load_magnet` | Load a magnet link |
| `POST` | `/api/load_torrent` | Load a .torrent file (base64) |
| `POST` | `/api/start` | Start downloading selected files |
| `POST` | `/api/pause` | Pause the torrent |
| `POST` | `/api/resume` | Resume the torrent |
| `POST` | `/api/stop` | Stop and clear |
| `GET` | `/api/status` | Get download status & progress |
| `GET` | `/api/files` | List all downloaded files |
| `GET` | `/api/download/{path}` | Download a file |
| `DELETE` | `/api/files/{path}` | Delete a specific file |
| `DELETE` | `/api/files` | Delete all files |

## Notes

- Files are stored on the Space disk for the duration of your session
- Sessions are cleaned up after 6 hours of inactivity
- No Google account needed