Skip to content
This repository was archived by the owner on May 25, 2026. It is now read-only.

mralanbourne/Yomi

Repository files navigation

Yomi Logo

YOMI: Your Forbidden Gateway

Version Stremio Addon Status Online License MIT VPS Ready P2P Supported

The definitive high-performance bridge between Sukebei and Stremio. Access the largest library of uncensored adult anime & Hentai via Real-Debrid, Torbox, or Direct P2P BitTorrent with advanced episode parsing, a strict 3-phase sorting engine, subtitle injection, and zero server-side tracking.
🍏 Fully Compatible with Stremio Web (Linux / iOS / iPadOS) & AIOStreams 🖤

🌐 Community Instance

yomi.ruka.pw

Install Button

Warning

⚠️ MUST READ: Addon Quirks & Limitations

Sukebei is the Wild West of anime releases. Yomi uses no backend database to store results, resolving everything on-the-fly. Keep these UI quirks in mind:

  1. 🖼️ 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.
  2. 🎭 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.
  3. 👻 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.
  4. 🎬 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 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% RD]).
  5. 🔍 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.
  • 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.

🌙 Quick Start

  1. Open the Community Instance.
  2. Enter your Real-Debrid and / or Torbox API Key, OR toggle the "Enable Simple P2P" option if you do not have a Debrid subscription.
  3. Select your Preferred Languages (e.g., GER, JPN, ENG) from the setup grid. Order matters!
  4. Choose your catalog preferences (Trending / Top Rated).
  5. Click "Install" or copy your manifest url to add your personalized configuration to Stremio.
  6. Use the global Stremio search. Results will appear under the "Yomi Search" catalog.

✨ Key Features & Next-Gen Engine Upgrades

  • 📡 Simple P2P & Tracker Injection: Don't have a Debrid service? Yomi can seamlessly hand over pure infoHash objects injected with high-availability trackers directly to Stremio's internal WebTorrent engine for blazing-fast peer discovery.
  • 🍏 Apple iOS & Flatpak Ready: Yomi 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.
  • 🔄 Automated Tracker Failover & Proxy: Sukebei trackers are often targeted by ISP blocks. Yomi now features an intelligent mirror-rotation engine (nyaa.si, iss.one, etc.) with optional Proxy tunneling to bypass aggressive Cloudflare challenges and DNS bans.
  • 🧠 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! Yomi's adaptive parser perfectly differentiates between single-file movies/OVAs and multi-episode series.
  • 📦 Bulletproof Batch Routing (Binge-Ready): Uploaders on Sukebei use zero naming conventions. Yomi intelligently recognizes international batch formats (like Spanish 01 a 12) and isolates exact individual files inside massive batch folders. Clicking "Next Episode" in Stremio seamlessly loads the correct file.
  • ⛩️ Aggressive Unicode Sanitization: Advanced reverse-digit extraction safely captures Japanese volume markers (第, 巻), single-character tags (E05), and strictly protects Hentai versioning tags (like v2 or v3 for decensored re-releases) or audio channels (5.1) from being misidentified as episode numbers.
  • 🛡️ Precision Subtitle Proxy: No more false positives! Yomi utilizes strict ISO boundaries to differentiate between European words (like "de" or "es") and actual release tags. External .ass, .srt, .vtt, and .ssa files are automatically scrubbed, proxied with bandwidth-leak protection, and injected into the Stremio player.
  • 🧠 Dual-Database Intelligence (AniList + MAL): Yomi scrapes AniList for high-quality metadata. If an obscure adult release is missing, it automatically falls back to MyAnimeList (Jikan API) to fetch official posters, synopsis, and true episode counts.

💻 Self-Hosting Instructions (VPS & Docker)

Hosting your own Gateway

Yomi is optimized for dedicated VPS hosting using Docker. It requires no persistent storage or database.

1. Deployment (Docker Compose)

The recommended way to host Yomi is via docker-compose. This ensures easy updates and log management.

services:
  yomi-scraper:
    image: ghcr.io/mralanbourne/yomi:latest
    container_name: stremio-yomi
    restart: unless-stopped
    environment:
      - NODE_ENV=production
      - PORT=7000
      - BASE_URL=[https://yomi.ruka.pw](https://yomi.ruka.pw)
      - ROOT_TORBOX_KEY=your_torbox_api_key
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

About

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

Topics

Resources

License

Stars

Watchers

Forks

Contributors