go-vgo/robotgo sits at 10.9k stars on GitHub, written primarily in Go. RobotGo, Go Native cross-platform RPA, GUI automation, Auto test and Computer use @vcaesar
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Français | Deutsch | Español | Русский | Português
Golang Desktop Automation, auto test and AI Computer Use.
Control the mouse, keyboard, read the screen, process, Window Handle, image and bitmap and global event listener.
RobotGo supports Mac, Windows, and Linux; and robotgo supports arm64 and x86-amd64.
I build Codg now, Easy code and work AI agent system: auto, asynchronous, concurrency, efficiently and High accuracy
RobotGo-Pro get the JavaScript, Python, Lua and others version, tech supports, new features and newest robotgo version ("no open-source version now").
ADB, packaging android adb and ios wda, robotgo compatible API.
Requirements
Go 1.26+ (see go.mod) and one backend:
Default (Cgo):CGO_ENABLED=1, a C compiler and the platform libraries below.
Pure Go (tested): no C toolchain; see Cgo-free Builds.
Both need the feature-specific dependencies
for the features you use.
Default Cgo setup
macOS
Go and the Xcode Command Line Tools (Clang):
brew install go
xcode-select --install
Permissions (Cgo and pure Go): in System Settings > Privacy & Security,
grant the app or terminal Accessibility (input) and Screen Recording
(capture).
The toolchain's bin (e.g. C:\mingw64\bin) must be on PATH and match
GOARCH. Any other Cgo-compatible compiler, such as a manual
MinGW-w64 install, also works.
Bitmap ships libpng for MinGW-w64 only;
with another toolchain, build libpng yourself.
Linux (X11)
Build: GCC, libc headers, X11/XTest headers. Runtime: an X server with XTEST
and DISPLAY set. For native Wayland, see Cgo-free Builds.
Bitmap and GoHook are separate Cgo packages; a pure-Go RobotGo backend does not
remove their C requirements.
Cgo-free Builds
Tested pure-Go backends build and cross-compile with CGO_ENABLED=0
(no GCC, MinGW, Xcode or X11 headers). Same import path and API; a build tag
selects the backend — CGO_ENABLED=0 alone selects nothing.
Target GOOS
Build tag
Package
Runtime requirements
windows
win
win
Win32 only, no extra runtime
darwin
mac
darwin
System frameworks and privacy permissions
linux
x11
x11
X server with XTEST, DISPLAY set
linux
wayland
wayland
wlroots compositor, see Wayland
linux
libei
libei
RemoteDesktop portal (GNOME/KDE), see libei
purego is a shortcut: mac on macOS, win on Windows, wayland on
Linux. Add x11 or libei to override on Linux (-tags "purego,x11").
Use one backend tag matching GOOS; combinations such as x11,libei fail
to compile (purego plus one Linux override is the only exception).
Build commands
# Current OS
CGO_ENABLED=0 go build -tags purego .
# Cross-compile
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -tags win .
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -tags mac .
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -tags x11 .
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -tags wayland .
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -tags libei .
PowerShell: $env:CGO_ENABLED = "0"; go build -tags purego .
Build the module root (.) or your own package, not ./...: examples/ and
some subpackages need Cgo-only APIs.
Limitations
The runtime requirements above still apply. Cgo-only APIs such as
CaptureScreen / FreeBitmap do not exist; use CaptureImg. Unsupported
operations return ErrNotSupported (or an empty result).
mac: window management (GetTitle, GetBounds, ActivePid,
ActiveName, MinWindow, MaxWindow, CloseWindow) uses Accessibility
and needs the Accessibility permission; MaxWindow toggles native full
screen and GetClient equals GetBounds.
wayland, libei: Wayland has no protocol for the global cursor
position. Location() reads the real cursor from Hyprland (IPC socket) and
KDE Plasma (KWin script over D-Bus) when that query succeeds; wayland also
needs every output to share one scale ratio (differently scaled or rotated
outputs fall back). Otherwise, and elsewhere (GNOME, Sway, other wlroots
compositors), it returns the last position injected by RobotGo, not the
physical cursor. Clipboard needs wl-clipboard.
Wayland
A wlroots compositor (Sway, Hyprland, Wayfire, ...) with WAYLAND_DISPLAY and
XDG_RUNTIME_DIR set, exposing:
Feature
Protocol global
Mouse control
zwlr_virtual_pointer_manager_v1
Keyboard control
zwp_virtual_keyboard_manager_v1
Screen capture
zwlr_screencopy_manager_v1
Window management
zwlr_foreign_toplevel_manager_v1
GNOME and KDE do not provide these protocols; use libei there.
libei (GNOME / KDE)
Input goes through the xdg-desktop-portalRemoteDesktop D-Bus interface:
needs a session bus, xdg-desktop-portal and a backend implementing it
(xdg-desktop-portal-gnome, -kde or -wlr). The first run shows a consent
dialog; the restore token is cached under $XDG_STATE_HOME/robotgo.
Absolute motion uses a linked ScreenCast stream (default); set
libei.LinkScreenCast = false for relative motion only. Screen capture and
window management report ErrNotSupported.
Installation
go get github.com/go-vgo/robotgo
import "github.com/go-vgo/robotgo"
png.h: No such file or directory with Bitmap: see its libpng requirements and
issues/47.
Update
go get -u github.com/go-vgo/robotgo
Note go1.10.x C file compilation cache problem, golang #24355.
go mod vendor problem, golang #26366.
Examples
Mouse
package main
import (
"errors"
"fmt"
"github.com/go-vgo/robotgo"
)
func main() {
robotgo.MouseSleep = 300
robotgo.Move(100, 100)
fmt.Println(robotgo.Location())
robotgo.Move(100, -200) // multi screen supported
robotgo.MoveSmooth(120, -150)
fmt.Println(robotgo.Location())
robotgo.ScrollDir(10, "up")
robotgo.ScrollDir(20, "right")
robotgo.Scroll(0, -10)
robotgo.Scroll(100, 0)
robotgo.MilliSleep(100)
robotgo.ScrollSmooth(-10, 6)
// robotgo.ScrollRelative(10, -100)
robotgo.Move(10, 20)
robotgo.MoveRelative(0, -10)
robotgo.DragSmooth(10, 10)
robotgo.Click("wheelRight")
robotgo.Click("left", true)
robotgo.MoveSmooth(100, 200, 1.0, 10.0)
robotgo.Toggle("left")
robotgo.Toggle("left", "up")
// Check the returned errors, invalid arguments return an error
if err := robotgo.ScrollDir(10, "forward"); err != nil {
fmt.Println("robotgo.ScrollDir error:", err)
}
// Backends differ: Cgo returns an error, pure Go does a single left click and returns nil
if err := robotgo.Click("left", "double"); err != nil {
fmt.Println("robotgo.Click error:", err)
}
// MoveSmoothRelative reports a failed smooth move as ErrSmoothMove
err := robotgo.MoveSmoothRelative(10, -10)
if errors.Is(err, robotgo.ErrSmoothMove) {
fmt.Println("smooth move failed:", err)
}
// Pure-Go backends return ErrNotSupported for unsupported operations
err = robotgo.Move(100, 200)
if errors.Is(err, robotgo.ErrNotSupported) {
fmt.Println("robotgo.Move is not supported by this backend")
}
}
Keyboard
package main
import (
"errors"
"fmt"
"github.com/go-vgo/robotgo"
)
func main() {
robotgo.Type("Hello World")
robotgo.Type("だんしゃり", 0, 1)
// robotgo.Type("テストする")
robotgo.Type("Hi, Seattle space needle, Golden gate bridge, One world trade center.")
robotgo.Type("Hi galaxy, hi stars, hi MT.Rainier, hi sea. こんにちは世界.")
robotgo.Sleep(1)
// ustr := uint32(robotgo.CharCodeAt("Test", 0))
// robotgo.UnicodeType(ustr)
robotgo.KeySleep = 100
robotgo.KeyTap("enter")
// robotgo.Type("en")
robotgo.KeyTap("i", "alt", "cmd")
arr := []string{"alt", "cmd"}
robotgo.KeyTap("i", arr)
robotgo.MilliSleep(100)
robotgo.KeyToggle("a")
robotgo.KeyToggle("a", "up")
robotgo.WriteAll("Test")
text, err := robotgo.ReadAll()
if err == nil {
fmt.Println(text)
}
// Unknown key names return an error instead of pressing a wrong key
if err := robotgo.KeyTap("notakey"); err != nil {
fmt.Println("robotgo.KeyTap error:", err)
}
// TypeStr returns the first typing error, Type only returns the count
if err := robotgo.TypeStr("Hello, 世界"); err != nil {
fmt.Println("robotgo.TypeStr error:", err)
}
// Hold a modifier, then always release it and check both errors
if err := robotgo.KeyDown("shift"); err == nil {
err = errors.Join(robotgo.KeyTap("a"), robotgo.KeyUp("shift"))
if err != nil {
fmt.Println("shift + a error:", err)
}
}
}
Screen
package main
import (
"fmt"
"strconv"
"github.com/go-vgo/robotgo"
"github.com/vcaesar/imgo"
)
func main() {
x, y := robotgo.Location()
fmt.Println("pos: ", x, y)
color := robotgo.GetPixelColor(100, 200)
fmt.Println("color---- ", color)
sx, sy := robotgo.GetScreenSize()
fmt.Println("get screen size: ", sx, sy)
bit := robotgo.CaptureScreen(10, 10, 30, 30)
defer robotgo.FreeBitmap(bit)
img := robotgo.ToImage(bit)
imgo.Save("test.png", img)
num := robotgo.DisplaysNum()
for i := 0; i < num; i++ {
robotgo.DisplayID = i
img1, _ := robotgo.CaptureImg()
path1 := "save_" + strconv.Itoa(i)
robotgo.Save(img1, path1+".png")
robotgo.SaveJpeg(img1, path1+".jpeg", 50)
img2, _ := robotgo.CaptureImg(10, 10, 20, 20)
robotgo.Save(img2, "test_"+strconv.Itoa(i)+".png")
x, y, w, h := robotgo.GetDisplayBounds(i)
img3, err := robotgo.CaptureImg(x, y, w, h)
fmt.Println("Capture error: ", err)
robotgo.Save(img3, path1+"_1.png")
}
}
The most recent commit recorded on go-vgo/robotgo was 3 months ago, based on the GitHub push timestamp. The repository has 967 forks — one of the better signals of community interest.
How does go-vgo/robotgo compare to other Backend projects?
go-vgo/robotgo is tracked by TopGit in the Backend category, with 10.9k GitHub stars and written in Go. Browse the Backend topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does go-vgo/robotgo have?
go-vgo/robotgo has 10.9k GitHub stars — refresh the page for the live number, or check github.com/go-vgo/robotgo. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is go-vgo/robotgo?
go-vgo/robotgo (go-vgo/robotgo) is a Go project on GitHub. From the project's own README: RobotGo, Go Native cross-platform RPA, GUI automation, Auto test and Computer use @vcaesar
What language is go-vgo/robotgo written in?
go-vgo/robotgo is written primarily in Go. GitHub's language field is based on the largest share of bytes in the default branch.
TopGit places go-vgo/robotgo in the Backend category based on its GitHub topics and description (tagged: "ai", "auto-test", "automation"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Is robotgo worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of robotgo.