About this project

libvlc-go provides handcrafted Go bindings for libVLC along with a higher-level media-player interface. It is intended for Go applications that need embedded multimedia playback or other VLC-provided media capabilities. The library uses Go modules to mirror supported libVLC major versions: the v3 module implements bindings for libVLC 3.x, while v2 targets libVLC 2.x. A legacy build tag is documented for libVLC versions before 2.2.0. Building or using the package requires the libVLC development files, with installation guidance for Linux, Windows, and macOS in the project wiki. The API supports initializing and releasing libVLC, creating players, loading media from local paths or URLs, controlling playback, and managing event callbacks. Documented examples also cover list players, media tracks, media information, screen display, screen recording, Chromecast streaming, equalizer usage, and media discovery. GUI examples are provided using GTK 3 and GTK 2. The project is MIT licensed, includes package documentation on pkg.go.dev, and links to upstream libVLC references. Listed users include a command-line music player and a 24/7 slow-TV art project.