⛩️ AMATSU: The Heavenly Gateway

The definitive high-performance bridge between Stremio and Nyaa.si. Access the world's largest library of high-quality Anime and Asian Live-Action with bulletproof episode parsing and zero server-side tracking. (Fully AIOStreams Compatible!)

🚀 Why Amatsu is built different:

• 🧠 Strict 3-Phase Sorter: No more scrolling through junk. Amatsu cascades streams strictly by: 1. Language Priority -> 2. Video Resolution (8K down to SD) -> 3. File Size.
• 📦 Bulletproof Batch Routing (Binge-Ready): Say goodbye to episode hijacking. The new multi-tier parser isolates individual files inside massive 100+ episode torrent batches. Clicking "Next Episode" now seamlessly loads the correct file!
• 💬 Precision Subtitle Proxy: Bypasses Stremio limits to extract .ass, .srt, and .vtt files from torrents and injects them directly into your player as selectable tracks.
• ⛩️ Asian Raw & Versioning Support: Safely captures Japanese volume markers and protects release tags (like v2 for decensored) from being misidentified.
• 🎬 Cinematic Segregation: Anime movies are strictly separated from TV series, keeping your Stremio search rows native and uncluttered.
• ⚡ Debrid Powered: Full Real-Debrid & Torbox integration.

⚠️ MUST READ: Quick Tips & Quirks

Because Amatsu scrapes raw, unmoderated P2P trackers directly, keep these visual quirks in mind:

1. 🎬 The "Waiting" Video: Clicked an uncached stream (☁️ DL)? Stremio will play a short "Waiting" video. This is NOT an error! It means the torrent is being successfully sent to your Debrid cloud.
2. ⏳ Refresh Progress: To see the live download percentage directly in Stremio (e.g., [⏳ 45%]), you MUST back out of the episode and click it again to refresh the list.
3. 🖼️ Blue Posters & Mismatched Metadata: Obscure global search results appear as blue text-only posters to keep searching lightning fast. If Amatsu guesses the wrong AniList poster, don't panic! The actual video streams are fetched via the raw title, so the streams inside will still be exactly what you searched for.
4. 👻 Ghost Episodes: If metadata APIs don't know how many episodes a series has, Amatsu guesses based on torrent names. If an uploader mislabeled a file (e.g., Episode 12 instead of 02), Stremio might generate 12 episode tiles. Just ignore the empty "ghost" episodes!
5. 🎯 Verify Titles: Nyaa uploaders can be chaotic. Always check the 🎯 File description to ensure you got the right episode.

🛠️ The Technical Backbone

• Stateless & Open Source: Zero server-side tracking, zero databases. Your API keys stay encrypted in your URL.
• Hybrid Meta: Prioritizes AniList with a Jikan (MyAnimeList) fallback.

🔗 Help, Bug Reports & Source Code: https://github.com/mralanbourne/Amatsu