amp

Guía · 01

Instalación

libmpv para el sonido, uv para Python, y luego amp — en macOS, Linux o Windows.

amp necesita tres cosas: libmpv, que reproduce el sonido; uv, que trae el Python adecuado y las dependencias de amp; y el propio amp. Diez minutos como mucho, casi todo de descarga.

1. libmpv

brew install mpv                    # macOS
sudo apt install libmpv2            # Debian, Ubuntu (libmpv1 en versiones antiguas)
sudo dnf install mpv-libs           # Fedora
sudo pacman -S mpv                  # Arch
scoop install mpv                   # Windows

En Windows también puedes poner libmpv-2.dll junto a python.exe o en cualquier lugar de tu PATH. Si libmpv está en un sitio poco habitual, dile a amp dónde: AMP_LIBMPV=/path/to/libmpv.dylib.

¿Aún sin libmpv? amp se abre igualmente con --no-audio: todo funciona menos el sonido — práctico para echar un vistazo primero.

2. uv

uv instala Python 3.14 y las versiones exactas de las dependencias de amp. Nunca tocas un entorno virtual tú mismo.

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                             # todo, con miniaturas de portadas
uv run amp --diagnose               # comprueba libmpv, el medidor de nivel y las portadas

--diagnose te dice qué puede mostrar tu terminal (imágenes reales en kitty y Ghostty, medios bloques en los demás) y si el motor de audio responde.

amp en todas partes

Para escribir amp desde cualquier carpeta en lugar de uv run amp, instala los comandos una vez:

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

Así tienes amp y ampd. La versión de ventana se instala del mismo modo: uv tool install ./amp-qt --with ./amp-core, y luego amp-qt.

Extras opcionales

Herramienta Para
ffmpeg en el PATH convertir archivos, convertir grabaciones, Opus o MP3 para un teléfono
fpcalc (Chromaprint) y una clave AcoustID gratuita reconocer un archivo por su sonido

fpcalc viene con Chromaprint: brew install chromaprint, sudo apt install libchromaprint-tools, o la versión para Windows de acoustid.org.