Skip to content

h4harsimran/streambridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

58 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎬 StreamBridge

Bridge Your Emby Server to Stremio

Version License Node.js Status

Stream media from your personal or shared Emby server directly in Stremio using IMDb, TMDb, Tvdb, or Anidb IDs.

Quick Start β€’ Features β€’ Requirements β€’ FAQ β€’ Deployment


πŸ“– Table of Contents


🌟 Overview

StreamBridge is an unofficial Stremio addon that acts as a stream resolver for your Emby server. When you browse titles in Stremio using catalog addons like Cinemeta, StreamBridge automatically checks if the content exists in your server library and returns direct play links for instant streaming.

Note: Jellyfin support will be added once its API for providerID is fixed by the Jellyfin team.

Key Benefits

  • βœ… Seamless Integration: Works with existing Stremio catalog addons
  • βœ… Direct Play: No transcoding required, streams directly from your server
  • βœ… Multi-Quality Support: Automatically handles different quality options
  • βœ… Subtitle Support: Automatic subtitle loading from your server
  • βœ… Universal ID Support: Works with IMDb, TMDb, Tvdb, and Anidb IDs

πŸ”§ Features

Feature Description
🎯 One-Page Setup Custom configuration page to get your User ID + Access Token and build a ready-to-install link
πŸ” Multi-ID Matching Supports IMDb (tt1234567), TMDb (tmdb:98765), Tvdb, and Anidb IDs
πŸ“Ί Direct-Play Multi-Quality Direct play URLs with support for different quality options (4K, 1080p, 720p, etc.)
πŸ“ Subtitle Support Automatic subtitle loading from your server library
πŸ”„ Emby Support Works with Emby servers
βš™οΈ Configurable Customizable stream names and server display options

⚠️ Requirements

Before installing StreamBridge, ensure you have:

  • βœ… HTTPS Server: Your Emby server must be accessible via HTTPS (HTTP and localhost are not supported)
  • βœ… Public Access: Your server must be accessible from the internet (not just localhost)
  • βœ… Server Credentials: Your server username and password (not Emby Connect credentials)

πŸ“¦ Quick Install

Option 1: Direct Install (Recommended)

  1. Click the configure link:

    https://39427cdac546-streambridge.baby-beamup.club/configure
    
  2. Configure your server:

    • Enter your Server URL (must be HTTPS)
    • Enter your Username and Password
    • Click Get Access Info
    • Your User ID and Access Token will auto-fill
  3. Install the addon:

    • Click Create & Install Add-on
    • Confirm the install prompt in Stremio
    • The addon is now ready to use!

Option 2: Manual Install

  1. Open Stremio and go to Addons

  2. Install using the manifest link:

    https://39427cdac546-streambridge.baby-beamup.club/manifest.json
    
  3. Configure the addon:

    • Click the Configure button on the addon
    • Follow the configuration steps in Option 1

After Installation

Once installed, StreamBridge will automatically return streams for matching titles in your server when you click on them in Stremio. No additional configuration needed!


πŸ”„ How It Works

  1. Browse in Stremio: Use catalog addons like Cinemeta to browse movies and TV shows
  2. Click a Title: When you click on a movie or episode in Stremio
  3. StreamBridge Checks: StreamBridge queries your Emby server using the title's ID (IMDb, TMDb, etc.)
  4. Stream Returned: If found, StreamBridge returns direct play links to stream from your server
  5. Instant Playback: Stremio plays the content directly from your server
Stremio Catalog Addon β†’ StreamBridge β†’ Your Emby Server β†’ Direct Play

❓ FAQ

Getting "Load failure" or authentication errors?

Common causes and solutions:

1. Using HTTP instead of HTTPS

  • ❌ Wrong: http://your-server.com:8096
  • βœ… Correct: https://your-server.com:8096
  • Why? Modern browsers and Stremio require secure connections for security. HTTP connections are blocked by default.

2. Using Server Credentials (Not Connect Credentials)

  • ❌ Wrong: Your Emby Connect email/password
  • βœ… Correct: Your server username/password (the ones you use to log into your server web interface)
  • Where to get them? Go to your server web interface β†’ Users β†’ Your username β†’ Edit β†’ Set a password if you haven't already
  • Note: These are the same credentials you use when logging into your server directly in a browser.

3. Using Localhost Addresses

  • ❌ Wrong: localhost:8096 or 127.0.0.1:8096
  • βœ… Correct: Your public HTTPS URL (e.g., https://your-domain.com:8096)
  • Why? The addon runs on the internet and needs to reach your server from outside your network.

4. Server Not Accessible from Internet

  • Make sure your server is accessible via HTTPS from outside your local network
  • Setup needed: Configure your router/firewall to forward HTTPS traffic to your server
  • Alternative: Use a reverse proxy (nginx, Caddy) or VPN solution to expose your server securely

Can I use this with multiple servers?

Yes! You can install the addon multiple times with different configurations to connect to multiple Emby servers.

Does this work with local servers?

No, your server must be accessible via HTTPS from the internet. Localhost and local network addresses are not supported.

What IDs are supported?

StreamBridge supports:

  • IMDb IDs: tt1234567
  • TMDb IDs: tmdb:98765
  • Tvdb IDs: tvdb:123456
  • Anidb IDs: anidb:12345

Can I filter stream qualities?

Yes! The configuration page allows you to filter out specific stream types (4K, 1080p, HDR, Dolby Vision) if needed.


πŸš€ Addon Deployment Guide

Note: This section is only for developers who want to deploy their own version. If you're here to just use the addon, the Quick Install guide above should suffice.

Deploy with BeamUp

BeamUp is a free hosting service built specifically for Stremio addons.

Prerequisites

  • Node.js installed on your system
  • Git repository with your code

Deployment Steps

  1. Install BeamUp CLI:

    npm install -g beamup-cli
  2. Initialize and deploy:

    beamup
  3. Follow the prompts and push with:

    git push beamup main:master
  4. Your addon is live at:

    https://<addon-id>.baby-beamup.club/manifest.json
    

Local Development

To run the addon locally:

# Install dependencies
npm install

# Start the server
npm start

# Server will be available at
# http://localhost:7000/manifest.json

πŸ›  Tech Stack

  • Runtime: Node.js
  • Framework: Express.js
  • SDK: stremio-addon-sdk
  • APIs: Emby REST API
  • HTTP Client: Axios
  • Middleware: CORS

⚠️ Disclaimer

This addon is for educational and personal use only. It is not affiliated with or endorsed by Emby or Stremio.

  • This is an unofficial addon
  • Use at your own risk
  • Respect copyright laws and terms of service
  • The developers are not responsible for any misuse

πŸ“„ License

This project is licensed under the MIT License.

Copyright (c) 2025 StreamBridge


Made with ❀️ for the Stremio community

Report Bug β€’ Request Feature β€’ Contributing

About

Unofficial resolver addon that links Emby content to Stremio using direct stream URLs.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published