whatisgithub

What is streamfin?

scamnscoot/streamfin — explained in plain English

Analysis updated 2026-05-18

28C++Audience · generalComplexity · 3/5LicenseSetup · moderate

In one sentence

A Stremio-protocol streaming client for homebrewed Nintendo Switch, forked from Switchfin, that plays streams from user-supplied addon URLs.

Mindmap

mindmap
  root((StreamFin))
    What it does
      Cinemeta browsing
      Stream picking via MPV
      Continue watching
    Tech stack
      C++
      Borealis UI
      MPV player
      Stremio protocol
    Use cases
      Homebrew Switch streaming
      Custom catalog rows
      Auto-fetched subtitles
    Audience
      Homebrew Switch users
      Stremio addon users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Stream movies and shows on a homebrewed Nintendo Switch via Stremio addons

USE CASE 2

Browse Cinemeta catalogs with IMDb ratings and a continue watching list

USE CASE 3

Add custom catalog addons for anime, streaming-service, or list-based rows

USE CASE 4

Pull matching subtitles automatically from a subtitles addon

What is it built with?

C++MPVBorealisStremio addon protocol

How does it compare?

scamnscoot/streamfinfrankkk96/flashqwenlostamongrectify/seed-phrase-generator
Stars282828
LanguageC++C++C++
Setup difficultymoderatehard
Complexity3/55/5
Audiencegeneralresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a homebrewed Switch, a Stremio stream addon URL, and a debrid service for torrent-based addons to actually play.

Use, modify, and distribute freely, including commercially, as long as you keep attribution and license notices.

So what is it?

StreamFin is a video streaming app for homebrewed Nintendo Switch consoles that speaks the Stremio addon protocol. It is a fork of an earlier project called Switchfin, with its original Jellyfin server support replaced by Stremio's system for browsing catalogs and finding streams. The app itself ships with no media and no addons built in: you bring your own Stremio addon URLs, which it asks for the first time you launch it. Once configured, the home screen shows browsable rows of movies and shows pulled from the public Cinemeta catalog, with posters, IMDb ratings, search, favourites, and a continue watching list with resume support. Selecting a title shows details like cast, plot, and runtime, and for series lets you browse seasons and episodes before picking an available stream to play through the MPV video player, with playback controls adapted for a game controller. Setup mainly means placing a plain text configuration file on the SD card before the console starts, listing one or more stream addon URLs, and optionally a catalog addon, a poster rating provider, or a subtitles addon. Multiple stream addons can be listed together, and the app queries all of them at once when you pick something to watch, merging the results and removing duplicates. The README stresses that StreamFin has no built in torrent engine, so torrent based addons like Torrentio only work if they are paired with a paid debrid service that turns torrents into direct playable links. Without one, nothing from those addons will actually play. Custom catalog addons can add their own rows to the home screen, which can be reordered or toggled on and off, and a subtitles addon can be configured to automatically fetch subtitles matching whatever is playing, in addition to any subtitle tracks already embedded in the video file. Building the app from source requires the devkitPro toolchain along with a specific set of Switch portlibs. It is released under the Apache 2.0 license, the same license used by the Switchfin project it was forked from.

Copy-paste prompts

Prompt 1
Help me set up StreamFin on my homebrewed Switch with a streamfin-addon.txt stream addon URL.
Prompt 2
Explain why StreamFin needs a debrid service configured for torrent addons like Torrentio.
Prompt 3
Show me how to add a custom catalog addon so its rows appear on the StreamFin home screen.
Prompt 4
Walk me through building StreamFin.nro from source with devkitPro.

Frequently asked questions

What is streamfin?

A Stremio-protocol streaming client for homebrewed Nintendo Switch, forked from Switchfin, that plays streams from user-supplied addon URLs.

What language is streamfin written in?

Mainly C++. The stack also includes C++, MPV, Borealis.

What license does streamfin use?

Use, modify, and distribute freely, including commercially, as long as you keep attribution and license notices.

How hard is streamfin to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is streamfin for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.