Gowall is a command-line image processing tool written in Go that began as a wallpaper color scheme converter and has evolved into a comprehensive image manipulation utility. The project is maintained by Achno and offers extensive documentation with visual examples at its dedicated documentation site.
The core functionality centers on converting wallpapers and icons to different color schemes and themes. Gowall supports numerous popular themes including Catppuccin flavors, Dracula, Everforest, Gruvbox, Nord, Onedark, Solarized, and Tokyo variants, with additional themes like Arc Dark, Cyberpunk, Github Light, Kanagawa, Material, Rose Pine, and Synthwave 84 available. Users can also create custom themes through configuration files.
Beyond color conversion, Gowall provides a diverse suite of image processing features. These include OCR capabilities supporting nine or more providers through traditional OCR, Visual Language Models, and hybrid methods for extracting text from images and PDFs. The tool offers AI-powered image upscaling using adversarial networks to increase resolution while preserving quality. Image compression reduces file sizes for PNG, JPEG, JPG, and WebP formats. Additional features encompass converting images to pixel art, replacing specific colors, creating GIFs from image sequences, extracting color palettes similar to pywal, changing image formats, inverting colors, drawing borders and grids, removing backgrounds, and applying effects like mirroring, flipping, and grayscale conversion with brightness adjustments.
A distinctive feature is the terminal image preview capability, allowing users to view images directly within the CLI despite Gowall being a command-line tool. The project supports Unix pipes and redirection for reading from stdin and writing to stdout, enabling integration into shell workflows. Gowall also includes a daily wallpaper feature showcasing community-voted wallpapers that reset daily.
Installation options are flexible, with precompiled binaries available from the release section as the preferred method. The tool is packaged for multiple distributions including Homebrew for macOS, AUR for Arch Linux, COPR for Fedora, NixOS, and Void Linux. Users can also build from source using Go and Zig for cutting-edge features not yet released.
According to GitGenius activity tracking, the project shows rapid issue and pull request response times with a median latency of zero hours across tracked items and a mean of 0.1 hours. The primary contributor is Achno with four tracked events, while uzzy-buzzy has contributed one event. Bug reports represent the most active issue label category. The project is classified across multiple domains including wallpaper management, desktop backgrounds, image rotation, multi-monitor support, automatic wallpaper changes, configuration file support, and cross-platform compatibility. The codebase emphasizes customization through configuration files and provides comprehensive command-line functionality for users seeking advanced image processing capabilities.
