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.
- 🎨 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
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
# Using yay
yay -S goshot-bin
# Using paru
paru -S goshot-bin
# Add the PPA
sudo add-apt-repository ppa:watzon/goshot
sudo apt update
# Install goshot
sudo apt install goshot
package main
import (
"image/color"
"log"
"github.com/watzon/goshot/background"
"github.com/watzon/goshot/chrome"
"github.com/watzon/goshot/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)
}
}
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
This project is licensed under the MIT License - see the LICENSE file for details.