Simple VPX GUI Tools for Linux

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

Just download a release file and run anywhere you want.

VPX GUI Launcher	INI Editor
Launcher Features:	Editor Features:
- Lists tables and extra files	- Explanations for each variable (need help!)
- Lists frontend media files	- Category-split Sections
- Extract and edit VBS scripts	- Create and edit single table ini's
- Search and folder shortcuts	- Open any ini you want!
- Show if files have diff***	- Wont override code comments

*If you need a dual monitor fullscreen frontend as simple as possible, look here.

**If you need help installing VPX check the wiki.

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

Installation & Usage

You can download a release file here: https://github.com/surtarso/vpx-frontend/releases or follow the instructions below.

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

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

2. Install dependencies:

   sudo apt install yad python3 python3-tk

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

3. Run the launcher:

   ./vpx_launcher.sh

4. Configure paths and args

   

   • 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`

5. Select a table and press play!

   Obs:

   • 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.
   • You can always manually search for the .ini you want to open.
   • 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

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

python3 vpx_ini_editor.py

python3 vpx_ini_editor.py /path/to/anyfile.ini

It only requires Tkinter and does not depend on yad.

Contribute

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