Bright Oddity Press
Audiobook Studio 1.x docs

Install Audiobook Studio

Pick the install path that matches how comfortable you are with a terminal.

At a glance
  • Easiest: Pinokio, which sets everything up for you.
  • Other path: the run.sh or run.ps1 launcher script.
  • You need Python 3.10+, Node.js 18+ and FFmpeg for the script path.
  • The app opens in your browser at http://127.0.0.1:8123.

Option 1: Pinokio (recommended)

If you are new to GitHub or terminals, start here. Pinokio handles setup and launch for you. During install it can also add an optional demo library, which gives you a nearly finished book to explore right away.

  1. Open the Audiobook Studio page on Pinokio.
  2. Click Install.
  3. Choose whether to include the demo library.
  4. When it finishes, launch the app from Pinokio.

The Audiobook Studio page on Pinokio with the Install button at the top right

Option 2: The launcher script

This path is for people who like direct control. You need these installed first:

  • Python 3.10 or newer
  • Node.js 18 or newer
  • FFmpeg
  • macOS, Linux or Windows (an NVIDIA graphics card is recommended for faster voice generation)

On macOS or Linux, download the project from GitHub, open a terminal in its folder, and run:

./run.sh

On Windows, open PowerShell in the project folder and run:

powershell -ExecutionPolicy Bypass -File .\run.ps1

The script sets up what the app needs, builds the screens if needed, and starts the app. The first run takes a while because the voice engine has to set itself up. Watch the terminal window: it shows progress, so a long pause is normal.

Useful options

On macOS or Linux you can add these to ./run.sh:

  • --setup-only: install everything, but do not start the app.
  • --no-reload: start without auto-reload.
  • --port 9000: use a different port.

On Windows the matching options are -SetupOnly, -NoReload and -Port 9000.

Tip: If the script stops because npm or ffmpeg is missing, install it and run the script again.

Next