AIOStreams Kodi Plugin Documentation

Contents

Overview

AIOStreams for KODI is a powerful Kodi video plugin that connects to your self-hosted AIOStreams backend, providing seamless access to streaming content with advanced features like Trakt synchronization, intelligent stream selection, and comprehensive metadata integration.

What Does AIOStreams for KODI Do?

AIOStreams acts as a frontend client for your AIOStreams backend, bringing powerful streaming aggregation directly into your Kodi media center:

Required Configuration

1. AIOStreams Backend

You must have a running AIOStreams instance configured with:

Required Components:

Backend Setup:

  1. Deploy AIOStreams (self-hosted or via ElfHosted)
  2. Configure AIOMetadata as your metadata provider
  3. Set up scrapers (torrent indexers, debrid services)
  4. Ensure IMDB tags are enabled in metadata responses

2. Plugin Settings

Access settings via: Add-ons → Video add-ons → AIOStreams → Right-click → Settings

Essential Settings:

General

Playback

Trakt Integration (Optional)

Custom Formatter Option

AIOStreams supports custom stream title formatting to display stream information exactly how you want it.

Enabling Custom Formatting

  1. Go to: Settings → Playback → Stream Display
  2. Enable "Use Custom Formatter"
  3. Enter your custom format string

Format Specification

Use the following custom formatter parameters in your format string, all in the 'Name' section, leave Description empty:

{stream.resolution::exists["RESOLUTION: {stream.resolution}"||""]}
{service.name::exists["SERVICE: {service.name}"||""]}
{addon.name::exists["ADDON: {addon.name}"||""]}
{stream.size::>0["SIZE: {stream.size::bytes}"||""]}
{stream.proxied::istrue["PROXIED: YES"||""]}{stream.proxied::isfalse["PROXIED: NO"||""]}
{service.cached::istrue["CACHED: YES"||""]}{service.cached::isfalse["CACHED:NO"||""]}
{stream.library::istrue["IN LIBRARY: YES"||""]}{stream.library::isfalse["IN LIBRARY: NO"||""]}
{stream.duration::>0["DURATION: {stream.duration::time} "||""]}
{stream.quality::exists["VIDEO: {stream.quality}"||""]} | {stream.visualTags} | {stream.encode}
{stream.audioTags::exists["AUDIO: {stream.audioTags::join(' | ')} | {stream.audioChannels}"||""]}{stream.languages::exists[" | {stream.languages::join(' / ')}"||""]}
{stream.indexer::exists["INDEXER: {stream.indexer} "||""]}{stream.seeders::exists["| {stream.seeders} Seeders"||""]}{stream.age::exists[" | {stream.age} Old"||""]}
{stream.filename::exists["FILENAME: {stream.filename}"||""]}

Installation

  1. In Kodi, open Settings → File manager → Add source, enter https://voidxela.github.io/AIOStreamsKODI/, and give it a memorable name such as AIOStreams.
  2. Open Settings → Add-ons → Install from zip file, select the AIOStreams source, then select repository.aiostreams-1.1.30.zip. The same link can be downloaded in a browser when needed.
  3. Confirm the repository installation.
  4. Open Settings → Add-ons → Install from repository → AIOStreams Repository → Video add-ons → AIOStreams, then select Install.

Quick Start Guide

  1. Install the plugin (see Installation above)
  2. Configure AIOStreams backend with AIOMetadata
  3. Open plugin settings and enter your backend URL
  4. (Optional) Authorize Trakt for sync features
  5. Browse catalogs or search for content
  6. Select a stream and enjoy!

Troubleshooting

No Streams Found

External ID Errors

Trakt Sync Issues

License: MIT