KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

volume-go

★ 119 Open GitHub ↗

Cross-platform audio volume control library for Go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# volume-go
[![CI Status](https://github.com/itchyny/volume-go/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/itchyny/volume-go/actions/workflows/ci.yaml?query=branch:main)
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/itchyny/volume-go/blob/main/LICENSE)
[![release](https://img.shields.io/github/release/itchyny/volume-go/all.svg)](https://github.com/itchyny/volume-go/releases)
[![pkg.go.dev](https://pkg.go.dev/badge/github.com/itchyny/volume-go)](https://pkg.go.dev/github.com/itchyny/volume-go)

### Cross-platform audio volume control library for Go language
This is a Go language package for controlling audio volume.

## volume command
### Homebrew
```sh
brew install itchyny/tap/volume
```

### Build from source
```sh
go install github.com/itchyny/volume-go/cmd/volume@latest
```

### Basic usage
```sh
 $ # Get the current audio volume.
 $ volume get
20

$ # Set the audio volume.
 $ volume set 40
 $ volume status
volume: 40
muted: false

$ # Increase/decrease the audio volume.
 $ volume get
40
 $ volume up
 $ volume get
46

$ volume down
 $ volume get
44

$ # Get current audio volume status.
 $ volume status
volume: 20
muted: false

$ # Mute and unmute.
 $ volume mute
 $ volume status
volume: 20
muted: true

$ volume unmute
 $ volume status
volume: 20
muted: false
```

## Package usage
```go
package main

import (
	"fmt"
	"log"

"github.com/itchyny/volume-go"
)

func main() {
	vol, err := volume.GetVolume()
	if err != nil {
		log.Fatalf("get volume failed: %+v", err)
	}
	fmt.Printf("current volume: %d\n", vol)

err = volume.SetVolume(10)
	if err != nil {
		log.Fatalf("set volume failed: %+v", err)
	}
	fmt.Printf("set volume success\n")

err = volume.Mute()
	if err != nil {
		log.Fatalf("mute failed: %+v", err)
	}

err = volume.Unmute()
	if err != nil {
		log.Fatalf("unmute failed: %+v", err)
	}
}
```

## Bug Tracker
Report bug at [Issues・itchyny/volume-go - GitHub](https://github.com/itchyny/volume-go/issues).

## Author
itchyny (<https://github.com/itchyny>)

## License
This software is released under the MIT License, see LICENSE.

volume-go

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README