sounds

README

Licenses:

message.opus is taken from `sound-theme-freedesktop` at
https://directory.fsf.org/wiki/Sound-theme-freedesktop. It is re-encoded from
the original .oga file to a low bitrate .opus file. It is licensed under
Creative Commons.

Documentation

Index

• Constants
• func Play(app *app.Application, id string)

Examples

• Play

Constants

const (
	Bell    = "bell"
	Message = "message"
)

Sound IDs.

Functions

func Play

func Play(app *app.Application, id string)

Play plays the given sound ID. It first uses Canberra, falling back to ~/.cache/gotktrix/{id}.opus, then the embedded audio (if any), then display.Beep() otherwise.

Play is asynchronous; it returning does not mean the audio has successfully been played to the user.

Example

app := app.New(context.Background(), "com.example.app", "app")
app.ConnectActivate(func() {
	// Plays are automatically debounced.
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)
	sounds.Play(app, sounds.Message)

	app.Hold()
	glib.TimeoutSecondsAdd(1, app.Release)
})

app.Run(nil)