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
- Host: GitHub
- URL: https://github.com/tmpstpdwn/shwal
- Owner: tmpstpdwn
- License: gpl-3.0
- Archived: true
- Created: 2024-05-27T15:12:19.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-13T07:27:58.000Z (about 1 year ago)
- Last Synced: 2025-05-13T08:28:25.413Z (about 1 year ago)
- Topics: aesthetic, bash, colorscheme, gplv3, imagemagick, linux, pywal, shell
- Language: Shell
- Homepage:
- Size: 105 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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.

## 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).