### Install gowall via xbps

Source: https://github.com/achno/gowall/blob/main/README.md

Use the Void Linux package manager to install gowall.

```sh
sudo xbps-install -S gowall
```

--------------------------------

### Install Gowall via Package Managers

Source: https://context7.com/achno/gowall/llms.txt

Instructions for installing Gowall on macOS, Arch Linux, Fedora, NixOS, and Void Linux. Also includes building from source.

```bash
# macOS (Homebrew)
brew install gowall
```

```bash
# Arch Linux (AUR)
yay -S gowall
```

```bash
# Fedora (COPR)
sudo dnf copr enable achno/gowall
sudo dnf install gowall
```

```bash
# NixOS (in configuration.nix)
# environment.systemPackages = [ pkgs.gowall ];
```

```bash
# Void Linux
sudo xbps-install -S gowall
```

```bash
# Build from source
git clone https://github.com/Achno/gowall
cd gowall
go build
sudo cp gowall /usr/local/bin/
```

--------------------------------

### Install gowall via Homebrew

Source: https://github.com/achno/gowall/blob/main/README.md

Use Homebrew to install gowall on MacOS.

```sh
brew install gowall
```

--------------------------------

### Install gowall via Fedora COPR

Source: https://github.com/achno/gowall/blob/main/README.md

Enable the COPR repository and install gowall on Fedora.

```sh
sudo dnf copr enable achno/gowall
sudo dnf install gowall
```

--------------------------------

### Install gowall via AUR

Source: https://github.com/achno/gowall/blob/main/README.md

Use yay to install gowall on Arch Linux.

```sh
yay -S gowall
```

--------------------------------

### Install Zig via scoop

Source: https://github.com/achno/gowall/blob/main/README.md

Install the Zig compiler using the scoop package manager.

```bash
scoop install main/zig # or just go to the website and download zig if you don't want to use a package manager
```

--------------------------------

### Install gowall binary manually

Source: https://github.com/achno/gowall/blob/main/README.md

Move the extracted binary to a directory in your system PATH.

```sh
sudo cp gowall /usr/local/bin/
```

--------------------------------

### Build gowall from source

Source: https://github.com/achno/gowall/blob/main/README.md

Clone the repository and build the binary using Go.

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

--------------------------------

### Build gowall with Zig

Source: https://github.com/achno/gowall/blob/main/README.md

Configure environment variables and build gowall using Zig as the C compiler.

```bash
git clone https://github.com/Achno/gowall
cd gowall

export CGO_ENABLED=1 # if you are using powershell : $env:CGO_ENABLED=1
export CC="zig cc" # if you are using powershell : $env:CC="zig cc"
export CXX="zig c++" # if you are using powershell : $env:CXX="zig c++"

go clean -cache 
go build -v

# then simply add the binary to your PATH
```

--------------------------------

### List and Preview Themes

Source: https://context7.com/achno/gowall/llms.txt

Display available themes and their color palettes.

```bash
# List all themes
gowall list

# Show colors for specific theme
gowall list --theme catppuccin

# Show theme colors and open preview
gowall list --theme nord --preview
```

--------------------------------

### Gowall Configuration File

Source: https://context7.com/achno/gowall/llms.txt

YAML configuration for terminal previews, backends, and custom themes.

```yaml
# ~/.config/gowall/config.yml

# Enable terminal image preview
EnableImagePreviewing: true

# Use inline image preview (requires compatible terminal)
InlineImagePreview: false

# Image preview backend: kitty, sixel, iterm2
ImagePreviewBackend: "kitty"

# Color correction backend: haldclut, lutgen
ColorCorrectionBackend: "haldclut"

# Default output folder (supports ~ expansion)
OutputFolder: "~/Pictures/gowall"

# Path to .env file for API keys
EnvFilePath: "~/.config/gowall/.env"

# ONNX Runtime library path (for AI features)
OnnxRuntimeFolderPath: "~/.config/gowall/onnx"

# ONNX model folder path
OnnxModelFolderPath: "~/.config/gowall/models"

# Custom themes
themes:
  - name: "my-custom-theme"
    colors:
      - "#1a1b26"
      - "#f7768e"
      - "#9ece6a"
      - "#e0af68"
      - "#7aa2f7"
      - "#bb9af7"
      - "#7dcfff"
      - "#a9b1d6"
```

--------------------------------

### Color Utility Commands

Source: https://context7.com/achno/gowall/llms.txt

Perform color conversions, generate palettes, and create gradients.

```bash
# Convert color format
gowall color convert "#FF5733" --to rgb
gowall color convert "rgb(255,87,51)" --to hsl
gowall color convert "hsl(9,100%,60%)" --to hex

# Lighten color
gowall color light "#5D3FD3" --factor 0.3

# Darken color
gowall color dark "#5D3FD3" --factor 0.2

# Blend between two colors
gowall color blend "#FF0000" "#0000FF" --number 5

# Generate shades (darker variants)
gowall color variants "#5D3FD3" --type shades --number 5

# Generate tints (lighter variants)
gowall color variants "#5D3FD3" --type tints --number 5

# Generate tones (muted variants)
gowall color variants "#5D3FD3" --type tones --number 5

# Generate monochromatic palette
gowall color variants "#5D3FD3" --type monochrome --number 6

# Color wheel schemes
gowall color wheel "#5D3FD3" --type triadic
gowall color wheel "#5D3FD3" --type complementary
gowall color wheel "#5D3FD3" --type analogous
gowall color wheel "#5D3FD3" --type split-complementary
gowall color wheel "#5D3FD3" --type quadratic

# Generate contrast color
gowall color wheel "#5D3FD3" --type contrast

# Generate gradient image
gowall color gradient "#FF0000,#00FF00,#0000FF" --dimensions 1920x1080

# Gradient with direction
gowall color gradient "#FF5733,#FFC300" --dimensions 800x600 --direction vertical

# Gradient with angle
gowall color gradient "#000000,#FFFFFF" --dimensions 1920x1080 --direction 45

# Gradient with different interpolation method
gowall color gradient "#FF0000,#0000FF" --dimensions 1920x1080 --method hcl
```

--------------------------------

### Unix Pipeline Integration

Source: https://context7.com/achno/gowall/llms.txt

Use standard input and output to chain Gowall commands.

```bash
# Read from stdin, write to stdout
cat image.png | gowall convert - --theme catppuccin - > output.png

# Pipe through multiple tools
cat photo.jpg | gowall effects grayscale - - | gowall invert - - > result.png

# Process and redirect
gowall convert input.png --theme nord - > themed.png
```

--------------------------------

### Configure gowall on NixOS

Source: https://github.com/achno/gowall/blob/main/README.md

Add gowall to system packages in your NixOS configuration.

```yaml
  environment.systemPackages = [
    pkgs.gowall
  ];
```

--------------------------------

### Define OCR Schemas

Source: https://context7.com/achno/gowall/llms.txt

Configure OCR providers and pipeline settings in the ~/.config/gowall/ocr-schemas.yml file.

```yaml
schemas:
  - name: "openai-fast"
    config:
      ocr:
        provider: "openai"
        model: "gpt-4o-mini"
        format: "md"
      pipeline:
        dpi: 120
        concurrency: 5
      rateLimit:
        rps: 1
        burst: 3

  - name: "gemini-detailed"
    config:
      ocr:
        provider: "gemini"
        model: "gemini-1.5-pro"
        format: "md"
        prompt: "Extract text with high accuracy, preserve formatting"
      pipeline:
        dpi: 150
        ocrConcurrency: 5
      rateLimit:
        rps: 0.5
        burst: 2

  - name: "local-ollama"
    config:
      ocr:
        provider: "ollama"
        model: "llava"
        format: "txt"
      ollamaOptions:
        baseUrl: "http://localhost:11434"
```

--------------------------------

### Create GIF animations

Source: https://context7.com/achno/gowall/llms.txt

Generate animated GIFs from multiple images with control over timing, looping, and resizing.

```bash
# Create GIF from batch of images
gowall gif --batch frame1.png,frame2.png,frame3.png,frame4.png

# Create GIF from directory
gowall gif --dir ~/Frames --output animation.gif

# Custom frame delay (milliseconds)
gowall gif --dir ~/Frames --delay 100

# Single loop (play once)
gowall gif --batch frame1.png,frame2.png --loop -1

# Loop 3 times (shows frames 4 times total)
gowall gif --dir ~/Frames --loop 3

# Auto-resize frames to match dimensions
gowall gif --dir ~/Frames --resize 1
```

--------------------------------

### Batch Resize Images with Gowall

Source: https://context7.com/achno/gowall/llms.txt

Resize images in a directory to specific dimensions.

```bash
gowall resize --dir ~/Photos --dimensions 1024x768 --output ~/Resized/
```

--------------------------------

### Fetch Wallpaper of the Day

Source: https://context7.com/achno/gowall/llms.txt

Retrieve daily community-voted wallpapers.

```bash
# Fetch and preview wallpaper of the day
gowall --wall
gowall -w
```

--------------------------------

### AI Image Upscaling

Source: https://context7.com/achno/gowall/llms.txt

Upscale images using ESRGAN models with Vulkan GPU acceleration. Supports different scale factors and specialized models for photos and anime.

```bash
# Upscale 2x with default model
gowall upscale lowres.png
```

```bash
# Upscale 4x
gowall upscale image.jpg --scale 4
```

```bash
# Upscale with high-quality model (forces 4x)
gowall upscale photo.png --model realesrgan-x4plus
```

```bash
# Upscale anime/illustration
gowall upscale anime.png --model realesrgan-x4plus-anime --scale 4
```

```bash
# Upscale with fast video model (default)
gowall upscale image.png --model realesr-animevideov3 --scale 3
```

--------------------------------

### Batch upscale directory

Source: https://context7.com/achno/gowall/llms.txt

Upscale all images in a directory to a specific scale.

```bash
gowall upscale --dir ~/LowRes --scale 2 --output ~/HighRes/
```

--------------------------------

### Stack images

Source: https://context7.com/achno/gowall/llms.txt

Combine multiple images into a single composite layout, such as grids or horizontal/vertical stacks.

```bash
# Stack vertically (default)
gowall stack --batch img1.png,img2.png,img3.png

# Stack horizontally
gowall stack --dir ~/Images --layout horizontal

# Stack in 2x2 grid
gowall stack --batch a.png,b.png,c.png,d.png --layout 2x2

# Stack in 3x2 grid
gowall stack --dir ~/Gallery --layout 3x2

# Stack with border between images
gowall stack --batch img1.png,img2.png --layout horizontal --border 10

# Stack with colored border
gowall stack --dir ~/Photos --layout 2x2 --border 5 --color "#000000"

# Resize images to match smallest
gowall stack --batch large.png,small.png --resize biggest
```

--------------------------------

### Execute OCR Commands

Source: https://context7.com/achno/gowall/llms.txt

Run OCR operations on files using a specified schema from the configuration.

```bash
gowall ocr document.pdf --schema openai-fast
gowall ocr scan.png --schema local-ollama
```

--------------------------------

### Draw on images

Source: https://context7.com/achno/gowall/llms.txt

Add borders, grids, and rounded corners to images, with support for batch processing.

```bash
# Draw border with color and thickness
gowall draw border image.png --color "#5D3FD3" --borderThickness 10

# Draw rounded border
gowall draw border photo.png --color "#FF5733" --borderThickness 5 --radius 20

# Draw grid overlay
gowall draw grid image.png --size 80 --thickness 1 --color "#5D3FD3"

# Draw grid only on transparent areas (mask mode)
gowall draw grid transparent.png --size 60 --color "#333333" --mask

# Round image corners
gowall draw round image.png --radius 30

# Batch draw borders
gowall draw border --dir ~/Icons --color "#FFFFFF" --borderThickness 3
```

--------------------------------

### Compress Images

Source: https://context7.com/achno/gowall/llms.txt

Compress images using various lossy and lossless methods for PNG, JPEG, WebP, and AVIF. Supports custom quality, methods, speed, batch processing, and directory compression.

```bash
# Compress with default settings (quality 80, speed 4)
gowall compress image.png
```

```bash
# Compress with custom quality (0-100)
gowall compress photo.jpg --quality 60
```

```bash
# Compress with specific method
gowall compress image.png --method losslesspng
```

```bash
# Compress AVIF with optimal settings
gowall compress image.avif --method lossyavif --quality 55
```

```bash
# Batch compress with custom speed (1-10)
gowall compress --batch img1.png,img2.jpg --quality 70 --speed 6
```

```bash
# Compress entire directory
gowall compress --dir ~/Photos --quality 75 --output ~/Photos/compressed/
```

--------------------------------

### Custom JSON Themes

Source: https://context7.com/achno/gowall/llms.txt

Define themes in JSON format for use with the convert command.

```json
{
  "name": "my-theme",
  "colors": [
    "#1a1b26",
    "#f7768e",
    "#9ece6a",
    "#e0af68",
    "#7aa2f7",
    "#bb9af7",
    "#7dcfff",
    "#a9b1d6",
    "#414868",
    "#24283b"
  ]
}
```

```bash
# Use custom JSON theme
gowall convert wallpaper.png --theme ~/themes/my-theme.json
```

--------------------------------

### Convert Image Color Theme

Source: https://context7.com/achno/gowall/llms.txt

Convert an image's color scheme to predefined or custom themes. Supports single images, batch processing, directories, color replacement, and format conversion.

```bash
# Convert single image to Catppuccin theme
gowall convert input.png --theme catppuccin
```

```bash
# Convert to theme with custom output location
gowall convert wallpaper.jpg --theme nord --output ~/Pictures/themed/
```

```bash
# Convert using a custom JSON theme file
gowall convert image.png --theme /path/to/custom-theme.json
```

```bash
# Batch convert multiple files
gowall convert --batch file1.png,file2.png,file3.jpg --theme dracula
```

```bash
# Convert entire directory
gowall convert --dir ~/Wallpapers --theme gruvbox --output ~/Wallpapers/gruvbox/
```

```bash
# Replace specific color in image
gowall convert image.png --replace "#FF0000,#00FF00"
```

```bash
# Replace color with custom threshold
gowall convert icon.svg --replace "#FF0000,#00FF00,5.0"
```

```bash
# Convert image format (webp to png)
gowall convert image.webp --format png
```

--------------------------------

### Resize images

Source: https://context7.com/achno/gowall/llms.txt

Resize images to specific dimensions using various resampling methods.

```bash
# Resize to specific dimensions
gowall resize image.png --dimensions 1920x1080

# Resize with Lanczos resampling (default)
gowall resize photo.jpg --dimensions 800x600 --method lanczos

# Resize with Catmull-Rom resampling
gowall resize image.png --dimensions 1280x720 --method catmullrom
```

--------------------------------

### Pixelate images

Source: https://context7.com/achno/gowall/llms.txt

Transform images into pixel art with configurable block sizes.

```bash
# Pixelate with default scale (15)
gowall pixelate image.png

# Heavy pixelation (lower = more pixelated)
gowall pixelate image.png --scale 5

# Light pixelation
gowall pixelate highres.png --scale 20

# Batch pixelate
gowall pixelate --batch img1.png,img2.jpg --scale 8
```

--------------------------------

### Remove image backgrounds

Source: https://context7.com/achno/gowall/llms.txt

Remove backgrounds using AI models or K-means clustering, with options for batch processing and color replacement.

```bash
# Remove background with default U2Net model
gowall bg portrait.jpg

# Remove background with BRIA-RMBG (requires ~7GB RAM)
gowall bg photo.png --method bria-rmbg

# Remove background with K-means clustering
gowall bg image.png --method kmeans --iterations 150

# K-means with custom parameters
gowall bg photo.jpg --method kmeans \
  --iterations 100 --conv 0.001 --sRate 0.5 --routines 4

# Replace background with solid color
gowall bg portrait.png --bg-color "#FFFFFF"

# Batch remove backgrounds
gowall bg --dir ~/Photos --method u2net --output ~/Cutouts/
```

--------------------------------

### Extract color palette

Source: https://context7.com/achno/gowall/llms.txt

Extract dominant colors from images and optionally preview them in a browser.

```bash
# Extract 6 dominant colors (default)
gowall extract wallpaper.png

# Extract specific number of colors
gowall extract image.jpg --colors 10

# Extract and open hex preview website
gowall extract photo.png --preview

# Batch extract from directory
gowall extract --dir ~/Wallpapers --colors 8
```

--------------------------------

### Apply image effects

Source: https://context7.com/achno/gowall/llms.txt

Apply various transformations and adjustments to images, including geometric flips, color corrections, and 3D tilt effects.

```bash
# Flip image horizontally
gowall effects flip image.png

# Mirror image
gowall effects mirror wallpaper.jpg

# Convert to grayscale
gowall effects grayscale photo.png

# Adjust brightness (1.2 = 20% brighter, 0.8 = 20% darker)
gowall effects br image.png --factor 1.3

# Adjust contrast (normal mode)
gowall effects contrast image.png --mode normal --factor 25

# Adjust contrast (sigmoid mode for natural look)
gowall effects contrast image.png --mode sigmoid --midpoint 0.5 --sigmoid-factor 5

# Apply gamma correction
gowall effects gamma photo.png --gamma 1.5

# Adjust saturation (-100 to 100)
gowall effects saturation image.png --percentage 30

# Apply 3D tilt effect with gradient background
gowall effects tilt screenshot.png --tiltx 5 --tilty -8 --tiltz 3 --scale 0.65

# Tilt with preset
gowall effects tilt image.png --preset p1

# Tilt with custom background colors
gowall effects tilt image.png --bg-start "#121212" --bg-end "#282828" --radius 40

# Tilt with background image
gowall effects tilt screenshot.png --bg-image background.jpg
```

--------------------------------

### Invert Image Colors

Source: https://context7.com/achno/gowall/llms.txt

Invert colors for single files or entire directories.

```bash
# Invert image colors
gowall invert image.png

# Invert with custom output
gowall invert dark-theme.png --output light-theme.png

# Batch invert
gowall invert --dir ~/Icons --output ~/InvertedIcons/
```

--------------------------------

### OCR Text Extraction

Source: https://context7.com/achno/gowall/llms.txt

Extract text from images and PDFs using various OCR providers like OpenAI, Gemini, Ollama, and Tesseract. Supports custom prompts, schemas, batch processing, and output formats.

```bash
# Basic OCR with OpenAI
gowall ocr document.png --provider openai --model gpt-4o
```

```bash
# OCR with Gemini
gowall ocr scan.jpg --provider gemini --model gemini-1.5-flash
```

```bash
# OCR with local Ollama model
gowall ocr image.png --provider ollama --model llava
```

```bash
# Extract text from PDF (converts to images internally)
gowall ocr document.pdf --provider openai --model gpt-4o --dpi 150
```

```bash
# OCR with custom prompt
gowall ocr table.png --provider openai --model gpt-4o \
  --uprompt "Extract all text and format as a markdown table"
```

```bash
# Append to base prompt
gowall ocr document.png --provider gemini --model gemini-1.5-flash \
  --aprompt "Focus on mathematical equations"
```

```bash
# Use predefined schema from ~/.config/gowall/ocr-schemas.yml
gowall ocr document.pdf --schema my-ocr-config
```

```bash
# Batch OCR with rate limiting
gowall ocr --dir ~/Documents/scans --provider openai --model gpt-4o \
  --rps 0.5 --burst 3
```

```bash
# Output as plain text instead of markdown
gowall ocr image.png --provider openai --model gpt-4o --format txt
```

```bash
# OCR with Tesseract (traditional OCR)
gowall ocr document.png --provider tesseract --model eng
```

```bash
# OCR with Docling (hybrid method)
gowall ocr document.pdf --provider docling --model default
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.