Skip to main content
Raffi is fully compatible with the Stremio addon ecosystem, allowing you to use any Stremio addon for content sources, metadata, subtitles, and catalogs.

​
What are Stremio Addons?

Stremio addons are community-developed extensions that provide:
  • Streaming sources - Links to video content
  • Subtitles - Multi-language subtitle files
  • Catalogs - Browsable collections of content
  • Metadata - Information about movies and TV shows
Raffi uses the proven Stremio addon protocol, giving you access to hundreds of community-maintained addons.

​
Addon Resources

Each addon can provide one or more resource types:

​
Stream Resources

Provide video streaming sources:
  • Torrent/magnet links
  • Direct HTTP/HTTPS video URLs
  • HLS manifests
  • Multiple quality options

​
Subtitle Resources

Provide subtitle files:
  • Multiple languages
  • SRT and VTT formats
  • Automatic fetching during playback
  • Synced with video content

​
Catalog Resources

Provide browsable content collections:
  • Movies and TV shows
  • Genre-based catalogs
  • Popular/trending content
  • Search functionality

​
Meta Resources

Provide content information:
  • Titles, descriptions, and posters
  • Cast and crew information
  • Episode lists for TV series
  • Release dates and ratings

​
Installing Addons

Add new addons to expand Raffi’s capabilities:
1

Open Addon Manager

Click “Addons” in the sidebar or settings.
2

Add Addon URL

Paste the addon’s manifest URL (ends with /manifest.json).
3

Install

Click “Install” or “Add Addon” to install.
4

Wait for Validation

Raffi validates the addon manifest and checks for supported resources.
5

Addon Ready

The addon appears in your list and is immediately available.
Some addons require configuration. If you see a “Configure” button, click it to set up the addon properly.

​
Managing Addons

​
Viewing Installed Addons

See all your configured addons:
  1. Navigate to the Addons page
  2. View addon names, types, and capabilities
  3. See which resources each addon provides
  4. Check addon status and configuration

​
Addon Information

Each addon displays:
  • Name - Addon display name
  • Version - Current addon version
  • Resources - Available resource types (Streams, Subtitles, Catalogs, Meta)
  • Description - What the addon provides
  • Transport URL - Base URL for the addon

​
Configuring Addons

Some addons require setup:
1

Click Configure

Click the “Configure” button next to the addon.
2

Enter Settings

Opens the addon’s configuration page (usually in a browser).
3

Save Configuration

Follow the addon’s instructions to complete setup.
4

Return to Raffi

Configuration is automatically applied.
Many addons offer advanced options like quality preferences, language settings, and account integration.

​
Removing Addons

1

Open Addon Manager

Navigate to your addons list.
2

Select Addon

Find the addon you want to remove.
3

Uninstall

Click the remove or uninstall button.
4

Confirm

Confirm the removal when prompted.

​
Using Addons

​
Finding Streams

When you select content to watch:
  1. Raffi queries all installed addons with stream resources
  2. Available streams appear grouped by addon
  3. Each stream shows quality, size, and source information
  4. Select any stream to begin playback
Addons are queried in parallel for fast stream discovery.

​
Stream Filtering

Filter and sort available streams:
  • By quality - 1080p, 720p, 480p, etc.
  • By source - Group by addon provider
  • By size - Sort by file size
  • By seeds - Sort torrents by seeder count

​
Automatic Subtitle Fetching

Subtitles are automatically fetched:
  1. When you start playing content
  2. Raffi queries all subtitle-enabled addons
  3. Available subtitles appear in the subtitle menu
  4. Each subtitle shows language and source addon
  5. Select any subtitle to load immediately

​
Catalog Browsing

Browse content from addon catalogs:
  1. Navigate to the catalog section
  2. Select an addon catalog
  3. Browse movies, series, or genres
  4. Click any item to view details and streams
Search across addon catalogs:
  • Searches all catalogs with search support
  • Combines results from multiple addons
  • Deduplicates matching content
  • 1.8-second timeout per addon for responsiveness

​
Addon Compatibility

​
Supported Addon Types

Raffi supports all standard Stremio addon types:
  • Movie addons - Content type: movie
  • Series addons - Content type: series
  • Multi-type addons - Support both movies and series

​
Resource Validation

Raffi validates addon resources:
  • Checks for supported resource types
  • Validates manifest structure
  • Tests addon connectivity
  • Displays warnings for unsupported features
Raffi filters out addons with no supported resources during installation.

​
ID Prefix Support

Addons can specify ID prefixes they support:
  • IMDb IDs - tt prefix (e.g., tt1234567)
  • TMDB IDs - Custom prefixes
  • Other databases - Addon-specific prefixes
Raffi respects these restrictions when querying addons.

​
Advanced Features

​
Multiple Addons for Redundancy

Install multiple stream addons:
  • Increases likelihood of finding working streams
  • Provides quality options from different sources
  • Automatic fallback if one addon fails
  • Compare sources before selecting

​
Addon Priority

While Raffi doesn’t have explicit priority settings:
  • Results from all addons shown together
  • You choose which stream to use
  • Sort and filter to find preferred sources
  • Recently working streams move to top

​
Addon Caching

Raffi caches addon responses:
  • Catalog results - Cached for faster browsing
  • Search results - 60-second cache
  • Metadata - Cached until refresh
  • Stream lists - Fresh on each request

​
Custom Addon Development

You can create your own addons:
  1. Follow the Stremio addon SDK documentation
  2. Deploy your addon to any hosting service
  3. Add the manifest URL to Raffi
  4. Your custom addon works like any other
Check the Stremio Addon SDK for development resources.

​
Addon Manifest Structure

Raffi reads standard Stremio manifests: 
{
  "id": "addon.identifier",
  "version": "1.0.0",
  "name": "My Addon",
  "description": "Provides streaming sources",
  "resources": ["stream", "subtitles"],
  "types": ["movie", "series"],
  "catalogs": [],
  "idPrefixes": ["tt"]
}

​
Required Fields

  • id - Unique addon identifier
  • version - Addon version
  • name - Display name
  • resources - Available resource types

​
Optional Fields

  • description - What the addon provides
  • types - Supported content types
  • catalogs - Browsable catalogs
  • idPrefixes - Supported ID formats

​
Finding Addons

Discover new Stremio addons:
  • Community lists - Search for “Stremio addons” online
  • Reddit - r/Stremio has addon recommendations
  • Official addons - Check Stremio’s addon directory
  • Forums - Stremio community forums
Any addon that works with Stremio will work with Raffi.

​
Troubleshooting

​
Addon Won’t Install

If an addon fails to install:
  • Verify the manifest URL is correct
  • Check that the URL is accessible
  • Ensure the addon provides supported resources
  • Check Raffi console logs for specific errors

​
No Streams Found

If addons return no streams:
  • Verify addons are properly configured
  • Check if addons require authentication
  • Try a different content item
  • Install additional stream addons

​
Slow Stream Loading

If streams load slowly:
  • Some addons query external services
  • Network conditions affect response times
  • Try addons with faster infrastructure
  • Consider local or cached addons

​
Addon Configuration Issues

If configuration doesn’t work:
  • Clear browser cache and try again
  • Follow addon’s specific setup instructions
  • Check if addon requires account registration
  • Contact addon developer for support
Raffi displays addon errors in the console. Check console logs for detailed troubleshooting information.

​
Best Practices

Multiple Sources

Install 3-5 reliable stream addons for best availability.

Keep Updated

Check for addon updates periodically for best performance.

Test After Install

Test new addons with known content to verify they work.

Remove Unused

Remove non-working or duplicate addons to keep things clean.

Build docs developers (and LLMs) love

Get started for freeTalk to us