AnimeSub+ 🎌

Overview 🎬

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

It is designed to work alongside your preferred catalog or metadata addon. AnimeSub+ does not add Home/Discover catalogs of its own. When you open a compatible anime, episode or anime movie from another catalog, AnimeSub+ focuses on discovering, matching, ranking and returning playable streams and subtitles.

AnimeSub+ combines:

🐱 Multiple anime torrent/index sources
⚡ Multi-debrid playback and cache detection
📰 USENET / Easynews playback from AnimeTosho NZBs
🧲 Optional direct P2P / BitTorrent
🧠 Anime-aware metadata and episode matching
🎧 Independent audio-language priority
💬 Independent release-subtitle priority
🎞️ Ordered quality priority from 8K down to SD
💬 Aggregated subtitle addons with 52 locale choices
🎨 A customizable 9-line stream formatter
🚀 Persistent indexing, background workers, Valkey hot cache and stale-while-revalidate

🔎 Release Discovery Sources

AnimeSub+ combines and deduplicates results from multiple sources by torrent infoHash.

🐱 Nyaa.si

Primary anime torrent discovery for individual episodes, WEB/WEB-DL releases, Blu-ray encodes, fansubs, RAW releases, Dual Audio/Multi-Sub releases, batches, complete seasons, movies and specials.

🌸 AnimeTosho

AnimeTosho is a first-class source and is also the source of NZB metadata used for Easynews/USENET playback.

AnimeSub+ supports both .nzb and .nzb.gz AnimeTosho descriptors.

When AnimeTosho provides a compressed .nzb.gz, AnimeSub+ normalizes only the small NZB descriptor. Media data is still downloaded directly from the configured USENET server.

🌅 Erai-raws

Anime-oriented release discovery used by the full background indexing process.

💎 SeaDex

Curated anime release metadata that can improve matching for known releases, encodes and batches.

🐾 NekoBT

Anime-focused torrent discovery with structured metadata such as audio, subtitle and fansub languages.

🌍 AniRena

Anime torrent discovery with title/episode filtering and magnet resolution. It is primarily processed by background workers to avoid slowing the initial Stremio request.

🔎 Knaben

Additional torrent discovery. Duplicate hashes are merged with releases found by the other sources.

⚡ TorBox Search

When available, AnimeSub+ can use TorBox's own search/index data. This can find cached hashes that may no longer be easy to discover through current tracker searches.

☄️ Comet

Optional discovery using Comet's Stremio stream endpoint.

AnimeSub+ imports release/hash information only and does not forward the user's debrid credentials to Comet.

🔁 StremThru Torz

Optional discovery through StremThru Torz. Results are merged with the native providers and user debrid credentials are not forwarded for discovery.

The server operator can globally disable any discovery source. Disabled sources disappear from /configure and are skipped by the workers.

🧠 Anime-Only Identity Gate

AnimeSub+ is anime-focused by design.

For generic IMDb movie/series requests, AnimeSub+ verifies that the requested title actually maps to anime metadata using AniList/Kitsu before torrent or subtitle discovery begins.

If an anime identity cannot be established, AnimeSub+ returns no results rather than querying torrent indexes for an unrelated live-action title.

Direct AniList, Kitsu and MAL IDs are already anime-scoped.

🧠 Smart Anime Matching

Anime release names use many different numbering systems.

AnimeSub+ can use:

IMDb IDs
AniList IDs
Kitsu IDs
MAL IDs
English titles
Romaji titles
Native titles
Alternative titles and synonyms
Release year/type
S01E05
Season 3 Episode 2
Absolute anime episode numbering
Episode ranges
Batches
Season packs
File-level episode selection

AnimeSub+ also attempts to reject contradictory episode ranges, remake/year collisions, non-video releases and unrelated titles.

🚀 Fast Persistent Index

AnimeSub+ uses a persistent release index instead of making every Stremio request wait for a complete live scrape.

The fast path includes:

Persistent indexed torrent results
Valkey hot cache
Background index workers
Stale-while-revalidate
Single-flight cold-request protection
Neighbor-episode prewarming
Debrid availability caching
Progressive index publication

For cold content, AnimeSub+ performs a bounded first-pass search and lets the background worker continue gathering slower sources.

When Easynews is configured, AnimeTosho becomes a first-pass dependency because Easynews requires AnimeTosho's NZB metadata.

If an existing partial index has a torrent hash but no NZB, AnimeSub+ can run a targeted AnimeTosho completion pass and merge the NZB into the existing hash.

⚡ Multi-Debrid Streaming

Supported services:

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

More than one debrid provider can be configured simultaneously.

AnimeSub+ checks candidate hashes against the configured services before final stream ranking.

Hide uncached debrid

Enable Hide uncached debrid to return only releases reported as immediately available by the configured debrid providers.

Cached releases bypass the minimum-seeders restriction because playback no longer depends on the live torrent swarm.

📰 USENET / Easynews

AnimeSub+ supports native USENET playback using Easynews.

The playback flow is:

AnimeTosho → NZB → AnimeSub+ validation → Stremio NZB stream → Easynews NNTP

Users configure:

Easynews username
Easynews password
Maximum NNTP connections

AnimeSub+ uses Easynews through encrypted NNTP/TLS on:

news.easynews.com:563

Important behavior:

Easynews is currently a playback provider, not a separate Easynews search engine.
AnimeTosho provides the NZB.
.nzb is supported directly.
.nzb.gz is safely normalized to a normal NZB descriptor.
Only the small NZB descriptor may pass through AnimeSub+ when normalization is necessary.
Video/article data does not pass through AnimeSub+'s web server.
Media data is fetched directly from Easynews by the compatible client.
Batch NZBs use episode-aware file selection.
Easynews credentials are encrypted at rest.
Credentials are not exposed in the public manifest URL.
Credentials are stripped from shared stream cache templates.
AnimeSub+ reserves up to 3 visible Easynews streams by default so debrid duplicates cannot completely remove USENET from the final list.
The private /<TOKEN>/debug/easynews.json endpoint can validate Easynews TLS/authentication without downloading an article.

⚠️ Easynews playback requires a Stremio client implementing native NZB/NNTP stream support.

🧲 Optional P2P

Direct BitTorrent playback can be enabled explicitly.

This allows AnimeSub+ to return torrent infoHash streams without requiring a debrid or Easynews account.

⚠️ Direct P2P exposes the user's IP address to the torrent swarm.

🔀 Advanced Stream Ranking

AnimeSub+ provides a strict priority chain of up to five criteria.

Available criteria:

⚡ Availability
🎞️ Quality
🎧 Audio language
💬 Release subtitles
👥 Seeders
💾 File size

Availability order is:

Easynews/USENET → cached debrid → uncached debrid → P2P

Priority 1 is evaluated before Priority 2, and so on.

Quality-first example

Quality
Availability
Audio
Release subtitles
Seeders

With this configuration, a 4K result can stay before a cached 1080p result.

Instant-playback example

Availability
Quality
Audio
Release subtitles
Seeders

The final stream limit is applied only after discovery, matching, availability checking and ranking.

Available limits:

20
40
60
100
120 streams

🎧 Audio Priority

Audio language has its own ordered priority.

Available anime release language families include:

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

💬 Release-Subtitle Priority

Release/embedded subtitle language has an independent ordered priority.

For example:

Audio

Japanese
Spanish
English

Release subtitles

Spanish
English
Japanese

AnimeSub+ uses structured source metadata where available and distinguishes explicit audio/subtitle evidence from weaker release-name hints.

🎞️ Ordered Quality Priority

Quality is both an allow-list and an ordered preference.

Available options:

8K
4K / 2160p
2K / 1440p
1080p
720p
480p
SD / Unknown

If Quality is Priority 1 and 4K is positioned before 1080p, 4K ranks first.

👥 Minimum Seeders

Available minimum thresholds:

The minimum applies to P2P and uncached debrid releases.

Cached debrid releases bypass it.

💬 Aggregated Subtitles

AnimeSub+ exposes the Stremio subtitles resource.

Supported subtitle providers:

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

Results are:

Normalized
Filtered by selected locale
Deduplicated
Sorted by language priority
Limited to the configured maximum

AnimeSub+ currently exposes 52 BCP-47 locale choices, including regional Spanish, English, French and Portuguese variants, Japanese, Korean, Arabic, Hebrew, Persian, Tamil, Telugu and Simplified/Hong Kong/Traditional Chinese.

Maximum subtitle results:

🎨 Custom 9-Line Stream Formatter

AnimeSub+ can display up to 9 visual lines:

1 main Stremio stream-name line
Up to 8 independent detail lines

Available fields include:

Addon
Provider
Cache status
Audio
Release subtitles
Resolution
Release title
Seeders
File size
Source/indexer

Each visual line supports up to seven fields.

You can customize:

Field order
Number of lines
Separators
Addon label
Title prefix
Provider icon
Cached/uncached/P2P icons
Seeder icon
Size icon
Source icon
Language flags

The primary line always retains the AnimeSub+ identity.

Built-in presets

AIO Balanced
AIO Compact
AIO Classic
AIO Rich
Anime Focus
Debrid First
TV Clean
Mobile Compact
Technical

A live preview shows the resulting stream layout while editing.

📡 Stream-Only by Design

AnimeSub+ does not provide its own Home/Discover catalogs.

Use your preferred catalog addon and let AnimeSub+ supply streams/subtitles when compatible anime content is opened.

Supported ID families include:

IMDb
AniList
Kitsu
MAL

🌍 Multilingual Configuration

The interface currently exposes 52 BCP-47 locales, including regional variants.

Right-to-left layouts are supported for:

Arabic
Persian
Hebrew

Existing personal configurations preserve their selected language.

🔐 Privacy & Security

Each saved configuration receives a private manifest URL such as:

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

The URL contains a random configuration identifier rather than plaintext credentials.

Sensitive configuration is encrypted at rest using:

Sodium / XChaCha20-Poly1305

Stored secrets are not rendered back into /configure.

When editing:

Credential fields remain blank.
Existing encrypted credentials are retained unless replacements are entered.

Easynews credentials are inserted only into the user's private NZB stream response and are removed from shared cache templates.

Debrid credentials are not forwarded to discovery-only Comet/StremThru Torz integrations.

Keep your private manifest URL secret.

🛠️ Installation

Open AnimeSub+.
Choose one or more playback methods: debrid, Easynews or optional P2P.
Select discovery providers.
Configure quality priorities.
Configure audio priorities.
Configure release-subtitle priorities.
Configure ranking and minimum seeders.
Configure aggregated subtitles.
Customize stream appearance.
Save the configuration.
Install the generated private manifest in Stremio or another compatible client.

AnimeSub+ does not add catalog rows. Open content using your existing metadata/catalog addons.

✅ Recommended Setups

Debrid-first

TorBox, Real-Debrid or another supported provider
Hide uncached debrid: Enabled
P2P: Disabled
Ranking: Availability → Quality → Audio → Release subtitles → Seeders

Quality-first

Put 4K / 2160p before 1080p
Ranking: Quality → Availability → Audio → Release subtitles → Seeders

Easynews / USENET

AnimeTosho enabled
Easynews username/password configured
Appropriate NNTP connection count
Optional debrid/P2P fallback
Compatible Stremio client with native NZB support

⭐ Support AnimeSub+

If AnimeSub+ is useful to you, please leave a star on the AnimeSub+ page at stremio-addons.net.

It only takes a few seconds and helps other Stremio users discover the project.

⭐ Star AnimeSub+ on Stremio Addons

Stars are voluntary and are never required to configure, install or use AnimeSub+.

ℹ️ Important Notes

AnimeSub+ does not host anime video files.
AnimeSub+ does not operate the third-party torrent, USENET, debrid or subtitle providers it uses.
External availability can change.
Torrent/release metadata can occasionally be inaccurate.
Easynews playback requires native NZB support in the client.
P2P exposes the user's IP address to the BitTorrent swarm.
Users are responsible for complying with applicable laws and third-party service terms.

🎯 Why AnimeSub+?