https://github.com/mralanbourne/yomi

A stateless high-performance Stremio addon for Sukebei. Access adult content via Real-Debrid and Torbox with zero server-side tracking
https://github.com/mralanbourne/yomi

anime hentai nyaa nyaa-si real-debrid stateless stremio stremio-addon sukebei torbox

Last synced: 3 months ago
JSON representation

A stateless high-performance Stremio addon for Sukebei. Access adult content via Real-Debrid and Torbox with zero server-side tracking

• Host: GitHub
• URL: https://github.com/mralanbourne/yomi
• Owner: mralanbourne
• License: mit
• Created: 2026-03-24T14:02:34.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-03-26T12:32:43.000Z (3 months ago)
• Last Synced: 2026-03-26T17:37:57.599Z (3 months ago)
• Topics: anime, hentai, nyaa, nyaa-si, real-debrid, stateless, stremio, stremio-addon, sukebei, torbox
• Language: JavaScript
• Homepage: https://yomi.koyeb.app
• Size: 15.4 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  



YOMI: Your Forbidden Gateway




  

  

  

  

  





  The definitive high-performance bridge between Sukebei and Stremio. Access the largest library of uncensored adult anime via Real-Debrid or Torbox with advanced episode parsing, subtitle injection, and zero server-side tracking.





  
🌐 Community Instance

  yomi.koyeb.app

  


  


  

    

  






> [!WARNING]

> ### ⚠️ MUST READ: Addon Quirks & Limitations

> Sukebei and Nyaa are the Wild West of anime releases. I don't store cleaned up results in a massive backend database, so to use this addon effectively, you **need** to know these 6 quirks:

> 

> 1. 🧠 **Always check the filename:** Uploaders use zero naming conventions. Yomi features an aggressive multi-stage parsing engine to find the exact episode you clicked on (even inside batches like `01-12`). However, it might guess wrong. **Always look at the `📄 Title` or `🎯 File` description** in the stream list to ensure you are selecting the right file!

> 2. 🖼️ **The "Pink Posters" (Working as intended):** During a global search, obscure Sukebei results will appear as pink text-only posters to keep the search lightning fast. **This is not a bug!** The real MyAnimeList poster, description, and episode count are fetched in the background *the moment you click on the title*.

> 3. 🎭 **Mismatched Metadata:** Because the addon tries to match incredibly messy Sukebei titles against strict databases like AniList or MAL, it will sometimes guess wrong and display the wrong poster. **Don't panic!** The actual video streams are fetched directly from Sukebei based on the raw title, so the streams inside will still be correct.

> 4. 👻 **Inflated Episode Counts:** If metadata APIs don't know how many episodes a series has, Yomi scans the torrent titles to guess the highest episode number. If an uploader mislabeled a file (e.g., naming it Episode 12 instead of 02), Stremio might show 12 episode tiles. Just ignore the empty "ghost" episodes.

> 5. 🎬 **The "Loading" Video (Uncached Torrents):** If you click an uncached stream (`☁️ DL`), Stremio will start playing a looping "Waiting/Loading" video. **This is not an error!** It means Yomi sent the Torrent to your Debrid cloud. Wait a bit, back out of the episode screen, and click it again to refresh the live download progress (e.g., `[⏳ 45%]`).

> 6. 🔍 **Search Term Strictness:** Because we search the Sukebei RSS feed directly, your search queries need to be somewhat accurate. Stick to Romaji or English titles or phrases. Very short abbreviations (under 4 characters) or obscure Kanji searches might yield empty catalogs.

> [!IMPORTANT]

> ### 🔒 Privacy & Zero-Knowledge Security

> * Yomi is built on a **Stateless Architecture**. Unlike other addons, your sensitive data never touches a database.

> * **URL-Encoded Config:** Your Debrid keys are stored exclusively in your personal Manifest URL.

> * **Direct Resolution:** Stream links are resolved on-the-fly and redirected directly to your player.

> * **100% Open Source:** Your security is paramount. Verify the code yourself. Everything is public.

> * **Stateless Sync:** Because your keys are part of the URL, you only need to configure the addon **once**. Stremio will automatically sync **Yomi** to your Phone, Tablet, and TV.

### 🌙 Quick Start

1. Open the [Community Instance](https://yomi.koyeb.app) and enter your Real-Debrid and / or Torbox API Key.

2. Choose your catalog preferences (Trending / Top Rated).

3. Click "Install" to add your personalized configuration to Stremio.

4. Use the global Stremio search. Results will appear under the **"Yomi Search"** catalog.

### ✨ Key Features

* **🧠 Dual-Database Intelligence (AniList + MAL):** Yomi scrapes AniList for high-quality metadata. If an obscure release is missing, it automatically falls back to **MyAnimeList (Jikan API)** to fetch official posters, synopsis, and episode counts.

* **💬 Universal Subtitle Proxy:** Bypasses Stremio's CORS limitations! Yomi detects `.ass`, `.srt`, `.vtt`, and `.ssa` files inside torrents, proxies them through the server, and injects them directly into your Stremio player as selectable tracks.

* **🎯 Embedded MKV Priority:** The engine automatically prefers `.mkv` files over `.mp4` when resolving episodes, ensuring you have access to embedded dual-audio and subtitle tracks.

* **⚡ Hybrid Debrid Support:** Full, seamless integration for both Real-Debrid and Torbox.

* **📦 Stateless & Lightweight:** Designed for high performance with near-zero overhead. Uses intelligent RAM-caching and Promise-Deduping to survive heavy traffic without rate-limiting.

---

💻 Self-Hosting Instructions (Developers)

### Hosting your own Gateway

Yomi is optimized for PaaS environments like Koyeb. It requires no persistent storage or database.

#### 1. Prerequisites

* **Node.js:** v18 or higher.

#### 2. Deployment (Docker)

1. **Clone the Repo:**

```

git clone [https://github.com/mralanbourne/Yomi.git](https://github.com/mralanbourne/Yomi.git)

cd Yomi

```

Build and Run:

```

docker build -t yomi-addon .

docker run -p 7000:7000 -e BASE_URL="[https://your-domain.com](https://your-domain.com)" yomi-addon

```

Environment Variables:

    BASE_URL: REQUIRED. The public URL of your deployment (e.g., https://yomi.yourdomain.com)

  Yomi requires this to correctly construct the Subtitle-Proxy and Stream-Resolver links. If this is missing or incorrect, streams and subtitles will fail to load!

    PORT: Optional. Defaults to 7000.

#### 3. Customizing the "Waiting" Video

When users click on an uncached stream, Yomi routes the Stremio player to a fallback loading video while Debrid downloads the file.

The repository includes the default waiting.mp4 file located in the public/ directory. If you want to use your own custom loading screen, simply replace the waiting.mp4 file before building your Docker image.

☕ Support


I maintain this instance for the community. If you enjoy unrestricted access to the Sukebei District, consider supporting the development!














Made with 🖤 for the Underground Community.