CLI Music Player

About cold

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

Requirements

• Go
• Windows
• Debian libasound2-dev
• Mac
• Arch alsaalsa-lib
• Fedora alsa-lib-devel

Installation

Go

go install github.com/axyut/cold@latest

Curl

curl ...install.sh

Build From Source

• go version 1.22
• git clone https://github.com/axyut/cold.git && cd cold
• make install for debian.
• make build or make build_arm for binary at bin/.
• cp bin/[filename] ~/.local/bin/cold
• cold

Features

• Plays Music.
• Light weight with minimum dependencies.
• Controls.
• Stream, Radio
• Visualization.

Themes

• UI with bubbletea
• Tview(https://github.com/rivo/tview)
• Raw UI Build

Audio Engine

• oto
• go-mp3
• beep
• portaudio

Built With

• Go
• Mp3 Engine (go-mp3, oto)
• Cobra
• UI with bubbletea
• Go FM

Usage

cold -h

Configuration

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

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

It will include the following default settings:

general:
start_dir: /home/user/Music/score/enable_logging: trueplayer:
shuffle: truerepeat_playlist: truemusic:
repeat_song: falserepeat_playlist: trueshuffle: truerenderer: tea # tea, tview, rawuser:
use_db: falsetemp:
start_dir: ""show_icons: falseshow_hidden: falseexclude: []playonly: []include: []renderer: ""enable_logging: false

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 ...

IMP Links

similar in go, gomusimlar in go, grumpsimilar in rustproject structuregithub actions triggercommands parsergo releaserradio exampletui vis examplegstreameroto wrapper