gen2brain/beeep

Go cross-platform library for sending desktop notifications, alerts and beeps

Go

1,770

113 commits

updated Dec 11, 2025

See the code

README

beeep

Build Status Go Reference

beeep provides a cross-platform library for sending desktop notifications, alerts and beeps.

Installation

go get -u github.com/gen2brain/beeep

Build tags

  • nodbus - disable godbus/dbus and use only notify-send

Examples

err := beeep.Beep(beeep.DefaultFreq, beeep.DefaultDuration)
if err != nil {
    panic(err)
}
//go:embed testdata/info.png
var icon []byte

err := beeep.Notify("Title", "Message body", icon)
if err != nil {
    panic(err)
}
beeep.AppName = "My App Name"

err := beeep.Alert("Title", "Message body", "testdata/warning.png")
if err != nil {
    panic(err)
}
beep
beeps
notifications
notify

Significant stargazers

Yurii Rashkovskii

818 followers · starred Jun 2023

technoweenie

2,765 followers · starred Dec 2019

Yash Ladha

182 followers · starred Nov 2019

Lauris B

104 followers · starred Feb 2026

gen2brain/beeep

Go cross-platform library for sending desktop notifications, alerts and beeps

Go

1,770

113 commits

updated Dec 11, 2025

See the code

README

beeep

Build Status Go Reference

beeep provides a cross-platform library for sending desktop notifications, alerts and beeps.

Installation

go get -u github.com/gen2brain/beeep

Build tags

  • nodbus - disable godbus/dbus and use only notify-send

Examples

err := beeep.Beep(beeep.DefaultFreq, beeep.DefaultDuration)
if err != nil {
    panic(err)
}
//go:embed testdata/info.png
var icon []byte

err := beeep.Notify("Title", "Message body", icon)
if err != nil {
    panic(err)
}
beeep.AppName = "My App Name"

err := beeep.Alert("Title", "Message body", "testdata/warning.png")
if err != nil {
    panic(err)
}
beep
beeps
notifications
notify

Significant stargazers

Yurii Rashkovskii

818 followers · starred Jun 2023

technoweenie

2,765 followers · starred Dec 2019

Yash Ladha

182 followers · starred Nov 2019

Lauris B

104 followers · starred Feb 2026