Graphical application for generating different color variations of a Oomox (Numix-based), Materia and Arc themes (GTK2, GTK3), Gnome-Colors and Archdroid icons and terminal
Python Shell Makefile Dockerfile
Permalink
Failed to load latest commit information.
colors chore(colors: modern): add 4 materia theme variants Mar 31, 2018
dockerfiles chore(dockerfiles): add ubuntu 18.04 Aug 12, 2018
maintenance_scripts chore: bump version to 1.7 Aug 8, 2018
oomox_gui refactor: import gettext's _ explicitly Aug 12, 2018
packaging chore: bump version to 1.7.0.2 Aug 12, 2018
plugins chore(plugins: oomox): update submodule Aug 14, 2018
po Added Dutch translation (#152) Jun 30, 2018
terminal_templates chore(terminal_templates): import more from https://github.com/protes… Mar 26, 2018
.editorconfig chore(pkgbuild): remove .git from gtk-theme Aug 19, 2017
.flake8 fix(gui: preview): reuse css providers Sep 28, 2017
.gitattributes chore(gitattributes): themes moved to ./plugins/ dir Jan 29, 2018
.gitignore chore(gitignore): ignore mypy cache Jul 31, 2018
.gitmodules feat(plugins, packaging): add arc-theme Aug 8, 2018
.pylintrc refactor: import gettext's _ explicitly Aug 12, 2018
.travis.yml chore(dockerfiles): add ubuntu 18.04 Aug 12, 2018
CREDITS doc(CREDITS): add new oomox contributors Aug 20, 2017
LICENSE * Removed run attribute. (#515) Aug 23, 2016
Makefile chore(Makefile): +DISABLE_PLUGIN_IMPORT_IMAGE Aug 10, 2018
README.md feat(plugins, packaging): add arc-theme Aug 8, 2018
gui.sh chore: bump version to 1.5.0.2 Feb 16, 2018
po.mk fix(po): new module name Mar 6, 2017
screenshot_gui.png doc(readme): reorder screenshots Jul 31, 2018
screenshot_pil.png doc(readme): reorder screenshots Jul 31, 2018

README.md

oomox theme designer

Graphical application for generating different color variations of Oomox (Numix-based), Materia (ex-Flat-Plat) and Arc themes (GTK2, GTK3, Cinnamon, GNOME, Openbox, Xfwm), Gnome-Colors and Archdroid icon themes. Have a hack for HiDPI in gtk2.

Table of contents:

Screenshot GUI

Screenshot image import

Big screenshot with number of generated themes 🔗

Latest Oomox GTK theme screenshots 🔗

Installation

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

Debian, Ubuntu, Linux Mint

For Debian 9+, Ubuntu 17.04+ or Linux Mint 19+ you can download oomox.deb package here: https://github.com/themix-project/oomox/releases

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

Or, if you don't want to install third-party binary package you can build it on your own:

# with docker:
sudo systemctl start docker
sudo ./packaging/ubuntu/docker_ubuntu_package.sh  # sudo is not needed if your user is in docker group

# or directly from ubuntu host if you don't like docker:
./packaging/ubuntu/create_ubuntu_package.sh

For older 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 and Arc themes:

  • 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 locales:
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;
}

Review articles and videos

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