<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>PinReady FAQ: pincab setup on Linux, VPX 10.8.1 standalone troubleshooting</title>
<meta name="description" content="Answers about PinReady and Visual Pinball X 10.8.1 standalone: who it is for, old tables and VBS patches, per-table ini, DOF, tilt and nudge, speakers, Wayland and X11, crash reports.">
<link rel="canonical" href="https://le-syl21.github.io/PinReady/faq.html">
<link rel="alternate" hreflang="en" href="https://le-syl21.github.io/PinReady/faq.html">
<link rel="alternate" hreflang="fr" href="https://le-syl21.github.io/PinReady/fr/faq.html">
<link rel="alternate" hreflang="x-default" href="https://le-syl21.github.io/PinReady/faq.html">
<meta property="og:type" content="website">
<meta property="og:site_name" content="PinReady">
<meta property="og:title" content="PinReady FAQ: pincab setup on Linux, VPX 10.8.1 standalone troubleshooting">
<meta property="og:description" content="Answers about PinReady and Visual Pinball X 10.8.1 standalone: who it is for, old tables and VBS patches, per-table ini, DOF, tilt and nudge, speakers, Wayland and X11, crash reports.">
<meta property="og:url" content="https://le-syl21.github.io/PinReady/faq.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="PinReady FAQ: pincab setup on Linux, VPX 10.8.1 standalone troubleshooting">
<meta name="twitter:description" content="Answers about PinReady and Visual Pinball X 10.8.1 standalone: who it is for, old tables and VBS patches, per-table ini, DOF, tilt and nudge, speakers, Wayland and X11, 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": "PinReady FAQ: pincab setup on Linux, VPX 10.8.1 standalone troubleshooting", "description": "Answers about PinReady and Visual Pinball X 10.8.1 standalone: who it is for, old tables and VBS patches, per-table ini, DOF, tilt and nudge, speakers, Wayland and X11, crash reports.", "url": "https://le-syl21.github.io/PinReady/faq.html", "inLanguage": "en", "about": {"@id": "https://le-syl21.github.io/PinReady/#app"}}, {"@type": "FAQPage", "url": "https://le-syl21.github.io/PinReady/faq.html", "inLanguage": "en", "mainEntity": [{"@type": "Question", "name": "Is PinReady for my cabinet?", "acceptedAnswer": {"@type": "Answer", "text": "PinReady is built to support the development and adoption of Visual Pinball X 10.8.1. It targets testers and early adopters of the new 10.8.1 architecture: integrated plugins, one folder per table, SDL3/bgfx engine. If your cabinet runs a stable VPX 10.7.x setup that you rely on, PinReady is probably not for you yet."}}, {"@type": "Question", "name": "Do I need a real pinball cabinet?", "acceptedAnswer": {"@type": "Answer", "text": "No. The wizard starts from one screen: pick 1 screen and the Desktop display mode for a normal computer, and play with the keyboard or a gamepad. Two to four screens, pinball controller boards, accelerometers and surround sound are all optional."}}, {"@type": "Question", "name": "Does PinReady install the official Visual Pinball?", "acceptedAnswer": {"@type": "Answer", "text": "No. The automatic install downloads a recent build of the Visual Pinball X fork tested with PinReady, from Le-Syl21/vpinball, not the official VPX build. If you prefer your own install, choose I already have Visual Pinball on the first page and point PinReady to the VPinballX_BGFX program."}}, {"@type": "Question", "name": "Which pinball controller boards are recognized?", "acceptedAnswer": {"@type": "Answer", "text": "Pinscape KL25Z (KL Shield V5.1, Brain, Rig Master), Pinscape Pico, DudesCab and CSD PinOne. When one is detected, its factory button layout fills the joystick column, and VPX handles the plunger and the accelerometer by itself. Any other joystick or gamepad works too: map its buttons one by one. See the Inputs page of the wizard."}}, {"@type": "Question", "name": "An older table does not work under VPX standalone. What can I do?", "acceptedAnswer": {"@type": "Answer", "text": "Some older tables use VBScript features that only work on Windows. On the Tables page, turn on the automatic VBS patches: PinReady then places a patched script next to the table when Le-Syl21/vpx-standalone-scripts has one. It is off by default, because a patch can occasionally make a specific table worse. You can also do it by hand: take the .vbs matching your table from jsm174/vpx-standalone-scripts and put it next to the .vpx, with the same base name."}}, {"@type": "Question", "name": "How do I use different settings for one table?", "acceptedAnswer": {"@type": "Answer", "text": "Put a .ini file next to the .vpx, with the same base name, containing only the settings you want to change; everything else comes from the global VPinballX.ini. To keep those settings inside the table file itself, vpxtool can extract the table (vpxtool extract MyTable.vpx) and put it back together with the ini inside (vpxtool assemble MyTable/)."}}, {"@type": "Question", "name": "My tables take a lot of disk space.", "acceptedAnswer": {"@type": "Answer", "text": "Tables often ship large lossless images. vpxtool can convert them to WebP: vpxtool images webp MyTable.vpx."}}, {"@type": "Question", "name": "My toys, lights and solenoids do nothing in game.", "acceptedAnswer": {"@type": "Answer", "text": "Visual Pinball ships with every plugin turned off, DOF included. Generate your DOF configuration with the VPUniverse ConfigTool, extract it into the directoutputconfig folder, then turn DOF on from the Accessories page."}}, {"@type": "Question", "name": "The table tilts for nothing, or never tilts.", "acceptedAnswer": {"@type": "Answer", "text": "Check the accelerometer range on the Tilt / Nudge page. It must match the range your board really uses: PinReady reads it from the board when the board publishes it, and warns you when the selected value does not match. A wrong range makes every shake look too strong or too weak, and no other setting can make up for it. The page also tells you when the chosen tilt angle is out of the sensor's reach."}}, {"@type": "Question", "name": "The sound comes from the wrong speakers.", "acceptedAnswer": {"@type": "Answer", "text": "Use the tests on the Audio page. If the rolling ball goes the wrong way from front to back, change the output mode; if it goes the wrong way from left to right, check your left/right wiring. Jack colours vary between sound cards."}}, {"@type": "Question", "name": "Linux: my output board is not found on the Accessories page.", "acceptedAnswer": {"@type": "Answer", "text": "Raw USB HID access on Linux usually needs a udev rule. The Accessories page shows the rules, can copy them, or install them for you after asking for your password."}}, {"@type": "Question", "name": "Linux: do I need to run the wizard again after switching between Wayland and X11?", "acceptedAnswer": {"@type": "Answer", "text": "No. A screen is named differently depending on whether Visual Pinball runs under Wayland or X11, so PinReady remembers each screen by its position, size and EDID identity (the ID the monitor reports). When the launcher starts, it picks the driver VPX will use and updates the screen names in VPinballX.ini to match."}}, {"@type": "Question", "name": "How do I start the configuration again?", "acceptedAnswer": {"@type": "Answer", "text": "Open the wizard from the Configuration button of the launcher, or run pinready --config. To start from scratch, use Reset the configuration in the wizard: it forgets every answer and keeps your old VPinballX.ini as VPinballX.ini.reset-backup. Your tables are left alone."}}, {"@type": "Question", "name": "Visual Pinball crashed. How do I report it?", "acceptedAnswer": {"@type": "Answer", "text": "When VPX exits abnormally, PinReady shows a report with the command to reproduce the crash, system information, the logs and the location of the crash dump. Click Copy or Save… and share it on Discord or in the GitHub issues."}}, {"@type": "Question", "name": "A table shows “no image” in the launcher.", "acceptedAnswer": {"@type": "Answer", "text": "Put a picture at medias/launcher.png in the table folder (.webp, .jpg and .jpeg work too), or a .directb2s backglass file. If pictures look out of date after you reorganized your tables, click Rebuild in the launcher."}}, {"@type": "Question", "name": "Where are my settings stored?", "acceptedAnswer": {"@type": "Answer", "text": "See file locations. pinready --print-paths prints the paths PinReady actually uses."}}]}]}</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">Launcher</a><a href="faq.html" aria-current="page">FAQ</a></nav>
<a class="lang" href="fr/faq.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>Questions and answers</h1>
<p class="lead">Common questions about PinReady and Visual Pinball X 10.8.1 standalone. Something missing? Ask on
<a href="https://discord.gg/T37DYHmt2j">Discord</a>.</p>
<details class="faq"><summary><h2>Is PinReady for my cabinet?</h2></summary><p>PinReady is built to support the development and adoption of Visual Pinball X 10.8.1. It targets testers and early adopters of the new 10.8.1 architecture: integrated plugins, one folder per table, SDL3/bgfx engine. If your cabinet runs a stable VPX 10.7.x setup that you rely on, PinReady is probably not for you yet.</p></details>
<details class="faq"><summary><h2>Do I need a real pinball cabinet?</h2></summary><p>No. The wizard starts from one screen: pick <strong>1 screen</strong> and the <strong>Desktop</strong> display mode for a normal computer, and play with the keyboard or a gamepad. Two to four screens, pinball controller boards, accelerometers and surround sound are all optional.</p></details>
<details class="faq"><summary><h2>Does PinReady install the official Visual Pinball?</h2></summary><p>No. The automatic install downloads a recent build of the Visual Pinball X fork tested with PinReady, from <a href="https://github.com/Le-Syl21/vpinball">Le-Syl21/vpinball</a>, not the official VPX build. If you prefer your own install, choose <strong>I already have Visual Pinball</strong> on the first page and point PinReady to the <code>VPinballX_BGFX</code> program.</p></details>
<details class="faq"><summary><h2>Which pinball controller boards are recognized?</h2></summary><p>Pinscape KL25Z (KL Shield V5.1, Brain, Rig Master), Pinscape Pico, DudesCab and CSD PinOne. When one is detected, its factory button layout fills the joystick column, and VPX handles the plunger and the accelerometer by itself. Any other joystick or gamepad works too: map its buttons one by one. See the <a href="wizard.html#inputs">Inputs page of the wizard</a>.</p></details>
<details class="faq"><summary><h2>An older table does not work under VPX standalone. What can I do?</h2></summary><p>Some older tables use VBScript features that only work on Windows. On the <strong>Tables</strong> page, turn on the automatic VBS patches: PinReady then places a patched script next to the table when <a href="https://github.com/Le-Syl21/vpx-standalone-scripts">Le-Syl21/vpx-standalone-scripts</a> has one. It is off by default, because a patch can occasionally make a specific table worse. You can also do it by hand: take the <code>.vbs</code> matching your table from <a href="https://github.com/jsm174/vpx-standalone-scripts">jsm174/vpx-standalone-scripts</a> and put it next to the <code>.vpx</code>, with the same base name.</p></details>
<details class="faq"><summary><h2>How do I use different settings for one table?</h2></summary><p>Put a <code>.ini</code> file next to the <code>.vpx</code>, with the same base name, containing only the settings you want to change; everything else comes from the global <code>VPinballX.ini</code>. To keep those settings inside the table file itself, <a href="https://github.com/francisdb/vpxtool">vpxtool</a> can extract the table (<code>vpxtool extract MyTable.vpx</code>) and put it back together with the ini inside (<code>vpxtool assemble MyTable/</code>).</p></details>
<details class="faq"><summary><h2>My tables take a lot of disk space.</h2></summary><p>Tables often ship large lossless images. <a href="https://github.com/francisdb/vpxtool">vpxtool</a> can convert them to WebP: <code>vpxtool images webp MyTable.vpx</code>.</p></details>
<details class="faq"><summary><h2>My toys, lights and solenoids do nothing in game.</h2></summary><p>Visual Pinball ships with every plugin turned off, DOF included. Generate your DOF configuration with the VPUniverse ConfigTool, extract it into the <code>directoutputconfig</code> folder, then turn DOF on from the <a href="wizard.html#accessories">Accessories page</a>.</p></details>
<details class="faq"><summary><h2>The table tilts for nothing, or never tilts.</h2></summary><p>Check the <strong>accelerometer range</strong> on the <a href="wizard.html#tilt">Tilt / Nudge page</a>. It must match the range your board really uses: PinReady reads it from the board when the board publishes it, and warns you when the selected value does not match. A wrong range makes every shake look too strong or too weak, and no other setting can make up for it. The page also tells you when the chosen tilt angle is out of the sensor's reach.</p></details>
<details class="faq"><summary><h2>The sound comes from the wrong speakers.</h2></summary><p>Use the tests on the <a href="wizard.html#audio">Audio page</a>. If the rolling ball goes the wrong way from front to back, change the output mode; if it goes the wrong way from left to right, check your left/right wiring. Jack colours vary between sound cards.</p></details>
<details class="faq"><summary><h2>Linux: my output board is not found on the Accessories page.</h2></summary><p>Raw USB HID access on Linux usually needs a udev rule. The Accessories page shows the rules, can copy them, or install them for you after asking for your password.</p></details>
<details class="faq"><summary><h2>Linux: do I need to run the wizard again after switching between Wayland and X11?</h2></summary><p>No. A screen is named differently depending on whether Visual Pinball runs under Wayland or X11, so PinReady remembers each screen by its position, size and EDID identity (the ID the monitor reports). When the launcher starts, it picks the driver VPX will use and updates the screen names in <code>VPinballX.ini</code> to match.</p></details>
<details class="faq"><summary><h2>How do I start the configuration again?</h2></summary><p>Open the wizard from the <strong>Configuration</strong> button of the launcher, or run <code>pinready --config</code>. To start from scratch, use <strong>Reset the configuration</strong> in the wizard: it forgets every answer and keeps your old <code>VPinballX.ini</code> as <code>VPinballX.ini.reset-backup</code>. Your tables are left alone.</p></details>
<details class="faq"><summary><h2>Visual Pinball crashed. How do I report it?</h2></summary><p>When VPX exits abnormally, PinReady shows a report with the command to reproduce the crash, system information, the logs and the location of the crash dump. Click <strong>Copy</strong> or <strong>Save…</strong> and share it on <a href="https://discord.gg/T37DYHmt2j">Discord</a> or in the <a href="https://github.com/Le-Syl21/PinReady/issues">GitHub issues</a>.</p></details>
<details class="faq"><summary><h2>A table shows “no image” in the launcher.</h2></summary><p>Put a picture at <code>medias/launcher.png</code> in the table folder (.webp, .jpg and .jpeg work too), or a <code>.directb2s</code> backglass file. If pictures look out of date after you reorganized your tables, click <strong>Rebuild</strong> in the launcher.</p></details>
<details class="faq"><summary><h2>Where are my settings stored?</h2></summary><p>See <a href="download.html#files">file locations</a>. <code>pinready --print-paths</code> prints the paths PinReady actually uses.</p></details>
</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>