diff --git a/README.md b/README.md
index 3459699..53c5780 100644
--- a/README.md
+++ b/README.md
@@ -102,6 +102,22 @@ too. From a checkout, `nix develop` gives you `uv`, `ruff` and the audio tools
 for the usual `uv sync` / `uv run pytest` workflow; `nix build` builds and
 tests the package.
 
+### Arch Linux (AUR)
+
+[`beefy-player`](https://aur.archlinux.org/packages/beefy-player) is packaged in
+the AUR (`aur/PKGBUILD` here):
+
+```bash
+paru -S beefy-player        # or: yay -S beefy-player
+```
+
+The Python side is pulled in automatically. For audio, the output-synced
+spectrum and image passthrough through tmux, install the optional tools too:
+
+```bash
+sudo pacman -S mpv ffmpeg libpulse tmux
+```
+
 ### From source
 
 ```bash