{"id":37204463,"url":"https://github.com/achno/gowall","last_synced_at":"2026-04-09T20:21:35.452Z","repository":{"id":249678502,"uuid":"832211416","full_name":"Achno/gowall","owner":"Achno","description":"A tool to convert a Wallpaper's color scheme / palette, OCR with VLM's Traditional \u0026 Hybrid, Image Compression ,color palette extraction,  image upsacling with Adversarial Networks  and more image processing features.","archived":false,"fork":false,"pushed_at":"2026-01-11T22:32:06.000Z","size":8549,"stargazers_count":1974,"open_issues_count":15,"forks_count":31,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-01-12T02:22:08.865Z","etag":null,"topics":["cli","color-extractor","color-palette","color-scheme","compression","go","image","image-converter","image-processing","ocr","pixel-art","theme-switcher","upscale"],"latest_commit_sha":null,"homepage":"https://achno.github.io/gowall-docs/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Achno.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-07-22T14:43:58.000Z","updated_at":"2026-01-11T17:02:06.000Z","dependencies_parsed_at":"2024-08-27T10:58:23.312Z","dependency_job_id":"5417204a-228f-4d67-b5ee-f11eb95a16f4","html_url":"https://github.com/Achno/gowall","commit_stats":null,"previous_names":["achno/gowall"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/Achno/gowall","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Achno%2Fgowall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Achno%2Fgowall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Achno%2Fgowall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Achno%2Fgowall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Achno","download_url":"https://codeload.github.com/Achno/gowall/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Achno%2Fgowall/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28438728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T22:37:52.437Z","status":"ssl_error","status_checked_at":"2026-01-14T22:37:31.496Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","color-extractor","color-palette","color-scheme","compression","go","image","image-converter","image-processing","ocr","pixel-art","theme-switcher","upscale"],"created_at":"2026-01-14T23:34:12.141Z","updated_at":"2026-01-14T23:34:12.808Z","avatar_url":"https://github.com/Achno.png","language":"Go","readme":"###### *\u003cdiv align = right\u003e\u003csub\u003eDesign By Achno\u003c/sub\u003e\u003c/div\u003e*\n\u003cdiv align = center\u003e\u003cimg src=\"assets/go-sticker-overlay-small.png\"\u003e\u003cbr\u003e\u003cbr\u003e\n\n\u0026ensp;[\u003ckbd\u003e \u003cbr\u003e Overview \u003cbr\u003e \u003c/kbd\u003e](#overview-framed_picture)\u0026ensp;\n\u0026ensp;[\u003ckbd\u003e \u003cbr\u003e Installation \u003cbr\u003e \u003c/kbd\u003e](#installation-package)\u0026ensp;\n\u0026ensp;[\u003ckbd\u003e \u003cbr\u003e Contributions \u003cbr\u003e \u003c/kbd\u003e](#contributions-handshake)\u0026ensp;\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\u003c/div\u003e\n\n---\n\n# Overview :framed_picture:\n\nGowall started as a tool to convert an image ( specifically a wallpaper ) to any color-scheme / palette you like!\nIt has now evolved to a swiss army knife of image prosessing offering (OCR,Image upsacling,image compression and a lot more)\n\n## Docs\nGowall is really well documented with **visual examples**: [Gowall Docs](https://achno.github.io/gowall-docs/)\n\n---\n\n## Features\n\n❗ Although Gowall is a CLI tool, it has an `Image preview` feature that allows\nprinting images directly in the terminal. See [Gowall Terminal Image preview](https://achno.github.io/gowall-docs/#image-preview)\n\n- **Convert Wallpaper's theme**  – Recolor an image to match your favorite + (Custom) themes (Catppuccin...).\n- **Image compression** - Reduce the size of png,jpeg,jpg,webp images.\n- **OCR** - Extract text from images and pdfs', supporting 9+ providers (Traditional OCR, Visual Language Models and hybrid methods).\n- **AI Image Upscaling** - Increase the resolution of the image while preserving or improving its quality.\n- **Convert Icon's theme**  (svg,ico) - Recolor your icons to match a theme.\n- Support for Unix pipes/redirection  - Read from stdin and write to stdout.\n- Image to pixel art - Transforms your image to the typical blocky appearance of pixel art.\n- Replace a specific color in an image - Pretty self explanatory.\n- Create a gif from images - Use the images as frames and specify a delay and the number of loops.\n- Extract color palette - Extracts all the dominant colors in an image (like pywal).\n- Change Image format - Ex. change format from .webp to .png.\n- Invert image colors - Pretty self explanatory.\n- Draw on the Image - Draw borders,grids on the image\n- Remove the background of the image - Pretty self explanatory.\n- Effects - Mirror,Flip,Grayscale,change brightness and more to come!\n- Daily wallpapers - Explore community-voted wallpapers that reset daily.\n\n---\n\n\u003cdiv  align=\"center\"\u003e\u003cimg height=\"350\" src=\"assets/custom.png\"\u003e\u003cbr\u003e\u003cbr\u003e\u003c/div\u003e\n\n\u003cdiv align=\"center\" \u003e\u003cimg height=\"450\" src=\"https://github.com/user-attachments/assets/4029e2b7-b8fd-4738-9334-20a6d01872c7\"\u003e\u003cbr\u003e\u003cbr\u003e\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\u003cimg height=\"450\" src=\"https://github.com/user-attachments/assets/7b6ad413-938f-4f01-bda7-1f50f2f64616\"\u003e\u003cbr\u003e\u003cbr\u003e\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\u003cimg height=\"500\" src=\"https://github.com/user-attachments/assets/4bf6dc47-46eb-4bc4-9913-8dea3b454b80\"\u003e\u003cbr\u003e\u003cbr\u003e\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\u003cimg src=\"assets/invert.png\"\u003e\u003cbr\u003e\u003cbr\u003e\u003c/div\u003e\n\n---\n\n# Themes :art:\n\nYou can check the section [here](https://achno.github.io/gowall-docs/themes) on how to create a **Custom Theme**.\n\nThe currently supported themes are featured below, if your favourite theme is missing open an issue or a pull request\nAll themes can be shown (both default and user-created via `~/.config/gowall/config.yml`) by `gowall list`.\n\n- **Catppuccin flavors**\n- **Dracula**\n- **Everforest**\n- **Gruvbox**\n- **Nord**\n- **Onedark**\n- **Solarized**\n- **Tokyo-dark/storm/moon**\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eClick to see more themes\u003c/strong\u003e\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003cstrong\u003eArc Dark\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eAtom Dark\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eAtom One Light\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eCat Frappe/latte\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eCyberpunk\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eGithub Light (black \u0026 white)\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eKanagawa\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eMaterial\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eMelange (Dark \u0026 Light)\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eNight Owl\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eOceanic Next\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eRose Pine\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eShades of Purple\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eSunset Aurant\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eSunset Saffron\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eSunset Tangerine\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eSweet\u003c/strong\u003e\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eSynthwave 84\u003c/strong\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n---\n\n# Installation :package:\n\nMake sure to do `gowall -v` and compare it against the release page version,\nsince the [docs](https://achno.github.io/gowall-docs/installation) only show the commands/flags and capabilities of the latest released version.\n\n### Grab the binary from the release section (Stable Release) 🢀 **Prefered Method**\n\n- If the installation options do not cover your package manager of your distro/OS\n- If gowall in your package manager is not up to date as per the [release section's latest version](https://github.com/Achno/gowall/releases)\n- If you don't know how to install gowall and don't want to build the project.\n\nHead over to the [release](https://github.com/Achno/gowall/releases) section\n\nChoose the latest version of gowall. You should see a `.tar.gz` for your operating system and architecture. Simply Extract the binary inside named `gowall` and place it inside your `$PATH`\n\n```sh\nsudo cp gowall /usr/local/bin/\n```\n\n\n### MacOS (Homebrew) - currently on v0.2.0\n\n```sh\nbrew install gowall\n```\n\nThank you to `chenrui333`. You can find the [ruby formula](https://github.com/Homebrew/homebrew-core/blob/b86ea8e19ae7bf087fab8e2d56cd623eec1e1cf9/Formula/g/gowall.rb) there.\n\n### Arch linux - AUR\n\n```sh\nyay -S gowall\n```\n### Fedora - COPR\n\n```sh\nsudo dnf copr enable achno/gowall\nsudo dnf install gowall\n```\n\n### NixOS - ( Maintainer : [Emily Trau](https://github.com/emilytrau))\n\n```yaml\n  environment.systemPackages = [\n    pkgs.gowall\n  ];\n```\n\nMore installation options : [here](https://search.nixos.org/packages?channel=24.05\u0026from=0\u0026size=50\u0026sort=relevance\u0026type=packages\u0026query=gowall)\n\n### Void Linux - XBPS-SRC ( Maintainer : [elbachir-one](https://github.com/elbachir-one/))\n\nAssuming you have [void-packages](https://github.com/void-linux/void-packages)\n\n```sh\ngit clone https://github.com/elbachir-one/void-templates\ncd void-templates/ \u0026\u0026 cp -r gowall/ void-packages/srcpkgs/\ncd void-packages/\n./xbps-src pkg gowall\nsudo xbps-install -R hostdir/binpkgs gowall\n```\n\n### Build from source (Cutting Edge) \n\nIf you are a normal user, consider using using the method above for a stable gowall release.\n\n\u003e If you want to contribute to the project\n\u003e \n\u003e Or have all the latest features that have not been released yet then\n\n🔨 Clone the repo, build the project and move it inside your `$PATH`\n\n\n```sh\ngit clone https://github.com/Achno/gowall\ncd gowall\ngo build\nsudo cp gowall /usr/local/bin/\ngowall\n```\n\nIf this threw any errors while building simply follow the solution below.\n\n#### Windows (Or any OS if git cloning and go build did not work)\n\nFor Windows we need to install `zig` \u0026 `go` to build it. I advise you to use a package manager like [scoop](https://scoop.sh/) to install it. Obviously you can just go the zig website and download the installer, it doesn't really matter, the zig binary needs to be in your `$PATH`.\n\n```bash\nscoop install main/zig # or just go to the website and download zig if you don't want to use a package manager\n```\n\n```bash\ngit clone https://github.com/Achno/gowall\ncd gowall\n\nexport CGO_ENABLED=1 # if you are using powershell : $env:CGO_ENABLED=1\nexport CC=\"zig cc\" # if you are using powershell : $env:CC=\"zig cc\"\nexport CXX=\"zig c++\" # if you are using powershell : $env:CXX=\"zig c++\"\n\ngo clean -cache \ngo build -v\n\n# then simply add the binary to your PATH\n```\n\n---\n\n# Contributions :handshake:\n\nIf you wish to contribute by adding a new theme please open an `issue`\nI would also be very happy if you can provide the `rgb values` of your theme as well :) but not required if it's popular\n\nFeel free to suggest any cool features that would improve gowall even further by opening an `issue` \n\n# Community \n\n##  Community Extensions\n\nThe following are **third-party projects** built by the community that extend or integrate with `gowall`.\n\n\u003e[!Warning]\n\u003eThese tools are **not officially affiliated with the `gowall` project**. Please audit/inspects scripts before running them.  \n\n### 🔗 Projects\n\n- [**tinted-gowall**](https://github.com/tinted-theming/tinted-gowall) — A bridge between `gowall` and the [tinted-theming](https://github.com/tinted-theming) ecosystem. This project enables users to apply their `base16`/`base24` themes with `gowall`, unlocking hundreds of new visual styles.\n\n\n# Special Thanks\n\nSpecial thanks to [lutgen](https://github.com/ozwaldorf/lutgen-rs) for the original implementation of the color correction algorithm which i adapted for this project.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachno%2Fgowall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fachno%2Fgowall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachno%2Fgowall/lists"}