Skip to content

surtarso/vpx-gui-tools

Repository files navigation

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"

image

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.

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 --shallow-submodules https://github.com/surtarso/vpx-gui-tools.git
  2. Install dependencies:

    sudo apt install build-essential cmake libsdl2-dev
  3. Build the application

    cd vpx-gui-tools/
    mkdir build && cd build
    cmake -DCMAKE_BUILD_TYPE=Release ..
    make -j$(nproc)
  4. Run the launcher:

    ./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.
  1. 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

image

Editor Features:

  • Explanations for each variable (need help!)
  • 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.

About

GUI to organize, configure and play Visual Pinball X on Linux.

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •