🦑 Kraken

Hosted Stremio torrent addon that hits 50+ providers, scores the results, and hands the good stuff to your debrid service.

Official URLs

• Configure: https://kraken.backwoodsdevelopment.com/configure
• Manifest: https://kraken.backwoodsdevelopment.com/manifest.json
• Health: https://kraken.backwoodsdevelopment.com/health

Install

1. Open the Kraken config page.
2. Pick your debrid, providers, and quality filters.
3. Click install. That's it.

What It Does

• Searches 50+ torrent providers in parallel.
• Supports 8 debrid services: RD, AD, PM, DL, TB, OC, ED, and Put.io.
• Ranks streams with a real scoring model instead of blindly sorting by seeders.
• Supports binge-ready playback with bingeGroup for next-episode autoplay.
• Handles movies, series, and anime with IMDb and Kitsu IDs.

Supported Debrid Services

Service	Short code
RealDebrid	RD
AllDebrid	AD
Premiumize	PM
Debrid-Link	DL
TorBox	TB
Offcloud	OC
EasyDebrid	ED
Put.io	Put.io

Configuration

• Providers: Turn sources on or off. Keep the default stack if you just want good coverage fast.
• Quality filters: Cap the max resolution and block trash like CAM or TS before it ever hits Stremio.
• Debrid: Pick your service, paste your API key, and Kraken will favor cached results when it can.
• Prowlarr and Jackett: Optional. Only touch these if you already run your own indexer stack.

Self-Hosting

Kraken is already hosted for you at kraken.backwoodsdevelopment.com. If you want your own instance anyway, read DEPLOY.md.

Repo Layout

• kraken-addon/: Express app, manifest routes, stream logic, Docker assets, and the backend-served /configure page.
• configure.html: static config page copy for repo/docs publishing.
• DEPLOY.md: maintainer and self-hosting notes.

Tech Stack

• TypeScript
• Express
• Cheerio
• Bottleneck
• Redis (optional)

Contributing

Fork it, make a branch, and send a PR. Bug reports and small focused fixes are welcome. If you're changing provider behavior, include enough context to reproduce it.

License

MIT. See LICENSE.