Download PinReady

PinReady is a single program file: download the one for your system, extract it and start it. There is nothing to install. These links always point to the latest release.

System	Download
Linux PC with an Intel or AMD 64-bit processor (x86_64)	pinready-linux-x86_64.tar.gz
Linux ARM 64-bit processor (aarch64)	pinready-linux-aarch64.tar.gz
macOS Apple silicon Mac (M-series chip)	pinready-macos-aarch64.tar.gz
macOS Intel Mac	pinready-macos-x86_64.tar.gz
Windows 64-bit Windows PC (x86_64)	pinready-windows-x86_64.zip

Release notes and older versions: all releases on GitHub.

Start it

Windows: extract the zip, then double-click pinready.exe.
Linux: extract the archive and start the program from its folder:
```
tar xzf pinready-linux-x86_64.tar.gz
./pinready
```
macOS: extract the archive and start the program from the Terminal:
```
tar xzf pinready-macos-aarch64.tar.gz
./pinready
```

The Windows program is digitally signed, and the macOS programs are signed and notarized with Apple. The macOS builds target macOS 11 or later.

The first start opens the setup wizard; the following ones open the table launcher.

What you need

Visual Pinball X 10.8.1 or later. PinReady can install it for you, or use a copy you installed yourself.
A tables folder using the 10.8.1 layout, one folder per table. PinReady can help you get there: see the Tables page of the wizard.
An Internet connection for the automatic Visual Pinball install and the update checks. It is optional if you install Visual Pinball yourself.

There are no libraries to install: SDL3 and SQLite are built into PinReady.

Installing Visual Pinball

The first page of the wizard offers two choices:

Install automatically (recommended) downloads and installs a recent build of the Visual Pinball X fork tested with PinReady, from Le-Syl21/vpinball. This is not the official VPX build. It picks the build for your system, including builds for Raspberry Pi and RK3588 boards on ARM Linux. You choose the installation folder.
I already have Visual Pinball uses a copy you installed yourself: point PinReady to the VPinballX_BGFX program.

The automatic install is validated on Ubuntu 24.04 LTS, under X11, on a 3-screen pincab. The official Visual Pinball project lives at vpinball/vpinball.

Updates

At startup PinReady checks whether a new build of Visual Pinball or a new version of PinReady is out. When one is, an update button appears in the launcher: one click downloads it and installs it.

Where files go

The folders are found automatically; you do not need to create them.

What	Linux	macOS	Windows
Visual Pinball settings (read and written by PinReady)	`~/.local/share/VPinballX/10.8/VPinballX.ini`	`~/Library/Application Support/VPinballX/10.8/VPinballX.ini`	`%APPDATA%\VPinballX\10.8\VPinballX.ini`
PinReady database and log	`~/.local/share/pinready/`	`~/Library/Application Support/pinready/`	`%APPDATA%\pinready\`
DOF configuration (extract the VPUniverse zip here)	`~/.local/share/VPinballX/10.8/directoutputconfig/`	`~/Library/Application Support/VPinballX/10.8/directoutputconfig/`	`%APPDATA%\VPinballX\10.8\directoutputconfig\`

Build from source

PinReady is written in Rust. On Linux (Debian or Ubuntu), install the build tools first:

sudo apt install build-essential cmake pkg-config \
  libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev \
  libxkbcommon-dev libssl-dev

cargo build --release

On macOS and Windows, cargo build --release is enough. SDL3 and SQLite are compiled from source automatically. The program lands in target/release/.