HomeDownloadDocsFAQ Sign in

Frequently Asked Questions

01

How does Eclipse work?

Eclipse is a music player that connects to your own sources. Point it at cloud storage you already run — Plex, Jellyfin, or similar — and it streams your library from there.

It's also addon-driven: install community addons to plug in new music sources without waiting on us to build them.

02

How do I connect TorBox or Real Debrid?

  1. Open eclipsemusic.app/configure and expand Vault Addon.
  2. Pick TorBox or Real Debrid and paste your API key.
  3. In the Debrid Vault section, set the URL to debridvault.elfhosted.com. For the Auth Token, head to Debrid Vault → SettingsAccount settings and mobile access.
  4. Copy the resulting manifest URL.
  5. In the app, go to SettingsCloud StorageAdd ConnectionCloud and paste the URL.
03

What is the Eclipse addon store?

A single place to browse and install every community addon without leaving the app.

Open eclipsemusic.app/addons, copy the addon-store manifest URL, then in the app: SettingsCloud StorageAdd ConnectionCloud → paste. New addons show up automatically as they're added.

04

How do I install a community addon?

Pick an addon at eclipsemusic.app/addons and generate its manifest URL. Then in the app: SettingsCloud StorageAdd ConnectionAddons.

05

Why can't everything play through Debrid?

Music doesn't have the cache depth or indexer quality that makes a Stremio-style experience seamless for movies and TV. We're not there yet for every track.

For Debrid music today, use LibraryCloudDebrid, or search for a specific track in the Search tab.

06

Why isn't something playing?

Open your addon management and confirm a primary playback source is selected and your addons are configured correctly.

If it's still broken, open a ticket in our Discord and we'll take a look.

07

Advanced vs Simple mode?

Advanced lets you pick a provider for each search in the Search tab.

Simple hides the extra controls — use it when you have one main addon handling everything.

Still stuck?

Open a Ticket