amp

Guide · 01

Installation

libmpv pour le son, uv pour Python, puis amp lui-même — sur macOS, Linux ou Windows.

amp a besoin de trois choses : libmpv, qui joue le son ; uv, qui apporte le bon Python et les dépendances d’amp ; et amp lui-même. Dix minutes au plus, surtout de téléchargement.

1. libmpv

brew install mpv                    # macOS
sudo apt install libmpv2            # Debian, Ubuntu (libmpv1 sur les versions plus anciennes)
sudo dnf install mpv-libs           # Fedora
sudo pacman -S mpv                  # Arch
scoop install mpv                   # Windows

Sous Windows, vous pouvez aussi placer libmpv-2.dll à côté de python.exe ou n’importe où dans votre PATH. Si libmpv se trouve à un endroit inhabituel, indiquez-le à amp : AMP_LIBMPV=/path/to/libmpv.dylib.

Pas encore de libmpv ? amp s’ouvre quand même avec --no-audio : tout fonctionne sauf le son — pratique pour faire d’abord le tour.

2. uv

uv installe Python 3.14 et les versions exactes des dépendances d’amp. Vous ne touchez jamais vous-même à un environnement virtuel.

curl -LsSf https://astral.sh/uv/install.sh | sh                 # macOS, Linux
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"      # Windows

3. amp

git clone <repository> amp && cd amp
uv sync                             # tout, avec les vignettes de pochettes
uv run amp --diagnose               # vérifie libmpv, le vumètre et les pochettes

--diagnose vous dit ce que votre terminal sait afficher (de vraies images dans kitty et Ghostty, des demi-blocs ailleurs) et si le moteur audio répond.

amp partout

Pour taper amp depuis n’importe quel dossier au lieu de uv run amp, installez les commandes une fois :

uv tool install ./amp-tui --with ./amp-core --with-executables-from amp-core

Vous obtenez amp et ampd. La version fenêtrée s’installe de la même façon : uv tool install ./amp-qt --with ./amp-core, puis amp-qt.

Extras facultatifs

Outil Pour
ffmpeg dans le PATH convertir des fichiers, convertir des enregistrements, de l’Opus ou du MP3 pour un téléphone
fpcalc (Chromaprint) et une clé AcoustID gratuite reconnaître un fichier à son son

fpcalc est fourni avec Chromaprint : brew install chromaprint, sudo apt install libchromaprint-tools, ou la version Windows sur acoustid.org.