GDMapp

# INTRO

(Beta version 0.0.1)

GDMapp is a **real-time video mapping software** built on the Godot Engine.

It started as an 'in house tool' for a commisioned project:

[https://surreal.asturnazari.com/2025/12/01/penpots-whac-a-mappole-a-floss-interactive-mapping/](https://surreal.asturnazari.com/2025/12/01/penpots-whac-a-mappole-a-floss-interactive-mapping/)

and was presented at the GodotCon 2026 Amsterdam conference.

## Features:

* Corner-based warping system made with shaders

* Multi-channel mixer (8 channels × 2 mixers) with blend modes and alpha support

* Support for images, videos (via GDE Gozen) and NDI

* Single-screen projection system with warpeable elements

* MIDI control for physical hardware (KORG nanoKONTROL2, nanoKEY Studio) <--- currently limited support

* Project persistence using `.tres` files

# THIS IS OPEN SOURCE SOFTWARE

In this page you are buying a compiled binary of this project, and also supporting the developer to continue with the project.

You will get free future updates and acces to future documentation on how to use it and how to implement your own projects along with this code.

The price may increase in the future, but not once you've bought it.

If you're not interested in supporting the development, you can go to the Codeberg repository and compile it yourself:

[https://codeberg.org/asturnazari/GDMapp](https://codeberg.org/asturnazari/GDMapp)

# ROADMAP NOTES

Next step in my roadmap is to write a simple usage tutorial on how to setup a video mapping with GDMapp

The feature to add Godot Scenes as sources is broken at the moment, but will be added ASAP

A QA and performance roadmap is planned and published in the codeberg repo. It is not set in stone and may change in the future.

Code is ready to accept UNDO / REDO feature, but it's not fully implemented yet, but in the QA roadmap

# TODO FEATURES

* Remove sources

* Add godot scenes as sources

* Implement Undo/Redo in all commands

* Add 'about info' in a modal window

# Basic usage (UI description)

The user interface of GDMapp includes a top bar and three parts split container.

## Top Bar

It includes the main menu and a path to the current project. Also indicates with a * when project has unsaved changes. Some menu entries are not yet implemented.

## Left Container:

It includes a set of buttons with warping tools and two tabs

### Project Settings Tab

Here are the main project settings as the resolution, projector monitor and a tree with current project elements. You can click on tree elements to select them and edit their properties

There is a Edition Mode siwtch in the project settings tab.

It is recomended to set this parameter off when you are ready to play your mapping performance. This option will disable edit features in the workspaces and will improve overall performance of the app.

Also at the top of this screen you have four buttons:

* Add warpeable:
It creates a warpeable element that projects all the mixer content into the output workspace. When you click this, a warpeable element is added and the interface switch to the output workspace to let you edit the corners and position of the element

* Add warpeable shape:
This will create a partial warpeable. When you click this, it enters in a draw mode and you can click on the input workspace to define a polygon for your warpeable. Once you double click, press enter or close the polygon, a warpeable shape is created and the interface switches to the output workspace to edit the corners and position

* Show and hide all warpeables
Simple functions to help working with a lot of warpeable shapes. You can show and hide the elements individually in the tree menu.

## Right Container

Here you have all sources of your project. You can drag and drop this elements to the mixer channels.

Click the buttons above to add images, videos or ndis as sources for your project.

## Center container:

It has two tabs, one for each workspaces

### Input Workspace:

In this workspace the user can:

* Add visual elements to compose the piece

You can tho this by dragging your sources thumbnail to a mixer channel. Once they are there, you can edit their properties by clicking on the thumbnail of each channel.

* Create warpeable elements to configure how this workspace is projected into the output workspace

### Output workspace

This workspace is where warping happens, the content of this canvas is cloned into the projection output when it's activated.