github.com/Achno/gowall
v0.2.4
Achno/gowall
What this package is like to depend on
Last release 2 months ago
10 Jun 2026
Release timing varies
gaps range from 8 days to 2 months
Most releases are documented
notes for 10 of 15 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
64 releases · first in 2024
19 releases in the last 12 months
see the full history below
Release timeline
64 releases · Jul 2024 to Jun 2026Releases
latest 60 of 64-
v0.2.5-0.20260610091103-96345aaaa5c810 Jun 2026 pre-releaseNothing published for this version
-
v0.2.5-0.20260520175400-7ba787f4419f20 May 2026 pre-releaseNothing published for this version
-
v0.2.5-0.20260416173100-51509d3b957a16 Apr 2026 pre-releaseNothing published for this version
-
v0.2.5-0.20260413073704-e1acf06b84fd13 Apr 2026 pre-releaseNothing published for this version
-
v0.2.409 Apr 2026Release notes
Open source →Big Features❗ ❗
-
gowall bgnow has access to models for removing the background of an image. [CPU-ONLY] for now. See documentationu2net(relatively fast,low resources) -> generally does very good.
bria-rmbg(slow, high resources) -> extremely good.
Also added--bg-colorflag to replace the removed background with any color instead of only transparency.onnx runtime only supports CUDA-12 and support will be added in a future release for GPU acceleration, i will also check out AMD ROCm.
The folders/path for
onnxcan be configured in~/.config/gowall/config.yml. This also allows NixOS users to bypass theNixOS cant run dynamically linked executablesby downloading onnx runtime themselves and simply pointing the.solibrary to gowall by the config. If you downloaded bg removal models before you could also simply point their folder path to gowall to avoid making gowall re-download them. -
The other big feature is all the color theory utilities (
gowall color ...) that have been added in this update that help you in generating the colors needed for a custom themeI have added a guide on how you can use them to create your custom theme here. Use custom themes, stop relying on the default catppuccin,gruvbox etc.. output.
Features
-
Improved the replace specific color feature
gowall convert img.png -r "#EA6254,#F9E2AF,20", making the replacement much smoother by changing the threshold,normalizing it and blending colors see differences here -
Avifimage format support! You can now easily do everything you did with the other formats with avif.gowall convert img.avif -t catppuccinorgowall convert img.png --output img.avif -
gowall compressnow has a newlossyavifmethod where you can tweak the quality and speed to your liking to compress avif images. here -
gowall effects tiltcommand added, it makes really nice 3D isometric tilt/rotate effect to your image. Previously you would have needed something like GIMP to achieve this. Documentation here -
gowall stackcommand added, Stack images in any way you want by specifying a grid (ex. 3x3) or horizontally or vertically, seperate them with a border of your color and pixel size. Documentation here -
Added a
--radius -r flagin the border command so now you can add rounded borders to your image:
Example :gowall draw border ~/Pictures/Unixporn/rice/1.png -c #ffffff -r 30 -b 3. Documentation here -
Added
gowall resize. Guess what it does lol. Batch resizing icons to 32x32 is useful for me. Documentation here <-- -
Enabled preview support for gifs in the kitty terminal
Quality Features
-
added
--previewtrue/false global flag for all commands, that overridesEnableImagePreviewingfromconfig.yml, closes #73 here -
added
--yesglobal flag which allows you to auto accept anyy/nconfirmation prompts, very useful for automation since the first time you download gowall and it wants to download lets say a model it requires confirmation, but with this you can skip it.# Example (skips 2 confirmations for the onnx runtime & u2net model) gowall bg ~/Pictures/hollow-knight.jpg --yes -
added
ayutheme and all its variants, closes #77
Bug Fixes
- Fixed
gowall -wCould not fetch wallpaper of the day: there wasn't a top wallpaper today :( check latererror that was happening because gowall couldn't verify a challenge to prove that its not scraping content. - Fixed 429 rate limit that got returned by
gowall -won MacOS closes #81
-
v0.2.4-0.20260407213217-87e6c827d4c707 Apr 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20260405225025-0dddb0e2eb9505 Apr 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20260402224508-75e26aa53f3202 Apr 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20260327135507-ff047ec9c3ec27 Mar 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20260302193947-bb1227a7ccf902 Mar 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20260219185818-848bb2deb25119 Feb 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20260213191446-8951e89edd3913 Feb 2026 pre-releaseNothing published for this version
-
v0.2.4-0.20251214180751-98050f0e724f14 Dec 2025 pre-releaseNothing published for this version
-
v0.2.311 Oct 2025Release notes
Open source →Big Features❗ ❗
-
Image Compression: Compresspng,jpeg,jpg,webpimages with various available methods : [pngquant, losslesspng, lossyjpeg, lossyjpg, lossywebp], tweakqualitywith flags check out the docs -
OCR: OCR - Extract text from images and pdfs', supporting 9+ providers (Traditional OCR, Visual Language Models and hybrid methods). Integrations with your favorite image screenshot tools :) check out the docs
Bug fixes
- Fixed #54 config.yml "outputfolder" option does not work expectedly
- Fixed could not find config.yml issue, by creating the file if it doesn't exist by default
Quality Features
- Added a spinner for
gowall -wandgowall ocr - Added
melangetheme
-
v0.2.211 Oct 2025 -
v0.2.2-211 Oct 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20251003141226-3b3b9c8676f703 Oct 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250920171954-c9317f7f478720 Sep 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250829164906-95645b9e6d7c29 Aug 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250807085510-311e5c16b85607 Aug 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250608205721-8f6a305fa8ca08 Jun 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250528082920-6b4560e6533028 May 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250506184915-a39c075a4e3a06 May 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250424073102-b0b86d3762f924 Apr 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250418080312-80248d34347618 Apr 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250412165157-9682ab09538b12 Apr 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250412140607-4d8ef48d858812 Apr 2025 pre-releaseNothing published for this version
-
v0.2.2-0.20250412132750-13a782d5d77812 Apr 2025 pre-releaseNothing published for this version
-
v0.2.110 Apr 2025Release notes
Open source →Big Features❗ ❗
Unix pipe/redirection (stdin,stdout) support,this enables gowall to work withsvgandicosand convert icon themes, documentation here and here--dir, --batch, --outputflags have been expanded to all* gowall commands and all of future commands will have them as well.
--dirprocesses whole directories,--batchbatch-files,--outputallows you to put the processed file(s) in whatever path you want.- A bunch of important bug fixes :
[MacOS not reading config file],[panic when converting whole directories] etc...
Features
Gowall is available on the official MacOS repo's: heregowall is now available as a binary instead of building it yourselfcheck the tarballs at the release section.gowall supports the Kitty image protocol directlythis means that you don't need external dependencies (like kitty previously) to view images in the terminal in Konsole & Ghostty (You still have to enable a flag). hereImage Terminal Previewadded for Wezterm see hereChafa as Terminal image preview option: chafa supports sixel, the kitty image protocol as well as ASCII representations for terminals that don't support images (cough* Alacritty) check it out here- You can now change the threshold in
replace image colorsee the new docs here - You can draw grids to an image or draw the grid in the background of the image docs
- increased performance in
gowall gifcheck out the new flags here
Quality Features
- Shell completions for the theme names have been added
- gowall now respects
XDG_PICTURES_DIRfor users that dont have an english filesystem. gowall convertnow respects transparency.- Themes : Added the other catppuccin flavor themes
cat-frappecat-lattedue to demand as well askanagawa
Thank you to my contributors
@MillerApps For helping in natively supporting the kitty image protocol without dependencies
@0bCdian For helping in the IO refactor and the Unix Pipe and redirection features. -
v0.2.1-0.20250410211632-38f04031b92010 Apr 2025 pre-releaseNothing published for this version
-
v0.2.1-0.20250328203804-32539618358328 Mar 2025 pre-releaseNothing published for this version
-
v0.2.1-0.20250326170007-993d2b9ea78326 Mar 2025 pre-releaseNothing published for this version
-
v0.2.1-0.20250301154140-8e2ec108b33201 Mar 2025 pre-releaseNothing published for this version
-
v0.2.1-0.20250220224816-02999f7ec56c20 Feb 2025 pre-releaseNothing published for this version
-
v0.2.1-0.20250216185415-2a4345ac0bc916 Feb 2025 pre-releaseNothing published for this version
-
v0.2.009 Feb 2025Release notes
Open source →Big Features❗ ❗
AI image Upscalerdocumentation hereNew color correction algorithm: Massive improvements in performance up to 40-60% quicker and fixes all rough color transitions, ensuring a smooth color conversion. Documentation here
Features
Image Terminal Previewadded for Ghostty & Konsole terminal emulatorsDynamically pass a theme.jsonfor color conversion (useful in scripts) see documentation hereCreate gifs from Images:gowall gif -b <file,file>Effectswithgowall effects [effect]you can now flip, mirror ,convert to grayscale & change the brightness of images.
Quality Features
- Added
-o <Outputname>flag forgowall convertandgowall gifsince its useful for scipts see documentation here gowall listnow shows themes in alphabetical order- Added
rose-pinetheme
-
v0.1.10-0.20250122214506-992690ac301922 Jan 2025 pre-releaseNothing published for this version
-
v0.1.10-0.20250105230619-120fd0503a4905 Jan 2025 pre-releaseNothing published for this version
-
v0.1.10-0.20241208004029-2f19f094367a08 Dec 2024 pre-releaseNothing published for this version
-
v0.1.10-0.20241201230053-d8307c5023ae01 Dec 2024 pre-releaseNothing published for this version
-
v0.1.10-0.20241124201409-dd264f306f4b24 Nov 2024 pre-releaseNothing published for this version
-
v0.1.10-0.20241120201035-94cbfea5180420 Nov 2024 pre-releaseNothing published for this version
-
v0.1.10-0.20241119173657-d6e9c680a51919 Nov 2024 pre-releaseNothing published for this version
-
v0.1.10-0.20241117090206-c94985f9757917 Nov 2024 pre-releaseNothing published for this version
-
v0.1.915 Nov 2024Release notes
Open source →Big Feature🚀 Addedimg to pixel art❗ ❗
The documentation can be found here along with visual examples ;)- Finally
Docs📚 : https://achno.github.io/gowall-docs/ Not just relying on theREADMEfor documentation anymore. Every feature there has a visual example. Also its a place i canshare tips and tricks for gowallfor how to avoid bad conversions (check here. Feature🚀 AddedRemove background from image. The documentation for this can be found hereFeature🚀 AddedReplace a specific color in an Image. Incredibly convenient if the background of the image is a solid color or you just want to change something in the image. The documentation can be found hereShell Completions⌨ Shell completion guide forzshbashfishpowershellavailable : here
Thats all for this time ;) See you in the next release (i have left an easter egg 🥚 in the docs site for the future features in the next update)
-
v0.1.9-0.20241115204434-df2aa6e1d27a15 Nov 2024 pre-releaseNothing published for this version
-
v0.1.9-0.20241018164643-296fcb7e6f9018 Oct 2024 pre-releaseNothing published for this version
-
v0.1.9-0.20240911162516-56452ad5673211 Sep 2024 pre-releaseNothing published for this version
-
v0.1.811 Sep 2024Release notes
Open source →Feature🚀 Added the ability to create a border for an image. View number 11 in the Usage section to see an example image. You can specify color and border thickness (pixels) .The syntax is:
gowall draw ~/Pictures/img.png -c #5D3FD3 -b 5Feature🚀 Added the ability to change image formats
For example from.webpto.png(of course you can change to any format you want)
gowall convert ~/Pictures/img.webp -f pngThis eliminates the reason for you to go to image converter websites
With gowall the conversion happens instantly whereas in most converter websites it can take seconds- Added
NixOSinstallation method
-
v0.1.8-0.20240827192712-0ebacfc8633727 Aug 2024 pre-releaseNothing published for this version
-
v0.1.8-0.20240816154207-5160b11111fe16 Aug 2024 pre-releaseNothing published for this version
-
v0.1.716 Aug 2024Release notes
Open source →-
Big Feature🚀 addedExtracting color pallete from wallpaper( yes like pywal , in under 150ms) ❗❗
Usage :gowall extract ~/Pictures/pagoda.jpeg -c 6
The-cflag specifies the number of colors to return ( in this case it returns 6 hex colors: #130C0C #3E3D3D #A33234 #757271 #908F8D #C6C6C6 )In order to preview the colors of all the hex color codes at once you use the
-pflag
Example :gowall extract ~/Pictures/pagoda.jpeg -pc 6. It should have opened a url in your default web browser , simply copy-paste the hex codes from your terminal and view the colors :) -
Feature🚀 AddedWallpaper of the daywithgowall -w.
It fetches the top wallapper and displays it on your terminal if you are running kitty , else opens your default image viewing application -
Quality FeatureAdded a way to print the hex color codes of all themes , so you can trim them down and help you create your custom color scheme.
gowall list -t catppuccin--> prints all the hex codes of catppuccin
The general syntax isgowall list -t <theme_name>You can also use
gowall list -pt <theme_nameto open a hex previewer and paste the hex colors of the theme for you to view !
(Saves you time tracking down the colors for a theme and enables you to tweak the theme with custom themes even faster)
-
-
v0.1.7-0.20240809160540-b78a0fdc145e09 Aug 2024 pre-releaseNothing published for this version
-
v0.1.609 Aug 2024Release notes
Open source →-
Big Feature🚀 AddedImage previewing❗ ❗ If you are using a terminal which supports images (Kitty) it will print the image to the terminal. Anything other than kitty it will open your default image viewing application of your operating system.Image previewingis on by default for single image processing. You can disable it if you want in~/.config/gowall/config.ymlwithEnableImagePreviewing: false -
Quality featureImproved error handling and now errors are shown in red to be easier to see : example -
Quality featureYou can capitalize the name of the theme however you want instead of only lowercase : ex.gowall ... -t catppuccin==gowall ... -t CATPPUCCIN==gowall ... -t Catppuccin -
Fixed
bug🐛 where gowall threw a panic if you did not specify the filepath
-
-
v0.1.6-0.20240803170741-1e310a39479b03 Aug 2024 pre-releaseNothing published for this version
-
v0.1.501 Aug 2024 -
v0.1.5-0.20240801145518-fb4d68ae992f01 Aug 2024 pre-releaseNothing published for this version
-
v0.1.5-0.20240730170724-3b1657bf4ef730 Jul 2024 pre-releaseNothing published for this version
-
v0.1.429 Jul 2024Nothing published for this version
-
v0.1.329 Jul 2024Nothing published for this version