Private Music Addon for Stremio

Musiq is a self-hosted Node.js Stremio addon that indexes and streams only your locally uploaded music and music videos — no external library dependency.

localhost:7000 • token-protected • self-hosted

Core Features

Local-Only Media

Only scans and streams files from your ./uploads directory.

Token Security

All external access is protected via per-install access token.

Artist Channels

Artists behave like playable channels with filtered media lists.

Auto Library Indexing

Recursively scans, validates, and caches playable media items.

Architecture Overview

Server Design

Single Express server on port 7000 handling dashboard, API, and Stremio SDK endpoints.

Library Pipeline

Upload → Normalize → Scan → Metadata Enrichment → Stream Index

Data Model

Albums = series
Artists = channel metas
Tracks/videos = playable stream items

Install

Add the addon to Stremio using your tokenized manifest URL:

http://localhost:7000/manifest.json?token=YOUR_TOKEN

Rules

• Install Musiq last to appear at bottom of catalog
• Requires local server running on PC
• LAN access allowed without token
• External/VPN requires token

API Endpoints

GET /manifest.json
GET /catalog/:type/:id.json
GET /meta/:type/:id.json
GET /stream/:id
POST /upload
POST /rescan
GET /

Security Model

Local IPs bypass auth.
External requests require token validation.
Streams are always file-verified before exposure.