TouchOsc Generator

A generator for TouchOsc files which greatly reduces repetive tasks and adds several helpful features not available in the original TouchOsc Editor.

TouchOsc generator does not have a UI, but is a script generating .touchosc files based on input files (json) describing the TouchOsc interface you want to build.

If you don't have python installed or don't know how to run python scripts on your computer, in the Installation section you will find everything to get you started.

Examples

Here are some simple examples to get you started quickly.

Simple

This creates a basic .touchosc file containing just a label and some text in it.

example.json:

{
  "type": "layout",
  "mode": 3,
  "version": 17,
  "width": 2000,
  "height": 1200,
  "orientation": "horizontal",
  "tabpages": [
    {
      "type": "tabpage",
      "components": [
        {
          "type": "labelh",
          "text": "Hello world!",
          "x": "0",
          "y": "0",
          "width": "300",
          "height": "70"
        }
      ]
    }
  ]
}

./touchosc.py example.json

This creates ./output/example.touchosc.

Something useful

Let's create 10 faders sending different osc messages:

{
  "type": "layout",
  "mode": 3,
  "version": 17,
  "width": 2000,
  "height": 1200,
  "orientation": "horizontal",
  "data": {
    "messages": [
      "msg-1",
      "msg-2",
      "msg-3",
      "msg-4",
      "msg-5",
      "msg-6",
      "msg-7",
      "msg-8",
      "msg-9",
      "msg-10"
    ]
  },
  "tabpages": [
    {
      "type": "tabpage",
      "name": "mixer",
      "text": "Mixer",
      "components": [
        {
          "type": "repeat",
          "width": "100%",
          "height": "80%",
          "x": "0",
          "y": "100",
          "count": 10,
          "columns": 10,
          "spacer_x": "2%",
          "component": {
            "type": "faderv",
            "width": "8%",
            "height": "50%",
            "osc": "/action/{{data.messages.@index}}"
          }
        }
      ]
    }
  ]
}

Yes, you can use percentages for dimensions and coordinates 💪

More examples!

The examples directory contains several input files showcasing in more detail what you can do with TouchOsc Generator.

Installation

To run TouchOsc Generator you need to know how to run python scripts and have python 3.6+ and the jinja2 package installed.

Python installation

Follow the official installation instructions on https://wiki.python.org/moin/BeginnersGuide/Download.

Pip (python package manager) installation

Please follow the installation instructions on https://pip.pypa.io/en/stable/installing

Jinja2

To install jinja2 using pip, the following into a command line:

pip install jinja2