Skip to main content Skip to docs navigation

Help - Resources

Quick Start | Tutorials | User Guide | Help Center & FAQs

This page provides a quick overview of Wotja and links to some useful Help Resources.

To close this page (or the In-App User Guide), use the top left "X" button. To go back a link, use the top right "<" button.

Links with an external link icon go to an online webpage or resource.

Wotja icon Welcome to Wotja!

Wotja is a FREE and powerful & Generative Music 'Creator Player System'.

Use Wotja ( "whah-chah" [alt "wot-yah"; Siri "woa-chah"]) to generate ambient soundscapes, relaxing drones, text-to-music arps, MIDI + much more - and to do it all locally on your device, i.e. not in the cloud.

Wotja icon Wotja Quick Start

Play a 'Flow':

  • In the Documents screen select the Flows segment (see below):
  • Tap any one of the Schema ('Flow') icons. Tip: If you have a slower or older device, tap one of those appended with (CPU-).
  • Wotja will then in the Flow Player auto-generate a live 'flow' of beautiful generative music mixes.
  • See also: 30 second Play a Flow tutorial.

Create & Play an Album:

  • In the Documents screen select the Albums segment (see image above, 3rd segment along).
  • In the Albums screen tap the "+" button and create an auto-album which should just auto-play.
  • See also: 1 minute Create & Play an Album tutorial.

Wotja icon Wotja Tutorials

Our online Tutorials are short, focused and easy. W23 Updated. NEW See also Quick Start, above.

Wotja icon Wotja User Guide

Sections: Wotja icon | Wotja WME iconWME | Wotja WAE iconWAE | Wotja WSE iconWSE

Sections: Wotja icon | Wotja WME iconWME | Wotja WAE iconWAE | Wotja WSE iconWSE

Our comprehensive User Guide (reference manual) will quickly help you get to grips with the workings of Wotja - should you want to know!

View it In-App [default] or Online, depending on the status of Settings: GeneralSettings: General > "Help: In-App (uncheck for Online Help)""Help: In-App (uncheck for Online Help)" [default: checked].

Tip: To see it in your own language, view it Online and use our website Translate option.

User Guide button (some screens):

    • Displays the appropriate section of the User Guide.

Actions menu (most screens):

  • Help - User Guide
    • Displays the appropriate section of the User Guide.

Wotja icon How does Wotja work?

It is way easier to use Wotja than it is to describe how it works - and you can get going in seconds.

A good analogue is to consider how easy it is to drive a car vs having to know in great detail how every bit of a car works - before you can drive it!

That said, the 'magic' in Wotja largely results from how we use 'chance' and randomization in/with its powerful engines (music, audio & script) and 100s of included editable templates - and you can create/use your own, too.

That magic is a consequence of 30+ years of continuous improvement & extension (meaning our craft, passion and blood, sweat & tears!).

Here goes...

Note: For a hyperlinked version of what follows, see also the Overview in the In-App Guide (which can be accessed from most Actions menu buttons) or from this link to the Online Guide.

  • At the core of the Wotja Generative Music System are 4 main types of user-editable files:
    • Wotja Template File ("Template"; filetype: .wotja_tp);
    • Wotja Schema File ("Schema"; filetype: .wotja_sc);
    • Wotja Mix File ("Mix"; filetype: .wotja);
    • Wotja Album File ("Album"; filetype: .wotja_al).
  • Wotja Template File:
    • User editable Wotja Templates are used to populate Cells in Mix Files, and auto-population of Cells can be achieved through use of Schemas (below).
    • Each Wotja Template comprises a Generator Network of one or more Generators that generate MIDI notes/controller events, the Generators being any of those included in the Wotja Music Engine (WME).
      • Each Generator creates MIDI notes and events according to its Generator Type, the settings of the Rule Objects it uses (e.g. Scale, Harmony, Rhythm and Next Note), as well as other related parameters like Phrasing, Chording and Articulation etc.
    • Each Wotja Template includes a Wotja Audio Engine (WAE) Synth & FX Network for each Generator, this being used to generate audio from that Generator's MIDI notes/events (use of the WAE is optional, and it can be turned off).
      • You can instead if you wish use 3rd Party Hosted Plug-ins or send the MIDI to a 3rd Party DAW/Synth for use by that.
    • Many Wotja Templates are built-in to Wotja, but they can also be exported from a Cell.
  • Wotja Schema File:
    • These are used to generate mix files, 'flows' and albums (all of which use Template) and many are built-in to Wotja, but they can be added/duplicated and edited in the Schema Editor.
    • Each Wotja Schema comprises all settings necessary to create a Wotja Mix file or a 'Flow' (a sequence of auto-generated mix files generated in the Flow Player) from a random selection of selected Wotja Templates, selected Sound Presets and selected FX Presets.
  • Wotja Mix File:
    • These are the editable files that generate music and they can be manually populated or populated from Schemas.
    • Each Mix File comprises Cells which are arranged in grid of 4 columns and 12 Tracks (i.e. 48 Cells in total).
      • Each Cell can have a Template added to or merged into it, OR have links to a WAV or MIDI file in a Pak.
        • WAE Wavetable Units in Templates can also refer to external SF2 files.
        • Any such SF2 and Paks must be located in the Wotja Folder.
    • Various mix-related settings such as Cell Properties and Mix Properties.


  • WAE FX can also be applied directly as Generator FX, Cell FX, Track FX or even as Mix FX.
  • In any Track only one Cell can play at a time.
  • When a Mix File is saved ALL Template settings/edits are saved to the Mix file.