PinUP Popper

PinUP Popper frontend

Click any image to enlarge it.

PinUP Popper Files

PinUP Player (enables PUP Packs) — v1.4.5 Install Guide
PinUP Player Update — v1.4.5 → v1.4.6 Release Notes
PinUP Popper Front End — v1.4.5 Install Guide
PinUP Popper Front End Update — v1.4.5 → v1.4.6 Release Notes
Baller Installer (All-in-One) — Ver 2022.4 Main Page Jan 2023 Update

What is PinUP Popper?

PinUP Popper is a front end designed to manage tables. It is the front end of choice for many virtual pinball enthusiasts, partly because the developer Nailbuster is very active in the community and releases many guides on popular features.

PinUP Popper is loaded with functionality — including a built-in multimedia server where users can download artwork for their tables with a single click.

Flintstones PUP Pack

One of PinUP Popper's killer features is PUP Packs — additional video animations synchronized with gameplay. When a certain action is triggered on the table, the animation plays on the backglass. It can also be text or an image on a topper screen or full DMD.

PUP Packs are available for free download on VPUniverse.

A PUP Pack for the Flintstones VPX.

Pre-Requisites

Disable antivirus

Disable Antivirus

Disable your antivirus from day one. It can create false positives, block files, and make tables sluggish.

Unblock downloaded files

Always Unblock Downloaded Files

Right-click → Properties → check Unblock → Apply. This unblocks files downloaded from the internet so Windows will run them.

Windows display scaling 100%

Set Display Scaling to 100%

Make sure Scaling is set to 100% on all displays in Windows display settings.

Windows display settings

Getting Started

Deadpool PUP Pack

Be prepared to be frustrated when things don't work at first. PUP Packs require everything to be configured correctly. Read The Manual. The author(s) put enormous effort into creating and documenting this software — read it, read it, read it.

Once configured correctly, you will be amazed at the overall experience.

Step 1: RTFM. All steps, images, and videos are available online. Take the few hours required to get to know the software — it is so much more fun when you understand everything you're doing.

A PUP Pack for JP's Deadpool.

PinUP Player Installation

Install PinUP Player first, before the front end. Download link at Nailbuster's wiki.

1 — Download, Unblock & Extract
Installing PinUP Player PinUP Player files
  • Download PinUP Player, unblock, and extract
  • Copy all files to a folder of your choice — recommended: C:\Vpinball\PinupSystem
2 — Run PinupPlayerRegister.bat as Administrator
Run PinupPlayerRegister.bat

Right-click PinupPlayerRegister.bat → Run as Administrator. You'll be presented with the PinUP Player Screen Config setup.

3 — Configure Your Screens
Screen config setup
Screen layout options Topper screen settings

A topper is an additional screen above the backglass. If you don't have one, allocate a space on the backglass screen. Toppers display images, text, or looping videos.

Ghostbusters topper animation

Example topper animation: The Real Ghostbusters by SERGIOSOUZA. Toppers can be downloaded from Facebook Groups, Discord, VPUniverse, VPForums, and the built-in media server.

Select and size all screens

Select all screens and size to your desired proportions. For a single-screen setup, place the topper and Slim DMD at non-overlapping locations on your main screen. You can always adjust this later — for now, Save and Exit.

4 — Install the B2S Driver
Copy PinUPPlayerB2Sdriver

Copy PinUPPlayerB2Sdriver to the folder where your B2S server files are (where B2S_Setup.exe is located).

Paste shortcut in plugins folder

Open (or create) a plugins folder, right-click inside it and select Paste Shortcut.

Plugins folder contents Final plugins folder

This is what your folder should look like. The B2S driver is now installed.

5 — Copy PinUPPlayerVPinMame Files
PinUPPlayerVPinMame files

Navigate to C:\Vpinball\PinupSystem\PinUPPlayerVPinMame, select all files, cut, and paste into C:\VisualPinball\VPinMAME.

6 — Run PUPDMDControl.bat as Administrator
Run PUPDMDControl.bat

In the Vpinmame folder, right-click PUPDMDControl.bat → Run as Administrator.

7 — Edit DmdDevice.ini
DmdDevice.ini location

Edit DmdDevice.ini to enable PinUP Popper. Use Notepad++ for easy editing.

Set pinup enabled=true

Around line 290, find the [pinup] section and set enabled = true.

8 — Activate Plugins via Backglass
Right-click backglass plugins

Launch a table. When the backglass opens, right-click it and:

  • Check Activate Plugins
  • Uncheck Error message without backglass

Close and re-launch the table — the Plugins settings button should now be enabled.

Plugin active

The plugin is active. PinUP Player installation is complete! ✅

Installing PUP Packs

PUP Packs are made by the community and can be complex to create. Synchronizing video triggers with table actions is difficult — sometimes a PUP pack will overlap the table audio. All PUP packs are on VPUniverse. The VPS often links to the PUP pack in the table description.

Example — JP's Deadpool
Deadpool V5.1 and PupPack 2.0 on VPUniverse

DeadPool Table V5.1 & PupPack 2.0   ⬇ Download

  • Download, unblock, and extract
  • Copy JP's Deadpool v5.1_VPX8(Pup).vpx to your VPX tables folder
  • Copy the PUP pack folder jpsdeadpool to \PinupSystem\PUPVideos
🎉 And all that work is now paying off!

PinUP Popper Front End Installation

This front end lets you add, manage, organise and launch tables. PinUP Player MUST be installed first.

1 — Download, Unblock & Extract
Popper front end files

Download, unblock, and extract PinUP Popper. Drop the files into the same folder as PinUP Player (C:\Vpinball\PinupSystem).

2 — Run PinUPPopperRegister.bat as Administrator
PinUPPopperRegister.bat Screen config shown

You will see the screen config — close it, as we already set up screens during PinUP Player installation.

3 — Configure Popper Setup Options
DMD Slim 512x128 DMD settings
Real DMD users: set DMD Slim to 512×128, enable it, set to Show Always On, and position it on your backglass screen.

The most commonly used options are shown below. For full details visit Nailbuster's Wiki.

Setup screen 1 Setup screen 2 Apron/FullDMD section
Do not change the Apron/FullDMD section unless you have a Full DMD setup — then set to Active and Update.
Setup screen 4 Emulator launch setup Launch parameters VPX emulator settings

In Emulator/Launch Setup you can add programs and parameters for table launch. All parameters documented here.

Controller setup tab

The Controller Setup tab configures keyboard/cabinet button mappings. Double-click an action for a yellow prompt waiting for key input.

Key binding Screen/Theme section

The Screen/Theme section toggles front end screens on or off (does not affect PUP packs).

DMD show forced back useDOF setting
  • Real DMD: set DMD to Show forced back
  • DOF users: change useDOF from false to true and save
useDMD true and mirror
Real DMD: set useDMD to true and mirror.

Tables Management

Tables management Add game button
  • Click Add Game to open the table scanner
  • Use the Emulator dropdown to filter by system
  • Click Scan for new games — shows only tables not yet in the front end
Scan results Select all add to system

Select all and click Add to System. Added games turn green. Now add them to a playlist.

Games green
Add to playlist Playlist view
Playlist final

Media Manager

The built-in multimedia server lets you preview and download media for each table (backglass art, wheel images, playfield videos, audio, etc.).

Media manager tab Globe icon for media server

Click the Globe icon next to AudioLaunch. If you see an error, PinUP Popper needs updating — see below.

Error — update needed
⚠️ Before updating PinUP Popper, always back up your database first.

Backing up the Database

Popper Setup Backup DB Backup confirmation

Go to Popper Setup → Backup DB → click Yes. It saves a single SQL file.

Backup file path Save backup safely

Save somewhere safe. To restore: rename to PUPDatabase.db and drop into PinupSystem.

Updating PinUP Popper

Release notes wiki

Go to PinUP Popper Wiki release notes. Read the file titles carefully and download the correct upgrade package for your version (e.g. 1.4.5 → 1.4.6). This update covers both PinUP Player and the Front End.

Upgrade files highlighted in yellow

Download, unblock, extract. Drag and drop new files into PinupSystem, overwriting old ones. Make sure PinUP Popper is fully closed. Re-launch when done.

Copy overwrite files

Back in Media Manager, click the Globe icon — the multimedia server should now be working.

Media server working Download media for table

Repeat for backglass, DMD, Playfield, Audio, Wheel, and anything else you want.

Fields turn green when set

When media is applied, the field turns green.

Apollo 13 in the front end

Click Exit and Launch to open the front end. Here's Apollo13 with all media set. Now do the same for all your games — and don't forget to back up your database! 🎉

---

Related: Visual Pinball X · Freezy / DMD Ext · DOF Setup · Software