Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/GideonWolfe/Chameleon

🦎 Theme your linux system to match any image
https://github.com/GideonWolfe/Chameleon

linux pywal ricing theming

Last synced: about 2 months ago
JSON representation

🦎 Theme your linux system to match any image

Host: GitHub
URL: https://github.com/GideonWolfe/Chameleon
Owner: GideonWolfe
Created: 2019-07-27T18:39:20.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2023-04-09T23:45:42.000Z (over 1 year ago)
Last Synced: 2024-06-11T11:45:04.633Z (3 months ago)
Topics: linux, pywal, ricing, theming
Language: Python
Homepage:
Size: 3.72 MB
Stars: 170
Watchers: 3
Forks: 9
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Chameleon

![alt-text](/demo.gif)

This script acts as an extension to wal, by taking the generated colors and theming anything that can be themed, all in one script.

If the script detects you have certain programs on your system, it will try to generate themes for them.

The current programs are ones that I use, but feel free to add more and send a PR!

# Examples

![alt-text](https://i.imgur.com/araXbD4.jpg)

Programs that use GTK themes like Thunar and Baobab should just pick up the theme, assuming you have selected the `oomox-xresources-reverse` theme in `lxappearance`. Spotify, Discord, Firefox, and gnuplot are shown here rocking their custom generated themes.

Programs that use Qt themes can also be configured to take themes from GTK, meaning we can theme them as well! The programs must be launched with the `--style gtk2` flag, and you must install and configure [qt5-styleplugins](https://www.archlinux.org/packages/community/x86_64/qt5-styleplugins/).

## Installation

```bash
git clone https://github.com/GideonWolfe/Chameleon/
cd Chameleon
make install
```

## Usage

* `chameleon -i [path to picture] [options for wal]`
* `chameleon -t [wal theme] [options for wal]`

## Configuration

Configuration of `chameleon` is done through the file `$HOME/.config/chameleon/config.yaml`

Here, one can specify options specific to a single program, or even specify custom commands to be run every time you apply a theme.

Most programs will have a `path` attribute which may or may not be necessary depending on your setup. For example, if you were using a cloned, local version of `wal-discord`, one
might want to specify a specific path where `chameleon` can find this specific executable.

If the `path` attribute is not given for a program, it is assumed that the program is located in your `$PATH` and will be run as a standalone command.

## Programs supported
* [oomox](https://github.com/themix-project/oomox) for GTK and Spotify

* [Zathura-Pywal](https://github.com/GideonWolfe/Zathura-Pywal)

* [Gnuplot-Pywal](https://github.com/GideonWolfe/Gnuplot-Pywal)

* [pyWalNeopixels](https://github.com/Paul-Houser/pyWalNeopixels)

* [slickgreeter-pywal](https://github.com/Paul-Houser/slickgreeter-pywal)

* [StartTree](https://github.com/Paul-Houser/StartTree): Dynamic browser startpage

* [ckb-next](https://github.com/ckb-next/ckb-next) for corsair keyboards

* [razer-cli](https://github.com/LoLei/razer-cli) for razer devices

* [telegram-palette-gen](https://github.com/matgua/telegram-palette-gen) for telegram-desktop

* [spicetify](https://github.com/khanhas/spicetify-cli): CSS Customization engine for spotify

* [Pywalfox](https://github.com/Frewacom/Pywalfox) to theme FireFox and DuckDuckGo on the fly

* [pywal-discord](https://github.com/FilipLitwora/pywal-discord) to theme Discord

* [wal-discord](https://github.com/guglicap/wal-discord) to theme Discord

## Planned support

## Notes
To get the most complete theme possible, check out my [dotfiles](https://github.com/GideonWolfe/dots). Here you can find the configurations to get these colors on many other programs, such as rofi, polybar, firefox, and more. Since they update automatically, there was no need to include them in this script.

To apply icon themes, you need one of the icon sets supported by oomox. Change the icons section of the config file to look for the folder your desired icons are in, and change the command to the appropriate variant.

* [gnome-color-icons](https://aur.archlinux.org/packages/gnome-colors-icon-theme/)
* [archdroid icons](https://aur.archlinux.org/packages/archdroid-icon-theme/)
* [Materia icons](https://aur.archlinux.org/packages/materia-theme-git/)

To use the new icon themes added to oomox, you have to create a executable file in ```$HOME/.local/bin``` with a similar naming schema like the example command used for gnome colors icon theme in ```config.yaml```. The content of the executable should be something like:
```
#!/bin/bash
cd /opt/oomox
exec ./plugins/{path to change_color.sh file for your respective icon theme under plugins} "$@"
```
With the above executable created, all you have to do is to give it execute permission by using ```chmod +x``` and use the name of the executable as the command for your icon theme in the ```config.yaml``` file. **Note: Make sure ```$HOME/.local/bin``` is added to your PATH.**

## Upgrade from v1 to v2

Simply delete the old `chameleon` executable at `/usr/local/bin/chameleon`. Now use `chameleon.py` which should be symlinked to `$HOME/.local/bin/chameleon.py`.

`$HOME/.local/bin/` must be on your `$PATH`