Note: This is a work in progress project. References made in the readme and documentation are currently unfulfilled.

RE:Flex Nexus - Universal Dance Pad Utilities

RE:Flex Nexus aims to provide a comprehensive collection of PC software utilities for dance pads. The interface specification is flexible, allowing any dance pad to be quickly integrated and begin using available software features.

In addition, the project aims to provide a comprehensive set of user guides for open-source dance pad design. The goal is to create a centralised ecosystem for both software tools and documentation of dance pads. This will hopefully inspire creativity/freedom, while letting dance gamers share technology together.

Installation

• The latest executable can be found on the Releases page
• Download the application for your respective operating system
• Download the nexus-resources.zip package and extract to the location you would like to store program data
• Open the reflex-nexus application
• You will be prompted to set up your program data folder, enter the directory of the folder that you just extracted

Usage

For details on usage, check out the Documentation.

Contributing

Install the latest version of Python and git, use your terminal/command prompt to navigate to the directory you would like to install this project to, then run the following commands:

# Clone and enter repository.
git clone https://github.com/ReflexCreations/Nexus.git
cd nexus
# Get the build/environment manager.
pip install poetry
# Set up virtual environment and install reflex_nexus as package.
poetry install

You're all set up! You can now use Poetry to run the application scripts.

# Build the executable.
poetry run build
# Build the documentation HTML.
poetry run docs
# Lint the project.
poetry run lint
# Test the project for your Python version and operating system.
poetry run test

To synchronise your code editor with the virtual environment that Poetry creates, you can use poetry env info -p, copy the path, and supply that path to your code editor for the Python interpreter location.

Acknowledgements

The following Python packages are used in this project, and are greatly appreciated:

Runtime dependencies:

• libusb-package - Container package for libusb
• PyQtDarkTheme - Dark/light theme for Python QT applications
• PySide6 - Python bindings for QT GUI framework
• PyUSB - Python USB access module
• QtAwesome - FontAwesome/Elusive Icons for Python QT applications

Development dependencies:

• Poetry - Dependency, environment and packaging manager
• PyInstaller - Cross-platform executable generator
• pytest - Project testing
• pytest-cov - Coverage integration for pytest
• Ruff - Project linting
• Sphinx - Documentation generator
• Sphinx-Rtd-Theme - Read the Docs Sphinx theme

RE:Flex Nexus is released under the MIT License, more details in LICENSE file.