Formato de tema do modo console (.heronite-theme.json)

Um tema do modo console é um único arquivo JSON, <id>.heronite-theme.json. O jeito mais fácil de criar um é em Configurações → Modo console e depois Exportar…. Publique o seu nas Discussões para outras pessoas importarem.

Regras do arquivo

As chaves usam camelCase.
Todos os campos são opcionais. Um campo que falta assume o valor do tema Clássico.
Um valor desconhecido volta ao padrão daquele campo, e chaves desconhecidas são mantidas, então um tema feito por um Heronite mais novo ainda abre.
format é a versão do formato do arquivo, hoje 1. Um tema com format maior é recusado na importação.
A imagem de fundo vai dentro do arquivo (PNG, JPEG ou WebP, no máximo 16 MiB), então você compartilha um arquivo só.

Exemplo de arquivo de tema

{
  "format": 1,
  "id": "my-couch",
  "name": "My couch",
  "author": "you",
  "description": "Wide tiles, green focus",
  "version": "1.0",
  "tabs": [
    { "name": "Home", "layout": "xbox", "source": "all" },
    { "name": "Installed", "layout": "grid", "source": "installed" },
    { "name": "Retro", "layout": "wheel", "source": "emulated" }
  ],
  "tiles": { "shape": "landscape", "size": "l", "corners": "soft", "badges": "all" },
  "background": { "source": "art", "dim": 40, "blur": 10 },
  "interface": { "accent": "green", "font": "system", "scale": 110, "clock": "24h" },
  "controls": { "glyphs": "auto", "swapAb": false },
  "gamePage": "hero",
  "menu": { "style": "sidebar", "side": "left" }
}

Campos que você pode definir

Sobre o tema

Campo	Valor
`format`	`1`
`id`	Letras minúsculas, dígitos e `-`
`name`, `author`, `description`, `version`	Texto

`tabs`

Até quatro abas, trocadas com LB / RB. Cada uma é { "name", "layout", "source" }.

layout: shelves, spotlight, cinema, dashboard, grid, wheel, carousel ou xbox (o layout Series X).
source (quais jogos a aba mostra):
- all, installed, not-installed, favourites, pc, emulated
- status:<id>, category:<nome>, store:<nome>, platform:<nome>

`shelves`

As linhas do layout Prateleiras. Cada uma é { "kind", "on", "title" }.

kind:
- recent, favourites, installed, added, backlog-short, random, forgotten, statuses
- Um grupo: status:<id>, store:<nome>, platform:<nome>, genre:<nome>, category:<nome>
on: true ou false

shelfLimit define quantos jogos uma prateleira mostra.

`nav`

Campo	Valores
`startOn`	`first`, `last`
`aButton`	`details` (abre a página do jogo), `play`
`wrap`	`true`, `false`

`hero` (o jogo grande no topo)

Campo	Valores
`title`	`text`, `logo`
`size`	`small`, `medium`, `large`
`factStyle`	`line`, `chips`
`align`	`left`, `center`
`facts`, `overview`, `stats`	O que mostrar

`tiles`

Campo	Valores
`shape`	`portrait`, `landscape`, `square`
`size`	`s`, `m`, `l`, `xl`
`titles`	`never`, `focused`, `always`, `bar`
`badges`	`off`, `running`, `all`
`corners`	`square`, `soft`, `round`
`focus`	`ring`, `glow`, `lift`, `underline`
`greyUninstalled`, `header`	`true`, `false`

`background`

Campo	Valores
`source`	`art`, `cover` (desfocada), `screenshots`, `game-colour`, `solid`, `image`
`dim`	`0` a `90`
`blur`	`0` a `40`
`motion`	`still`, `drift`
`image`	A imagem, como uma URL `data:` (escrita pelo Exportar)

`interface`

Campo	Valores
`accent`	`white`, `game` (a cor da capa), `ice`, `green`, `amber`, `pink`, `violet` ou `#rrggbb`
`font`	`heronite`, `cabin`, `rubik`, `system`, `mono`
`scale`	`80` a `140` (porcentagem)
`clock`	`24h`, `12h`, `off`
`motion`	`full`, `reduced`, `off`
`headings`	`normal`, `spaced`
`tabBar`	`top`, `bottom`, `title`, `names`
`date`, `label`, `statusIcons`	O que mostrar

`colors`

background, panel, text, muted, focusText e on, como #rrggbb.

`controls`

Campo	Valores
`glyphs`	`auto`, `xbox`, `playstation`, `nintendo`, `deck`, `keyboard`
`hints`	`always`, `auto`, `off`
`swapAb`	`true` para trocar A e B
`sounds`	Sons da interface

`gamePage`

classic, hero, tabs ou sheet.

`menu`

Campo	Valores
`style`	`sidebar`, `grid`, `dock`, `rail`
`side`	`left`, `right`
`items`	Uma lista de `{ "item", "on" }`: quais entradas o menu tem, em ordem

`layouts`

Opções de layouts específicos:

gridPanel: title ou right
wheelItems: name ou logo
spotlightActions: full ou play
jumpLetters, spotlightCards, carouselReflect, xboxGroups
dashboard: week, downloads, random, journal, shortcuts

O que um tema não inclui

O arquivo deixa de fora o que acontece quando um controle conecta, como o Heronite abre e o que ele faz quando fica parado. Essas são configurações do seu PC, não do tema.

Regras do arquivo

Exemplo de arquivo de tema

Campos que você pode definir

Sobre o tema

tabs

shelves

nav

hero (o jogo grande no topo)

tiles

background

interface

colors

controls

gamePage

menu

layouts