CLI Music Player

About Playgo

Play Music in terminal. Written in Go. Relatively feature-packed.

Built With

• Go
• Mp3 Engine (go-mp3, oto)

Requirements

• Go
• Windows go
• Debian go libasound2-dev
• Mac
• Arch
• Fedora

Installation

Go

go install github.com/axyut/playgo@latest

Curl

curl ...install.sh

Development

• go run . . from the source
• GOOS=linux GOARCH=amd64 go build -o ~/go/bin/ . build to your bin path.
• GOOS=linux GOARCH=amd64 go build . && sudo cp playgo /usr/local/bin/ build for the system.
  • GOOS=darwin GOARCH=amd64 Mac
  • GOOS=windows GOARCH=amd64 Windows

Features

• Plays Music.
• Light weight with minimum dependencies.
• Controls.
• Visualization.

Themes

• UI with bubbletea
• Raw UI Build

Audio Engine

• oto
• go-mp3
• beep
• portaudio

Usage

## flags
  play files                  - $playgo <file.mp3> <file2.mp3>
  play all music in folder    - $playgo / $playgo . / $playgo ~/Music/path
  help                        - $playgo -h
  test condition/health       - $playgo -t
## while playing
  q - quit player
  p - Play/Pause

  h - play previous song
  j - seek backward 10s
  k - seek forward 10s
  l - play next song

  w - Increase Volume by 5%
  a -
  s - Decrease Volume by 5%
  d -

  e - Toogle Repeat Playlist On/Off
  r - Toogle Repeat Song On/Off
  t - Toogle Shuffle On/Off

Configuration

About settings... A config file will be generated when you first run playgo. Depending on your operating system it can be found in one of the following locations:

• macOS: ~/Library/Application\ Support/playgo/config.yml
• Linux: ~/.config/playgo/config.yml
• Windows: C:\Users\me\AppData\Roaming\playgo\config.yml

It will include the following default settings:

setting:
  general:
    show_icons: true
  player:
    shuffle: true
    repeat_playlist: true
  music:
    repeat_song: false
theme:
  raw: true

Uninstalling

If installed with go install remove bin file from your go bin path. If not setup, by default it is in ~/go/bin, If installed with curl ...