Docs / Quickstart

Quickstart

From signup to a playable stream in five minutes.

1. Sign up

Head to toru.ravengrid.cc/signup, confirm your email, and you'll land on the dashboard. A tu_<prefix>_<secret> API key auto-mints on your first visit to /dashboard/api-keys.

2. Connect a debrid backend (optional)

Toru works without one — the shared cold-start cascade (Premiumize → Torrin → TorBox → Real-Debrid → AllDebrid) handles requests for users without integrations. Connect your own at /dashboard/integrations to use your own quota first.

3. Add content

From /dashboard/jobs, paste a magnet URI or a hoster URL. Toru routes the submission through the cascade; the row appears within a second (Realtime push) and flips to ready once the upstream finishes.

curl -X POST https://api.toru.ravengrid.cc/v1/torrents \
  -H "Authorization: Bearer tu_…" \
  -H "Content-Type: application/json" \
  -d '{"magnet": "magnet:?xt=urn:btih:..."}'

4. Stream it

Click Play on any ready file (the dashboard mints a fresh signed URL on each click) or fetch it programmatically:

curl -H "Authorization: Bearer tu_…" \
  https://api.toru.ravengrid.cc/v1/torrents/{job}/files/{file}/stream
# {"url": "https://...", "expires_in_seconds": 900, "source": "external", ...}

5. Plug it into your stack

The /dashboard/connect page surfaces every URL you need, templated with your live key:

• Stremio: stremio://addon.toru.ravengrid.cc/<key>/manifest.json
• RSS: https://api.toru.ravengrid.cc/v1/feed.rss?token=<key> (Sonarr/Radarr-friendly)
• WebDAV: server https://dav.toru.ravengrid.cc, user me, password <key>

6. Auto-grab from RSS

/dashboard/rss takes any RSS feed (1337x, Nyaa, custom Sonarr trackers) and submits new items every poll_interval_seconds through the same cascade. Filter by regex + quality.

Stuck? File an issue.