Developer
Log in

Theming

"Sharing: .velumtheme"

A .velumtheme is one file that holds a theme and everything a gallery or the theme picker shows for it. Double-click it, or drag it onto Studio, to install it.

Making one

In Theme Studio, Export .velumtheme… writes the bundle, with Theme Studio's preview of the theme and an icon made from it. Plain .json themes keep working beside bundles; a bundle adds what a single JSON file can't carry.

What's inside

A .velumtheme is a zip, in the Velum file container:

File What it is
manifest.json What the file is, and the SHA-256 and size of every other file in it
theme.json The same velum-theme/1 file as in your themes folder
preview.png 1280 × 800, Theme Studio's preview of the theme, for the gallery
icon.png 256 × 256, for the theme picker
fonts/ Optional .ttf or .otf files; LICENSES/ is required with them
images/ Optional .png or .jpg pictures the theme uses
LICENSES/ .txt or .md license text for anything bundled
signature.ed25519 Optional: a signature over the manifest

Here is the manifest of Studio Dark, one of the two built-in themes, which ship as bundles read by the same code as yours:

JSONstudio-dark.velumtheme › manifest.json
{
  "type": "velum.theme",
  "format": 1,
  "created": "2026-11-12T04:06:05.706578592Z",
  "app": "0.1.0",
  "name": "Studio Dark",
  "description": "Velum Studio's built-in studio-dark theme",
  "thumbnail": "preview.png",
  "contents": [
    {
      "path": "theme.json",
      "sha256": "7f75bd5651250010725f466eac124e5c3aaa93f8d97a3bfb3e707f41d3f4bee3",
      "bytes": 2409
    },
    {
      "path": "icon.png",
      "sha256": "882dd7b5a0b5b6cd80b82afbab8d01d537c6017acefb76474ebe839922a4f42e",
      "bytes": 7895
    },
    {
      "path": "preview.png",
      "sha256": "fcd775807ce71f150ef4f2bd5aba3bf5ace0ad997e48261288bec7a5ec3d3d60",
      "bytes": 130656
    }
  ]
}

Rules

  • A theme contains no code. Tokens, pictures and fonts only; any other file is refused.
  • Every file is listed in the manifest with its SHA-256 and size, so a damaged or changed file is caught when it's opened, before anything in it is used.
  • Size limits: at most 512 files, 20 MB unpacked in total, and 20 MB for any one file.
  • Fonts a theme brings are used by Studio only and are never installed on the computer. They must come with a license that allows redistribution, in LICENSES/.

Installing

Double-click a .velumtheme, or drag it onto Studio. It's unpacked into Studio's themes/<id>/ folder, and the version it replaces is kept so it can be rolled back. If Studio is already running, the file goes to that Studio rather than opening a second one.

Signing

A bundle can carry signature.ed25519, the same scheme every Velum file and plugin uses:

JSON
{"key": "<Ed25519 public key, 64 hex digits>", "signature": "<128 hex digits>"}

The signature is Ed25519 over the exact bytes of manifest.json. Because the manifest holds the SHA-256 of every other file, one signature covers the whole bundle. Studio shows whether a file is unsigned, signed by its maker, or signed by the publisher, which is how themes listed in the public gallery will be marked. A signature that's present but doesn't verify makes Studio refuse the file.

to open · ↑ ↓ to move · Esc to close