oomox theme designer

Graphical application for generating different color variations of a Numix-based and Materia (ex-Flat-Plat) themes (GTK2, GTK3), Gnome-Colors and Archdroid icon themes.

Installation:

Arch Linux, Manjaro
CentOS, Fedora, Mageia
Slackware
Ubuntu
Other distributions
Flatpak

Arch Linux:

Install

pikaur -S oomox-git

AUR helpers are not officialy supported, so you can also install it manually from either rolling-release or stable PKGBUILD.

Open the GUI

oomox-gui

CentOS, Fedora, Mageia

Oomox can be installed by using a third party COPR repository:

sudo dnf copr enable tcg/themes
sudo dnf install oomox

Slackware

There is a slackbuild: https://slackbuilds.org/repository/14.2/desktop/oomox/

Ubuntu

For Ubuntu 17.04+ you can download oomox.deb package here: https://github.com/themix-project/oomox/releases

sudo dpkg -i ./oomox.deb
sudo apt install -f

For older Ubuntu releases install the dependencies manually and next follow general installation instructions below.

Other distributions:

Prerequisites

For GUI app itself:

python3-gobject
gtk3>=3.18
gdk-pixbuf2
xorg-xrdb - optional, for xresources themes

For plugins:

Oomox theme:

sassc>=3.4
rsvg-convert from librsvg
glib-compile-schemas from glib2
gdk-pixbuf2
bc
sed
find
grep

Materia theme:

sassc>=3.4
glib-compile-schemas from glib2
gdk-pixbuf2
bc
sed
find
grep
optipng
parallel
inkscape
gtk2-engine-murrine

Gnome-Colors icons:

bc
sed
find
grep
rsvg-convert from librsvg
imagemagick
breeze-icons - optional, to provide more fallbacks

Archdroid icons:

sed
find
breeze-icons - optional, to provide more fallbacks

Spotify theme:

polkit or gksu
zip
bc
grep

Import colors from images:

python3 PIL or Pillow

Installation

git clone https://github.com/themix-project/oomox.git --recursive
cd oomox
# if you need to generate French locale:
make -f po.mk install

Running

./gui.sh

After exporting a theme select the generated theme (oomox-YOUR-THEME-NAME) in your appearance config tool (for example, lxappearance or gnome-tweak-tool).

If your prefer CLI interface, refer to change_color.sh scripts inside ./plugins/.

Spotify:

Spotify theme can be also exported from GUI, but if you prefer commandline interface:

./plugins/oomoxify/oomoxify.sh ./colors/gnome-colors/shiki-noble

Also you can normalize font weight with -w argument, see -h for usage.

Spotify theme settings are backed up to ~/.config/oomox/spotify_backup. To undo the changes made by oomoxify, these files can be copied back to their original location /usr/share/spotify/Apps. Spotify can also be reinstalled, which will reset these files as well.

Using with tiling WMs:

To resolve borders/shadow problem in tiling window managers create/append to ~/.config/gtk-3.0/gtk.css:

.window-frame, .window-frame:backdrop {
    box-shadow: 0 0 0 black;
    border-style: none;
    margin: 0;
    border-radius: 0;
}
.titlebar {
    border-radius: 0;
}
window decoration {
    margin: 0;
    border: 0;
}

Flatpak

You can build and run the latest application version in any distribution with flatpak available with the following commands:

cd ./packaging/flatpak/
./flatpak-builder-build.sh
./flatpak-builder-run.sh

WARNING! Flatpak build scripts are not officially supported since it unstable before Flatpak will reach version 1.0. Please use with caution/be prepared for bugs.

Review articles

To learn more about using the application you can check these articles:

Demo video

One of the users, Spatry, made this cool demo video:

https://www.youtube.com/watch?v=Dh5TuIYQ6jo

ohsevin / oomox Goto Github PK

oomox's Introduction