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

https://github.com/tmpstpdwn/shwal

Set wallpaper and create colorschemes effortlesly. inspired by pywal
https://github.com/tmpstpdwn/shwal

aesthetic bash colorscheme gplv3 imagemagick linux pywal shell

Last synced: 2 months ago
JSON representation

Set wallpaper and create colorschemes effortlesly. inspired by pywal

Awesome Lists containing this project

README

          

# shwal

- `shwal` is a bash script to set wallpaper and generate color schemes from an image.
- It allows you to use templates so that new colorschemes can be applied across many softwares effortlessly.

## shwal integrated with lf filemanager.

![Alt Text](https://s10.gifyu.com/images/SfDyQ.gif)

## Usage

```sh
Usage: shwal [OPTIONS] [FILE]
Set wallpaper and generate colorscheme from an image.

Options:
-w Set wallpaper.
-i Set wallpaper, generate colorscheme, templates from .
-r Restore wallpaper.
```

## Installation

```bash
git clone https://github.com/tmpstpdwn/shwal.git
cd shwal
mv src/shwal ~/.local/bin
```

- Make sure that `~/.local/bin` is in `$PATH`.

## Dependencies

- `ImageMagick` (magick) for color extraction.
- `feh` for setting wallpaper.
- `bc` for arithmetic, if you already dont have it.

## Configuration

- Templates are stored in `$HOME/.config/shwal/templates`.
- The way templates work is that you can store your template files in this folder.
- inside a template file colors can be substituted from the generated colorscheme by using `{color-key}`.
- The following are the colorkeys
`foreground`, `background`, `cursor`, `color0` ... `color15`.
- Colorschemed templates generated are stored in `$HOME/cache/shwal`.

## License

This project is licensed under the GPLv3 [License](LICENSE).