cold

README

CLI Music Player

About cold

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

Requirements

• Go
• Windows
• Debian libasound2-dev
• Mac
• Arch alsa alsa-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: true
player:
    shuffle: true
    repeat_playlist: true
music:
    repeat_song: false
    repeat_playlist: true
    shuffle: true
renderer: tea # tea, tview, raw
user:
    use_db: false
temp:
    start_dir: ""
    show_icons: false
    show_hidden: false
    exclude: []
    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, gomu simlar in go, grump similar in rust project structure github actions trigger commands parser go releaser radio example tui vis example gstreamer oto wrapper