Goshot

Goshot is a powerful Go library and CLI tool for creating beautiful screenshots of code and terminal command output with customizable window chrome, syntax highlighting, and backgrounds. Similar to Carbon and Silicon, Goshot allows you to create stunning visual representations of your code snippets for documentation, presentations, or social media sharing.

✨ Features

• 🎨 Beautiful syntax highlighting with multiple themes
• 🖼 Customizable window chrome (macOS, Windows, Linux styles)
• 🌈 Various background options (solid colors, gradients, images)
• 🔤 Custom font support
• 📏 Adjustable padding and margins
• 💾 Multiple export formats (PNG, JPEG)
• 🛠 Both CLI and library interfaces
• 🚀 Command execution support

Quick Start

Installation

Note

The CLI is a work in progress, but should be more or less functional.

# Install the CLI tool
go install github.com/watzon/goshot/cmd/goshot@latest

# Install the library
go get github.com/watzon/goshot

Package Managers

Arch Linux (AUR)

# Using yay
yay -S goshot-bin

# Using paru
paru -S goshot-bin

Ubuntu/Debian

# Add the PPA
sudo add-apt-repository ppa:watzon/goshot
sudo apt update

# Install goshot
sudo apt install goshot

Basic Usage

package main

import (
    "image/color"
    "log"

    "github.com/watzon/goshot/pkg/background"
    "github.com/watzon/goshot/pkg/chrome"
    "github.com/watzon/goshot/pkg/render"
)

func main() {
    // Create a new canvas with macOS chrome and gradient background
    canvas := render.NewCanvas().
        SetChrome(chrome.NewMacChrome(chrome.WithTitle("Hello World"))).
        SetBackground(
            background.NewGradientBackground(
                background.LinearGradient,
                background.GradientStop{Color: color.RGBA{R: 26, G: 27, B: 38, A: 255}, Position: 0},
                background.GradientStop{Color: color.RGBA{R: 40, G: 42, B: 54, A: 255}, Position: 1},
            ).
                SetAngle(45).
                SetPadding(40).
                SetCornerRadius(8).
                SetShadow(
                    background.NewShadow().
                        SetOffset(0, 3).
                        SetBlur(20).
                        SetSpread(8).
                        SetColor(color.RGBA{R: 0, G: 0, B: 0, A: 200}),
                ),
        ).
        SetCodeStyle(&render.CodeStyle{
            Language:        "go",
            Theme:           "dracula",
            TabWidth:        4,
            ShowLineNumbers: true,
        })

    // Render code to file
    code := `func main() {
        fmt.Println("Hello, World!")
    }`
    
    img, err := canvas.RenderToImage(code)
    if err != nil {
        log.Fatal(err)
    }
    
    if err := render.SaveAsPNG(img, "code.png"); err != nil {
        log.Fatal(err)
    }
}

Documentation

For detailed documentation, examples, and guides, please visit our Wiki:

• Installation Guide - Detailed installation instructions
• Library Usage - Library documentation and examples
• Configuration - Configuration options and customization
• Contributing - Guidelines for contributing

License

This project is licensed under the MIT License - see the LICENSE file for details.