https://github.com/surtarso/vpx-gui-tools
GUI to organize, configure and play Visual Pinball X on Linux.
https://github.com/surtarso/vpx-gui-tools
debian editor gui ini launcher linux pinball vbs visual-pinball vpx wiki
Last synced: 7 months ago
JSON representation
GUI to organize, configure and play Visual Pinball X on Linux.
- Host: GitHub
- URL: https://github.com/surtarso/vpx-gui-tools
- Owner: surtarso
- Created: 2025-02-21T15:58:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-15T20:36:53.000Z (7 months ago)
- Last Synced: 2025-11-15T22:18:00.632Z (7 months ago)
- Topics: debian, editor, gui, ini, launcher, linux, pinball, vbs, visual-pinball, vpx, wiki
- Language: C++
- Homepage:
- Size: 22.6 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
PLEASE NOTE:
---
VPX GUI Tools for Linux
A VPinballX GUI tool for launching VPX tables, editing INI settings, extracting VBS scripts, and more with "just a mouse click".
Now in C++ and powered by vpxtool! "Harder, better, faster, stronger"
This tool is part of the ASAPCabinetFE ecosystem.
## **Launcher Features:**
- Lists table info and extra files
- Lists frontend media files
- Extract and edit VBS scripts
- Show if INI/VBS files have diff
- Search and folder shortcuts
>[!TIP]
>If you need help installing VPX, check the [WIKI](https://github.com/surtarso/vpx-frontend/wiki/Visual-Pinball-X-on-Debian-Linux).
>
>If you need a dual monitor frontend "as simple as possible", check [ASAPCabinetFE](https://github.com/surtarso/ASAPCabinetFE/).
## **Installation & Usage**
1. **Download the repository** to any folder of your choice.
```bash
git clone --recurse-submodules --shallow-submodules https://github.com/surtarso/vpx-gui-tools.git
```
2. **Install dependencies:**
```bash
sudo apt install build-essential cmake libsdl2-dev
```
3. **Build the application**
```bash
cd vpx-gui-tools/
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
```
4. **Run the launcher:**
```bash
./VPXGUITools
```
5. **Configure paths and args**
>[!CAUTION]
>_This application expects you to have files inside table folders._
>
>/allTables/[table folder]/images | video | roms etc
- Set tables folder; it will look recursively for .vpx files.
- Set the absolute path of your VPX executable.
- Set the absolute path of your VPinballX.ini.
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's INI file if it exists or ask to create one.
> - The **Extract VBS** button will extract the VBS script by default if none is found and open it with your preferred editor.
> - The **Open Folder** button will open the selected table's directory or the table's root directory if no table is selected.
## **INI Editor**
## **Editor Features:**
- Explanations for each variable [**(need help!)**](https://github.com/surtarso/vpx-gui-tools/wiki/Adding-VPinballX.ini-Tooltips)
- Category-split Sections
- Create and edit single table INI files or default vpx ini
- Keeps the ini file intact
## Contribute
Contributions to this project are welcome! Feel free to snoop around, open issues, submit pull requests or help with the TODO list!
Any contribution to the INI Editor explanations project is highly appreciated! Check the [wiki](https://github.com/surtarso/vpx-gui-tools/wiki/Adding-VPinballX.ini-Tooltips).