The table launcher

Once the wizard is done, PinReady opens straight on your tables: pick one, start it, and come back to the list when Visual Pinball closes.

Browse your tables

A grid of every table folder found in your tables directory, each with its backglass picture: taken from the table's .directb2s file, from the artwork downloaded by the catalog enrichment, or from your own medias/launcher.png.
Search: just start typing, the list filters as you go.
An update available badge on tables with a newer version listed in the Virtual Pinball Spreadsheet.
Rebuild clears the cached pictures and script patch state, then scans the tables folder again, for when the list no longer matches your disk.
The toolbar also has the Configuration button to reopen the wizard, a light/dark theme switch, a rotation button and an About box.

Controls

The joystick buttons follow the bindings you set in the wizard, so the cabinet buttons work in the launcher too.

Action	Keyboard	Cabinet buttons	Mouse
Previous / next table	Left / Right arrow, Left / Right Shift	Left / Right flipper	Hover
Row above / below	Up / Down arrow, Left / Right Ctrl	Left / Right MagnaSave	Wheel (cabinet mode)
Jump one screen of tables	Page Up / Page Down	–	Wheel flick
First / last table	Home / End	–	–
Start the table	Enter	Start or Launch Ball	Click
Open the setup wizard	–	–	Configuration button
Clear the search, then quit	Escape	Exit Game	–

On a multi-screen cabinet

In the Cabinet display mode, the launcher opens full screen on the playfield screen, turned to match a screen lying flat, with a mouse pointer drawn by PinReady. The other screens are used too:

Backglass: the backglass picture of the selected table.
DMD and topper: a cover with the Visual Pinball logo.

When a table starts, these covers step aside so Visual Pinball can take over every screen.

Starting a table

A loading overlay shows the progress reported by Visual Pinball while the table loads. On Linux, PinReady picks the display driver Visual Pinball runs under (Wayland or X11) according to your desktop session, and keeps the screen names in VPinballX.ini in step, so each window opens on the right screen.

When Visual Pinball crashes

If Visual Pinball exits abnormally, PinReady shows a report instead of silently returning to the list: the command to reproduce the problem, the working folder, system information, the loading log and the last 100 lines of the game log, and the exact location of the crash dump on your system (systemd-coredump on Linux, ~/Library/Logs/DiagnosticReports/ on macOS, %LOCALAPPDATA%\CrashDumps\ on Windows). Copy puts it on the clipboard, ready for a bug report; Save… writes it to a file.

Updates

PinReady checks for new versions of Visual Pinball and of itself at startup; update buttons appear in the launcher and install in one click.

Command-line options

Option	What it does
`--config`, `-c`	Open the setup wizard.
`--reset-wizard`	Mark the wizard as not completed and exit: the next start goes back to the wizard.
`--merge-dry-run SCAN_ROOT [OUTPUT] [--strategy MODE]`	Show what the collection import would place, without touching any file.
`--merge SCAN_ROOT [OUTPUT] [--strategy MODE] [--yes]`	Run the import. `MODE` is `copy` (default), `move` or `symlink`; omit `OUTPUT` when the collection already has one folder per table.
`--print-paths`	Print the database, log, ini, tables and Visual Pinball paths.
`--list-tables`	Print one line per table folder found.
`--version`, `--help`	Show the version and licence, or the help.