---
name: "macchina"
section: "7"
platform: "linux"
package: "macchina"
version: "6.4.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/macchina/7"
---

# macchina(7)

theming.

## NAME

macchina - theming.

## SYNOPSIS

**$XDG\_CONFIG\_HOME/macchina/themes**, **~/.config/macchina/themes**.

## DESCRIPTION

Themes are your interface to customizing all visual aspects of macchina. The following manpage covers everything you need to know to design your own theme.

## GENERAL OPTIONS

General options should be set at the top of the theme's configuration file, as they do not belong to any particular section.

### spacing

Defines the amount of spacing to leave between the separator and the content besides it, e.g.:

spacing = 1

### padding

Defines the amount of padding to leave between the content and its surroundings, e.g.:

padding = 0

### hide\_ascii

Disables the rendering of ASCII, whether it be built-in or custom, e.g.:

hide\_ascii = false

### prefer\_small\_ascii

For built-in ASCII, always use smaller variants, e.g.:

prefer\_small\_ascii = true

### separator

Defines the glyph to use for the separator, e.g.:

separator = "--\>"

### key\_color

Defines the color of the keys.

Accepts hexadecimal values:

color = "#00FF00"

Indexed values:

color = "046"

Predefined color names, where casing is insensitive:

color = "Green"

### separator\_color

Defines the color of the separator.

Accepts hexadecimal values:

color = "#00FF00"

Indexed values:

color = "046"

Predefined color names, where casing is insensitive:

color = "Green"

## PALETTE SECTION

This section, noted **\[palette\]**, offers a visual component that displays and represents the active colorscheme of your terminal emulator.

### type

Defines the color set to use for the palette, with possible values of "Dark", "Light", "Full" (case-sensitive).

### glyph

Defines the glyph to use for the palette, e.g.:

glyph = "() "

You should append a space to leave some room between the glyphs.

### visible

Defines whether to show or hide the palette, e.g.:

visible = true

## BAR SECTION

This section, noted **\[bar\]**, replaces data that ranges from 0-100% with bars.

### glyph

Defines the glyph to use for all bars, e.g.:

glyph = "o"

### symbol\_open

Defines the character to use for opening delimiters. Be sure

to surround the value with single quotes and not double quotes, e.g.:

symbol\_open = '('

### symbol\_close

Defines the character to use for closing delimiters. Be sure to surround the value with single quotes and not double quotes, e.g.:

symbol\_close = ')'

### visible

Defines whether to show or hide the bars, e.g.:

visible = true

### hide\_delimiters

Defines whether to show or hide the bars delimiters, i.e. the characters that surround the bars themselves, e.g.:

hide\_delimiters = false

## BOX SECTION

The section, noted **\[box\]**, offers a box component which is rendered to surround your system information.

### title

Defines the title of the box, e.g.:

title = "Hydrogen"

### border

Defines the type of border to use for the box, with possible values of "plain", "thick", "rounded" or "double".

### visible

Defines whether to show or hide the box, e.g.:

visible = true

## BOX.INNER\_MARGIN SECTION

### x

Defines the horizontal margin to leave between the content and the box, e.g.:

x = 2

### y

Defines the vertical margin to leave between the content and the box, e.g.:

y = 1

## CUSTOM\_ASCII SECTION

This section, noted **\[custom\_ascii\]**, allows you to specify your own ASCII art. ANSI escape sequences are supported.

### color

Defines the color of the ASCII.

Accepts hexadecimal values:

color = "#00FF00"

Indexed values:

color = "046"

Predefined color names (case-insensitive):

color = "Green"

### path

Defines the path to a file on your filesystem which contains the ASCII art you want to display, e.g.:

path = "~/ascii/arch\_linux"

## RANDOMIZE SECTION

This section, noted **\[randomize\]**, is used to randomize color selection.

### key\_color

Defines whether to randomize the color of the keys, e.g.:

key\_color = true

### separator\_color

Defines whether to randomize the color of the separator, e.g.:

separator\_color = true

### pool

Defines the pool of colors from which to pick a random color, with possible values of "hexadecimal", "indexed" or "base" (case-insensitive).

• If "hexadecimal" is specified, you'll get a random color ranging

from #000000 to #FFFFFF

• If "indexed" is specified, you'll get a random color ranging from 0 to 255

• If "base" is specified, you'll see a random color from the following set of

colors: "black", "white", "red", "green", "blue", "yellow", "magenta" and "cyan".

## KEYS SECTION

This section, noted **\[keys\]**, allows you to modify the text of each key.

For example, the "Processor" readout, which by default shows up as "CPU" in macchina's output, can be renamed to whatever you like by setting the "cpu" option.

### host

Defines the text of the Host readout, e.g.:

host = "Host"

### kernel

Defines the text of the Kernel readout, e.g.:

kernel = "Kernel"

### os

Defines the text of the OperatingSystem readout, e.g.:

os = "OS"

### machine

Defines the text of the Machine readout, e.g.:

machine= "Machine"

### de

Defines the text of the DesktopEnvironment readout, e.g.:

de = "DE"

### wm

Defines the text of the WindowManager readout, e.g.:

wm = "WM"

### distro

Defines the text of the Distribution readout, e.g.:

distro = "Distro"

### terminal

Defines the text of the Terminal readout, e.g.:

terminal = "Term"

### shell

Defines the text of the Shell readout, e.g.:

shell = "Shell"

### packages

Defines the text of the Packages readout, e.g.:

packages = "Packages"

### uptime

Defines the text of the Uptime readout, e.g.:

uptime = "Uptime"

### local\_ip

Defines the text of the LocalIP readout, e.g.:

local\_ip = "Local IP"

### memory

Defines the text of the Memory readout, e.g.:

memory = "Memory"

### battery

Defines the text of the Battery readout, e.g.:

battery = "Battery"

### backlight

Defines the text of the Backlight readout, e.g.:

backlight = "Brightness"

### resolution

Defines the text of the Resolution readout, e.g.:

resolution = "Resolution"

### cpu

Defines the text of the Processor readout, e.g.:

cpu = "CPU"

### cpu\_load

Defines the text of the ProcessorLoad readout, e.g.:

cpu\_load = "CPU %"

### gpu

Defines the text of the GPU readout(s), e.g.:

gpu = "GPU"

### disk\_space

Defines the text of the disk space readout, e.g.:

disk\_space = "Disk Space"

## SEE ALSO

[macchina(1)](/macchina/1.md)