VPX GUI Tools for Linux

A GUI tool for launching VPX tables, editing INI settings, extracting VBS scripts and more with "just a mouse click", to be used with VPinballX.

VPX GUI Tools Launcher

This tool is part of the ASAPCabinetFE ecosystem.

Launcher Features:

• Lists tables and extra files
• Lists frontend media files
• Extract and edit VBS scripts
• Search and folder shortcuts
• Show if files have diff*

*Shows only INI diffs. Not yet implemented for .vbs scripts.

Tip

If you need help installing VPX check the WIKI.

If you need a dual monitor frontend "as simple as possible", check ASAPCabinetFE.

Installation & Usage

1. Download the repository to any folder of your choice.

   git clone --recurse-submodules https://github.com/surtarso/vpx-frontend.git

2. Install dependencies:

   sudo apt install yad

Note

If you don’t plan to use the launcher, you can skip installing yad. Move to Standalone INI Editor

3. Build the INI Editor

   ./compile.sh

4. Run the launcher:

   ./vpx_launcher.sh

5. Configure paths and args

Caution

This script expects you to have a specific naming convention.

/tables/[table folder]/[table file (brand YYYY)].vpx

E.g. /tables/Mars (Original)/Mars (Stern 2024).vpx

• Set table folder, it will look recursevely for .vpx files.
• Set any initial args you may need. (or leave empty)
• Set absolute path of your VPX executable.
• Set any final args you may need. (or leave empty)
• Set absolute path of VPinballX.ini
• Set fallback editor for VBS files (any text editor in case there's no default one)
• Set launcher window widht and height
• Set you own media path for images and videos (from /tables/table_name/)

The code will assemble a command line that looks like this:

[initial arg] [VPX executable] `-play` [table dir] [selected.vpx] [final args]

For example:

DRI_PRIME=1 gamemoderun /home/tarso/Games/vpinball/build/VPinballX_GL -play /home/tarso/Games/vpinball/build/tables/tomandjerry/tomandjerry.vpx --fullscreen`

6. Select a table and press play!

Note

• The INI Editor will open ~/vpinball/VPinballX.ini by default if no table is selected.
• Selecting a table and pressing the INI Editor button will attempt to open the table ini file if it exists or ask to create one.
• The Extract VBS will extract by default if no script is found and open the script with your preferred editor.
• The Open Folder button will open the selected table' dir or root dir if no table selected.
• To clear the Search term just press the button again.

Standalone INI Editor

INI Editor

Editor Features:

• Explanations for each variable (need help!)
• Category-split Sections
• Create and edit single table ini's
• Open any ini you want!
• Wont override code comments

Build with: ./compile.sh

Note

You can run the INI Editor separately without the launcher with:

./vpx_config

./vpx_config /path/to/anyfile.ini

Contribute

Contributions to this project are welcome! The code is highly commented, so feel free to snoop around, open issues or submit pull requests.

Any contribution to the INI Editor explanations project is higly apreciated! Check the wiki.

Older versions in Python + Shell can be downloaded here: https://github.com/surtarso/vpx-frontend/releases