BadMapper

A simple projection mapping software, similar to MadMapper, but a free and open-source alternative — and unapologetically worse.

Exemple of use case. Source: Pinterest

Downloads

Download the latest release for your platform from the Releases page:

• Linux: badmapper-linux
• Windows: badmapper-windows.exe

Getting Started

Running as development mode

Create a virtual environment and install dependencies

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Running the app

python main.py

Controls

Press H to show/hide helper panel.

Features

Project Files (.bad)

BadMapper allows you to save and load projects in .bad format (JSON-based). Projects include:

• Mask positions, types, and transformations
• Media file paths (images and videos)
• Webcam configurations
• Media transformations (position, scale, rotation, perspective)
• Projection settings (width and height)

Keyboard Shortcuts:

• Ctrl+N - New Project
• Ctrl+O - Open Project
• Ctrl+S - Save Project
• Ctrl+Shift+S - Save Project As

Webcam Support

BadMapper supports using webcams as live media sources for your masks:

1. Select a mask
2. Go to File > Add Webcam to Mask
3. Choose the webcam index (usually 0 for the default camera)
4. The webcam feed will be displayed in real-time on your projection

Note: Webcam configurations are saved in project files and will automatically reconnect when you load the project.

Screenshots