instantTHEMES

Theming for instantOS

instantTHEMES

Documentation

Features

A single theme package for most parts of the OS

• Gtk theme
• Icon theme
• Qt theme
• Cursor
• Fonts

Light/Dark variants with automatic switching between them

imosid integration for theming dotfiles

Usage

Theme structure

Themes consist of a folder or archive that contains all information and assets for the theme.

themename
    theme.toml
    dotfiles
        light
            Xresources
            dunstrc
            ...
        dark
            ...
        multi
            ...
    assets
        fonts
            ...
        themes
            Arc
            ...
        wallpapers
            ...
        icons
            Papirus
            ...

Example config

name = "instantOS"
version = 0
defaultvariant = "light"
dependencies = ["materia-gtk-theme", "papirus-icon-theme", "instantcursors"]

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

[font]
name = "Inter"
size = 12

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

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

[qt]
[qt.light]
theme = "kvantum"
[qt.dark]
theme = "kvanum-dark"

kvantum = "Materia"

Planned features

• QT theme
• QT icons
• GTK 4 theme
• Wallpaper config
• dark/light gnome spec support

---

Dependencies

bash dasel git curl imosid atool

instantOS is still in early beta, contributions always welcome