Lumen
Download

Addons

Add catalogs, sources and subtitles to Lumen. Choose the addons you trust and install them with a link.

The Addons screen in Lumen: a field to paste a manifest link with an Install button, a directory field, and the two installed addons, Cinemeta and OpenSubtitles v3, each with the resources it provides.

What an addon provides

A manifest lists what the service can answer. Lumen asks it for that and nothing else.

  • Catalogs The shelves on your home board and the tabs in Discover.

  • Metadata Titles, artwork, descriptions, cast and episode lists.

  • Streams The sources listed under a title when you open it.

  • Subtitles Subtitle files, matched to the file you are watching.

An addon may provide one of these or several. A directory is an addon that lists other addons instead of content.

Included addons

Cinemeta for catalogs and metadata. OpenSubtitles for subtitles. No API keys needed.

  • Cinemeta

    Catalogs and metadata for movies and series

    • catalog
    • meta
    • addon_catalog

  • OpenSubtitles v3

    Subtitles, matched to your file

    • subtitles

Lumen ships no content sources, no scrapers and no addon list. What plays is decided by the addons you install. Restore default addons brings these two back if you remove them.

Addons are yours to choose: install any addon link or directory you trust.

Installing an addon

Add an addon by link, or browse a directory you trust. Review what it provides before installing.

The field on the Addons screenhttps://…/manifest.json or lumen://…

  1. Paste the manifest link

    Open Addons in the app and paste the addon's manifest URL. Lumen reads the manifest and shows what the addon provides before you confirm.

  2. Or click a lumen:// link

    Addon pages can offer a link that opens Lumen with the install screen already filled in, so nothing has to be copied by hand.

  3. Or add a directory you trust

    A directory is an addon that lists others. Lumen ships none; if you add one, its entries install with the same manifest-first confirmation.

Managing addons

Every installed addon has a card in the app, and nothing about it is hidden from you.

  • Its catalogs are listed, so you can see exactly what it adds to the home board.

  • A health indicator shows whether the addon is answering, and how quickly.

  • A configure button appears when the addon offers its own settings page.

  • Drag to prioritise: the order decides which addon answers first.

  • Hide a catalog's shelf from the home board without removing the addon.

  • Turn an addon off, or remove it. The choice syncs to your other devices.

For addon authors

Lumen understands the same manifest, catalog, meta, stream and subtitle resources as the rest of the ecosystem.

Install link scheme
lumen://<host>/manifest.json
For an addon at example.addon
lumen://example.addon/manifest.json

Lumen replaces the scheme with https and opens the install screen with that manifest. On Windows the scheme is registered for the current user on first start; on Android the app handles it.