cliamp とは？
cliamp は ターミナル向けに作り直された Winamp 2.x です。プレイリストエディタ、グラフィックイコライザ、スペクトラムビジュアライザ、そしてスキンの代わりとなるテーマ機構が、すべてテキストで描かれます。ローカルファイル（MP3、FLAC、OGG、WAV）、インターネットラジオ、ポッドキャストを再生し、Spotify、Qobuz、Navidrome、Jellyfin、Emby、Plex、SoundCloud、NetEase、YouTube Music を一つの画面から扱えます。--daemon を付ければ同じバイナリが UI を持たないプレーヤーになり、IPC ソケット越しに操作できます。ステータスバーもキーバインドもスクリプトも、すでに鳴っている音楽と直接やり取りできます。
⚡ cliamp の主な機能
🎚️ テキストで再現した Winamp
プレイリストエディタ、グラフィックイコライザ、ピークメータ付きの往年のレイアウトを罫線文字で描き直しました。dracula や nord から vantablack まで 20 種類の内蔵テーマが、かつてのスキンのように見た目を丸ごと変えます。
📡 ラジオとストリーミング
お気に入り付きのインターネットラジオカタログに加え、Spotify、Qobuz、Navidrome、Jellyfin、Emby、Plex、SoundCloud、NetEase、YouTube Music を --provider 一つと対話型ウィザード cliamp setup で扱えます。
📊 29 種類のビジュアライザ
スペクトラムバー、オシロスコープ、ステレオフィールド、マトリックスの雨、炎、花火など、すべて同じ FFT から描かれます。cliamp vis で実行中に切り替えられ、--low-power はバッテリー重視のときに丸ごと止めます。
🎛️ 本格的なオーディオ設定
プリセット付きのパラメトリックイコライザ、0.25 倍から 2 倍までの再生速度、モノラルダウンミックス、ギャップレス再生、出力デバイスの切り替え、サンプルレート・ビット深度・バッファサイズの明示的な指定。
🖥️ ヘッドレスなデーモンと IPC
cliamp --daemon は TUI なしで再生し、ソケット越しに cliamp status、next、volume に応答します。cliamp visstream はビジュアライザの帯域を NDJSON で出力し、Waybar や quickshell、パイプを読めるものなら何にでも渡せます。
🧩 サンドボックス化された Lua プラグイン
再生イベント、キーマップ、通知、HTTP、ストレージ向けのフックを備えたプラグイン API を、すべてサンドボックス内で提供します。同梱の例は「再生中」ファイル、Webhook、ジャンル別の自動イコライジングを扱います。
apt upgrade だけで常に最新バージョンを維持できます。
📦 deb.griffo.io からのインストール
ステップ 1: リポジトリを追加
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update🆓 ずっと無料の選択肢もあります。 cliamp は deb-free.griffo.io のずっと無料のミラーにも収録されています。アカウントもサブスクリプションも不要、上流より最大2か月遅れ、セキュリティ修正は即座に公開されます。上のリポジトリの代わりに、こちらを追加してください:
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt updateステップ 2: cliamp をインストール
# 最新の cliamp をインストール
sudo apt install cliamp
# ffmpeg は推奨（追加フォーマットとストリーム対応）、
# yt-dlp は提案（YouTube と YouTube Music 用）
sudo apt install ffmpeg yt-dlp
# インストールを確認
cliamp --version# 最新の cliamp をインストール
apt install cliamp
# ffmpeg は推奨（追加フォーマットとストリーム対応）、
# yt-dlp は提案（YouTube と YouTube Music 用）
apt install ffmpeg yt-dlp
# インストールを確認
cliamp --versionステップ 3: 最初の再生
# 音楽フォルダをプレーヤーで開く
cliamp ~/Music
# またはインターネットラジオのカタログから始める
cliamp --provider radio
# Spotify、Qobuz、Navidrome、Jellyfin、Emby、Plex を設定
cliamp setup
# bash と zsh の補完はパッケージに同梱
cliamp --help🎯 基本的な使用例
再生する:
# ファイル、フォルダ、ストリーム URL
cliamp ~/Music/albums/1997
cliamp https://stream.example.org/radio.mp3
# すぐにシャッフル再生を開始
cliamp ~/Music --auto-play --shuffle
# 保存したプレイリストを名前で指定
cliamp --playlist roadtrip
# YouTube Music の URL（yt-dlp が必要）
cliamp "https://music.youtube.com/watch?v=..."
# 何を聴いたか
cliamp history見た目と音:
# テーマの一覧と切り替え
cliamp theme list
cliamp theme tokyo-night
# ビジュアライザの一覧と切り替え
cliamp vis list
cliamp vis Stereo
# イコライザのプリセットと再生速度
cliamp eq Rock
cliamp speed 1.25
# 出力デバイスを選ぶ
cliamp --audio-device list
cliamp device "USB Audio"
# 小さな端末向けの 80 桁レイアウト
cliamp --compactヘッドレスとスクリプト:
# TUI なしで動かし、IPC を提供
cliamp --daemon ~/Music
# 動作中のプレーヤーをどこからでも操作
cliamp toggle
cliamp next
cliamp volume -3
cliamp seek 90
cliamp status
# ビジュアライザの帯域をステータスバーに流す
cliamp visstream | jq -c .
# Lua プラグインを管理
cliamp plugins list🔧 ツール連携
cliamp は、システムにすでにあるものの上に意図的に組み立てられています:
- ALSA: 音声は
libasoundから出力されます。パッケージが依存しているのはそのためで、デスクトップセッションのない素のサーバーでも動きます - ffmpeg: 推奨。内蔵デコーダが扱わないフォーマットやストリームに使われます
- yt-dlp: 提案。YouTube と YouTube Music の再生に必要です
- D-Bus 経由の MPRIS: キーボードのメディアキーやデスクトップの「再生中」ウィジェットが、他のプレーヤーと同じように cliamp を操作します
- Waybar、quickshell、シェル: IPC ソケットと
cliamp visstreamがステータスバーやウィジェットを動かし、bash と zsh の補完はこのパッケージに同梱されています
🚀 なぜ deb.griffo.io を選ぶのか？
- 公式 Ubuntu: cliamp をパッケージ化していないため、素のシステムでは
apt install cliampは失敗します - go install: 最新ではありますが、マシンごとに cgo ビルドが必要で、先に ALSA、FLAC、Ogg、Vorbis の開発ヘッダを用意しなければなりません
- 上流のインストールスクリプト: 手軽ですが、パッケージマネージャの知らないうちに
~/.local/binへバイナリを置き、その後はcliamp upgradeが独自のタイミングでそのバイナリを差し替えます - deb.griffo.io: 自動更新付きの最新バージョン
- ✅ 唯一の apt ソース: cliamp は Debian にも Ubuntu のアーカイブにもありません。このリポジトリが公式の上流ビルドをパッケージ化しています
- ✅ ストリーミングは壊れ、上流で直る: cliamp が話す音楽サービスは絶えず変わるため、今月のリリースかどうかがプロバイダの可否を分けます
- ✅ 自動更新: 上流リリースの数時間以内にパッケージを更新
- ✅ 完全なパッケージ:
/usr/bin/cliamp、man ページ、アプリアイコン付きのデスクトップエントリ、bash と zsh の補完 - ✅ 正直な依存関係: ALSA に依存し、
ffmpegを推奨、yt-dlpを提案するので、最小構成は最小のままです - ✅ 2 つのアーキテクチャ: amd64 と arm64。同じパッケージがノート PC と Raspberry Pi の両方をカバーします
- ✅ マルチディストリビューション: Ubuntu 22.04、24.04、25.10、26.04 で動作
- ✅ 簡単なメンテナンス: 更新は標準の apt コマンドで
📦 パッケージビルドリポジトリ
Ubuntu パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:
- 📻 cliamp-debian - 最新リリースのビルド
🔗 関連パッケージ
deb.griffo.io では次も利用できます:
- termusic - もう一つのターミナル音楽・ポッドキャストプレーヤー。レイアウトの好みで選べます
- lowfi - UI を一切求めないときのための、コマンド一つで動く lo-fi ラジオプレーヤー
- yt-dlp - cliamp が YouTube と YouTube Music のために呼び出すダウンローダ
- Yazi - 再生する前にアルバムを探すためのターミナルファイルマネージャ