mondo is a great tool to manage and create themes and other settings for programs that uses configuration files.
If you are using Arch linux, you can install the mondo-generator package from AUR.
Or follow the instructions below to install from source:
(configure the installation destination in the Makefile, if needed)
$ git clone https://github.com/budlabs/mondo.git
$ cd mondo
# make install
$ mondo -v
mondo - version: 0.121
updated: 2019-01-16 by budRich
mondo get VARIABLE
mondo --new|-n NAME
mondo --apply|-a THEME
mondo [--force|-f] --generate|-g THEME|all
mondo [--force|-f] --update|-u GENERATOR [THEME]
mondo --list|-l theme|var|icon|gtk|cursor
mondo --template|-t FILE|[NAME FILE]
mondo --call|-c FUNCTION [THEME]
mondo --help|-h
mondo --version|-v
mondo applies variables defined in themefiles to
templates defined in generators. mondo executes
userdefined scripts before any theme is applied, after each
theme is applies and after all themes are applied. It can
also execute a script after each theme is generated.
--new|-n NAME
Creates a new theme named NAME inside
MONDO_DIR/themes.
--apply|-a THEME
Apply THEME.
--force|-f
When this flag is set, the --update and --generate
options will overwrite any existing files when processing
themes.
--generate|-g all
Generate THEME. If -f is used, any existing generated
files will get overwritten. If all is the argument, all
themes will get generated.
--update|-u GENERATOR
Update GENERATOR. This will update all themes, but only for
the given GENERATOR. If -f is used, any existing generated
files will get overwritten. If the last argument is the name
of an existing theme, only that theme will get generated.
--list|-l cursor
Prints a list about the argument to stdout.
--template|-t FILE
Create a new generator. If the last argument is a path to
an existing file, that file will be used to create the
template (it will copy the file to _mondo-template, and
add the path to the target variable in _mondo-settings).
If a path is the only argument, the filename without
extension and leading dot will be used as the name for the
generator.
--call|-c FUNCTION
Can be used to test the color functions,
(mix,lighter,darker,more,less) from the commandline.
$ mondo --call "mix #FFFFFF #000000 0.6"
#666666
If the last argument is the name of an existing theme, the variables of that theme will be available, otherwise the variables of the last applied theme is available.
--help|-h
Show help and exit.
--version|-v
Show version and exit.
With mondo you can have several small theme files that might look something like this:
MONDO_DIR/themes/example
! example theme
background #FFFFD8
background-alt %%more background 0.12%%
foreground #988d6d
comment %%mix background foreground 0.524%%
red #CD5C5C
green #8EAE71
blue #0287c8
yellow #CDFFCC
cyan #8FCCCC
magenta #8888CC
highlight magenta
font Hack 12
It is really easy to create custom templates and actions (scripts) that will use the theme files.
An example of how the theme above could be:
- apply values to polybar, i3, xresources
- execute a script in which polybar, i3, and xrdb is reloaded
See the wiki for a more details on how to use mondo.
Added default to $XDG_CONFIG_DIR, fixes issue [#14].
Major refactoring to make use of the bashbud framework.
bashbud: https://github.com/budlabs/bashbud
Added some color manipulation functions that can be used both in themes and templates and the commandline:
MONDO_DIR/themes/muh-theme
bg #FFFFFF
fg #000000
red #FF0000
comment %%mix bg fg 0.6%%
darkred %%darker red 0.465%%
bg2 %%less bg 0.33%%
green %%more #00FF00 0.3%%
less and more works like this:
First mondo determines whether target color is dark
or light. If the color is light and the command is
more, the result will be more light (same results
as if the command was lighter). If the color is dark
and the command is more, the result will be more
dark (same results as if the command was darker).
It is also possible to use the functions on the
commandline:
mondo --call|-c FUNCTION [THEME]
$ mondo --call "mix #FFFFFF #000000 0.6"
#666666
If the last argument is the name of an existing theme, the variables of that theme will be available:
$ mondo --call "mix #FFFFFF darkred 0.123" muh-theme
#F0DFDF
A new setting is now available in template-setting
files: colorformat. If set, all expanded variables in
affected template will have that format.
MONDO_DIR/generator/muh-generator/_mondo-settings
# uncomment the colorformat below to use HEX (00-FF)
# This is how fully opaque "white" would look like
# with this format: #FFFFFFFF
# colorformat="#%R%G%B%A"
# uncomment the colorformat below to use RGB (0-255)
# This is how fully opaque "white" would look like
# with this format: 255,255,255,255
# colorformat="%r,%g,%b,%a"
Various small bugfixes, f.i. to use the Inject template
setting, it's value must be either True or true .
When using the --list command, variables with values
containing whitespace, now gets printed properly.
Mondo makes ricing so fun and easy, that it might cause addiction.
mondo is licensed with the MIT license