Skip to content

instantTHEMES ​

DANGER

DEPRECATED
instantTHEMES is no longer supported and has been replaced by ins dot and ins settings. This documentation is kept for archival purposes only.

Features ​

instantOS uses a program called instantTHEMES to theme the system. The goal of instantTHEMES is to provide a simple way to create themes that look coherent across the entire system.

Configure many parts of the OS ​

A theme can declaratively theme the following system components

  • Mouse Cursor
  • GTK
  • Icon theme
  • Fonts
  • QT

Extensible ​

instantTHEMES integrates with imosid which allows including theming configuration for arbitrary programs, all without messing with user configuration.

Simple workflow ​

Themes are special packages that can be shared easily and installed with a single command. They include everything instantTHEMES needs to install and apply all parts of the theme.

Apply/switch themes ​

bash
instantthemes apply themename

You can list all available themes with:

bash
instantthemes list

Dark/light mode ​

Creating themes ​

TODO

Advanced command-line usage ​

Querying ​

bash
instantthemes query query_expression

This executes a dasel query on the current theme and puts the results in stdout. You can read more about dasel at https://daseldocs.tomwright.me/selectors/introduction. The dasel query expression is optional. If no expression is passed, the whole theme config file is output instead.

Example:

~  instantthemes query
defaultvariant = "light"
dependencies = ["materia-gtk-theme", "papirus-icon-theme", "instantcursors", "inter-font"]
name = "instantOS"
version = 0

[colors]
  accent = "#88B2F6"
  background = "#121212"

[cursor]
  size = 16
  theme = "elementary-instantos"

[font]
  name = "Inter"
  size = 12

[gtk]

  [gtk.dark]
    theme = "Materia-dark"

  [gtk.light]
    theme = "Materia"

[icons]
  dark = "Papirus-Dark"
  light = "Papirus"

[qt]

  [qt.dark]
    kvantum = "Materia"
    theme = "kvantum-dark"

  [qt.light]
    theme = "kvantum"
~ 

An example query executed on the same theme:

~  instantthemes query qt.dark
kvantum = "Materia"
theme = "kvantum-dark"
~ 