<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Visual Pinball X 10.8.1 table launcher and browser for pincabs – PinReady</title>
<meta name="description" content="PinReady's table launcher for Visual Pinball X 10.8.1 standalone: backglass grid, search, joystick and flipper-button navigation, multi-screen cabinet layout, loading progress, crash reports.">
<link rel="canonical" href="https://le-syl21.github.io/PinReady/launcher.html">
<link rel="alternate" hreflang="en" href="https://le-syl21.github.io/PinReady/launcher.html">
<link rel="alternate" hreflang="fr" href="https://le-syl21.github.io/PinReady/fr/launcher.html">
<link rel="alternate" hreflang="x-default" href="https://le-syl21.github.io/PinReady/launcher.html">
<meta property="og:type" content="website">
<meta property="og:site_name" content="PinReady">
<meta property="og:title" content="Visual Pinball X 10.8.1 table launcher and browser for pincabs – PinReady">
<meta property="og:description" content="PinReady's table launcher for Visual Pinball X 10.8.1 standalone: backglass grid, search, joystick and flipper-button navigation, multi-screen cabinet layout, loading progress, crash reports.">
<meta property="og:url" content="https://le-syl21.github.io/PinReady/launcher.html">
<meta property="og:image" content="https://le-syl21.github.io/PinReady/img/og.jpg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:locale" content="en_GB">
<meta property="og:locale:alternate" content="fr_FR">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Visual Pinball X 10.8.1 table launcher and browser for pincabs – PinReady">
<meta name="twitter:description" content="PinReady's table launcher for Visual Pinball X 10.8.1 standalone: backglass grid, search, joystick and flipper-button navigation, multi-screen cabinet layout, loading progress, crash reports.">
<meta name="twitter:image" content="https://le-syl21.github.io/PinReady/img/og.jpg">
<meta name="color-scheme" content="light dark">
<link rel="icon" type="image/svg+xml" href="img/favicon.svg">
<link rel="stylesheet" href="style.css">
<script type="application/ld+json">{"@context": "https://schema.org", "@graph": [{"@type": "SoftwareApplication", "@id": "https://le-syl21.github.io/PinReady/#app", "name": "PinReady", "description": "Cross-platform configurator and launcher for Visual Pinball X 10.8.1 standalone.", "applicationCategory": "GameApplication", "operatingSystem": "Linux, macOS, Windows", "url": "https://le-syl21.github.io/PinReady/", "downloadUrl": "https://github.com/Le-Syl21/PinReady/releases/latest", "license": "https://www.gnu.org/licenses/gpl-3.0.html", "codeRepository": "https://github.com/Le-Syl21/PinReady", "offers": {"@type": "Offer", "price": "0", "priceCurrency": "EUR"}, "softwareVersion": "0.24.0"}, {"@type": "WebPage", "name": "Visual Pinball X 10.8.1 table launcher and browser for pincabs – PinReady", "description": "PinReady's table launcher for Visual Pinball X 10.8.1 standalone: backglass grid, search, joystick and flipper-button navigation, multi-screen cabinet layout, loading progress, crash reports.", "url": "https://le-syl21.github.io/PinReady/launcher.html", "inLanguage": "en", "about": {"@id": "https://le-syl21.github.io/PinReady/#app"}}]}</script>
</head>
<body>
<header class="site"><div class="wrap">
<a class="brand" href="./"><img src="img/favicon.svg" alt="" width="24" height="24"><span>Pin<b>Ready</b></span></a>
<nav class="main"><a href="./">Home</a><a href="download.html">Download</a><a href="wizard.html">Setup wizard</a><a href="launcher.html" aria-current="page">Launcher</a><a href="faq.html">FAQ</a></nav>
<a class="lang" href="fr/launcher.html" hreflang="fr" lang="fr"><img src="img/fr.svg" alt="" width="21" height="14">Version française</a>
</div></header>
<main><div class="wrap">
<h1>The table launcher</h1>
<p class="lead">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.</p>
<h2>Browse your tables</h2>
<ul>
<li>A grid of every table folder found in your tables directory, each with its backglass picture: taken from the
table's <code>.directb2s</code> file, from the artwork downloaded by the catalog enrichment, or from your own
<code>medias/launcher.png</code>.</li>
<li><strong>Search</strong>: just start typing, the list filters as you go.</li>
<li>An <strong>update available</strong> badge on tables with a newer version listed in the Virtual Pinball
Spreadsheet.</li>
<li><strong>Rebuild</strong> clears the cached pictures and script patch state, then scans the tables folder again,
for when the list no longer matches your disk.</li>
<li>The toolbar also has the <strong>Configuration</strong> button to reopen the wizard, a light/dark theme switch, a
rotation button and an About box.</li>
</ul>
<h2>Controls</h2>
<p>The joystick buttons follow the bindings you set in the wizard, so the cabinet buttons work in the launcher
too.</p>
<div class="table"><table><thead><tr><th>Action</th><th>Keyboard</th><th>Cabinet buttons</th><th>Mouse</th></tr></thead><tbody>
<tr><td>Previous / next table</td><td>Left / Right arrow, Left / Right Shift</td><td>Left / Right flipper</td><td>Hover</td></tr>
<tr><td>Row above / below</td><td>Up / Down arrow, Left / Right Ctrl</td><td>Left / Right MagnaSave</td><td>Wheel (cabinet mode)</td></tr>
<tr><td>Jump one screen of tables</td><td>Page Up / Page Down</td><td>–</td><td>Wheel flick</td></tr>
<tr><td>First / last table</td><td>Home / End</td><td>–</td><td>–</td></tr>
<tr><td>Start the table</td><td>Enter</td><td>Start or Launch Ball</td><td>Click</td></tr>
<tr><td>Open the setup wizard</td><td>–</td><td>–</td><td>Configuration button</td></tr>
<tr><td>Clear the search, then quit</td><td>Escape</td><td>Exit Game</td><td>–</td></tr>
</tbody></table></div>
<h2>On a multi-screen cabinet</h2>
<p>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:</p>
<ul>
<li><strong>Backglass</strong>: the backglass picture of the selected table.</li>
<li><strong>DMD and topper</strong>: a cover with the Visual Pinball logo.</li>
</ul>
<p>When a table starts, these covers step aside so Visual Pinball can take over every screen.</p>
<h2>Starting a table</h2>
<p>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 <code>VPinballX.ini</code> in step, so each window opens on the right screen.</p>
<h2>When Visual Pinball crashes</h2>
<p>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,
<code>~/Library/Logs/DiagnosticReports/</code> on macOS, <code>%LOCALAPPDATA%\CrashDumps\</code> on Windows).
<strong>Copy</strong> puts it on the clipboard, ready for a bug report; <strong>Save…</strong> writes it to a
file.</p>
<h2>Updates</h2>
<p>PinReady checks for new versions of Visual Pinball and of itself at startup; update buttons appear in the launcher
and install in one click.</p>
<h2 id="cli">Command-line options</h2>
<div class="table"><table><thead><tr><th>Option</th><th>What it does</th></tr></thead><tbody>
<tr><td><code>--config</code>, <code>-c</code></td><td>Open the setup wizard.</td></tr>
<tr><td><code>--reset-wizard</code></td><td>Mark the wizard as not completed and exit: the next start goes back to the wizard.</td></tr>
<tr><td><code>--merge-dry-run SCAN_ROOT [OUTPUT] [--strategy MODE]</code></td><td>Show what the collection import would place, without touching any file.</td></tr>
<tr><td><code>--merge SCAN_ROOT [OUTPUT] [--strategy MODE] [--yes]</code></td><td>Run the import. <code>MODE</code> is <code>copy</code> (default), <code>move</code> or <code>symlink</code>; omit <code>OUTPUT</code> when the collection already has one folder per table.</td></tr>
<tr><td><code>--print-paths</code></td><td>Print the database, log, ini, tables and Visual Pinball paths.</td></tr>
<tr><td><code>--list-tables</code></td><td>Print one line per table folder found.</td></tr>
<tr><td><code>--version</code>, <code>--help</code></td><td>Show the version and licence, or the help.</td></tr>
</tbody></table></div>
</div></main>
<footer class="site"><div class="wrap">
<a href="https://github.com/Le-Syl21/PinReady">Source code and issues on GitHub</a>
<a href="https://discord.gg/T37DYHmt2j">Discord</a>
<a href="https://www.youtube.com/playlist?list=PLZ838nY4NE902Am7NIOGYbEJaak5pEP71">Video demo</a>
<span>PinReady is free software under the GNU GPL v3 or later. Visual Pinball is a separate project by its own authors.</span>
</div></footer>
</body>
</html>