The definitive high-performance bridge between Nyaa.si and Stremio. Access the world's largest library of high-quality Anime and Live Action Content via Real-Debrid, Torbox, or Direct P2P BitTorrent with bulletproof episode parsing, a strict 3-phase sorting engine, multi-language subtitle injection, and zero server-side tracking.
🍏 Fully Compatible with Stremio Web (Linux / iOS / iPadOS) & AIOStreams 💙
Warning
Nyaa is the gold standard for Asian releases, but naming conventions vary wildly. Amatsu uses no backend database to store results, resolving everything on-the-fly. Keep these UI quirks in mind:
- 🖼️ The "Blue Posters" (Working as intended): During a global search, obscure Nyaa results will appear as blue text-only posters to keep the search lightning fast. This is not a bug! The real Posters, description, and episode count are fetched dynamically the moment you click on the title.
- 🎭 Mismatched Metadata: Because the addon matches messy P2P titles against strict databases like AniList, it will sometimes guess wrong and display the wrong poster in the catalog. Don't panic! The actual video streams are fetched directly from Nyaa based on the raw title, so the video content remains correct.
- 👻 Dynamic Episode Discovery: If metadata APIs don't know how many episodes a series has (common for OVAs or new releases), Amatsu scrapes Nyaa titles to detect the actual episode count dynamically.
- 🎬 The "Loading" Video (Uncached Torrents): If you click an uncached stream (
☁️ Download), Stremio will start playing a looping "Waiting/Loading" video. This is not an error! It means Amatsu sent the torrent to your Debrid cloud. Wait a bit, back out, and click again to see the live progress (e.g.,[⏳ 45% RD]) or Check your Debrid Dashboard.
Important
- Amatsu is built on a Stateless Architecture. Unlike other addons, your sensitive data never touches a database.
- Base64 Config: Your Debrid keys and Language preferences are stored exclusively in your personal Manifest URL using secure Base64 encoding.
- Direct Resolution: Stream links are resolved on-the-fly and redirected directly to your player.
- P2P Warning: If you enable the "Simple P2P" feature, you bypass Debrid services and stream via standard BitTorrent. Your IP address will be visible to the swarm. A VPN is highly recommended!
- 100% Open Source: Your security is paramount. Verify the code yourself. Everything is public.
- Open the Community Instance.
- Enter your Real-Debrid and / or Torbox API Key, OR toggle the "Enable Simple P2P" option if you do not have a Debrid subscription.
- Select your Preferred Languages (e.g., GER, JPN, ENG) from the setup grid. Order matters!
- Choose your catalog preferences (Trending / Top Rated).
- Click "Install" or copy your manifest url to add your personalized configuration to Stremio.
- Use the global Stremio search. Results will natively appear under the Amatsu Search catalogs.
- 📡 Simple P2P & Tracker Injection: Don't have a Debrid service? Amatsu can seamlessly hand over pure
infoHashobjects injected with high-availability Nyaa trackers directly to Stremio's internal WebTorrent engine for blazing-fast peer discovery. - 🍏 Apple iOS & Flatpak Ready: Amatsu features a heavily hardened CORS and Preflight (
OPTIONS) architecture, guaranteeing seamless stream and subtitle loading on strict WebKit browsers (iPhone/iPad Safari) and Linux sandboxes. - 🧠 3-Phase Multi-Pass Sorter: The stream sorting engine guarantees absolute precision. Streams are strictly cascaded by:
1. Language Priority & Cache Status ➔ 2. Video Resolution (8K down to SD) ➔ 3. File Size. - 🚀 Smart Movie & OVA Bypass: No more false-negative drops! Amatsu's adaptive parser perfectly differentiates between single-file movies and multi-episode series, ensuring that release years (2019), versions (v2), or audio channels (5.1) are never mistaken for episode numbers.
- 📦 Bulletproof Batch Routing: Say goodbye to episode hijacking. Amatsu intelligently recognizes international batch formats (like Spanish
01 a 12or01 to 12) and isolates exact individual files inside massive 100+ episode torrent chunks. - ⛩️ Aggressive Unicode Sanitization: Advanced reverse-digit extraction safely captures Japanese volume markers (第, 巻), single-character tags (E05), and effortlessly matches heavily punctuated titles by normalizing all special characters.
- 🛡️ Precision Subtitle Proxy: External
.ass,.srt,.vtt, and.ssafiles are automatically scrubbed, proxied with bandwidth-leak protection, and injected into the Stremio player as selectable tracks. - ⚡ Debrid API Protection: Built-in Promise deduplication and LRU caching protect your Real-Debrid and Torbox accounts from rate limits during heavy binge-watching sessions.
💻 Self-Hosting Instructions (VPS & Docker)
Amatsu is optimized for dedicated VPS hosting using Docker. It requires no persistent storage or database.
The recommended way to host Amatsu is via docker-compose. This ensures easy updates via Watchtower.
services:
amatsu-scraper:
image: ghcr.io/mralanbourne/amatsu:latest
container_name: stremio-amatsu
restart: unless-stopped
environment:
- NODE_ENV=production
- PORT=7002
- BASE_URL=[https://amatsu.ruka.pw](https://amatsu.ruka.pw)
- ROOT_TORBOX_KEY=your_torbox_api_key
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"BASE_URL: REQUIRED. The public URL of your deployment (e.g. https://amatsu.ruka.pw).
ROOT_TORBOX_KEY: Optional. Master Torbox API Key utilized for backend cache approximations cause RD is restrictive with their API.
PORT: Optional. Defaults to 7002.
NYAA_DOMAIN: Optional. Specify a custom Nyaa mirror.
PROXY_URL: Optional. Pass traffic through a secure proxy to bypass aggressive ISP blocks.
Amatsu supports automated updates via Watchtower. Simply push to your repository, and your VPS will automatically pull the latest image from GHCR.