Lightshow

A software designed to control the DIY Moving Head projector

Caution

Software made for windows and linux.

It detects beats from the output stream of your speakers and then use them to create beautiful lightshows.

Installation

Multi-platform

Wheel file is available, download in releases, run

pip install lightshow-X.XX.X.py3-none-any.whl

Windows

Installer

Installer needing admin in the releases.

Portable

Portable also available in the releases. Download, extract. Run lightshow.exe

Linux

AppImage

Download the AppImage. Make it executable:

chmod +x lightshow-X.XX.X-x86_64.AppImage

Portable

Download the .tar.gz archive. Make the lightshow file executable & execute:

cd extracted_folder
chmod +x lightshow
./lightshow

MacOS

Im not even sure it works.

Run from source

Tip

UV is recommended

1. Clone repo

   git clone https://github.com/PastaLaPate/Lightshow

2. Go to dir

   cd Lightshow

3. Install dependencies

   uv sync

4. Linux dev dependencies

   1. Using apt:
      

      sudo apt install libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev libsdl1.2-dev libsmpeg-dev librtmidi-dev

   2. Using dnf:
      

      sudo dnf install rtmidi-devel

5. Start

   uv run lightshow

Building

Make sure you have dev dependencies:

uv sync --dev

Wheel

uv build

Wheel is in dist/

Windows

Install NSIS. With chocolatery: choco install nsis

Build using pyinstaller: uv run pyinstaller lightshow.spec

Linux

Build using pyinstaller: uv run pyinstaller lightshow.linux.spec

Contributions

Feel free to open prs to fix code or add new devices.

AI Policy

In this project like every one I create, code is handwritten and hand-reviewed. AI must strictly be used as a tool, not as a replacment for your brain. AI Use cases:

• Explaining the code base
• Help for architectural decisions: which pattern to use
• Find TODOs and give snippet of example code.
• Help for Libs' usage.

What it musn't be used for:

• Full AI Commit with no review
• Full architectural decisions without thinking about alternatives
• Code you don't know how it works.

Stack

PyQT6 for ui. PyQTGraph for visualization. DBUS/winrt for tracks tracking.

Soundcard for audio stream, numpy for treatment.