Skip to content

Theme manifest

manifest.json describes the theme and everything it changes. Only id, name and api are required.

Field Required Description
id yes Unique id, also the folder name.
name yes Name shown in Settings.
api yes Theme format version. The current one is 1.
version no Shown in Settings, like "1.0.0".
author no Shown in Settings.
description no Shown in Settings.
icon no Image shown next to the theme in Settings and in the store. Without one, the store draws the theme icon in the theme’s text color over its tinted background.
screenshots no Images shown in the theme’s info: paths in the theme or https:// links.
min_version no Oldest Nari version the theme works with, like "1.2.0". Older versions keep the default look.
colors no The theme’s colors. See Colors.
mode no "light" (default) or "dark". Decides the palette Nari builds when colors follow the album art.
adapt no "allow" (default) lets the user’s Colors adapt to song setting decide, "off" keeps the theme’s colors, "force" always follows the album art.
icons_colored no true keeps the icons’ own colors instead of tinting them. See Icons.
background no See Backgrounds.
font no A font file, or one per weight. See Fonts and shape.
shape no How round and glowy panels are. See Fonts and shape.

Installed themes can’t use the dark id, it belongs to the theme that comes with Nari.