Overview 
     
 Installation 
     
 Contributions 
  

Gowall is a tool to convert an image ( specifically a wallpaper ) to any color-scheme / palette you like! It also offers a bunch of image processing features (image to pixel art, Image upscaling, color palette extraction...)

Gowall is really well documented with visual examples: Gowall Docs

❗ Although Gowall is a CLI tool, it has an Image preview feature that allows printing images directly in the terminal. See Gowall Terminal Image preview

• Convert Wallpaper's theme 👾 – Recolor an image to match your favorite + (Custom) themes (Catppuccin...).
• AI Image Upscaling 👾- Increase the resolution of the image while preserving or improving its quality.
• Support for Unix pipes/redirection 👾 - Read from stdin and write to stdout.
• Convert Icon's theme 👾 (svg,ico) - Recolor your icons to match a theme.
• Image to pixel art - Transforms your image to the typical blocky appearance of pixel art.
• Replace a specific color in an image - Pretty self explanatory.
• Create a gif from images - Use the images as frames and specify a delay and the number of loops.
• Extract color palette - Extracts all the dominant colors in an image (like pywal).
• Change Image format - Ex. change format from .webp to .png.
• Invert image colors - Pretty self explanatory.
• Draw on the Image - Draw borders,grids on the image
• Remove the background of the image - Pretty self explanatory.
• Effects - Mirror,Flip,Grayscale,change brightness and more to come!
• Daily wallpapers - Explore community-voted wallpapers that reset daily.

You can check the section here on how to create a Custom Theme.

The currently supported themes are featured below, if your favourite theme is missing open an issue or a pull request All themes can be shown (both default and user-created via ~/.config/gowall/config.yml) by gowall list.

• Catppuccin flavors
• Dracula
• Everforest
• Gruvbox
• Nord
• Onedark
• Solarized
• Tokyo-dark/storm/moon

Make sure to do gowall -v and compare it against the release page version, since the docs only show the commands/flags and capabilities of the latest released version.

brew install gowall

Thank you to chenrui333. You can find the ruby formula there.

yay -S gowall

sudo dnf copr enable achno/gowall
sudo dnf install gowall

  environment.systemPackages = [
    pkgs.gowall
  ];

More installation options : here

Assuming you have void-packages

git clone https://github.com/elbachir-one/void-templates
cd void-templates/ && cp -r gowall/ void-packages/srcpkgs/
cd void-packages/
./xbps-src pkg gowall
sudo xbps-install -R hostdir/binpkgs gowall

🔨 Clone the repo, build the project and move it inside your $PATH

git clone https://github.com/Achno/gowall
cd gowall
go build
sudo cp gowall /usr/local/bin/
gowall

Notes 🗒️ : You dont have to use sudo cp gowall /usr/local/bin/ if you have $GOPATH setup correctly Eg. you have the following in your .zshrc / .bashrc

export GOPATH=$(go env GOPATH)
export GOBIN=$GOPATH/bin
export PATH=$PATH:$GOBIN

And simply use go install

go install github.com/Achno/gowall@latest

If you wish to contribute by adding a new theme please open an issue I would also be very happy if you can provide the rgb values of your theme as well :) but not required if it's popular

Feel free to suggest any cool features that would improve gowall even further by opening an issue

Special thanks to lutgen for the original implementation of the color correction algorithm which i adapted for this project.