@@ -36,22 +35,24 @@ ## ✨ What is AIOStreams? -AIOStreams was created to give users ultimate control over their Stremio experience. Instead of juggling multiple addons with different configurations and limitations, AIOStreams acts as a central hub. It fetches results from all your favorite sources, then filters, sorts, and formats them according to *your* rules before presenting them in a single, clean list. +AIOStreams was created to give users ultimate control over their Stremio experience. Instead of juggling multiple addons with different configurations and limitations, AIOStreams acts as a central hub. It fetches results from all your favorite sources, then filters, sorts, and formats them according to _your_ rules before presenting them in a single, clean list. Whether you're a casual user who wants a simple, unified stream list or a power user who wants to fine-tune every aspect of your results, AIOStreams has you covered. +AIOStreams also includes a powerful suite of [built-in addons](#-built-in-addons) that can search various torrents and usenet indexers. With support for [nzbDAV](https://github.com/nzbdav-dev/nzbdav) and [AltMount](https://github.com/javi11/altmount), you can stream usenet results directly from your Usenet provider via NNTP - no debrid service required.
-
+
@@ -59,14 +60,16 @@ Whether you're a casual user who wants a simple, unified stream list or a power
### 🧩 Built-in Addons + Think of "built-in addons" as independent addons bundled exclusively with AIOStreams. When you host AIOStreams, you're also hosting these addons, ready to be added to your configuration just like any other community addon (e.g., Comet, Torrentio). -AIOStreams includes over 10 built-in addons that search various sources and deliver results that can usually be streamed through your debrid service. +AIOStreams includes over 10 built-in addons that search various sources and deliver results to be streamed by you. > [!NOTE] -> At this time, these addons require a debrid service and do not yet support P2P streaming. All built-in addons come with anime support and support Kitsu/MAL catalogs. +> Built-in addons that search for torrents require a debrid service and do not yet support P2P streaming. Usenet results can be streamed directly from your Usenet provider via [NZBDav](https://github.com/nzbdav-dev/nzbdav) or [AltMount](https://github.com/javi11/altmount), or through TorBox (Pro plan required). All built-in addons come with anime support and support Kitsu/MAL catalogs. The suite of built-in addons includes: + - **Stremio GDrive**: Connect your Google Drive to Stremio. - **TorBox Search**: An alternative to the official TorBox addon with more customisability and support for more debrid services. - **Knaben**: Scrapes Knaben, an indexer proxy for several popular torrent sites including The Pirate Bay, 1337x, and Nyaa.si. @@ -76,30 +79,33 @@ The suite of built-in addons includes: - **Bitmagnet**: Scrape your self-hosted Bitmagnet instance - a BitTorrent indexer and DHT crawler. Set `BUILTIN_BITMAGNET_URL` for the addon to appear. - **Jackett**: Connect and scrape your Jackett instance by providing its URL and API key. - **Prowlarr**: Connect and scrape your Prowlarr instance by providing its URL and API key. -- **NZBHydra**: Stream results from your Usenet indexers with TorBox by connecting your NZBHydra instance. -- **Newznab**: Directly configure and scrape your Usenet indexers for results with TorBox using a Newznab API. +- **NZBHydra**: Stream results from your Usenet indexers by connecting your NZBHydra instance. +- **Newznab**: Directly configure and scrape your Usenet indexers for results using a Newznab API. - **Torznab**: Configure any Torznab API to scrape torrent results, allowing individual indexers from Jackett to be added separately. ### 🔬 Advanced Filtering & Sorting Engine + Because all addons are routed through AIOStreams, you only have to **configure your filters and sorting rules once**. This powerful, centralized engine offers far more options and flexibility than any individual addon. - **Granular Filtering**: Define `include` (prevents filtering), `required`, or `excluded` rules for a huge range of properties: - - **Video/Audio**: Resolution, quality, encodes, visual tags (`HDR`, `DV`), audio tags (`Atmos`), and channels. - - **Source**: Stream type (`Debrid`, `Usenet`, `P2P`), language, seeder ranges, and cached/uncached status (can be applied to specific addons/services). + - **Video/Audio**: Resolution, quality, encodes, visual tags (`HDR`, `DV`), audio tags (`Atmos`), and channels. + - **Source**: Stream type (`Debrid`, `Usenet`, `P2P`), language, seeder ranges, and cached/uncached status (can be applied to specific addons/services). - **Preferred Lists**: Manually define and order a list of preferred properties to prioritize certain results, for example, always showing `HDR` streams first. - **Keyword & Regex Filtering**: Filter by simple keywords or complex regex patterns matched against filenames, indexers and release groups for ultimate precision. - **Accurate Title Matching**: Leverages the TMDB API to precisely match titles, years, and season/episode numbers, ensuring you always get the right content. This can be granularly applied to specific addons or content types. - **Powerful Conditional Engine**: Create dynamic rules with a simple yet powerful expression language. - - *Example*: Only exclude 720p streams if more than five 1080p streams are available: `count(resolution(streams, '1080p')) > 5 ? resolution(streams, '720p') : false`. - - Check the wiki for a [full function reference](https://github.com/Viren070/AIOStreams/wiki/Stream-Expression-Language). + - _Example_: Only exclude 720p streams if more than five 1080p streams are available: `count(resolution(streams, '1080p')) > 5 ? resolution(streams, '720p') : false`. + - Check the wiki for a [full function reference](https://github.com/Viren070/AIOStreams/wiki/Stream-Expression-Language). - **Customisable Deduplication**: Choose how duplicate streams are detected: by filename, infohash, and a unique "smart detect" hash generated from certain file attributes. - **Sophisticated Sorting**: - - Build your perfect sort order using any combination of criteria. - - Define separate sorting logic for movies, series, anime, and even for cached vs. uncached results. - - The sorting system automatically uses the rankings from your "Preferred Lists". + - Build your perfect sort order using any combination of criteria. + - Define separate sorting logic for movies, series, anime, and even for cached vs. uncached results. + - The sorting system automatically uses the rankings from your "Preferred Lists". ### 🗂️ Unified Catalog Management + Take control of your Stremio home page. AIOStreams lets you manage catalogs from all your addons in one place. + - **Rename**: Rename both the name and the type of the catalog to whatever you want. (e.g. Changing Cinemeta's `Popular - Movies` to `Popular - 📺`) - **Reorder & Disable**: Arrange catalogs in your preferred order or hide the ones you don't use. - **Shuffle Catalogs**: Discover new content by shuffling the results of any catalog. You can even persist the shuffle for a set period. @@ -111,12 +117,12 @@ Take control of your Stremio home page. AIOStreams lets you manage catalogs from ### 🎨 Total Customization + - **Custom Stream Formatting**: Design exactly how stream information is displayed using a powerful templating system. - **Live Preview**: See your custom format changes in real-time as you build them. - **Predefined Formats**: Get started quickly with built-in formats, some created by me and others inspired by other popular addons like Torrentio and the TorBox Stremio Addon. - **[Custom Formatter Wiki](https://github.com/Viren070/AIOStreams/wiki/Custom-Formatter)**: Dive deep into the documentation to create your perfect stream title. -