Velum Studio Gallery

Developer guide

Submit to the Velum gallery

Anyone can submit themes, plugins, extensions and presets. We try every one, and list the ones that follow the Velum design guidelines in Studio's Gallery with a “Made for Velum” mark and one-click install.

The easy way, for themes and presets: export your file from Studio (Theme Studio › Export .velumtheme…, or Export for a preset) and send it to development@legendremedia.com with the name it should be listed under and one line about it. We run every check below, sign it, and list it with you as the publisher, or send you exact notes. A one-click Submit to the gallery inside Studio is on its way. The developer route below (your own account and signing key) is for plugin developers and anyone who wants to manage their own submissions.

What you can submit

KindFileWhat it is
Theme.velumthemeEvery color, font and corner of Studio. Make one in Theme Studio (Settings › Appearance › New theme) and export it.
Overlay or preset.velumpresetAn overlay, a scene, a Dynamic Source pack, an automation or a source group, exported from Studio.
Plugin or extension.velumpluginNew sources inside Studio today, built on the plugin ABI; filters, transitions, outputs, docks and automation steps are planned.

Scene collections, settings profiles and backups are personal, so the gallery doesn't list them.

How it works

  1. Make a developer account on Velum Connect with your email. It's a Velum account, separate from any streaming platform's sign-in.
  2. Register your signing key. Make an Ed25519 key on your own computer and register only its public half. Your private key never leaves your computer.
  3. Sign your file: velum-bundle sign --key your-key.pem my-theme.velumtheme
  4. Upload it. Automated checks run at once (below). If one fails, you get the reason in plain words straight away.
  5. A person reviews it against the design guidelines, usually within five working days: approved, changes requested with notes, or declined with the reason.
  6. Approved, it's countersigned by Legendre Media Inc. and listed: we add our own signature over the file and over yours. It confirms your signature and the reviewed contents; it never replaces or cancels yours. Studio shows “Made for Velum” and checks both signatures before installing.

The automated checks

CheckWhat it looks for
FormatA Velum file that opens cleanly, every file matching its fingerprint, within the size limits.
SignatureSigned with the key registered to your account.
ManifestA name (1 to 60 characters, not in all caps), a description, and a 1280 × 800 preview.png (a theme needs one; Theme Studio makes it).
SizeThemes up to 20 MB; presets and plugins up to 500 MB.
ContentsNo code where it doesn't belong: a theme or preset never carries a program, and a plugin's code lives only in bin/<platform>/, built for that platform. Every file is also scanned for malware.
PermissionsA plugin asks only for permissions Studio knows (reading chat, changing scenes, the network, the camera and so on), each shown to people in plain words before they install.
DesignA theme passes Studio's own contrast checks: every text and mark readable against what it sits on, and status colors (LIVE red, warnings, success) kept apart from the accent. A web dock reads every color from the theme instead of writing its own.
VersionA version number (major.minor.patch) newer than any you've listed before.

What review looks for

Updates, and pulling a listing

An update is a new upload of the same item with a higher version; it goes through the same checks and a lighter review. Studio offers it as an update to everyone who installed yours from the gallery.

We can pull a listing, and revoke files that cause harm (malware, someone else's work, a file that damages collections). Studio refuses to install a revoked file and tells anyone who has it. We'll always tell you why.

Price and license

Everything in the gallery is free to install for now. Your listing shows the license you choose.

Your privacy, and theirs

Your account holds your email (never shown), the name you publish under, an optional website and your public keys. Studio fetches the gallery without sending anything about who is browsing or what they've installed.