noriah / catnip Goto Github PK

View Code? Open in Web Editor NEW

208.0 3.0 12.0 2.68 MB

terminal audio visualizer for linux/unix/macOS/windblows*

License: MIT License

Go 96.19% Julia 3.06% Shell 0.22% Makefile 0.52%

audio terminal golang portaudio ffmpeg pulseaudio visualization visualizer music-visualizer audio-visualizer

catnip's Introduction

catnip

terminal audio visualizer for linux/unix/macOS/windows*

^ click for a fun video

it supports audio backends

ALSA (linux FFmpeg)
AVFoundation (macOS FFmpeg)
DirectShow (windblows FFmpeg)
Pipewire (pw-cat)
PortAudio (linux/macOS/windblows (maybe))
PulseAudio (parec/FFmpeg)

it depends on

go modules
- github.com/nsf/termbox-go
- github.com/integrii/flaggy
- github.com/pkg/errors
- github.com/noisetorch/pulseaudio
- gonum.org/v1/gonum
binaries
- ffmpeg (required for FFmpeg backends)
- parec (required for PulseAudio backend with parec)
- pw-cat, pw-link (required for Pipewire backend)
c libraries (optional, requires CGO - CGO_ENABLED=1)
- fftw (fftw3) (enable with -tags fftw)
- portaudio (portaudio-2.0) (enable with -tags portaudio)

get it

# get source
git clone https://github.com/noriah/catnip.git

# cd to dir
cd catnip

# build and install catnip
go install ./cmd/catnip

# with portaudio
go install ./cmd/catnip -tags portaudio

# with fftw3
go install ./cmd/catnip -tags fftw

# with both portaudio and fftw3
go install ./cmd/catnip -tags portaudio,fftw

run it

use catnip list-backends to show available backends
use catnip -b {backend} list-devices to show available devices
use catnip -b {backend} -d {device} to run - use the full device name
use catnip -h for information on several more customizations

question it

catnip?

long story, short explanation

update

catnip's People

Contributors

Stargazers

Watchers

Forkers

diamondburned pahosler sensorphalanx yottamusic rizalgowandy taekwonzeus diyism k713927 angleton jcbevns zoemcc juanlegrange1994

catnip's Issues

[feature request?] put it in the AUR

put it in the AUR

put it in the aur

hangs on close when using portaudio

When using portaudio backend, closing catnip hangs the program

[input/ffmpeg] Windows DirectShow issues

input\ffmpeg\dshow.go:31:9: not enough return values

    have (*execread.Session)

    want (*execread.Session, error)

[feature request] option to visualize on logarithmic scale

It'd also be cool to have a toggle/setting that flips between logarithmic and linear axis scales, since right now I think the low frequencies are being squished together.

For reference, here's what an audio spectrum with a logarithmic scale looks like:

, versus a linear scale like

, which is what the visualizer looks like right now.

README has Google link

I almost clicked on that link before seeing the tooltip. Please switch it from Google to something like a SearX mirror or at least DuckDuckGo/Qwant/Startpage

What is the spectrum visualizer program you're running in the second demo vid?

it looks really cool

channel stops drawing randomly

pictured here:

Apparently the underlying library has no compatibility with Tmux (although it is only superficial), this is because Tmux sets the environment variable to tmux-256color, so it will end up with an unknown terminal error, instead, if the environment variable is changed to xterm-256color, the program works as expected.

This is the error I get:

failed to run catnip:  termbox: error while reading terminfo data: termbox: unsupported terminal

But if I run it this way, the problem is solved:

TERM=xterm-256color catnip

Clarify Build Instructions noportaudio

Can you please provide an example of building without portaudio?

(disable with -build noportaudio)" is unclear.

Thanks.