67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
# Shchemes
|
|
Automatically theming your apps with the power of the shell.
|
|
|
|
## Why
|
|
Shchemes will support any theme format, app, or scheme you want, with a little leg work.
|
|
It is less than 300 lines. It can go anywhere bash will, and will comfortably live in
|
|
your dotfiles. Compare with [tinty](https://github.com/tinted-theming/tinty).
|
|
|
|
## Installation
|
|
Clone the repo with submodules
|
|
```
|
|
git clone --recurse-submodules https://git.sys42.net/dakedres/shchemes.git
|
|
```
|
|
Symlink to it somewhere in your PATH. Pick your poison
|
|
```sh
|
|
ln -s $PWD/shchemes ~/bin/shchemes
|
|
ln -s $PWD/shchemes ~/.local/bin/shchemes
|
|
```
|
|
|
|
## Usage
|
|
Install your favorite base16 themes from tinted-themes:
|
|
```sh
|
|
shchemes install_tinted_scheme --scheme=monokai
|
|
```
|
|
You can also exclude --scheme from any of these commands and it will read from your `SCHEME` environment variable.
|
|
|
|
Append your theme to a config
|
|
```sh
|
|
shchemes --scheme=base16:monokai create_theme kitty >> ~/.config/kitty/kitty.conf
|
|
```
|
|
|
|
If you want to be able to hotswap themes, you'll probably need to use injection.
|
|
```sh
|
|
echo "#START SHCHEMES BLOCK : shchemes create_theme kitty" >> ~/.config/kitty/kitty.conf # Add the comment for the injection block
|
|
shchemes --scheme=base16:monokai inject ~/.config/kitty/kitty.conf # Inject the theme
|
|
```
|
|
|
|
Here's an example script:
|
|
```bash
|
|
export SCHEME="base16:horizon-terminal-dark"
|
|
|
|
shchemes install_tinted_scheme
|
|
|
|
shchemes inject "${HOME}/.config/kitty/kitty.conf"
|
|
shchemes inject "$HOME/.config/rofi/config.rasi"
|
|
|
|
bspwm_theme="$HOME/.config/bspwm/colors"
|
|
shchemes create_theme bspwm > "$bspwm_theme"
|
|
"$bspwm_theme"
|
|
|
|
shchemes inject "${HOME}/.config/qutebrowser/config.py"
|
|
pkill -HUP qutebrowser # Reload qutebrowser config
|
|
```
|
|
Note you'll have to add all the comments for where to place the injections
|
|
|
|
See the [cookbook](./doc/cookbook.md) for some ideas on ways to use Shchemes.
|
|
|
|
You can read the manual [in your browser](./doc/manual.md) or by running `shchemes help`.
|
|
|
|
## Credits
|
|
This software is a work of opportunism
|
|
|
|
- [mo](https://github.com/tests-always-included/mo) - Mustache templates in bash. Shchemes wouldn't be possible without it.
|
|
- [tinted-theming/schemes](https://github.com/tinted-theming/schemes) - Several base16 themes
|
|
- [deathbeam/base16-discord](https://github.com/deathbeam/base16-discord) - The base16 `better-discord` target
|
|
- [mk12/base16-kitty](https://github.com/mk12/base16-kitty) - The base16 `kitty` target
|
|
|