Skip to main content

AIOStreams V2

Description

info

This is the guide for v2 of AIOStreams, looking for the guide for v1? You can find it here.

This addon lets you combine all of your addons into one and provide consistent formatting, sorting, and filtering of the results. It is immensely configurable, allowing you to fine tune your catalogues too.

I will attempt to explain every single option available.

Configuration

warning

Torrentio is disabled on the public ElfHosted instance.

To get started, you'll want to head to the configuration page by clicking the "Configure" button above. Then, you'll need to click the big white Configure button on AIOStreams' configuration page.

Services

This is where you can enter credentials for, reorder, and toggle services like Real Debrid, Torbox etc.

The order of the services determines a couple things:

  • The priority order when deduplicating streams - given that the deduplicator is enabled.
  • The ranking of services used when sorting - given that the sorting uses service as a criterion.

Below all the services, there will be a field to enter your RPDB API Key. Add this if you would like to configure supported catalogue addons you add to use posters from RPDB.

Addons

Here you can manage your installed addons, add new ones, and configure them. You can also manage your catalogues here, as well as using the Group feature to group addons together. I will not be covering the Groups feature here, as it is not required and is a feature meant for advanced users. You may join the AIOStreams Discord to view the community's configurations.

To install addons, head to the Marketplace tab. You can choose from a variety of addons, and filter by supported services and the type of content or streams they provide. You may also use the Custom Addon feature to add any addon you want as long as you have the manifest URL. The addons provided in the Marketplace are all provided for convenience's sake to ensure you can easily add addons without having to leave AIOStreams.

Upon clicking Configure on an addon, you will be presented with a list of options. In most cases, you don't have to change anything, and click Install on the popup that appears. However, some addons may require you to enter credentials or API keys, and some may have additional options that you can configure.

As most options are generally explained well in the popup, I'm not going to cover them here. However, I will cover some of the more important ones that tend to appear on every addon.

  • Name - This lets you change the name of the addon as it appears in AIOStreams. This name is only used for stream results, it does not affect any catalog names.
  • Timeout - This lets you change the time that AIOStreams waits for the addon to respond before it aborts the request to it. Used for all requests to the addon, including catalogues, streams, subtitles etc.
  • Resources - This option allows you to override the resources that AIOStreams would use from the addon. This is useful if you want to disable catalogues from the addon, but keep its streams. So you would only select stream here. In most cases, its recommended to leave this blank, or at the defaults - as it is automatically determined by AIOStreams later.
  • URL - In most cases, you will be able to override the URL of the addon here. Usually this is generated automatically by AIOStreams - A benefit of this is you never having to worry about other addon updates, as AIOStreams will always use the latest version of the addon. However, if you want to use a custom URL, you can do so here. This is useful for using a specific configuration of the addon. Note: you will need to configure any debrid services separately, debrid services configured in AIOStreams do not apply to overriden URLs.

Once you've installed your addons, you can head back to the Installed tab to view them. You'll be able to click the edit icon to edit the configuration, the delete icon to remove the addon from your installed addons, and optionally toggle the addon on or off to temporarily disable it without removing it.

Catalogues

Within the Installed tab of the Addons menu, you will find a section where you can control your catalogues (given that you have at least one addon installed).

You'll first want to click the refresh icon on the top right corner. This will fetch the catalogues from all your addons and display them here.

There are a few options available here to you to help you manage your catalogues. For each catalogue, you will see the following options:

  • To the left of each catalogue card, you can drag the black bar to reorder your catalogues. The order here determines the order they are displayed in on Stremio or other clients.
  • The edit icon next to the catalogue name allows you to edit a catalogues name and type. Both these values can be edited to your liking and those changes will be reflected in Stremio.
  • To the right, you also have position controls to allow you to instantly move a catalogue to the top or bottom of the list.
  • There is also a switch to toggle the catalogue on or off. This is useful if you want to hide specific catalogues.
  • Below that, there is a settings section that you can expand which allows you to apply certain modifications to the catalogue. Each modification also has a icon button to provide quick access to toggling it.

Below the catalogue section, you will notice the Groups section. Like I mentioned earlier, this is an advanced feature that allows you to group addons together and I will not be covering it here. The Wiki has more information on how to use this feature.

Filters

One of AIOStreams' most recongisable feature is its advanced filtering system. This menu may look a bit overwhelming, but it is neatly organised into sections to try and make it easier to understand.

Cache

This section allows you to filter streams based on whether they are cached or not. There is a cached section and an uncached section.

Each section will have a toggle to completely disable cached/uncached streams, and optionally a more granular filter to exclude cached/uncached streams from specific addons, services, or stream types.

The apply mode setting controls how your 3 filters (addons, services, and stream types) are applied. The OR mode means that a cached/uncached stream will be excluded if it is either from an addon, service, or stream type that is excluded. The AND mode means that a cached/uncached stream will be excluded only if it is from all of the addons, services, and stream types that are excluded.

The stream type setting allows you to exclude uncached results for debrid, while keeping uncached results for usenet. Useful for TorBox pro users.

Generic Stream Attributes

The next couple sections allow you to filter streams based on generic attributes:

  • Resolution - The resolution of the stream, such as 1080p, 720p, etc.
  • Encode - The encoding of the stream, such as HEVC, AVC etc.
  • Stream Type - The type of the stream, such as p2p, debrid, http, usenet, etc.
  • Visual Tag - The visual tag of the stream, such as HDR, Dolby Vision, etc.
  • Audio Tag - The audio tag of the stream, such as Dolby Atmos, DTS, etc.
  • Audio Channel - The audio channel of the stream, such as 5.1, 7.1, etc.
  • Language - The language of the stream, such as English, Spanish, etc.

Each of these sections above have very similar options:

  • Required - Excludes streams that don't have one of the selected attributes. For example, if you set 1080p as a required resolution, any streams that are not 1080p will be excluded.
  • Excluded - Excludes streams that have at least one of the selected attributes. For example, if you set 720p as an excluded resolution, any streams that are 720p will be excluded.
  • Included - Prevents streams that have at least one of the selected attributes from being filtered out by all other exclude/required filters. For example, if you set HDR as an included visual tag, any streams that are HDR will not be filtered out by the other filters, even if they don't match the required or excluded attributes.
  • Preferred - This is a special filter that allows you to set a ranking for that specific attribute. This ranking is used when you enable the relevant sorting option in the Sorting section. For example, if you set 1080p as a preferred resolution, any streams that are 1080p will be ranked higher than streams that are not 1080p when sorting by resolution.

Seeders

This section allows you to filter streams based on the number of seeders they have. You can set 3 ranges of seeders

  • Required - Excludes streams whose number of seeders is not within the range.
  • Excluded - Excludes streams whose number of seeders is within the range.
  • Included - Prevents streams whose number of seeders is within the range from being filtered out by all other exclude/required filters.

You can also optionally set stream types for which the seeders filter should be applied. This is useful if you want to only apply these seeder filters to p2p streams, for example.

Matching

This section allows you to filter streams out based on whether they match with the requested content or not. You can apply title matching and season/episode matching.

Title Matching

This option fetches titles from the TMDB API and compares them to the titles of the streams returned by your addons.

This allows you to filter streams based on whether they match the title of the requested content or not. You can set the Matching mode to either Exact or Partial. The Exact mode will only match streams that have the exact same title as the requested content, while the contains mode will match streams that have the requested content's title anywhere in their title.

As the TMDB API is being used, it is required to provide a TMDB Access Token. This can be obtained by creating an account on TMDB and generating an API key in your account settings. You can then enter the Access Token in the TMDB Access Token field. (Make sure you use the Access Token, not the API Key!)

tip

You can use fake information when creating your application on TMDB

You can then optionally limit the title matching to specific addons or request types (e.g. movies, series, anime)

Season/Episode Matching

This section is the same as the above, except it doesn't require a TMDB Access token, simply enable it if you wish to use it.

Keyword

This section allows you to filter streams based on whether they contain specific keywords in their title or not. You can enter multiple words or phrases in 4 different fields:

  • Required - Excludes streams that do not contain at least one of the words or phrases in their title.
  • Excluded - Excludes streams that contain at least one of the words or phrases in their title.
  • Included - Prevents streams that contain at least one of the words or phrases in their title from being filtered out by all other exclude/required filters.
  • Preferred - This is a special filter that allows you to set a ranking for a specific set of keyword. This ranking is used when you enable the relevant sorting option in the Sorting section. For example, if you add ilikethisterm as a preferred keyword, any streams that contain ilikethisterm in their title will be ranked higher than streams that do not contain that term when sorting by keyword.

Regex

info

This filter is only available on self hosted instances, due to potential abuse You will either need to add your UUID to the TRUSTED_UUIDS environment variable, or set the REGEX_FILTER_ACCESS environment variable to all (only recommended if you have set an ADDON_PASSWORD, ensuring no one unauthorised can access your instance)

This is essentially a more powerful version of the keyword filter, allowing you to use regular expressions to filter streams. The only difference is in the preferred section. With regex, the order of the regexes you enter matters, and streams that match a regex higher up in the list are ranked higher than streams that match a regex lower down in the list when sorting by regex.

Size

This section allows you to filter streams based on their size.

You can set separate global size limits for movies and series. Any streams whose size does not lie within the specified range will be excluded. If you leave the two slider thumbs at opposite ends, no size filtering is applied.

You can also optionally set a specific size limit for movies and series per resolution. This is useful if you want to have different size limits for different resolutions. Only one set of size limits will be applied at a time, meaning a resolution specific size limit will take precedence over the global size limits.

Result Limits

This section allows you to limit the number of results returned by AIOStreams. You can set a maximum number of results to return, and optionally also limit the number of results per: service, addon, resolution, quality, indexer, and release group.

What this means is that AIOStreams will cut off streams after a specific group limit is reached. This means that it would keep streams higher up in the list (which depends on your sorting options) and remove streams lower down in the list.

Deduplicator

The deduplicator is a powerful feature that allows you to remove duplicate streams from your results.

Detection Methods - Allows you to control what attributes are used to determine whether two streams are duplicates or not.

  • filename - Uses fuzzy filename matching.
  • infoHash - uses the hash of the torrent file (available for all torrent streams, and some debrid streams) - this is the most accurate method.
  • smartDetect - This uses a hash generated using a combination of the streams metadata - including file size, resolution, audio tags, visual tags etc.

You can then control how duplicates are removed for specific types (cached, uncached, P2P), these are the 3 options you can choose:

  • Single Result - This keeps only one result, ranking the duplicates based on the serivce its from, and then the addon its from.
  • Per Service - This aims to keep the best result from each service, determined by the ranking of the addons.
  • Per Addon - This aims to keep the best result from each addon, determined by the ranking of the services.

Sorting

The sorting system uses a hierarchical approach to determine how content is sorted:

  1. Primary Sorts: Define the main sorting order for different content types:
  • Global: Used as a fallback when no specific type sort is defined (You most likely just want to define this and ignore everything else.)
  • Movies: Specific sorting for movies
  • Series: Specific sorting for TV series
  • Anime: Specific sorting for anime content
  1. Cached/Uncached Sorting: If your primary sort has "cached" at the top and there is both an uncached and cached sort criteria defined:
  • Content is split into cached and uncached groups
  • Each group is sorted separately using its specific sort criteria
  • Groups are then combined based on the cached sort direction
  • Type-specific cached/uncached sorts (e.g., "Cached Movies") take priority over global cached/uncached sorts

Formatter

Here, you can customise the way your streams are displayed in Stremio.

You can either choose from a list of pre-defined formats, or create your own custom format using AIOStreams` Formatter Syntax

tip

Join AIOStreams' Discord to see the formats created by the community, or to share your own formats!

There is a preview section that allows you to see how your streams will look like in Stremio. You can adjust specific values in the preview to see how they affect the display of the streams.

Proxy

You can use this section to optionally configure a stream proxy for AIOStreams. You can choose from either MediaFlow Proxy or StremThru.

The rest of the options are already explained well in the UI, so I will not be covering them here.

Miscellaneous

The options on this menu are already explained well in the UI, so I will not be covering them here.

Save & Install

Here, you will be able to create a new user on your AIOStreams instance, or update the existing user with the current configuration.

When creating a new user, you will need to set a reasonably strong password. You will also be given a unique UUID that you may need to access your configuration, should you lose your installation URL.

Once you create a user, you will be presented with a button to install the addon using your preferred method.

danger

Make sure you save your UUID and password somewhere safe, as you will need them to access your configuration in the future. You will NOT be able to recover your configuration, or reset your password if you lose them.

You can, however, keep exports of your configurations as backups, which I will discuss below.

Below the installation button, you will find a backup section that allows you to export your configuration as a JSON file and also import these configurations later. You can use this to backup your configuration, or to share it with others. You can also use this to import configurations from other users.

You can expand the Export Settings to toggle the Exclude Credentials option, which will exclude any credentials you have entered in the configuration from the exported file. Note that while this option filters out all sensitive information entered in AIOStreams, it will not filter out any URLs from custom addons or URLs that you have overriden. These URLs can possible contain sensitive information, so make sure to double check the exported file before sharing it with others.

FAQ

How do I edit my configuration?

When you create a user, you are given a unique installation URL ending in /manifest.json Most apps will display a Configure button next to the addon, which will take you to the configuration page. If this does not exist, you can manually navigate to the URL by replacing /manifest.json with /configure.

You may also manually go to the configuration page by navigating to https://your-instance-url/stremio/configure where your-instance-url` is the URL of your AIOStreams instance, and then click the login icon on the bottom left corner, where you will be asked for your UUID and password.

How do I update my configuration?

You can update your configuration by going to the configuration page and clicking the Update user button on the Save & Install menu.

You don't have to reinstall the addon in Stremio, as the manifest URL will remain the same. Note: This does not apply if you make changes that cause the manifest of the addon to change, such as reordering or editing catalogues or adding a type of addon (e.g. subtitle) that was not previously provided by your installation. In that case, you will need to reinstall the addon in Stremio.

Need Help?

If you need help in configuring this addon, feel free to ask in the AIOStreams Discord in the #support channel,