[AIOStreams] Precache next episode

For those who don't know, **AIOStreams** is a Stremio addon I created to let you combine streams from *multiple* Stremio addons into one single, manageable addon. But it's more than just a combiner; AIOStreams is designed to **radically simplify your entire Stremio addon setup.** You provide your Debrid service details (like API keys), and AIOStreams handles the heavy lifting of configuring the stream addons for you. This means you don't have to worry about individual addon configurations or reconfiguring them if an underlying addon updates. It also makes using multiple Debrid services seamless, as AIOStreams can auto-configure them across your chosen addons, ensuring you get the best of all worlds with minimal fuss. It also provides a centralised place for controlling all your sorting and filtering - and already offers more advanced options than other addons. Previously, AIOStreams was fantastic for getting a Stremio account packed with your favorite *stream* addons up and running in minutes. But I always envisioned it doing more... I'm absolutely thrilled to announce that **AIOStreams v2 is now LIVE!** For everyone tired of juggling multiple Stremio addons with different settings, quirks, and limits, **v2 is here to turn all of them into a single, unified experience - smarter, faster, and fully in your control.** This isn't just an update; it's a **complete rewrite from the ground up** aimed at making your Stremio life a whole lot easier and more powerful. With v2, AIOStreams can now handle *everything*, not just streams! This was a massive undertaking, allowing me to address **all open bug reports** as well as most feature requests. # 👀 TL;DR - Quick Links & Preview! 👀 For those who want to jump straight in or see it in action: * **Try the Public Instance Now (hosted by ElfHosted):** [**https://aiostreams.elfhosted.com/**](https://aiostreams.elfhosted.com/) * **Watch the AIOStreams v2 Preview Video:** [A brief showcase of the big changes in V2.](https://reddit.com/link/1lf9kxw/video/34t0l3ra2v7f1/player) # 🚀 The Big Upgrades in v2 🚀 * **Beyond Just Streams:** AIOStreams v2 now supports more than just stream addons! You can integrate **any supported Stremio addon type**, including **Catalog addons, Subtitle addons, and even Addon Catalog addons** into your single AIOStreams setup. Now it truly can do *everything*! * **100% Addon Compatibility:** That's right! AIOStreams v2 is designed to work with **100% of existing Stremio addons** that adhere to the Stremio addon SDK. * **Sleek New UI**: The entire interface has been redesigned for a more modern, intuitive, and frankly, beautiful configuration experience. *This new configuration page was only possible thanks to* [*Seanime*](https://seanime.rahim.app)*, a beautiful application for anime* # ✨ Feature Deep Dive - Get Ready for Control! ✨ This rewrite has paved the way for a TON of new features and enhancements. Here’s a rundown: **🛠️ Configuration Heaven & Built-in Marketplace:** * The configuration page now features a **built-in marketplace for addons**. This makes it super easy to discover and add new addons, displaying their supported resources (streams, catalogs, subtitles, etc.), Debrid services they integrate with, and stream types (torrent, http, usenet, live etc.). * You can now **quickly enable or disable individual addons** within your AIOStreams setup without fully removing them. This is particularly useful because tools like StremThru Sidekick wouldn't be able to detect or manage the individual addons *inside* your AIOStreams bundle, but with AIOStreams' own UI, you have that fine-grained control. * Remember, the marketplace is just there for convenience. You can still add any addon you want using the 'Custom' addon at the top of the marketplace and use an addons manifest URL to add it to AIOStreams. **📚 Supercharged Catalog Management:** * **Total Catalog Control:** Reorder your catalogs exactly how you want them, **regardless of which addon they originate from!** Mix and match to your heart's content. * **Granular Management:** Enable/disable specific catalogs, apply **shuffling** to individual catalogs - and control how long a shuffle lasts, **rename catalogs** for a personalized touch, and you can even **disable certain catalogs from appearing on your Stremio home page**, having them only show up in the Discover section for a cleaner look! * **Universal RPDB Posters:** Ever wanted those sleek posters with ratings on *any* catalog? Now you can! Apply **RPDB posters (with ratings) to any addon that uses a supported ID type (like IMDB or TMDB ID), even if the original addon doesn't support RPDB itself.** * **Why not just use other tools like StremThru Sidekick or the Addon Manager for catalogs?** * **Broader Compatibility:** Both StremThru Sidekick and Addon Manager are primarily limited to managing addons *for Stremio itself*. AIOStreams’ catalog features can be utilized by *any application* that supports Stremio addons, not just Stremio. * **True Internal Reordering:** Neither of those tools supports reordering catalogs *within an addon itself*. Since AIOStreams presents all its combined catalogs as coming from *one addon*, those tools wouldn't be able to reorder the catalogs *inside* your AIOStreams setup. AIOStreams gives you that crucial internal control. * **Safety:** AIOStreams does **not** make use of the Stremio API for its core functionality. This means it operates independently and **cannot break your Stremio account** or interfere with its settings. **🌐 Expanded Addon Ecosystem:** * The built-in marketplace comes packed with **many more addons than before**. * Some notable new stream addons include: **StremThru Torz, Nuvio Streams, Debridio Watchtower, StreamFusion**, and even built-in support for **wrapping AIOStreams within AIOStreams** (AIOception!). **💎 Revolutionary Grouping Feature:** * I've implemented a **new grouping feature** that allows you to group your addons and apply highly customizable conditions. * Streams from addons in Group 1 are always fetched. Then, you can set conditions for subsequent groups. For example, for Group 2, you could set a condition like `count(previousStreams) < 5`. This means addons in Group 2 will only be queried if the total number of streams found by Group 1 is less than 5. This means you can tell AIOStreams, for instance, to only tap into your backup/slower addon group if your main, preferred addons don't find enough streams first – super efficient! * This allows for incredibly optimized and tailored stream fetching. (For more advanced setups and details, I highly recommend checking out the [**Wiki**](https://github.com/Viren070/AIOStreams/wiki/Groups)). **🔎 Next-Level Filtering System:** * The filtering system has been completely revamped. Previously, you could mainly exclude or prefer. Now, for *every* filter criteria, you can set **four different filter types**: * **Include:** If matched, this item won't be excluded by other exclude/required filters for *any other exclude/required filter*. * **Required:** Exclude the stream if this criteria is *not* detected. * **Exclude:** Exclude the stream if this criteria *is* detected. * **Preferred:** This is used for ranking when you use that filter as a sort criteria. * **New Filters Added:** * **Conditions Filter:** This incredibly flexible filter uses the same powerful condition parser as the "Groups" feature. You can now enter **multiple filter conditions**, and any stream that matches *any* of the conditions you define will be filtered out. This allows for an almost infinite number of ways to combine filters and exclude streams with surgical precision! For example, a condition like `addon(type(streams, 'debrid'), 'TorBox')` would exclude all Debrid-type streams *only* from the "TorBox" addon, leaving its Usenet streams untouched. * **Matching:** This powerful filter helps ensure you get the right content. It includes: * **Title Matching:** Filter out results that don't match the requested title. You can choose between an "exact match" mode or a "contains" mode for flexibility. **You can optionally also match the year too.** * **Season/Episode Matching:** Specifically for series, this mode filters out results with incorrect season or episode numbers, ensuring accuracy. This can be granularly applied to only specific addons or request types. * **Audio Channels:** This was previously part of the Audio Tag filter but is now its own dedicated filter for more precise control (e.g., filter for 5.1, 7.1). * **Seeders:** Define include/required/exclude ranges for seeders. Finally, you can set a **minimum seeder count** and automatically exclude results below that threshold! * **Adjusted & Enhanced Filters:** * **Cache:** Get fine-grained control over cached/uncached content. You can now exclude uncached/cached content from specific Debrid services or addons, and even for specific stream types. For example, you could filter out all uncached *torrents* but still allow uncached *Usenet* results. * **Clean Results (now "Deduplicator"):** This is now far more customizable! You can modify what attributes are used to identify duplicates (e.g., infohash, filename) and how duplicates are removed for each stream type. For instance, for cached results, you might want one result from each of your Debrid services, while for uncached results, you might only want the single best result from your highest priority service. * **Size:** You can now set **individual file size ranges for each resolution** (e.g., 1-2GB for 720p, 3-5GB for 1080p, etc.). **📺 Smarter Sorting & Display:** * Define **different sorting priorities for cached vs. uncached media**, and also **different sorting for movies vs. series.** * **New "Light GDrive" Formatter:** For those who prefer a cleaner look but still need key information from the filename, this formatter only shows the title, year, and season/episode info (e.g., "Movie Title (2023) S01E01"), making sure you don't potentially choose an incorrect result while still keeping the text to a minimal level. * And of course, you can always join our Discord server to discover custom display formats shared by the community and easily use them with AIOStreams' custom formatter feature! **✨ Quality of Life Enhancements:** * **Import/Export Configurations:** You can now easily **export your entire AIOStreams configuration into a file.** This file can then be imported into any AIOStreams instance at any time – perfect for backups or migrating to a new setup. * **Shareable Templates:** There's an "Exclude Credentials" option when exporting, making it easy to share template configurations with others! * **⚠️ Important Warning:** While the "Exclude Credentials" feature removes sensitive information you enter *directly* into AIOStreams (like API keys), it **does not** modify or exclude URLs you provide for "Custom" addons or when you override an addon's default URL. These URLs can potentially contain sensitive tokens or identifiers, so please review them carefully before sharing a configuration file. * **External Downloads:** For added convenience, AIOStreams v2 now adds an "External Download" link below each stream result. Clicking this will open the direct download link for that stream in your browser, making it easy to grab a copy of the content if needed. * **Hide Errors:** Optionally hide error messages, and you can even specify this for particular resources (e.g., hide errors only for stream fetching, but show them for catalog fetching). * **Precache Next Episode:** When you're watching a series, AIOStreams can automatically request results for the *next* episode in the background. If it finds that all available results are uncached, it can **ping the first uncached result for your preferred Debrid service to start downloading it.** The goal? By the time you finish your current episode, the next one might already be cached and ready to stream instantly! **A Note on Options:** AIOStreams v2 offers a vast array of configuration options, especially within the filtering system. While this provides incredible power and flexibility for advanced users, please remember that **most users won't need to dive deep into every setting.** The default configurations are designed to be sensible and provide a great experience out-of-the-box! For a detailed explanation of every option and how to fine-tune your setup, the [**AIOStreams v2 Configuration Guide**](https://guides.viren070.me/stremio/addons/aiostreams) has been fully updated and is your best resource. # 💾 Under The Hood: The New Database Foundation 💾 * **Database-Driven:** AIOStreams is now database-based! This means your configurations are stored securely. When you create a configuration, it's assigned a **unique UUID** that you'll use to access it in Stremio. * **Password Protected:** You'll protect your configurations with a **password**. Without it, no one else can access your configuration. * **Seamless Updates (Mostly!):** A huge benefit of being database-driven is that for most setting changes, there’s **no longer a need to reinstall the addon in Stremio!** Just update your configuration, and the changes apply automatically. * **Note:** The only exception is if you make changes to your catalogs, or add a type of addon that wasn't previously present (e.g. adding your first subtitle addon) this specific case, a reinstall of the AIOStreams addon in Stremio is needed for Stremio to pick up the resources and catalog order. # ⚠️ Important Notes & Caveats for v2 ⚠️ * **Migration Requires Reconfiguration:** Due to the extensive changes and the new database system, existing AIOStreams users will need to **reconfigure their setups for v2.** Think of it as a fresh start with a much more powerful system! The [**v1 to v2 Migration Guide**](https://github.com/Viren070/AIOStreams/wiki/Migrate-to-V2) on the Wiki can help. For a deep dive into all the new settings, refer to the comprehensive [**AIOStreams v2 Configuration Guide**](https://guides.viren070.me/stremio/addons/aiostreams). **If you use custom formatters, you should also check the migration guide for minor syntax adjustments.** * **Torrentio support (on public instance)?** Torrentio was disabled on AIO for most of v1's history due to the way AIOStreams works (multiple requests appearing to come from one IP, which is problematic for public instances, especially for something like Torrentio that is already being scraped by numerous applications). Torrentio remains **disabled on the official public instance**, and this will not change. Self-hosted instances will have Torrentio enabled by default. The developer of Torrentio has personally stated that he does not want ElfHosted's public instances scraping Torrentio. * **Cloudflare Worker Support Dropped:** Maintaining compatibility with Cloudflare Workers alongside the new database requirements and feature set became infeasible. It was essentially like writing and maintaining two different versions of the addon. As such, direct Cloudflare Worker support has been dropped. For those of you who currently host V1 with Cloudflare Workers, your instance will continue working and will likely remain working for a long time. You just won't be able to update to V2. * **Free Hosting Challenges:** AIOStreams v2 now **requires a database** for storing configurations. Many free hosting services do not provide persistent database storage (or have very limited free tiers), which can lead to your configurations being wiped when the instance restarts. * For example, **Hugging Face Spaces** requires a paid tier for persistent storage. * **Koyeb's** free tier does not offer persistent file storage for the SQLite database, however, Koyeb *does* provide a free PostgreSQL database instance which AIOStreams v2 can use, offering a viable free hosting path if configured correctly. # 🔧 Self-Hosting AIOStreams & Self-Hosting Guides 🔧 For those of you who like to have full control over your setup, **AIOStreams v2 is, of course,** ***still*** **self-hostable!** If you're migrating your instance from v1 to v2, read the [Migration](https://github.com/Viren070/AIOStreams/wiki/Migrate-to-V2) page on the Wiki to ensure nothing unexpected happens. A few months back, I started out knowing very little about self-hosting (I was using Hugging Face to host my personal AIOStreams instance back then) and I've since decided to dive into self-hosting. As a result, I've put together a **set of comprehensive self-hosting guides** that I'm excited to share with the community. My goal with these guides is to take you **from scratch to hosting all sorts of addons and applications**, including AIOStreams, without spending a dime or needing any hardware other than a laptop/computer. (Some of you may even be able to set this all up just using your phone/tablet) However, I will say that this requires a lot more effort than other options that I previously had guides for like hugging face, render, cloudflare workers etc. but I have done my best to make it as comprehensive as possible. The guides cover: * Securing a **free Oracle Cloud VPS**. * Installing **Docker** and getting comfortable with its basics. * Utilizing my **highly flexible and detailed template compose project.** This Docker Compose setup is designed to be a launchpad for your self-hosting adventures and includes configurations for **countless apps, with AIOStreams v2 ready to go!** If you've ever been curious about self-hosting but didn't know where to start, I believe these guides can help you get up and running with a powerful, remote, and secure setup. * [**https://guides.viren070.me/selfhosting**](https://guides.viren070.me/selfhosting) # 💬 Join the AIOStreams Community on Discord! 💬 AIOStreams v2 wouldn't be where it is today without the feedback, bug reports, and ideas from our community. A massive **THANK YOU** to everyone on Discord who took part in testing, shared suggestions, and patiently helped polish every feature. Your involvement genuinely shaped this release! To celebrate the launch, I'm running a **1-year Real-Debrid giveaway (with 3 winners)** exclusively in the Discord server! Just join the server for your chance to win. Outside of the giveaway, you can also join our server for: * Questions about and support for AIOStreams and self hosting * Discover setups shared by the community like formats, regexes, group filters, condition filters etc. (and possibly even share your own!) * Staying updated on the latest AIOStreams developments Join our server using the link below: * [**https://discord.viren070.me**](https://discord.viren070.me) # ❤️ Support AIOStreams Development ❤️ AIOStreams is a passion project that I develop solo in my free time. Countless hours have gone into this v2 rewrite, and I'm committed to making it the best it can be. If you find AIOStreams useful and want to support its continued development, there are several ways you can help! **Financial Support:** Donations are hugely appreciated and help me dedicate more time to new features, bug fixes, and community support. * [**Sponsor me on GitHub**](https://github.com/sponsors/Viren070) * [**Buy me a coffee on Ko-fi**](https://ko-fi.com/viren070) **Community Support (Free!):** Even without donating, you can make a huge difference by helping with visibility. It only takes a second and helps others discover AIOStreams! * **Star the Addon:** Give AIOStreams a star on the official Stremio Addon catalog! * [**https://beta.stremio-addons.net/addons/aiostreams**](https://beta.stremio-addons.net/addons/aiostreams) * **Star the Repo:** If you're a GitHub user, starring the repository helps a lot. * [**https://github.com/Viren070/AIOStreams**](https://github.com/Viren070/AIOStreams) # 🚀 Get Started with AIOStreams v2! 🚀 I'm incredibly excited for you all to try out AIOStreams v2! I believe it's a massive step forward. Please give it a go, explore the new features, and share your feedback. Here’s how you can jump in: **1. Try the Public Instance (Easiest Way!)** * **ElfHosted (Official Public Instance):** Generously hosted and maintained. * **Link:** [**https://aiostreams.elfhosted.com/**](https://aiostreams.elfhosted.com/) **2. Self-Host AIOStreams v2** * **For New Self-Hosters:** If you know what you're doing - follow the [Deployment Wiki](https://github.com/Viren070/AIOStreams/wiki/Deployment). Otherwise, check out my comprehensive [**Self-Hosting Guides**](https://guides.viren070.me/selfhosting) to get started from scratch. * **Migrating from v1?** If you're currently self-hosting v1, ensure your setup supports persistent storage and then follow the [**v1 to v2 Migration Guide**](https://github.com/Viren070/AIOStreams/wiki/Migrate-to-V2). **3. Managed Private Instance via ElfHosted (Support AIOStreams Development!)** * Want AIOStreams without the self-hosting hassle? ElfHosted offers private, managed instances. * ✨ **Support My Work:** If you sign up using my referral link, **33% of your subscription fee directly supports AIOStreams development!** * **Get your ElfHosted AIOStreams Instance:** [**https://store.elfhosted.com/product/aiostreams/elf/viren070**](https://store.elfhosted.com/product/aiostreams/elf/viren070) This release marks a new chapter for AIOStreams, and I can't wait to see how you all use it to enhance your Stremio experience. Cheers, Viren.