From df96e05f756ed1044ec6eaa34934708f0af9cbec Mon Sep 17 00:00:00 2001 From: ingenium23 Date: Sat, 7 Feb 2026 17:25:12 -0500 Subject: [PATCH] docs: add macOS installation instructions --- README.md | 45 ++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 44 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 3b5f0a2..8efdf5d 100644 --- a/README.md +++ b/README.md @@ -60,7 +60,50 @@ The program works on **Linux**, **macOS**, and **Windows**. If you encounter pro ## Installation on macOS -- We need help writing instructions for macOS, but the program should work in theory. +- Install Homebrew + + - If you don't have it already, install Homebrew (the macOS package manager) by running this in your terminal: + +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +- Install System Dependencies + + - Update your packages and install FFmpeg: + +```bash +brew update && brew upgrade +brew install ffmpeg +``` + +- Install Python 3 + + - You can use a standard Python installation or Miniconda. To install Python via Homebrew: + +```bash +brew install python +``` + +- Install and Run + + - Install the latest stable version of audio-visualizer-python using pip: + +```bash +pip3 install audio-visualizer-python +``` + +- Now run the program from your terminal: + +```bash +avp +``` + +or + +```bash +python3 -m avp +``` ## [Keyboard Shortcuts](https://github.com/djfun/audio-visualizer-python/wiki/Keyboard-Shortcuts)