vtamp화면을 닫아도 재생이 멈추지 않는 터미널 음악 플레이어.
재생은 백그라운드 서버가 맡습니다. 플레이어를 열어 곡을 고르고 q로 닫은 뒤, 나중에 다른 창에서 다시 열어도 그대로 이어집니다.
로컬 파일과 라이브 라디오를 하나의 큐에서 재생합니다. 스크립트와 에이전트를 위한 JSON CLI와 이벤트 스트림도 제공합니다.
설치brew install rath/tap/vtamp
120 × 28칸. Library와 Queue를 한 화면에.
원본 크기로 보기Ghostty + tmux에서 캡처 · Catppuccin Mocha · 실제 라이브러리, 고해상도 앨범 아트
다른 창 없이,
터미널 안에서.
데스크톱 한구석에 두고 쓰던 작은 플레이어를 좋아했습니다. 요즘은 하루 대부분을 터미널에서 보내니, 음악도 여기에 있는 편이 자연스럽습니다.
앨범 커버는 Sixel 또는 Kitty 그래픽으로 고해상도 표시되며, 접속할 때 자동으로 감지합니다. Ghostty + tmux는 Kitty를 사용하고, tmux에서 Sixel을 쓰려면 tmux와 바깥 터미널이 모두 지원해야 합니다. 픽셀 그래픽을 쓸 수 없으면 컬러 하프블록으로 커버를 보여 줍니다.
색 테마는 아홉 가지입니다. 기본값인 Catppuccin Mocha, 밝은 Latte, Rosé Pine, 초기 녹색 Classic 등이 있습니다. t로 미리 보고 Enter로 저장하면 다음 접속부터 적용됩니다.
$ vtamp열기
서버가 없으면 자동으로 시작합니다. 라이브러리, 큐, 앨범 아트가 바로 나타납니다.
q닫기
화면만 닫히고 서버는 계속 재생합니다. 터미널은 하던 작업으로 돌아갑니다.
$ vtamp다시 열기
다른 창에서 다시 열면 같은 음악, 같은 큐, 재생 중이던 바로 그 지점이 그대로 나타납니다.
큐는 하나, 화면은 필요한 만큼.
미디어 키와 Now Playing 지원
익숙한 미디어 키를 그대로 씁니다. 플레이어를 닫아 둔 채로, tmux에서 detach한 뒤에도 재생, 일시정지, 곡 넘기기가 됩니다.
곡 제목, 아티스트, 앨범 커버가 macOS Now Playing에 표시됩니다. 터미널을 열지 않아도 제어 센터에서 바로 조작할 수 있습니다.
macOS 연동 설명 보기키보드 설정에 따라 Fn을 함께 눌러야 할 수 있습니다.
tmux 상태 표시줄에 현재 곡 표시
플레이어를 닫아도 현재 곡을 계속 볼 수 있습니다. 선택 설치하는 tmux 플러그인이 곡 제목과 경과 / 전체 시간을 상태 표시줄에 보여 줍니다.
일시정지해도 곡은 계속 표시되고, 재생을 멈추거나 서버를 끄면 사라집니다. 너비를 정하고, 아티스트를 추가하고, 원하는 위치에 둘 수 있습니다.
tmux 플러그인 설치하기"work"▶ Training Montage· 0:56 / 3:39플러그인을 불러오기 전에 상태 형식에 #{vtamp}를 넣어 두세요. 시계나 날짜는 없어도 됩니다.
set -g status-right \
'"#{=21:pane_title}" #{vtamp}'단축키로도,
명령어로도.
에이전트가 곡을 찾고, 다음에 재생할 곡을 줄 세우고, 지금 나오는 곡을 끊지 않은 채 큐를 편집할 수 있습니다.
일괄 편집은 적용하기 전에 미리 볼 수 있습니다. 취침 타이머를 걸어 두면 나머지는 서버가 처리합니다.
에이전트 CLI 살펴보기로컬 파일, 로컬 소켓. 계정도 API 키도 클라우드도 끼지 않습니다.
vtamp now --json지금 재생 중인 곡 보기.vtamp library search --artist "DAY6" --json원하는 곡 찾기.vtamp sleep set 30m30분 뒤 정지.$ vtamp now --json{
"version": 6,
"ok": true,
"data": {
"status": "playing",
"position_ms": 102000,
"remaining_ms": 117000,
"queue_revision": 42
}
}응답 일부 · 전체 큐 없이 현재 곡과 설정만 담깁니다.설치하고
바로 재생.
음악 폴더와 터미널만 있으면 됩니다.
나머지는 vtamp가 처리합니다.
macOS · Homebrew 또는 Rust 1.90+ · 로컬 오디오 파일
AAC / ALAC m4a, MP3, FLAC, WAV, Ogg Vorbis