Installation

Prerequisites:

• Python 3.11 or later
• Pip

Windows

• Download Microsoft Visual C++
• Download FFmpeg
• Open Powershell:

  cd $HOME
  

  Invoke-WebRequest -Uri "https://github.com/Ethorbit/SoundPrompt/releases/download/v0.1.5/soundprompt-0.1.5-py3-none-any.whl" -OutFile "soundprompt-0.1.5-py3-none-any.whl"
  

  pip install --user soundprompt-0.1.5-py3-none-any.whl
  

  python -m site --user-base
  

That last Powershell command will print something like:

C:\Users\YourName\AppData\Roaming\Python\Python311

Your scripts are in:

C:\Users\YourName\AppData\Roaming\Python\Python311\Scripts

Add this folder to your PATH permanently:

• Open Start → Edit the system environment variables → Environment Variables

• Under User variables, select Path → Edit → New

• Paste the Scripts folder path

• Click OK to save

Re-open Powershell:

soundprompt

macOS

These steps might be incorrect as I do not have macOS to test currently:

• Install: Homebrew
• In the terminal, run:

  cd $HOME
  

  brew update
  

  brew install ffmpeg portaudio wget
  

  wget https://github.com/Ethorbit/SoundPrompt/releases/download/v0.1.5/soundprompt-0.1.5-py3-none-any.whl
  

  pip3 install ./*.whl
  

  soundprompt
  

Linux

Manually (Debian Trixie)

In a terminal, run:

cd $HOME

apt-get update

apt-get install -y ffmpeg libportaudio2 wget

wget https://github.com/Ethorbit/SoundPrompt/releases/download/v0.1.5/soundprompt-0.1.5-py3-none-any.whl

pip install --user ./*.whl

soundprompt

With Docker

Your host must be running the following:

• PulseAudio
• X11 Desktop

At the root of the project, run:

xhost +SI:localuser:${USER}

docker compose --profile app run app --load /my/library