AnimeSub+ 🎌

Overview 🎬

AnimeSub+ is a fast, configurable anime stream and subtitle addon for Stremio and Nuvio.

It is designed to be used alongside your preferred catalog or metadata addon. AnimeSub+ does not add Home/Discover catalogs of its own; when you open an anime, series episode or compatible movie from another catalog, AnimeSub+ focuses on one job: finding, matching, ranking and returning the best available streams and subtitles.

AnimeSub+ combines multiple anime release sources, anime-aware metadata matching, debrid cache checks, optional P2P, aggregated subtitles and a persistent background index so repeat requests can be served quickly without waiting for every external indexer again.

Highlights ✨

• 🐱 Nyaa.si release discovery
• 🌸 AnimeTosho release discovery
• 💎 SeaDex curated anime releases
• 🐾 NekoBT anime-aware results and language metadata
• 🔎 Knaben additional torrent discovery
• 🧩 Optional server-side Zilean / DMM and Torznab / Prowlarr integration
• 🧠 IMDb / AniList / Kitsu / MAL metadata mapping
• 🔢 Season, local episode and absolute anime episode matching
• 📦 Individual episodes, ranges, batches and season packs
• ⚡ Cached debrid detection and ranking
• 🧲 Optional direct P2P / BitTorrent
• 💬 Aggregated subtitle providers
• 🎨 Fully customizable multi-line stream layout
• 🚀 Persistent background index + Valkey hot cache + stale-while-revalidate

How AnimeSub+ works 🌟

When Stremio or Nuvio requests streams for a supported title, AnimeSub+ resolves the content identity and builds an anime-aware search context.

It can work with IDs such as:

• IMDb (tt...)
• AniList
• Kitsu
• MyAnimeList / MAL

AnimeSub+ can combine:

• English titles
• Romaji titles
• Native titles
• Alternative titles and synonyms
• Season and episode numbers
• Absolute anime episode numbers

This is especially important for anime because torrent releases often use naming conventions that differ from the season/episode numbering shown by a catalog addon.

For example, a catalog may request a season episode while an anime release is named only with its absolute episode number. AnimeSub+ attempts to map both forms and reject contradictory releases.

⚡ Fast Persistent Index

AnimeSub+ uses a persistent release index instead of forcing every user request to wait for a complete live scrape.

The fast path is designed around:

• Persistent indexed torrent results
• Valkey hot cache
• Background indexing workers
• Stale-while-revalidate refreshes
• Single-flight protection for cold requests
• Neighbor episode prewarming
• Short-term debrid availability caching

When indexed data is fresh, AnimeSub+ can reuse it immediately. If data is stale, it can still return the existing result set while a background worker refreshes it.

This keeps slow or temporarily unavailable external indexers out of the critical playback path whenever possible.

🔎 Anime Release Sources

🐱 Nyaa.si

Nyaa is one of the primary anime torrent sources used by AnimeSub+.

Results may include:

• WEB / WEB-DL releases
• Blu-ray encodes
• Fansubs
• RAW releases
• Dual Audio
• Multi-Sub releases
• Individual episodes
• Batch torrents
• Complete seasons
• Anime movies and specials

AnimeSub+ reads torrent metadata such as title, infoHash, size, seeders and source when available.

🌸 AnimeTosho

AnimeTosho is queried as an additional anime release source and merged with the other indexers.

It is not merely a fallback after Nyaa. Results from available sources are combined and deduplicated by infoHash before final filtering and ranking.

💎 SeaDex

SeaDex provides curated anime release information. When available, AnimeSub+ can use its metadata and file-level information to improve release and batch matching.

🐾 NekoBT

NekoBT adds anime-focused torrent results and can provide structured metadata such as audio, subtitle and fansub languages.

This is useful for releases whose language cannot be inferred reliably from the torrent name alone.

🔎 Knaben

Knaben is used as an additional discovery source. Its results are merged with existing hashes instead of being shown as duplicate streams.

🧩 Optional server-side sources

AnimeSub+ can also be configured by the server operator to query:

• Zilean / DMM
• Torznab-compatible endpoints
• Prowlarr / Jackett-style Torznab sources

These are optional and are not required for normal use of the public addon.

🧠 Smart Anime Matching

Anime torrent names are inconsistent, so AnimeSub+ performs more than a basic title search.

Matching can take into account:

• IMDb / AniList / Kitsu / MAL identity
• English, Romaji and native titles
• Alternative titles and synonyms
• S01E05-style numbering
• Season 3 Episode 2-style numbering
• Absolute anime episodes such as - 39 or - 1143
• Episode ranges
• Season packs
• Batch torrents
• File-level episode selection where available

AnimeSub+ also attempts to reject obvious false positives, including unrelated titles that happen to contain a short anime abbreviation or the same episode number.

⚡ Debrid Streaming

AnimeSub+ supports multiple debrid providers and allows more than one provider in the same configuration.

Supported providers currently include:

• ⚡ TorBox
• 🔴 Real-Debrid
• 🟢 AllDebrid
• 🟣 Premiumize
• 🔗 Debrid-Link
• 📦 Debrider
• ⚡ EasyDebrid
• ☁️ Offcloud
• 📁 PikPak

AnimeSub+ checks candidate torrent hashes against the configured services and records whether a release is immediately available when the provider reports cache status.

Cached-only mode

Enable Hide uncached debrid if you only want releases reported as immediately available by the configured debrid providers.

This is useful for users who prefer instant playback and do not want uncached torrents mixed into the list.

🔀 Advanced Stream Ranking

AnimeSub+ supports a priority chain of up to five sorting criteria.

Available priorities are:

• ⚡ Availability — cached debrid → uncached debrid → P2P
• 🌍 Preferred language
• 🎞️ Resolution
• 👥 Seeders
• 💾 File size

The order is strict: Priority 1 is evaluated before Priority 2, and so on.

A recommended debrid-oriented setup is:

1. Availability
2. Preferred language
3. Resolution
4. Seeders
5. File size

The final stream limit is applied after discovery, matching, debrid availability checks and ranking, so the configured maximum is selected from the ranked result set rather than from the first torrents discovered.

🎌 Language Preferences

AnimeSub+ can prioritize common anime release languages:

• 🇪🇸 Spanish / Spain
• 💃🏽 Latin Spanish
• 🇬🇧 English
• 🇯🇵 Japanese
• 🌐 Multi-language

Where structured source metadata is available, AnimeSub+ can also use audio/subtitle language information instead of relying only on torrent-name parsing.

🎞️ Resolution Filtering

You can choose which video qualities AnimeSub+ is allowed to return.

Common options include:

• 4K / 2160p
• 1080p
• 720p
• 480p
• SD / Unknown

Unsupported or disabled resolutions are removed before the final stream list is returned.

🧲 Optional P2P / BitTorrent

AnimeSub+ can return direct torrent streams using the torrent infoHash when P2P is enabled.

A debrid account is therefore optional if you explicitly enable P2P.

⚠️ Privacy note: direct P2P exposes your IP address to the BitTorrent swarm. Keep P2P disabled if you only want debrid-based playback.

💬 Aggregated Subtitles

AnimeSub+ also exposes the Stremio subtitles resource and can aggregate subtitles from multiple subtitle addons.

Supported subtitle sources include:

• OpenSubtitles v3
• OpenSubtitles V3+
• SubDL
• SubSource
• SubHero
• AIO Subtitle when a configured endpoint is available

Results are normalized, filtered by the selected subtitle languages and deduplicated before being returned to Stremio/Nuvio.

Subtitle language selection now mirrors AnimeSub+'s full 42-locale interface catalogue: Spanish, English, French, Portuguese (Brazil and Portugal), Italian, German, Arabic, Bulgarian, Catalan, Czech, Danish, Greek, Estonian, Persian, Finnish, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Japanese, Korean, Lithuanian, Latvian, Malay, Dutch, Norwegian, Polish, Romanian, Russian, Slovak, Slovenian, Serbian, Swedish, Thai, Turkish, Ukrainian, Vietnamese and Simplified/Hong Kong/Traditional Chinese. Legacy configurations using older three-letter subtitle codes are migrated automatically.

You can also set a maximum number of subtitle results.

🎨 Custom Multi-Line Stream Formatter

AnimeSub+ includes a configurable stream formatter inspired by the flexibility users expect from advanced stream aggregators.

Instead of a fixed stream label, you can build up to five visual lines:

• 1 primary line for the stream name
• 4 independent detail lines in the stream description

Each line can combine up to six fields selected from:

• Addon name
• Debrid / P2P provider
• Cache status
• Language
• Resolution
• Release title
• Seeders
• File size
• Source / indexer

You can also customize:

• Main-line separator
• Separator for each detail line
• Addon label
• Title prefix
• Provider icon
• Cached / uncached / P2P icons
• Seeder, size and source icons
• Language flags

The AnimeSub+ addon label is always preserved in the primary stream name so users can identify which addon returned the result.

👀 Live Preview

The configuration page includes a live preview that updates while you edit the formatter.

Example:

AnimeSub+ TB ⚡ 🇪🇸 1080p
Attack on Titan S03E02
👤 44 · 💾 1.42 GB
🌐 Nyaa

🧩 Built-in presets

AnimeSub+ currently includes multiple ready-made layouts, including:

• Peerflix style
• Detailed
• Minimal
• AIO Balanced
• AIO Compact
• AIO Classic
• AIO Rich
• Anime Focus
• Debrid First
• TV Clean
• Mobile Compact
• Technical

Presets can be used as a starting point and then customized field by field.

📡 Stream-Only by Design

AnimeSub+ does not provide Home/Discover catalogs or its own content search catalog.

This is intentional.

Use AnimeSub+ together with the catalog or metadata addon you already prefer. When a compatible title is opened, AnimeSub+ receives the content ID and contributes its streams and subtitles.

This keeps AnimeSub+ focused on anime release discovery and playback instead of duplicating catalog functionality.

Supported resource ID families include IMDb, AniList, Kitsu and MAL where compatible metadata is available.

🌍 Multilingual Configuration Interface

The /configure interface is available in:

• 🇬🇧 English
• 🇪🇸 Español
• 🇫🇷 Français
• 🇩🇪 Deutsch
• 🇮🇹 Italiano
• 🇵🇹 Português
• Català

New configurations open in English by default, while an existing personal configuration keeps its selected interface language. The configure interface exposes 42 BCP-47 locales with complete translated UI coverage, including right-to-left layout for Arabic, Persian and Hebrew.

🔐 Privacy & Security

Every user receives a short personal manifest URL similar to:

https://animesub.duckdns.org/u_xxxxxxxxxxxxxxxxxxxxxx/manifest.json

The URL contains an opaque random configuration identifier, not the user's debrid API keys.

Debrid credentials and configuration data are stored encrypted at rest on the AnimeSub+ server using Sodium / XChaCha20-Poly1305.

Stored credentials are never rendered back into the configuration page HTML. When editing an existing configuration, the credential field is left blank and the existing encrypted value is preserved unless the user supplies a replacement.

When debrid availability or a debrid stream must be resolved, the credential is transmitted over HTTPS to the configured StremThru/debrid service required for that operation.

Your personal manifest URL should still be treated as private because anyone who obtains it can use that configured addon instance.

🛠️ Installation

1. Open the configuration page

Open:

https://animesub.duckdns.org/

2. Configure playback

Add one or more supported debrid providers, or explicitly enable P2P.

3. Choose preferences

Configure:

• Preferred release languages
• Allowed resolutions
• Cached-only behavior
• Stream result limit
• Ranking priorities

4. Configure subtitles

Enable or disable subtitle aggregation, select subtitle providers and choose your subtitle languages.

5. Customize stream appearance

Choose a preset or create your own multi-line stream layout using the live preview.

6. Save and generate your manifest

AnimeSub+ creates a short private manifest URL.

7. Install in Stremio or Nuvio

Use the Stremio installation button or copy the manifest URL into a compatible addon client.

No AnimeSub+ catalog rows will be added. Open content from your existing catalogs and AnimeSub+ will contribute streams/subtitles when it supports the requested ID.

✅ Recommended Setup

For a clean debrid-first configuration:

• ⚡ TorBox, Real-Debrid or another supported debrid provider
• 🔒 Hide uncached debrid: Enabled
• 🧲 P2P: Disabled unless you explicitly want direct torrent playback
• 🎞️ Enable your preferred resolutions, such as 4K + 1080p
• 🌍 Select your preferred release languages

Recommended ranking:

1. Availability
2. Preferred language
3. Resolution
4. Seeders
5. File size

For the formatter, AIO Balanced, Anime Focus or TV Clean are good starting points depending on the client and screen size.

ℹ️ Important Notes

• AnimeSub+ does not host anime files.
• AnimeSub+ does not operate the external torrent/indexer or subtitle services it queries.
• Release availability depends on external sources and can change over time.
• Debrid cache status depends on the selected debrid provider.
• Torrent names and metadata originate from third-party uploaders and may occasionally be inaccurate.
• AnimeSub+ uses anime-aware matching to reduce false positives, but torrent naming conventions are not standardized.
• Optional P2P exposes the user's IP address to the torrent swarm.
• Users are responsible for using the addon and third-party services in accordance with applicable laws and service terms.

🎯 Why AnimeSub+?

AnimeSub+ is built for users who already have the catalogs they want and need a dedicated anime stream engine behind them.

It combines:

• 🐱 Multi-source anime torrent discovery
• 🧠 Anime-specific title and episode matching
• 🔢 Absolute episode awareness
• ⚡ Multi-debrid cache checking
• 🔀 Strict configurable ranking
• 🎌 Language-aware results
• 📦 Episode and batch handling
• 💬 Aggregated subtitles
• 🎨 Five-line customizable stream presentation
• 🚀 Persistent indexing, background workers and Valkey caching
• 🧲 Optional P2P
• 🔐 Encrypted private configuration

Choose your catalog. Open your anime. Let AnimeSub+ find the streams. 🎌🍿