Skip to main content Skip to docs navigation

Wotja 24 User Guide

UI: Music; Engines: Wotja WME iconWME | Wotja WAE iconWAE | Wotja WSE iconWSE; Paks: Wotja Pak iconPak Maker

Wotja small 'W' icon24.3.6 | 24 Feature Set | PDF > Wotja Archive

Find something? Try page search e.g. with Cmd+F/Ctrl+F.

Intro, Start, Players Mix Editing Screens Settings, Store, Engines +

Intro


Getting Started


Wotja Players





Settings,  iCloud


Store  


Engines


Paks


Other


PDF

Overview

Wotja®: FREE Software for Live Generative Music & MIDI - AUv3 [AKA AU3]/VST3 Host App & Plugin

Wotja is a FREE App Bundle for: Phone, Tablet, Laptop, Desktop, TV, Watch; OS: iOS, iPadOS, macOS, Windows, Android, tvOS, Android/Fire TV, watchOS; iOS/iPadOS/macOS & Windows Apps are AUv3/VST3 Hosts & include AUv3/VST3 Plug-ins respectively

What is Wotja? | FREE

Wotja is a powerful & FREE system for on-device generation of Live Generative Music & MIDI.

Use it to easily create & play ambient music soundscapes, textured drones, text to music melodies & arps, experimental & adaptive music and so much more.

Wotja delivers great results and can even be used by Game & App Developers.

It is actively developed by us at Intermorphic, meaning it continues to evolve.

Enjoy using it for FREE in default Lite mode. Or, Go Pro to do the MAX!

See Why do I need Wotja? and check out some Demo Recordings.

Generative Music Creator, Lab & DAW

3 Generative Music Players

Other things to know...

See User Reviews to read some of many nice things that people say about Wotja.

Wotja is pronounced as "whah-chah" [alt "wot-yah"; Siri "woa-chah"].

It is a truly unique App with a distinguished provenance, it being the consolidation and continued evolution of 1992+ SSEYO Koan, 2000-2007 intent Sound System (incl. APRE) & SSEYO miniMIXA, 2007+ Noatikl, 2007+ Liptikl, 2008+ Mixtikl & 2012+ Tiklbox.

Wotja generates music locally on your device (i.e. no internet connection is required for generation).

Wotja App Bundles include the AUv3/VST3 Plug-in (iOS/macOS or Windows respectively).

The in-depth Wotja User Guide, Wotja Tutorials and Wotja FAQs should provide all the help you need to begin your creative journey with Wotja.

If the above is enough of an overview for you, then get Wotja now (it's free) and get started creating/playing. You'll soon understand why Wotja is so difficult to pigeon hole. Otherwise, read on...

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!

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

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

See also: Music Mode Schematic.

  • At the core of Wotja are 4 main types of user-editable files:
  • Wotja Template File:
    • User editiable 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 Wotja Template also 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 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.
    • Various mix-related settings such as Cell Properties and Mix Properties.

Notes:

  • 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.

What's New in Wotja 24?

Wotja 24 has a number of exciting new features, capabilities, content and improvements at launch, and more will be added during the course of 2024. Below are some of the biggest things (refer also to the Releases page).

Note: Wotja 24 saves files to a new format that can be opened in Wotja 23, but will not play as intended in Wotja 23 or earlier if any New Features are used in the file.

WOTJA URIs | DEMO FILES | RECORDINGS: Check out some examples!

The Wotja Feature Set (AKA 'FS') evolves with each major current version (see also Wotja Archive).

24 FS Lite mode Limitations shown in red. Auto-timeouts shown by . Go Pro to unlock ALL Lite mode Limitations. 24 FS subject to change.

See also: Licensing of Recordings | What are 'Features'? What is a 'Feature Set'? | Lite vs Pro modes. See the full Feature Set.

24 FS: Wotja Auto-Timeouts Lite Pro/Pro 23+
App: Album file 15 mins None
App: Schema file (Flow Player) 5 mins None
App: Mix or Template file 2 mins None
Plug-in: ALL filetypes 2 mins None
TV Player: Schemas 5 mins None
24 FS: NEW FEATURES in Wotja 24 (auto-timeouts as stated) Lite Pro/Pro 24+
24 (One Time Buy) | ONE TIME BUY EXAMPLE
Text-to-Music Generator 'Arp' options for 'Text-to-Arp' (TTA) [24.0] Yes Yes
Macro Oscillator 2 (WAE TG Unit) [24.0] Yes Yes
Resonator (WAE TG Unit [Experimental]) [24.0] Yes Yes
'24 IM Piano Damped' SoundFont (for WAE Wavetable TG Unit) [24.0] Yes Yes
'24 IM E-Piano' SoundFont (for WAE Wavetable TG Unit) [24.0] Yes Yes
'24 IM Strings' SoundFont (for WAE Wavetable TG Unit) [24.0] Yes Yes
24 Arps and 24 Strings Templates [24.0] Yes Yes
Many new 24 Synth and FX Presets for use in the WAE [24.0] Yes Yes
Schema format extended to support Mix Root/Rules & Schema Scripts [24.0] Yes Yes
Edit Schema Mix Root/Rules & Schema Scripts [24.0] No Yes
Various 24 Schemas [24.0] Yes Yes
Add or Export User Schema to Album [24.0] No Yes
Play an Album that includes a Schema [24.0] Yes Yes
Create New Template from a built-in Template [24.0] No Yes
24 FS: FREE IMPROVEMENTS in Wotja 24 (auto-timeouts as stated) Lite Pro/Pro 23+
Send MIDI CC Events on Channel Set for Generator MIDI Ch change [24.3] Yes Yes
Editor Panels + draggable Splitter Bars to improve ease of mix editing [24.2] Yes Yes
Mix UI Layout options (Desktop/Tablet/Mobile) for the Editor Panels [24.2] Yes Yes
Wotja Plug-in now supports multi-document use and URI Player [24.2] Yes Yes
Optional RHS placement of Mix Tab Bar for Landscape use [24.2] Yes Yes
Font Size Setting for the Script Editor [24.2] Yes Yes
Generator Network focus border on selected FX Button (Generator, Cell, Track, Mix) [24.2] Yes Yes
WAE Synth FX Editor Unit editing and new Undo button in each unit [24.2] Yes Yes
Quick Start Screen to help make it easier for new users [24.1] Yes Yes
URI Player for playing a Wotja URI (iOS/macOS/Windows/Android) [24.1] Yes Yes
Share screen for much easier exporting/sharing of a Wotja URI [24.1] Yes Yes
Any 'Import from Clipboard' option auto-opens in correct Doc Screen [24.1] Yes Yes
Wotja Script extended for use of Rules, Templates, WAE Presets & more [24.1] Yes Yes
24 Schemas updated, improved & extended [24.1] Yes Yes
Wotja Folder can be specified by user (Windows) [24.1] Yes Yes
Plug-in search path for VST folder scanning (Windows) [24.1] Yes Yes
Add File thumbnail buttons added to relevant Document Screens [24.1] Yes Yes
Main filetype formats have been modified for easier sharing [24.1] Yes Yes
API command support in Wotja URI for App/Game Devs [24.1] Yes Yes
Example Projects for App/Game Devs (iOS/macOS/Windows/Android) [24.1] Yes Yes
Standalone User Guides & PDFs for the WME, WAE & WSE [24.1] Yes Yes
Support for use of SF3 (Ogg) files (in WAE Wavetable TG Unit) [24.0] Yes Yes
More WAE Reverb Presets [24.0] Yes Yes
Multiple File tabs in Mobile version [24.0] Yes Yes
Many, many other smaller improvements [24.0 - 24.3 ] Yes Yes
24 FS: Wotja App (auto-timeouts as stated) Lite Pro/Pro 23+
Multi-channel MIDI Out/In Ch 1 only 16 Channels
Mix Record to Audio/MIDI No Yes
Hosted Plug-in data saved to Mixes No Yes
Create Playlists No Yes
Edit Schemas No Yes
Edit Albums No Yes
Save Flow to Mix or Album file No Yes
Export Mix to/from Album No Yes
Export/Import/Merge Cells (Templates) No Yes
Export/Import Sequence Generator & some Text related data No Yes
Remove Wotja watermark (full/display screen) No Yes
Sleep Timer No Yes
Custom Mix FX Override No Yes
AUv3 [AKA AU3] Plug-in Hosting (macOS/iOS) Yes Yes
VST3 Plug-in Hosting (Windows) Yes Yes
Load SF2/DLS/ZIP (i.e. Pak) files from file system Yes Yes
iCloud for Wotja Folder (iOS/macOS only) Yes Yes
Inter-App Audio/Audiobus/Ableton Link (iOS App only) Yes Yes
Play Schemas Yes Yes
Create/Edit/Play/Save/Export/Import Mixes Yes Yes
Create/Play/Save/Export/Import Albums Yes Yes
Create/Edit/Save/Export/Import Synth & FX Networks Yes Yes
12 Track Mix Editing Yes Yes
Access to all Editors - Mix, Text, Display, Plug-gins & Engines (WME, WAE) Yes Yes
Wotja Script Editing (WSE) Yes Yes
Save Text Rules & Text to Mixes Yes Yes
Import Text/Rules Yes Yes
Many, many, many other features & capabilities... Yes Yes
24 FS: Wotja Plug-in (auto-timeouts as stated) Lite Pro/Pro 23+
Mix File/Session Saving No Yes
Mix Record to Audio/MIDI No No
Support for Plug-in hosting No No
In-App Store No No
24 FS: Wotja Player for TV (auto-timeouts as stated) Lite Pro/Pro 23+
Plays Built-in Schemas only Yes Yes
Plays other File Types No No
Support for Plug-in hosting No No
In-App Store No No
24 FS: Engines (auto-timeouts as stated) Lite Pro/Pro 23+
Wotja 24 WME (Music Engine) Yes Yes
Wotja 24 WAE (Audio Engine) Yes Yes
Wotja 24 WSE (Script Engine) Yes Yes
Wotja 24 WTE (Text Engine) Yes Yes
24 FS: Add-on Paks [PAK EULA] (auto-timeouts as stated) Lite Pro/Pro 23+
Pro Paks FREE and licensed for use in specified version(s) Not licensed Yes

Load Screen

Wotja Load Screen

Tap for large

Guide Schematics

This User Guide provides schematics for each key screen, making it easy to get to grips with Wotja. Each schematic is surrounded by color-coded buttons.

Tap a button around the outside of a schematic for further info on that UI element. Tap it again (or use your browser back button) to return to the schematic.

In a desktop browser hover over the button for a pop-up description of the item; on an iOS device tap/hold the button for a quick preview. Easy!

Color-coded buttons and examples from the Music Mode Schematic :

# : Panel/Window/Area e.g. 43Editor Panel 1

# : Button/selector e.g. 26Cell Selector

# : Display item e.g. 37MIDI Channel Box

# : WME (Music) e.g. 32Generator Button

# : WAE (SFX) e.g. 40Generator FX Button

# : Splitter Bar e.g. 46Splitter Bar

File Types

IMPORTANT: As they support new W24.1 capabilities, opening/loading/using a Wotja 24.1 mix file or filetype requires Wotja 24.1 or later to open/play.

Wotja Shared Examples | Tip: How do I get files into Wotja? See this FAQ.

  • Wotja can directly open/save/import/export (no save to legacy):
    1. .wotja [Mix file extension]: Contains all parameters (WME, WAE, WTE), text and image needed to play and display a mix. Mix files are shown in the Documents > Mixes (& Templates) screen. See also: Sharing Wotja Files and the Share screen.
      • Wotja URI Format: wotja://mix/DATA...
        • Prior to W24.1 was: wotja://wj4DATA... (open/re-save to convert to the new format above)
      • Wotja URI API Format: wotja://api_load/?data=mix/DATA...
      • Web file: Change the above file extension to .SKM, where M stands for Mix
    2. .wotja_al [Album file extension; AKA 'Play-only' file]: A playlist container including up to 20 .wotja files. Album files are shown in the Documents > Albums screen. See also: Sharing Wotja Files and the Share screen.
      • URI Format: wotja://album/DATA...
        • Prior to W24.1 was: wotja://wotjabox_DATA... (open/re-save to convert to the new format above)
      • Wotja URI API Format: wotja://api_load/?data=album/DATA...
      • Web file (W23.5+ required): Change the above file extension to .SKP, where P stands for Play
      • Legacy extension: .wotjabox (see legacy below).
    3. .wotja_sc [Schema file extension; AKA 'Transmute' file]: A Schema contains all parameters/settings needed to generate a 'Flow', auto-create a mix file, or for use for in-mix randomization; previously called "Randomization Scheme", "Randomization Preset" or "RP". Schema files are shown in the Documents > Flows screen. See also: Sharing Wotja Files and the Share screen.
      • URI Format: wotja://schema/DATA...
        • Prior to W24.1 was: wotja://schema_DATA... (open/re-save to convert to the new format above)
      • Wotja URI API Format: wotja://api_load/?data=schema/DATA...
      • Web file (W23.7+ required): Change the above file extension to .SKT, where T stands for Transmute
      • Legacy extension: .wotjarp (see legacy below).
    4. .wotja_tp [Template file extension; AKA 'Design' file]: Added to a Cell via the Template List. Like Mix files, these are shown in the Documents > Mixes (& Templates) screen. To export a Template to clipboard see Music Mode & Grid button > Export Cell to Clipboard or the same button/option in the Template Editor (both Pro mode only).
      • URI Format: wotja://template/DATA...
        • Important: Templates can not be directly shared or played as a Wotja URI, but they can be exported/shared via Export to Template to Mix on Clipboard.
        • Prior to W24.1 was: noatikl://ptk3DATA... (open/re-save to convert to the new format above)
      • Web file (W23.5+ required): Change the above file extension to .SKD, where D stands for Design
      • Legacy extension: .noatikl (see legacy below).
    5. .wotja_ls [Playlist file]: References .wotja files located in the Wotja folder. Playlist files are shown in the Documents > Albums screen.
      • Format: wotja://list/DATA...
        • Prior to 24.1 was: wotja://wotjalist_DATA... (open/re-save to convert to the new format above)
      • Legacy extension: .wotjalist (see legacy below).
    6. Legacy file extensions: Still openable, but Wotja saves to new extension above.
      • .wotjarp [Schema file]: See .wotja_sc files above.
      • .wotjabox [Album/Box file]: See .wotja_al files above.
      • .wotjalist [Playlist file]: See .wotja_ls files above.
      • .noatikl [Noatikl file (Template)]: See .wotja_tp files above.
      • .mixtikl [Mixtikl file (Mix)]: Auto-converted to .wotja file when opened via Documents
      • .liptikl [Liptikl file]: Auto-converted to .wotja file when opened via Documents
  • Wotja can also import/export:
    1. .wotja_sy [WAE Synth Network file]: AKA "Synth Preset". To export a Synth Network to clipboard see SFX Network Editor > Actions > 'Export to Clipboard'; to import see the related 'Import from Clipboard' option.
      • Format: <fxm>DATA</fxm>
      • Legacy file extension:
        • .tg: Import, but not export.
    2. .wotja_fx [WAE FX Network file]: AKA "FX Preset". To export a FX Network to clipboard see SFX Network Editor > Actions > 'Export to Clipboard'; to import see the related 'Import from Clipboard' option.
      • Format: <fxm>DATA</fxm>
      • Legacy file extension :
        • .fxm: Import, but not export.
    3. Wotja URI (WJURI):
    4. Plain text: words/characters, cut-up, cut-up rules, patterns etc.
  • Wotja can use:
  • Wotja can record to:
    1. .wav (convertable to .ogg), .midi

Glossary

  • Album: A Wotja Album file (.wotja_al) includes a number of Wotja Mix files and is packaged as a zip file [AKA a Wotja 'Box']. Albums can be exported to the Clipboard as a Wotja URI (WJURI). See also: Filetypes and Album/Playlist Player.
  • Arp: Short for 'arpeggiation' or 'arpeggiated melody'. See also: Arp Mode.
  • Audio Unit (AU/AUv3): An Audio Unit (AU) [Apple link] / Audio Unit Extension / Audio Unit Plug-in (the latest iteration of which is Version 3) is most easily thought of as a self-contained program that can run in an Audio Unit Host. It is a proprietary plug-in architecture that is used by Apple, and so is different to Steinberg's VST format/architecture. See also: Plug-in Hosting and Wikipedia Audio Units.
  • Audio-rate unit: A WAE Unit (e.g. TG Wavetable or Reverb FX) that generates audio at your device's Audio Output rate (e.g. 48 kHz). See also: WAE Units and Synth & FX Editor.
  • Control-rate unit: A WAE Unit (e.g. LFO unit or Envelope) that operates at a low frequency, most typically between 0 - 50 Hz. See also: WAE Units and Synth & FX Editor.
  • Cell: At the heart of a Wotja Mix, a Cell can include one of A) a generative Template (unmodified, modified or even several merged into it); B) an Audio loop; or C) a MIDI file. See also: Cells and Cell Duration.
  • CPU: Acronym for Central Processing Unit. Wotja does not know (or care) how your device processes its audio (it could be the CPU, or a Digital Signal Processor (DSP) or even A N Other chip that does it, or any combination). That being so, we use the CPU acronym e.g. on the Music Mode Tab as a catch all to cover any processing activity.
  • Cut-up Text: Text selected at random from a "word pool", a technique that is particularly helpful for coming up with fresh ideas. The wordpool can include text from Mix Text Mode Sources and Libraries (User, General and Wotja). Cut-up text is very useful when used as a source for Text to Music (TTM) as generation can be set to occur at certain intervals. See also: Text Mode , Text Properties and Generator - Text-to-Music.
  • Flow: A succession of mixes that are auto-generated in the Flow Player using settings in the selected Schema - it is a bit like a local radio station just for you! See also: Flow Player.
  • Generator: One of 6 different MIDI note/MIDI controller event generator "types" in the WME:
    • Rhythmic: The original Generator and used for generating MIDI notes with durations only as available in the Generator's specified Rhythm Rule (which also specifies probability weightings). Several of the parameter settings for this generator type are common to other generators. Typical use: Melodies. See also: Generator - Rhythmic.
    • Ambient: Used for generating MIDI notes with durations/ranges specified via parameters (i.e. not the Rhythm Rule). Typical use: long MIDI notes (Drones, pedals); short random duration MIDI notes (e.g. effects like raindrops). See also: Generator - Ambient.
    • Sequence: Used for generating note sequences. Does not generate notes itself, but uses one of its supported sub-types to do that. It is easiest to think of it as a list which supports a number of list items where each list item includes all the parameter values needed for the generator sub-type to create note sequences. See also: Generator - Sequence.
      • Euclidian: A Sequence Generator sub-type, it composes note sequences from 3 main Euclidian parameters - Steps, Fill and Rotation. Typical use: Easy and FAST creation of melodies requiring no musical knowledge; for beat generation. See also: Sequence - Euclidian.
      • Text-to-Music: A Sequence Generator sub-type, it composes note sequences (and/or arps) from manually entered or auto-generated text and the Generator's Scale Rule. Typical use: Easy and FAST creation of melodies requiring no musical knowledge. See also: Sequence - Text-to-Music and Arp Mode.
      • Pattern: A Sequence Generator sub-type, it composes note sequences just like a Rhythmic Generator unless it is being used to play note patterns (there are 3 different kinds: B, R, F). Typical use: Providing a melodic structure (muted or not) for other Generators to compose around and/or to be followed (Follower); for playing predefined melodies (and sequences) See also: Sequence - Pattern.
    • Follower: Used for generating MIDI notes that follow those created by another Generator (of any type). You can select note delay options and a composition "strategy" of Chordal Harmony, Interval Within Scale Rule or Semitone Shift (but to be generated a note still must be permitted by the Generator's Rule). Typical use: Creating (delayed) harmonies on composed notes; generating notes for Listener Generators. See also: Generator - Follower.
    • Repeater: Composes just like a Rhythmic Generator but can repeat bars of MIDI notes that it has generated earlier. Typical use: Occasionally repeating previously composed bars of notes. See also: Generator - Repeater.
    • Listener: Listens out for incoming MIDI notes and, when detected, these can be played by a Follower Generator or used for Scripting with the WSE. Typical use: Hyper Instrument / Adaptive Music where external MIDI input can be used to influence/direct composition (albeit with some latency as the WME composes a little in advance). See also: Generator - Listener.
  • Generator Network: The particular combination of Generators in a Cell. See also: Generator Network View.
  • Mix: A Wotja Mix file (.wotja) that includes all the settings Wotja needs to play it. Mixes can be exported to the Clipboard as a Wotja URI (WJURI). See also: File Types and Music Mode.
  • Playlist: A Wotja Playlist file (.wotja_ls) references Wotja Mix files that exist in your Wotja Folder (it does not include them like an Album does). See also: File Types and Album/Playlist Player.
  • Plug-in or Plugin: See also: Audio Unit (AUv3) above or VST below.
  • Randomization Preset: Old name for Schema.
  • Rule: One of 4 different Rules in the WME where each rule specifies a number of discrete values (scale elements, note durations) and probability weighings that govern how likely any element is to be selected by a Generator. The Scale, Harmony and Next Note rules are are inter-dependent meaning that a particular note can be selected for composition ONLY if it is available in all of them AND it is possible with the Generator's Pitch/Range parameter settings:
    • Scale: The Generator Rule that specifies the available scale elements (pitches) that can be used for composition, starting at the Mix Root. If an element is not available it will not be used. Example: If the Mix Root was C then scale element 0 would be a note of pitch C, 1 would be C# (minor Second, 2 would be C (major Second) etc. See also: Scale Rule.
    • Harmony: The Generator Rule that specifies what harmony intervals are permitted when it composes notes (in a Cell or even the Mix). If an interval is not available it will not be used. Example: If there is a note already playing (and so needs to be considered for harmonization) then a Rule element of 0 would represent a note of the same pitch, 1 a minor Second above that pitch, 2 a major Second above that pitch etc. See also: Harmony Rule.
    • Next Note: The Generator Rule that specifies how far away from its last composed note (in terms of intervals, + or -) the next note needs to be. If an interval is not available it will not be used. Example: If there is a note already playing then a Rule element of 0 would represent a note of the same pitch, 1 a minor Second above or below that pitch, 2 a major Second above or below that pitch etc. See also: Next Note Rule.
    • Rhythm: The Generator Rule that specifies what note durations can be selected when a note is generated. If an interval is not available it will not be used. Example: A Rule element of 1 is a whole note (240 Wotja units), 1/2. a dotted half note 180 (240 Wotja units), 1/2 a half note (120 Wotja units) etc. See also: Rhythm Rule.
  • Schema: A Wotja Schema file (.wotja_sc) is a collection of parameter settings that can be used to create an automatic mix, a 'flow' in the Flow Player or when in-mix randomization is used. Schema files (AKA 'Touch' files) are displayed in the Flows screen. See also: Filetypes, Schemas and in-mix randomization
    • Formerly referred to as Randomization Preset (RP) or Randomization Scheme (RS).
  • Synth & FX Network: A particular configuration of WAE units created in the Synth & FX Editor. See also: Synth & FX Editor.
  • Template: A Wotja Template file (.wotja_tp) is required in any Cell that generates generative music. Templates must contain at least one Generator and can also include Synth & FX networks (Generator FX and/or Cell FX). Wotja includes many hundreds of editable Templates and you can also export your own from a Cell [Pro mode only]. See also: Filetypes and Templates.
  • Tone Generator: An audio-rate unit in the WAE. These generate sounds from MIDI events composed by the Generators, and are available only behind the Synth button in the Generator Network Editor. See also: Generator Network View.
  • Track: A group (line) of 4 Cells. Use the Grid Button to see all Cells in a Track. Tracks can be muted/soloed and have a Track Cell Sequencing button. This allows the Cells in the track to be sequenced (played one after the other), triggered or looped. Tracks can also have their own WAE Network. See also: Grid Button , Track Play Type and Track FX.
  • TTA (Text-to-Arp): The technique of generating arps from manually entered or auto-generated text and a TTM Generator with Mode set to Arp. See also: Generator - Text-to-Music and Arp Mode.
  • TTM (Text-to-Music): The technique of generating melodies from manually entered or auto-generated text and a TTM Generator's Scale Rule. See also: Generator - Text-to-Music.
  • URI Player: A bare-bones Wotja Player UI for auto-importing a Wotja URI and playing live generative music, for creator/fan sharing and for 3rd Party Apps/Games. See also: URI Player.
  • VST3: An VST3 Plug-in is most easily thought of as a self-contained program that can run in an VST3 Host. VST3 is Steinberg's latest Plug-in format and is different to Apple's Audio Unit format. See also: Plug-in Hosting and Wikipedia Steinberg VST.
  • Wotja Folder: This is where Wotja finds and saves files. See also: Wotja Folder.
  • WAE: The optional WAE (Wotja Audio Engine) is what Wotja uses for audio/sound generation (it can be turned off in Settings > Audio MIDI+ > WAE for Sounds & FX). It comprises a number of audio-rate tone generators (synths), FX units, control-rate units and connectors and junctions (to hook up more complex configurations). Complex networks of these units can be created in the Synth & FX Editor. See also: WAE , Setting WAE for Sounds & FX and Synth & FX Editor.
  • WJURI: A Wotja URI ('WJURI') is a Wotja Album, Mix or Schema file shared to clipboard as a long text string in the form of a URI (Uniform Resource Identifier). It can be embedded in a web page, shared in a message/forum or saved as the relevant Wotja file. See also: Share and File Types.
    • A Wotja Schema WJURI starts with wotja://schema/.
    • A Wotja Album WJURI starts with wotja://album/.
    • A Wotja Mix WJURI starts with wotja://mix/.
    • A WJURI can be can be as little as 3Kb in size and can be opened in any text editor!
  • WJAPI: Shorthand for a Wotja URI (see above) that also includes a Wotja API command for use in the Wotja URI Player.
  • WME: The WME (Wotja Music Engine) is what Wotja uses for MIDI note and MIDI controller event generation . It utilizes a range of chance / aleatoric / stochastic / algorithmic music techniques and features 6 generator "types", each with related parameter settings. Those settings are what determine the notes that it composes/generates. See also: WME.

Quick Start

Back button Screen Title Show Screen checkbox Store button Settings button Create or Play a Mix button Play or Edit a Schema button Play or Create an Album button Import WJURI from Clipboard button Play a Recording button Change a Setting button Scan Plug-ins button Make an In-App Purchase button Show User Guide button Online Tutorials button

(tap circle for info, hover for tooltip; tap image for large)

Quick Start Screen: Documents > Quick Start Button

The Quick Start Screen is included in the Wotja App and Plug-in (24.1 and later). It can help make it easier to get started with Wotja by taking you right to the screen you are interested in!

  • See also our short Tutorials (start with the 4 in the Play section).

1Back Button
Tap to return to the Documents Screen.
2Screen Title
Quick Start is the name of this screen.
3Show Checkbox

If this box is checked then the Quick Start screen is shown whenever you first load Wotja.

If you uncheck it, you can always tap on the Quick Start button to show this screen.

4Store

The Store button takes you to the In-App Store (or to a Store info page in the Plug-in).

To the left of the Store button is shown the active mode of operation. What is shown depends on which IAP(s) have been purchased.

5Settings

The Settings button takes you to either the Settings: General or Settings: Audio MIDI+ screen, depending on which you last used.

7Create or Play a Wotja Mix File

Takes you to the Mixes (& Templates) Screen.

6Play or Edit a Schema (Flow)

Takes you to the Schemas Screen.

  • A Flow is a succession of Mixes auto-generated from a Schema.
  • Tutorial: Play a 'Flow'
  • Note: Editing a Schema is a Pro mode only feature.
8Play or Create a Wotja Album File

Takes you to the Albums (& Playlists) Screen.

  • An Album is a collection of Mix and/or Schema files.
  • Albums can be entirely auto-generated or you can add your own Mix and/or Schema files (Pro mode only).
  • Tutorial: Open/Play an Album
  • Tutorial: Create & Play an Album
9Import a Wotja URI from Clipboard

Imports a Wotja URI (WJURI) from Clipboard.

Note: If the Wotja URI is formatted to allow saving, you are presented with a pop-up dialog which gives you the choice to "Auto-Play or Save?". If you select save the Wotja URI is saved to the relevant Documents Screen.

10Play a Recording

Takes you to the Recordings Screen.

11Change a Setting

Takes you to the most recently accessed Settings Screen, be that General or Audio/MIDI.

12Scan Plug-ins

Takes you to the Plug-in Scanner Screen.

  • If you wish to use Wotja as a Plug-in host, this screen is where you scan for Plug-ins.
13Make an In-App Purchase

Takes you to the Store Screen.

14Show User Guide

Takes you to this User Guide.

15Tutorials

Takes you to our online Tutorials.

Documents

Add File Button Actions Button Sleep Timer Button File Tab Flows (Schemas) Screen Selector File Display Button Mixes (&Templates) Screen Selector Screen Title Albums Screen Selector File Filter Button Recordings Screen Selector Quick Start Button Store (Feature Set) Store Button Settings Button File Sort Button

(tap circle for info, hover for tooltip; tap image for large)

Tip: The schematic above shows the items common to most of the file views (screens).

Documents
  • Unless you have the Quick Start Screen selected to show, the Documents Screen is shown after you have launched Wotja and it is where you add/open/delete and rename files.
  • It comprises four different document file views/screens, each of which can be selected by tapping the relevant Screen selector:
  • Desktop versions: These allow multiple files (Schemas, Mixes, Albums and Playlists) to be open at the same time. Each file is shown in a different 4File tab at the top of the screen. The User Guide schematics use Desktop screenshots and so show this. See also Desktop Menu.
  • iOS version: When you first start the app you're prompted if you want to use iCloud or Local. See iCloud Settings.
Tutorials

1Add File Button

Add File buttons are shown on the toolbar and also as thumbnail buttons in the relevant Document screens (buttons not shown in Recordings screen).

See:

2Actions Button

Displays the pop-up Actions menu with the following options:

  • Refresh
    • Refreshes the display in the Documents screen and re-syncs to iCloud (if in use).
  • Show Plug-in Scanner... (macOS/iOS/Windows only)
  • Latest Wotja News...
    • Takes you to News page on the wotja.com website.
  • Help - Resources
  • Help - User Guide
  • Help - Feature Set...
    • Takes you to Feature Set section of the User Guide on the wotja.com website.
  • Help - Sharing...
    • Takes you to Sharing section of the User Guide on the wotja.com website.
  • Import to Documents/Wotja... (Android only)
    • IMPORTANT: Wotja for Android can only load files from/save files to internal device memory (i.e not an SD Card), specifically a folder called <Internal Storage>/Documents/Wotja ('Internal Storage' might be referenced slightly differently on different devices).
    • This menu item lets you select files to import into the <Internal Storage>/Documents/Wotja folder from a temporary folder e.g. <Internal Storage>/Documents/tempWotja.
    • For details on the work flow required to move files in/out of the '/Documents/Wotja' folder see How do I copy files (Wotja, audio, MIDI, SF2 etc.) into the 'Documents/Wotja' folder for use in Wotja?.
  • Demo Files...
  • Cancel
    • Closes the menu.
3/ Sleep Timer Button (Pro mode only)

Tutorial: Set a Sleep Timer.

  • (Off) [Default]:
    • Sleep Timer is inactive.
  • (On):
    • Sleep Timer is active

Tip: When the Sleep Timer value is changed Wotja will auto-restart whatever is playing.

4File Tab

File tabs are in all desktop, tablet and mobile variants of the Wotja App and Wotja Plug-ins, however they are not in the TV variants. They permit multiple Wotja files to be open at the same time (Schemas, Mixes, Albums and Playlists). Any open Mix, Album and Playlist files can be played, including simultaneously (subject to the capabilities of your PC).

Note: Mix files have grey tabs and Template files have teal tabs.

Note: Built-in Albums and built-in Schemas are non-editable so they do not open in a tab.

5Schemas Screen
Add File button File Display button File Filter button File Sort button Schema button Built-in File badge Actions button Timeout badge

The Schemas screen displays a number of thumbnail buttons, arranged in a grid or list (see: 6File Display button), where each button represents a Schema (.wotja_sc file; see Filetypes). Schemas can be edited in the Schema Editor.

A Schema contains all the settings needed to be 'played' in the Flow Player (a 'flow' being a succession of mixes auto-generated from a Schema').

To start a 'flow' playing, just tap the thumbnail of an unlocked file or tap on the Schema Actions button and select 'Play in Flow Player'.

Note: For a User Schema to be shown it must be in the Wotja folder.


5AAdd File buttons

Note: During the "Add File" process you will see a pop-up dialog "Save Document with Name...". Should you wish it, this allows you to use a different name for the file.

Tap for a pop-up menu with the following options:

  • Add Schema (base on Schema name) (Pro mode only)
    • Creates a new Schema file based on the selected Schema (below).
  • Import From Clipboard
    • Imports a Schema that is on the Clipboard.
  • Select Schema
    • Lets you select the Schema you wish to use when creating a new Schema.
    • Wotja Schema Select Screen

      Tap for large

5BFile Display button

Toggles the file display between grid and list views.

See the common 6File Display button.

5CFile Filter button

Tap for a pop-up menu with the following options:

  1. User
    • Select (tick) to display Schema files that you have saved to or otherwise added to the Wotja folder.
  2. Built-in: Higher CPU impact
    • Select (tick) to display built-in Schema files for devices with faster processors. These have been created to generate mixes that have a richer sound. If you can play these without issue/breakup/glitching then these are the ones you will probably want to play!
  3. Built-in: Lower CPU impact (CPU-)
    • Select (tick) to display built-in Schema files for devices with slower processors. The sound is still great, but just not quite as rich as that using those above. You should use these if you are having issues/breakup/glitching using the ones above.
    • Note: These Flows display with 'CPU-' appended to the Flow name.
  4. Search:
    • Allows you to enter a search term to search for a file by name or part name.
    • The value is discarded if you restart the app.
5DFile Sort button

See the common 14File Sort button.

5EFile button

To start a 'flow' playing, just tap any thumbnail.

See also: GSchema Actions Button.

5FBuilt-in File badge

Shown bottom right on a built-in Schema file.

Note: Built-in Schema files cannot be renamed or deleted.

5GActions button

Tap for a pop-up menu with the following options:

  • Flow Player
    • Play the Schema, as a 'flow', in the Flow Player.
  • Edit Schema (Pro mode only)
  • Delete [User Added Schemas only]
    • Delete the file.
  • Rename [User Added Schemas only]
    • Rename the file.
  • Duplicate
    • Duplicate the file.
  • Share...
    • Displays the Share screen where you can easily share the item as a Wotja URI.
  • Show in Finder (macOS only)/Show in Explorer (Windows only)
    • Opens a window with the file selected.
  • Cancel
    • Exit the pop-up menu.
5HTop Left badge

Get New Version: This red badge trumps any other badge in this position. It signifies that this file was originally created in a later major version of Wotja but you are still using an earlier major version of Wotja (you can see your Version number at the top of the Settings screen; see also Releases). Such a file may not open at all, but if it does then A) it will probably not sound as intended and B) if resaved the file MAY also show this badge. Solution: Get the latest major version of Wotja which is always a free update.

Lite mode Auto-Timeout: This orange badge signifies that when this file is played or edited Wotja will operate in Lite mode with an Auto-Timeout. Solution: Go Pro.

New Feature Used: This orange badge is only displayed if you have a One Time Buy and the file uses or includes a New Feature not unlocked by it. It means that when this file is played or edited Wotja will operate in Lite mode with Lite mode Auto-Timeouts. Solution: Remove any New Feature dependency or alternatively get a Subscription, Thirty Day Unlock or a One Time Buy for the version of Wotja you are using.

6/ File Display button

This control is shown in the Schemas, Mixes and Albums screens.

Tap the File Display button to toggle between Grid and List views.

7Mixes (& Templates) Screen
Add File button File Display button File Filter button File Sort button Mix button Template File badge Actions button Plug-in badge Timeout badge

Documents: Mixes (& Templates)

(tap circle for info, hover for tooltip; tap image for large)

The Mixes (& Templates) screen displays a number of thumbnail buttons, arranged in a grid or list (see: 6File Display button), where each button represents a Mix (.wotja) or Template (.wotja_tp) file; see Filetypes).

Note: For a Mix or Template file to be shown it must be in the Wotja folder.


7AAdd File buttons

Note: During the "Add File" process you will see a pop-up dialog "Save Document with Name...". Should you wish it, this allows you to use a different name for the file to the auto-generated one.

Tap for a pop-up menu with the following options:

  • Auto (Schema name)
  • Empty
  • Import From Clipboard
    • Tutorial: Import a Mix
    • Imports from the Clipboard (if any) a mix file and saves it to the Wotja folder.
  • New Template (From Existing) (Pro 24+ mode only)
    • Tutorial: New Template from Existing
    • Select a built-in Template and duplicate it to the Wotja folder. You can then customise that and save your own variant which you can select from the Documents Pak.
  • Select Schema
    • Lets you select the Schema you wish to use when adding files.
    • Wotja Schema Select Screen

      Tap for large

7BFile Display button

Toggles the file display between grid and list views.

See the common 6File Display button.

7CFile Filter button

Tap for a pop-up menu with the following options:

  1. Mix Files
    • Select (tick) to display Wotja Mix files (.wotja, see Filetypes) that you have created or otherwise added to the Wotja folder.
    • Note: This includes Mix files in older formats (.skd, .mixtikl and .liptikl, see Filetypes).
  2. Template Files
    • Select (tick) to display Template files (.wotja_tp; see Filetypes) that you have created or otherwise added to the Wotja folder.
    • Note: This includes Templates in older format (.noatikl; see Filetypes).
  3. Search:
    • Allows you to enter a search term to search for a file by name or part name.
    • The value is discarded if you restart the app.
7DFile Sort button

See the common 14File Sort button.

7EFile button

To open a Mix file (.wotja; see Filetypes), just tap the thumbnail of an unlocked Mix file and it will open in Music Mode (it should open in the last used view (e.g. Music, Text etc.).

To open a Template file (.wotja_tp; see Filetypes), just tap the thumbnail of an unlocked Template file and it will open in Music Mode: Template Editor (it should open in the last used view (e.g. Music, Text etc.).

See also: GMixes Actions Button.

Note: The appearance of the thumbnail depends on a number of factors:

  1. Schema
    • When a mix is created, the mix button can display Cut-up, TTM or no text and with a solid color or thumbnail of the screensaver, all depending on the settings in the Schema that is used.
  2. Filetype
    • There are different icons shown if it is an old format Wotja file, Mixtikl file or Template file (see Filetypes).
  3. Manually changed
    • If you have added a background image to your mix it will show in the thumbnail (see: Display Mode > Background Image).
    • If you have created an Empty Mix or Cut-up Mix then the thumbnail will have a white background until you select your preferred Display settings (see: Display Mode > 4Properties).
7FTemplate File badge

Tutorial: Export a Template

Shown bottom right on a Template file (.wotja_tp; see Filetypes). Tap the button to open the Template File in the Template Editor (See: Music Mode > File Tab: Template).

7GActions button

Tap for a pop-up menu with the following options:

  • Open
    • Open the file.
  • Delete
    • Delete the file.
  • Rename
    • Rename the file.
  • Duplicate
    • Duplicate the file.
  • Share... (Mixes only)
    • Displays the Share screen where you can easily share the item as a Wotja URI.
  • Show in Finder (macOS only)/Show in Explorer (Windows only)
    • Opens a window with the file selected.
  • Cancel
    • Exit the pop-up menu.
7HPlug-in File badge

Shown top right on any mix file that uses Plug-ins.

7ITop Left badge

Get New Version: This red badge trumps any other badge in this position. It signifies that this file was originally created in a later major version of Wotja but you are still using an earlier major version of Wotja (you can see your Version number at the top of the Settings screen; see also Releases). Such a file may not open at all, but if it does then A) it will probably not sound as intended and B) if resaved the file MAY also show this badge. Solution: Get the latest major version of Wotja which is always a free update.

Lite mode Auto-Timeout: This orange badge signifies that when this file is played or edited Wotja will operate in Lite mode with an Auto-Timeout. Solution: Go Pro.

New Feature Used: This orange badge is only displayed if you have a One Time Buy and the file uses or includes a New Feature not unlocked by it. It means that when this file is played or edited Wotja will operate in Lite mode with Lite mode Auto-Timeouts. Solution: Remove any New Feature dependency or alternatively get a Subscription, Thirty Day Unlock or a One Time Buy for the version of Wotja you are using.

8Screen Title

Desktop versions: The Screen title is "Documents".

Mobile versions: The Screen title shows "Wotja".

9Albums (& Playlists) Screen
Add File buttons File Display button File Filter button File Sort button Album button Playlist badge Actions button Built-in File badge Plug-in badge Timeout badge

Documents: Albums (& Playlists)

(tap circle for info, hover for tooltip; tap image for large)

This screen shows a number of thumbnail buttons, arranged in a grid or list (see: 6File Display button).

Each button represents an Album (.wotja_al) or Playlist (.wotja_ls) file; see Filetypes).

The buttons which are shown depend on the filter settings selected in the 10File Filter button menu.

Note: For an Album or a Playlist file to be shown it must be in the Wotja folder.


9AAdd File buttons

Note: During the "Add File" process you will see a pop-up dialog "Save Document with Name...". Should you wish it, this allows you to use a different name for the file to the auto-generated one.

Tap for a pop-up menu with the following options:

  • Auto (Schema name)
  • Empty (Pro mode only)
    • Creates a new empty Album file (i.e. with no mixes) based on the currently selected Schema which is then opened in the Album Player.
  • Import From Clipboard
    • Imports from the Clipboard (if any) an album file and saves it to the Wotja folder.
  • Playlist only (Pro mode only)
    • Creates a new empty Playlist file (.wotja_ls, see Filetypes).
  • Select Schema
    • Lets you select the Schema you wish to use when adding files.
    • Wotja Schema Select Screen

      Tap for large

9BFile Display button

Toggles the file display between grid and list views.

See the common 6File Display button.

9CFile Filter button

Tap for a pop-up menu with the following options:

  1. Albums
    • Select (tick) to display Album files (.wotja_al, see Filetypes) that you have created or otherwise added to the Wotja folder.
  2. Playlists
    • Select (tick) to display Playlist files (.wotja_ls, see Filetypes) that you have created or otherwise added to the Wotja folder.
  3. Built-In
    • Select (tick) to display the built-in Albums, currently 'Calm' and 'Relax'.
  4. Search:
    • Allows you to enter a search term to search for a file by name or part name.
    • The value is discarded if you restart the app.
9DFile Sort button

See the common 14File Sort button.

9EFile button

To open an Album or Playlist, just tap the thumbnail of a file and it will open in the Album Player.

If the Album includes a background image then you will see that image on the Album button.

See also: GAlbums Actions button.

9FPlaylist File badge

Shown bottom right on any Playlist file (.wotja_ls; see Filetypes).

Note: The thumbnail used by the Playlist is that of the first mix in it.

9GActions button

Tap for a pop-up menu with the following options:

  • Open
    • Open the file.
  • Delete
    • Delete the file.
  • Rename
    • Rename the file.
  • Duplicate
    • Duplicate the file.
  • Share...
    • Displays the Share screen where you can easily share the item as a Wotja URI.
  • Show in Finder (macOS only)/Show in Explorer (Windows only)
    • Opens a window with the file selected.
  • Cancel
    • Exit the pop-up menu.
9HBuilt-in File badge

Shown bottom right on a built-in Album file.

Note: Built-in Album files cannot be renamed or deleted.

9IPlug-in File badge

Shown top right on an Album file which includes any mixes that use Plug-ins.

9JTop Left badge

Get New Version: This red badge trumps any other badge in this position. It signifies that this file was originally created in a later major version of Wotja but you are still using an earlier major version of Wotja (you can see your Version number at the top of the Settings screen; see also Releases). Such a file may not open at all, but if it does then A) it will probably not sound as intended and B) if resaved the file MAY also show this badge. Solution: Get the latest major version of Wotja which is always a free update.

Lite mode Auto-Timeout: This orange badge signifies that when this file is played or edited Wotja will operate in Lite mode with an Auto-Timeout. Solution: Go Pro.

New Feature Used: This orange badge is only displayed if you have a One Time Buy and the file uses or includes a New Feature not unlocked by it. It means that when this file is played or edited Wotja will operate in Lite mode with Lite mode Auto-Timeouts. Solution: Remove any New Feature dependency or alternatively get a Subscription, Thirty Day Unlock or a One Time Buy for the version of Wotja you are using.

10File Filter Button

This control is shown in the Schemas, Mixes and Albums screens; tap link below for the relevant details.

Tap to display the "Filter Files" pop-up menu with options that govern what files are displayed. Select what you require.

Note: The button text indicates the selected items, where each one is represented by a number e.g. "Filter..." if nothing set, "Show: 1, 2, 3" etc.

11Recordings Screen
Add File Button File Display Button File Sort Button Recording Play Button File Type Badge File Name File Size Actions Button Play Status Indicator

Documents: Recordings

(tap circle for info, hover for tooltip; tap image for large)

This screen shows a number of list items where each one represents a Recording of either type WAV, Ogg, or MIDI (see Filetypes).

Note: For a Recording to be shown it must be in the Wotja folder.


11AType Audio

Tap to display a list of Audio recordings (.wav, .ogg) in the Wotja Folder.

11BType MIDI

Tap to display a list of MIDI recordings (.midi) in the Wotja Folder.

11CFile Sort Button

See the common 14File Sort button.

11DFile Play Button

To play a recording, just tap the list item. Tap it again (if still playing) to stop playing it.

See also: IPlaying Status Indicator.

11EFile Type Badge

Shown in the relevant list, there are badges for Audio and MIDI files.

11FFile Name

Shows the file name.

11GFile Date and Size

Shows the file creation date and file size.

11HActions Button

Tap for a pop-up menu with the following options:

  • Show in Finder (macOS only)/Show in Explorer (Windows only)
    • Opens a window with the file selected.
  • Open With... (iOS only)
    • Opens an action sheet where you can choose how to export/share your recording to e.g. to iCloud Drive, Facebook, Dropbox etc. depending on what you have installed. See also this FAQ.
  • Delete
    • Delete the file.
  • Rename...
    • Rename the file.
  • Export to Ogg... (WAV file only)
    • Displays a pop-up dialog where you confirm if you wish to export an OGG version of the WAV file.
  • Cancel
    • Exit the pop-up menu.
11IPlaying Status Indicator

When the file is playing the list item has a yellowish tinge.

See also: DFile Play Button.

12Quick Start Button

See Quick Start

13Store Button

A Store button is shown in the Documents, Settings: General, Flow Player, Album Player and all 5 Mix Editing screens (Music, Text, Display, Plug-ins and Recording).

When tapped on, the Store button takes you to the In-App Store (or to a Store info page in the Plug-in).

14Settings Button

The Settings button takes you to either the Settings: General or Settings: Audio MIDI+ screen, depending on which you last used.

15File Sort Button

This control is shown in all four screens.

Displays a pop-up menu that lets you select the sort order for files in this screen.

The button text shows the selected sort order e.g. "Sort..." buttons, e.g. "Sort: A-Z".

Select one from the following:

  • Sort: New-Old
  • Sort: Old-New
  • Sort: A-Z
  • Sort: Z-A
Wotja (Mac) File Window Help
About New Show Window Show Wotja data folder
Open Resize User Guide - Online
Close Desktop Menu - Online
Save Online Tutorials
Recent End User License Agreement - Online
Exit Find out about Wotja 24
Install Wotja VST3 (Win)
How to Install the Wotja VST3 Plug-in (Win)
Show the Wotja VST3 Folder (Win)
About Wotja 24 (Win)

The Desktop versions of Wotja (the App but not the AUv3 Plug-in) allow you to have open multiple mixes/boxes/playlists/albums ('files'). Each file will be shown in a separate tab at the top. If your computer is powerful enough then you play all of the files at the same time!

Being able to have multiple files open can be really handy when you wish to copy between mixes, and it is a key feature advantage the desktop versions have over the mobile versions.

To carry out normal file related activities for the Desktop versions e.g. delete/duplicate/rename files etc. you can use either the 'Documents' screen or Finder / Windows Explorer.

Keyboard shortcuts: The Desktop menu items show the keyboard shortcuts that can be used to select them, e.g. Cmd+W (macOS) or Ctrl+W (Windows) to close a tab.

Tip: To change the Audio Output Device see Settings: Audio MIDI+ > Audio Output Device.

Note: If you have the macOS and iOS versions of Wotja and have iCloud, then, instead of using the local Wotja Folder for your Wotja Files (the Wotja Data Folder menu item will show you the location of this) you may instead prefer to use the Wotja iCloud Drive folder (recommended). A key benefit of using the Wotja iCloud Drive folder is that you you will then be able to access your Wotja files on any iOS or macOS device that shares the same iCloud account. See the iCloud FAQ.

WOTJA BACKUPS: Make these by: A) Using iCloud to store your files, or by B) backing up your device with Time Machine or equivalent; or C) emailing yourself a backup copy of each wotja. Using iCloud is the easiest way to manage your files.

  • Various weblinks

Schemas: Schema Items

Save / Exit Button Schema File Tab Schema Name Schema Parameter Group Schema Parameter Group Schema Actions Menu Button

(tap circle for info, hover for tooltip; tap image for large)

Note: The Schema Editor is only accessible in Pro mode.

Schema Editor: Documents > Schemas Screen > FActions Button > Edit Schema > Schema Items

Play a 'flow': Documents > Schemas Screen > FSchema Button

Overview: What is a Schema?
  • Schemas Screen: Schemas Screen
  • A Wotja Schema is a bit like a recipe. It is a collection of settings that are used for creating auto-mixes and for in-mix randomization. It was previously referred to as a "Randomization Preset".
  • Schemas can also be "played" in the Flow Player where they generate a succession of auto-mixes, one after another, hence a "Flow".
  • Schemas are found in the Schemas screen. All the settings in the currently selected Schema can be edited in the Schema Editor which is selected via the "Edit Schema" menu item in the Schema Actions button.
  • There are over 40 different settings in each one, described below. These range from Template selections (including ones you have made), Sound & FX preset selections (again including ones you have made) right through to Cut-up rules and the number of cells/tracks in an auto mix.
  • Each Schema can have completely different settings, too, meaning they can be configured exactly as you want - whether you want to change just one setting or all of them is up to you.
  • Randomization can be used in a number of places in Wotja and the randomization parameters in a Schema determine how it is used. Examples of this are how the mixes in 'flows' and Albums are created and whether e.g. text is displayed on screen in Flow Player and/or the Playlist Player Fullscreen mode. They are also used to determine how mix Cells are populated with templates when using the Random function in Wotja, how TTM Generator text randomization is applied to mixes and how Cut-up is generated in the Text Editor screen - plus a lot more, too.
  • Select a Schema:
  • Rename / Delete / Duplicate a Schema:
  • Save a Schema:
    • Tap the 1Schema Save/Exit button for a pop-up menu where you can save changes to the current Schema or to save as another one (i.e. create your own!).

1Save/Exit Button

Displays the Save Changes Menu pop-up before exiting to the Documents screen:

  • Save & Close
    • Save the changes you have made to your file and return to the Documents screen.
  • Save & Continue
    • Save the changes you have made to your file and then continue working on it.
  • Save a Copy
    • Creates a new file (which you can rename) based on the current state of the open file (a snapshot of where you are if you like), but leaves you in the current open file - meaning if you then exit the file you will see this pop up dialog again letting you choose what to do with the file.
      • Note: This is NOT the same as Save As so please remember to save your file if you want to keep your changes to it.
  • Discard
    • Lose any changes made to your file since you opened it.
  • Cancel
    • Dismiss this popup and return to the Display screen.
2File Tab

The File Tab shows the name of the Schema.

Note: Tabs are only supported in the Desktop variants.

3File Name

Shows the name of the Schema.

4Group Header

Related items are grouped together. The Group Header shows the name of the group.

5Item/Parameter Control

Tap the control and select/edit the setting you want for the item/parameter.

See: Schema Items

6Actions Menu Button

Displays the Actions Menu pop-up:

  • Export to Clipboard
    • Exports the Schema to Clipboard for easy sharing as a Wotja URI.

Schema Items

Mix/Main

  • Schema Script (Pro 24+ mode only)
    • Values: Wotja Script (support for Schema Script to be extended)
    • Example script:
        function onSchemaMixDone() {
        wjsLog("Enter onSchemaMixDone()")
      
        mixParameterSet("Scale Rules", "Default")
        mixValue = mixParameterGet("Scale Rules")
        wjsLog("Mix: Scale Rules now = " + mixValue)
      
        mixParameterSet("Mix Root", "C")
        mixValue = mixParameterGet("Mix Root")
        wjsLog("Mix: Mix Root now = " + mixValue)
      
        mixParameterSet("Tempo", "100")
        mixValue = mixParameterGet("Tempo")
        wjsLog("Mix: Tempo now = " + mixValue)
      
        wjsLog("Leave onSchemaMixDone()")
      }
  • Tempo (Min)
    • Values: 20-400 bpm
    • The minimum tempo of a new, random mix.
    • See: Mix Tempo.
  • Tempo (Max)
    • Values: 20-400 bpm
    • The maximum tempo of a new, random mix.
    • See: Mix Tempo.
  • Mix Root
    • Menu options:
      • Edit... (Pro 24+ mode only)
        • Customise the Roots used, e.g. "A,C,E"
      • Set to Default (Pro 24+ mode only)
        • Values: A,A#,B,C,C#,D,D#,E,F,F#,G,G#
    • The Mix Root for a new random mix is selected from the values permitted.
    • See: Mix Root.
  • Mix Scale Rule
    • Menu options:
      • Edit... (Pro 24+ mode only)
        • The Mix Scale Rule for a new random mix is selected from the values permitted (rules are comma separated).
        • Values: e.g. 1 0 1 0 1 1 0 1 0 1 0 1,1 1 1 1 1 1 1 0 0
      • Select from Defaults (Pro 24+ mode only)
        • The Mix Scale Rule for a new random mix is selected from a specified Included Scale Rule.
        • Values: Included Scale Rules (see names)
    • See: Mix Scale Rule.
  • Mix Harmony Rule (Pro 24+ mode only)
    • Menu options:
      • Edit... (Pro 24+ mode only)
        • The Mix Harmony Rule for a new random mix is selected from the values permitted (rules are comma separated).
        • Values: .35 0 0 .65 .85 1 .65 .65 .65 .1 .1 0 .35,.95 0 0 .65 .85 1 .65 .65 .65 .1 .1 0 .95
      • Select from Defaults (Pro 24+ mode only)
        • The Mix Harmony Rule for a new random mix is selected from a specified Included Harmony Rule.
        • Values: Included Harmony Rules (see names)
    • See: Mix Harmony Rule.
  • Mix Rhythm Rule (Pro 24+ mode only)
    • Menu options:
      • Edit... (Pro 24+ mode only)
        • The Mix Rhythm Rule for a new random mix is selected from the values permitted (rules are comma separated).
        • Values: .1 .25 1 .5 .5 .25 .25 0 0,.8 .25 1 .5 .5 .25 .85 0 0
      • Select from Defaults (Pro 24+ mode only)
        • The Mix Rhythm Rule for a new random mix is selected from a specified Included Rhythm Rule.
        • Values: Included Rhythm Rules (see names)
    • See: Mix Rhythm Rule.
  • Mix Next Note Rule (Pro 24+ mode only)
    • Menu options:
      • Edit... (Pro 24+ mode only)
        • The Mix Next Note Rule for a new random mix is selected from the values permitted (rules are comma separated).
        • Values: 0.25 1 1 .7 .3 .2 .1 .1 .1 .1 .05 .02 .05 0 0 0 0 0 0 0 0 0 0 0,0.85 1 1 .9 .6 .2 .1 .1 .1 .1 .05 .02 .05 0 0 0 0 0 0 0 0 0 0 0
      • Select from Defaults (Pro 24+ mode only)
        • The Mix Next Note Rule for a new random mix is selected from a specified Included Next Note Rule.
        • Values: Included Next Note Rules (see names)
    • See: Mix Next Note Rule.
  • Volume (Min)
    • Values: 1-127
    • The minimum volume of a track in a new, random mix.
    • See: Track Mixer.
  • Volume (Max)
    • Values: 1-127
    • The maximum volume of a track in a new, random mix.
    • See: Track Mixer.
  • Pan +/-
    • Values: 1-64
    • How far away from center that pan can be for a Track in a new, random mix.
    • See: Track Mixer.
  • Ramp Up
    • Values: 0-20 s
    • How long a mix takes to ramp up to its full volume.
    • See: Mix Ramp Up.
  • Ramp Down
    • Values: 0-20 s
    • How long a mix takes to ramp down to zero volume.
    • See: Mix Ramp Down.
  • Duration
  • Duration Max
  • Duration Range
  • Duration Range Max

Mix - Cells

  • Environment Cells/Column (min)
    • Values: 0-8
    • The minimum number of "WJ23 Environments" Pak populated Cells that will be in a column, assuming you have a "WJ23 Environments" Pak available for selection when randomizing. These Cells are populated first.
    • See: Cells.
  • Environment Cells/Column (max)
    • Values: 0-8
    • The maximum number of "WJ23 Environments" Pak populated Cells that will be in a column, assuming you have a "WJ23 Environments" Pak available for selection when randomizing.
    • See: Cells.
  • Drone Cells/Column (min)
    • Values: 0-8
    • The minimum number of "WJ23 Drones" Pak populated Cells that will be in a column, assuming you have a "WJ23 Drones" Pak available for selection when randomizing. These Cells are populated after any Environment Cells.
    • See: Cells.
  • Drone Cells/Column (max)
    • Values: 0-8
    • The maximum number of "WJ23 Drones" Pak populated Cells that will be in a column, assuming you have a "WJ23 Drones" available for selection when randomizing.
    • See: Cells.
  • TTM Cells/Column (min)
    • Values: 0-8
    • The minimum number of TTM populated Cells that will be in a column, assuming you have a TTM Pak available for selection when randomizing. These Cells are populated after any Drone Cells.
    • See: Cells.
  • TTM Cells/Column (max)
    • Values: 0-8
    • The maximum number of TTM populated Cells that will be in a column, assuming you have a TTM Pak available for selection when randomizing.
    • See: Cells.
  • TTM Words (min)
    • Values: 1-100
    • The minimum number of words that will be added to a Text to Music (TTM) Text field on creating a new random mix or in the TTM Text Editor when using the Randomize button with Randomize option selected.
    • See: Text-to-Music.
  • TTM Words (max)
    • Values: 1-100
    • The maximum number of words that will be added to a Text to Music (TTM) Text field on creating a new random mix or in the TTM Text Editor when using the Randomize button with Randomize option selected.
    • See: Text-to-Music.
  • Tracks
    • Values: 1-12
    • The number of Tracks that will have their cell contents (below) randomized (starting with Track 1).
    • See: Track Play Type
  • Cells
    • Values: 1-4
    • The number of Cells in the Tracks above that will have their contents repopulated from the list of available templates.
    • See: Track Play Type
  • Generative %
    • Values: 0-100%
    • The chance that a randomized Cell will be repopulated with a generative template.
    • See: Cells.
  • Blank Cell %
    • Values: 0-100%
    • The chance that a randomized Cell will be empty.
    • See: Cells.

Cells

  • Generative Bar Min
    • Values: Infinite(0)-1-100
    • The minimum base value for the number of bars a generative template will play for and to which the range value (below) is added. Special Value: If this value is set far left to ∞ then once play in a Track reaches such a cell the generative content in that cell will continue to play either for as long as the mix plays or until you manually select another cell in that Track to play.
    • See: Cell Gen Bars.
  • Generative Bar Max
    • Values: 0-100
    • The maximum base value for the above.
    • See: Cell Gen Bars.
  • Generative Bar Range
  • Cell Repeat Min
    • Values: 0-100
    • The minimum base value for the number of times a cell will repeat after it has played through once and to which the range value (below) is added. For a generative template each bar counts as one repeat; for audio or MIDI content this is the length of the content rounded up to the end of a bar). Note: If the cell contains generative content and the Generative Bar Min is value is set to ∞ then this setting takes no effect as the cell never repeats!
    • See: Cell Repeats.
  • Cell Repeat Max
    • Values: 0-100
    • The maximum base value for the above.
    • See: Cell Repeats.
  • Cell Repeat Range
    • Values: 0-100
    • Sets the range that applies to the above base value.
    • See: Cell Repeats Range.

Albums/Flow

  • Mixes in Box
    • Values: 1-20
    • The minimum number of mixes in an automatically generated Box.
    • See: Album/Playlist Player.
  • Max (Mixes in Box)
    • Values: 1-20
    • The maximum number of mixes in an automatically generated Box.
    • See: Album/Playlist Player.

Reset

  • Reset Settings of this Schema to Defaults
    • Displays a pop-up message allowing you to reset all values back in the Schema back to their Defaults.

Templates

Back Button Paks List Pak Toggle Screen Title Templates List Actions Button Load/Replace Button Merge Button Documents "Pak" Generator Types Pak Selected Pak Pak Selector 3rd Party Pak Template Toggle Template Selector Filetype Icon Preview Indicator

(tap circle for info, hover for tooltip; tap image for large)

Templates

NEW Templates for W24: 24 Arps and 24 Strings

  • Wotja includes 100s of editable built-in "Templates" (.wotja_tp; see Filetypes) - see also What is a Template?
  • Built-in Templates are at the core of Wotja because every Mix file is comprised of 17Cells and for any Cell to play it must have in it either:
    • a Template, be that in an included one or one one you or a 3rd party has created.
    • an Audio or MIDI file (in the Wotja folder either as a file or in a Paks).
  • Mix files are auto-created from a Schema file (when using the Add File Button in the Mixes Screen) or in the Flow Player, which is why this section comes before the other "Edit Mode" sections.
Tutorials
What is a Template?

In our terminology a Template is basically a self contained "generative music and sound preset". This simply means it contains all the parameter settings for the WME (Music Engine), WAE (Sound & FX Engine) and anything else Wotja needs to generate music. It can include just a single Generator (these generate MIDI notes) to very complex complex network of Generators, each with their own WAE Sound & FX networks (used to generate sound and FX).

Once a Template is added to a 26Cell you can edit/customize any of its settings, but you do not have to - they sound great as they are! There are hundreds of editable Templates included in Wotja that you modify and save to use as your own (see 9Documents "Pak" (Wotja Folder)).

How are Templates used?

Automatic Mixing:

Manual Mixing:


1Back Button

Takes you back to the screen you came from.

2Paks List

Displays a list of installed Paks that you can select a Template (or other supported FileType) from.

3Pak Toggle

Note: The Pak toggle is only shown when you are accessing the Template List via the Schema Editor.

For the purposes of randomization the Pak toggle allows you to specify which Paks you want Templates to be selected from for the current Schema.

4Screen Title

Displays the name of the screen.

5Templates List

The list of Templates (or other supported FileType) in the selected Pak.

6Actions Button

The Action button displays a pop-up menu a number of useful options to help with Template and Pak selection (those marked with * are only shown in Schema Editor:

  • Sort: Value
    • New-Old
    • Old-New
    • A-Z
    • Z-A
  • Select All Paks *
  • Deselect All Paks *
  • Select All Templates in Pak *
  • Deselect All Templates in Pak *
  • Select All Paks and All Templates *
  • Deselect All Paks and All Templates *
  • Older Paks: Hidden > Show / Shown > Hide
  • Help - User Guide
7Load/Replace Button

If the Cell is empty then you will see a Load button which when tapped simply adds the Template to the Cell.

If the Cell is not empty then you see a Replace button that allows you to Replace the content in a Cell with the selected Template.

8Merge Button

The Merge button allows you to merge the selected Template with the generative content that is already in a Cell. An example would be if you had a Cell with say a TTM Generator in it and you wanted to add another TTM Template to that.

Note: You are not allowed to Merge in a Template if there are insufficient free MIDI channels to accommodate the Template.

Note: The Merge button is only shown if accessing the Template List from a non-empty Cell.

9Documents Pak

The Documents "Pak" is always shown at the top for easy access. It is not really a "Pak" at all, but just lists all the generative templates (.wotja_tp files) that are present in the Wotja Folder, whether you have saved some to there (see 4Grid Button > Export Cell to Template) or have copied/moved into it.

10WME Generator Types Pak

The WME Generator Types Pak includes simple "starter" Templates for each of the 6 Generator types, as well as a couple of examples of them in action. These Templates are for those that want to build a mix from the most basic starting point.

The reason for the extra examples (see below) is because two of them do nothing by themselves (Follower, Listener) and so if you add one of those you will not hear anything. And, although Repeater can work by itself, it is also meant for use with another generator (to repeat it).

Note: The 6 Generator types are also the Templates that are added when you select "Add Generator of Type" from a Generator's pop-up menu.

IMPORTANT: As menu items link to the Templates in the WME Generator Types Pak they are updated every major version to take advantage of New Features in that major version. If you want to use the WME Generator Types for an older Feature Set (perhaps you have an old OTB) you can download a Pak of those here here. Place this zip in the Wotja folder, restart Wotja, and this Pak will show up at the bottom of the Pak list.

Here is what is included:

  • Ambient
    • A Generator of Type Ambient (you will hear something).
  • Follower
    • A Generator of Type Follower (it will be silent as it is not following anything).
  • Generator + Follower
    • A Generator Network comprising a Generator of Type Follower set up to follow another Generator (so that you will hear something).
  • Generator + Repeater
    • A Generator Network comprising a Generator of Type Repeater set up to repeat another Generator (so that you will hear something).
  • Listener + Follower
    • A Generator Network comprising a Generator of Type Listener set up to work with a Follower Generator (so that you will hear something if you send MIDI input into Wotja).
  • Listener
    • A Generator of Type Listener (it will be silent as a Follower Generator is required to generate sound).
  • Repeater
    • A Generator of Type Repeater (you will hear something).
  • Rhythmic
    • A Generator of Type Rhythmic (you will hear something).
  • Sequence - Both (B)
  • Sequence - Euclidian (Euc)
    • A Sequence Generator of Type Euclidian (you will hear something).
  • Sequence - Fixed (F)
  • Sequence - Rhythm (R)
  • Sequence - Text to Arp (TTA) Custom
    • A Sequence Generator of Type Text-to-Music, but with TTM mode set to 'Arp', and configured to use custom text (you will hear something).
  • Sequence - Text to Arp (TTA) Cut-up
    • A Generator of Type Text-to-Music, but with TTM mode set to 'Arp', configured to use Cut-up Text line (you will hear something).
  • Sequence - Text to Music (TTM) Custom
    • A Sequence Generator of Type Text-to-Music, configured to use custom text (you will hear something).
  • Sequence - Text to Music (TTM) Cut-up
    • A Generator of Type Text-to-Music, configured to use Cut-up Text line (you will hear something).
11Selected Pak

A light blue background on a Pak indicates that it is the selected Pak.

Similarly, a light blue background on a Template indicates that it is the selected Template.

12Pak Selector

Tap a Pak to select it and displays its templates in the right hand Templates list.

See "How are Templates Used?".

These are what some of the Paks are:

  • WME Generator types
    • Simple templates that let you start a cell with just one Generator type.
    • IMPORTANT: As menu items link to the Templates in the WME Generator Types Pak they are updated every major version to take advantage of New Features in that major version. If you want to use the WME Generator Types for an older Feature Set (perhaps you have an old OTB) you can download a Pak of those here here. Place this zip in the Wotja folder, restart Wotja, and this Pak will show up at the bottom of the Pak list.
  • 24 Arps
    • A collection of Text-to-Music Templates configured for Arp mode for use in Wotja 24+.
  • 24 Strings
    • A collection of String Templates for use in Wotja 24+.
  • 23 Basses
    • A collection of Bass Templates for use in Wotja 23+.
      • Previously named: WJ23 Basses
  • 23 Classic Polysynth
    • A collection of Synth Templates.
      • Previously named: WJ23 Classic Polysynth
  • 23 Drones
    • A collection of Drone Templates and Audio samples (Ogg files) for use in Wotja 23+.
      • Previously named: WJ23 Drones
  • 23 Environments
    • A collection of Environment Templates and Audio samples (Ogg files) for use in Wotja 23+.
      • Previously named: WJ23 Environments
  • 23 Sample Player Resources
    • A collection of Audio samples (Ogg files) in Wotja 23+ for use in the Sample Player.
      • Previously named: Sample Player Resources
  • 22 Drums
    • A collection of (Euclidian) Drum Templates for use in Wotja 22+.
      • Previously named: BP22 Drums
  • 22 Drums Ambient
    • A collection of Ambient Drum templates for use in Wotja 22+.
      • Previously named: BP22 Drums Ambient
  • 22 Mixed 1
    • A mixed collection of templates for use in Wotja 22+.
      • Previously named: BP22 Mixed 1
  • 21 Drones 1
    • A collection of Drone Templates for use in Wotja 21+.
      • Previously named: BP21 Drones 1
  • 21 Flows
    • A Pak that includes special Templates used in some Flows for use in Wotja 21+.
      • Previously named: Flows
  • 20 Drones 1
    • A collection of Drone Templates optimized for use in Wotja 20+.
      • Previously named: BP20 Drones 1
  • 19 Backings 4
    • A collection of Backing Templates for use in Wotja 19+.
      • Previously named: BP4 Backings
  • 19 TTM1 Players 2
    • Templates that use Text-to-Music techniques to generate melodies for use in Wotja 19+.
      • Previously named: TTM1 Players 2
  • 05 Backings 3
    • A collection of Backing Templates for use in Wotja 5+.
      • Previously named: BP3 Backings
  • 04 Backings 2
    • A collection of Backing Templates for use in Wotja 5+.
      • Previously named: BP2 Backings
  • 04 TTM Players
    • Templates that use Text-to-Music techniques to generate melodies for use in Wotja 4+.
      • Previously named: TTM1 Players
  • 00 Paks (see Actions > Older Paks: Hidden > Show / Shown > Hide)
    • These include templates for Noatikl and Mixtikl that will work in Wotja 4+. As far as we can remember, all of these below were originally Templates for Mixtikl except the those previously named 00 Drums1/Drums2/Elements1 MIDI which were originally for Noatikl. In general with the older naming, the more zeros the older the Template!
      • 00 Ambiences
        • Previously named: BP0 Ambiences
      • 00 Arps
        • Previously named: BP0 Arps
      • 00 Backings 1
        • Previously named: BP1 Backings
      • 00 BellsGlasses
        • Previously named: BP0 BellsGlasses
      • 00 BellsMetalArps
        • Previously named: BP00 BellsMetalArps
      • 00 DroneMaker1
        • Previously named: BP00 DroneMaker1
      • 00 Drones
        • Previously named: BP0 Drones
      • 00 Drums1 MIDI
        • Previously named: BP00 Drums1 MIDI
      • 00 Drums1 OWt
        • Previously named: BP00 Drums1 OWt
      • 00 Drums2 MIDI
        • Previously named: BP00 Drums2 MIDI
      • 00 Drums2 OWt
        • Previously named: BP00 Drums2 OWt
      • 00 Elements1 MIDI
        • Previously named: BP00 Elements1 MIDI
      • 00 Elements1 Synth
        • Previously named: BP00 Elements1 Synth
      • 00 MelodicPads
        • Previously named: BP0 MelodicPads
      • 00 Melodics
        • Previously named: BP0 Melodics
      • 00 Mix1/Mix2/Mix3/Mix4/Mix5
        • Previously named: BP000 Mix1/Mix2/Mix3/Mix4/Mix5
      • 00 Mix6/Mix7
        • Previously named: BP00 Mix6/Mix7
      • 00 Strings
        • Previously named: BP0 Strings
      • 00 Weirdness
        • Previously named: BP0 Weirdness
      • 00 WindHarp
        • Previously named: BP0 WindHarp
      • 00 WME Others
        • Previously named: WME Others
  • 3rd Party Paks
133rd Party Pak

3rd Party Paks are shown below at the very bottom of the included Paks list (i.e. below the Flows Pak), e.g. the free Morphing Drum and Bass (MDB) and Audio Loop Collections Paks.

14Template Toggle

For the purposes of randomization the Template toggle allows you to specify which Templates you want to be selected for the current Schema.

See "How are Templates Used?".

Note: The Template toggle is only shown when you are accessing the Template List via Settings > Randomization > Templates.

15Template Selector

Tap to select or preview a Template; tap again to stop the preview.

16Content Type Icon

Shows an icon to indicate the content type as follows (see Cell Content Type):

  • Generative
  • Audio file
  • MIDI file

Notes:

17Preview Indicator

Important: A template must always be previewed before it can be added to a mix.

A Template can be previewed when a mix is playing.

You can preview it without having to open it and when being previewed it has an orange background.

Tap to select or preview a Template; tap again to stop the preview.

Share (Wotja URI)

Important: As a generative music laboratory, Wotja is an 'open system'. This means that anyone with Wotja can open any Wotja URI (WJURI) or File you might share and then edit it (NB: Albums & Schemas require Pro mode for editing). If you don't want anyone to know how you did something, then don't share the Wotja file! Instead, share a video, audio or MIDI recording of it (see EULA).

Back button Copy (to clipboard) button Share button (Apple only) Screen Title Export & Test Import button Store button Settings button Help button Wotja URI Type options Option selector Wotja URI Format options Wotja URI Purpose options Character count Code for sharing panel

The Wotja Share screen is included in the Wotja App & Plug-in (24.1 and later). It is where you can easily share Wotja content, be that a Mix, User Album or User Schema file, as a Wotja URI (WJURI). You can even share a link to a built-in Album or Schema.

There are many reasons you might want to share something and whenever you do it helps foster the Wotja community. See some examples.

The Wotja Share screen is launched from the "Share..." menu item in an Actions menu, e.g.

Top Tip: If you are sharing Wotja content for others to play & enjoy, then share it as an Album where possible. Why? Because Albums in the Wotja App can play for 15 minutes in Lite mode, which is what many listeners might be using.

See also Help on Sharing.


1Back button

Takes you back to the screen you were last in.

2Copy (to clipboard) button

Copies to clipboard the code shown in the bottom 14Code for sharing panel.

3Share button (Apple only)

Opens the iOS Share menu or macOS Share menu for you to select where you want to share the 14Code for sharing.

4Screen Title

The title of this screen.

5Export & Test Import button

Tap this button to test play in the Wotja URI Player of the code shown in the 14Code for sharing panel.

Tip: This is any easy way for you to test your code and know it works - before sharing it!

6Store button

Takes you to the Wotja In-App Store where you can Go Pro should you wish to unlock any 9Wotja URI Type options that are greyed/marked as Pro only.

7Settings button

Takes you to the last used Settings screen, be that General Settings or Audio MIDI+Settings.

8Help button

Takes you to this Sharing section of the User Guide.

9Wotja URI Type

The options you see in this section depend on what you are sharing, where you are sharing it from and what Mode you are in.

  • Album:
    • Option is only shown when exporting a Mix File, User Album File or User Schema File.
      • Option will display as 'Pro mode only' when sharing a Mix or User Schema File in Lite mode.
      • Option will display as 'Pro mode only' when exporting a User Schema to an Album with a 23 Pro One Time Buy (OTB) because it is a New Feature in Wotja 24.
  • Mix:
    • This option is only shown when sharing a Mix File.
  • Schema:
    • This option is only shown when sharing a User Schema File.
  • Built-in Link:
    • This option is only shown when sharing a built-in Schema or Album (or Track in such an Album).
10Option selector

Use an option checkbox to select the option you wish to use.

Only one option in each a group can be selected.

11Wotja URI Format

The options you see in this section depend on what you are sharing and where you are sharing it from.

  • Auto-Play:
    • Select this option if you want the Wotja URI to open in the Wotja URI Player and auto-play.
  • Auto-Play or Save?:
    • Use this option if you want the user to have a choice on import of the Wotja URI of either auto-playing it, or saving it to the Wotja Folder (e.g. to play or edit later).
    • Note: This option not shown if you are sharing a built-in Link.
  • Auto-Play & Save Button (Web Page Embed only):
    • Select this option if you are exporting the Wotja URI for webpage embedding and want your Wotja URI to auto-play, but you want also to let a user save the Wotja URI via a separate Save button (this uses the save mechanism in the option above).
    • Note: This option not shown if you are sharing a built-in Link.
12Wotja URI Purpose

The options you see in this section depend on what you are sharing and where you are sharing it from. Each option generates different code to suit the purpose of the desired medium.

See our Wotja Sharing Examples.

  • Share in Message:
    • Select this option if you want to share your Wotja URI in a message. Edit it as you wish!
    • The 14Code for sharing panel will look something like this:

      "Item Name". To play as Live Generative Music: Get FREE Wotja (https://wotja.com/get); Either tap on Wotja URI below if shown as link, or copy message & import into Wotja (https://wotja.com/imp).

      WJURI.....

  • Share in Social Media Post:
    • Select this option if you want to share your Wotja URI in a social media post (e.g. X, Bluesky, Tiktok, Facebook etc.). Edit it as you wish!
    • The 14Code for sharing panel will look something like this:

      "Item Name". To play as Live Generative Music: Get FREE @Wotja (https://wotja.com/get); Copy Wotja URI below (or entire post); Import into Wotja (https://wotja.com/imp). #wotjamusic

      WJURI.....

  • Share in Forum Post A:
    • Select this option if you want to share your Wotja URI in a forum post (e.g. Audiobus forum) that uses Markdown instead of BBCode. Edit it as you wish!
    • The 14Code for sharing panel will look something like this:

      "**Item Name**". To play as **Live Generative Music**: 1) [Get FREE Wotja](https://wotja.com/pricing/ "") 2). Copy Wotja URI below (or entire post). 3) Import into Wotja ([Help](https://wotja.com/help/#import "")).

      WJURI.....

  • Share in Forum Post B:
    • Select this option if you want to share your Wotja URI in a forum post (e.g. KVR forum) that uses BBCode instead of Markdown. Edit it as you wish!
    • The 14Code for sharing panel will look something like this:

      "[b]Item Name[/b]". To play as [b]Live Generative Music[/b]: 1) [url=https://wotja.com/downloads/]Get FREE Wotja[/url]. 2) Copy Wotja URI below (or entire post). 3) Import into Wotja ([url=https://wotja.com/help/#import]Help[/url]).

      WJURI.....

  • Share in Web Page Embed:
    • Select this option if you want to share your Wotja URI in a webpage WITHOUT a separate Save button (i.e. if you do want a user to Save, then select the "Auto-Play or Save?" option to rely on that mechanism). Edit it as you wish!
    • The 14Code for sharing panel will look something like this:
      <p><a href="" title="Tap to play. Requires Wotja. For help see https://wotja.com/help/#import" onclick="href=wjuri_ItemName"><strong>▶ 'Item Name'</strong></a></p><p>To play as Live Generative Music: <a href="https://wotja.com/downloads/" title="Get Wotja">Get Wotja</a> | <a href="wotja://api_stop/" title="Stop Wotja">Stop</a> | <a href="wotja://api_play/" title="Replay Wotja">Replay</a> | <a href="https://wotja.com/help/#import" title="Import Help">Help</a></p><script>wjuri_ItemName="WJURI"</script>
  • Share in Web Page Embed (for Auto-Play & Save Button option):
    • Select this option if you want to share your Wotja URI in a webpage with WITH a separate Save button. Edit it as you wish!
    • The 14Code for sharing panel will look something like this:
      <p><a href="" title="Tap to play. Requires Wotja. For help see https://wotja.com/help/#import" onclick="href=wjuri_ItemName"><strong>▶ 'Item Name'</strong></a></p><p>To play as Live Generative Music: <a href="https://wotja.com/downloads/" title="Get Wotja">Get Wotja</a> | <a href="wotja://api_stop/" title="Stop Wotja">Stop</a> | <a href="wotja://api_play/" title="Replay Wotja">Replay</a> | <a href="https://wotja.com/help/#import" title="Import Help">Help</a> | <a href="" onclick="saveuri=wjuri_MyFlow.replace('wotja' + '://api_load/?data=', 'wotja://'); navigator.clipboard.writeText(saveuri); href=saveuri" title="Save as File">Save</a> </p><script>wjuri_ItemName="WJURI"</script>
  • Share as just Wotja URI:
    • Select this option if you just want to share the Wotja URI itself, without any additional code. You may want to do this if you want to replace the WJURI in a webpage embed you have already done, or if you are an App/Game developer wishing to include the WJURI in your App/Game.
    • The 14Code for sharing panel will look something like this:

      WJURI.....

13Characters

The Characters indicator shows you how many characters are in the Wotja URI and how many in all the exported code (including the Wotja URI).

Note: If your total character count is above 2048 chars then you will see a warngin at the end. This is only relevent if you wish to share your Wotja URI for users of the Windows version of Wotja. See Requirements.

14Code for sharing panel

The bottom panel shows you the code generated for the options you have selected.

It is this code that is exported to the clipboard via the 2Copy button, or shared to another App via the 3Share button (Apple only).

Wotja Flow Player

Exit Button Sleep Timer Button Repeat Button Next Button Randomization Preset Name Play/Stop Button Full Screen Top Panel Store Button Actions Button Settings Button Mix Time Remaining Flow/Sleep Time Remaining Text Area Background/Screensaver Wotja Watermark

(tap circle for info, hover for tooltip; tap image for large)

Tutorial
Wotja Flow Player
  • The Wotja Flow Player is one of 3 generative music play-only modes in the Wotja App.
  • Documents > 5Schemas Screen > EFile Button
  • Schemas Screen: Flows Screen
  • The Flow Player generates a succession of freshly created auto-mixes (a 'flow') from the various settings in the currently selected Schema, previously referred to as a Randomization Preset.
  • The Documents screen lists all the Schemas included in Wotja as well as any that are in the Wotja Folder i.e. any that you have added or created yourself.
  • Flow mix play time is governed by the Mix Duration value in the Schema.
  • Playback will continue until either the Sleep Timer kicks in (if active) or if the Lite mode auto-timeout is reached.

1Exit Button

Takes you back to the Documents screen.

2/ Sleep Timer Button (Pro mode only)

Tutorial: Set a Sleep Timer.

  • (Off) [Default]:
    • Sleep Timer is inactive.
  • (On):
    • Sleep Timer is active

Tip: When the Sleep Timer value is changed Wotja will auto-restart whatever is playing.

3Repeat Button
  • (Off) [Default]:
    • A new Flow mix will be generated/play when the current Flow mix has reached its end.
  • (On):
    • The currently playing Flow mix is restarted when it reaches its end, rather than new one being generated.
    • This is a Pro feature.
4Next Button

Forces another Flow mix to be generated.

5Schema Name

Displays the name of the Schema currently in use.

6 / Play/Stop Button

A Play/Stop toggle that will start or stop the Flow mix.

7Full Screen Top Panel

When displayed, this panel can help to see the various Menu buttons at the top of the screen. You can have it auto hide after 2 seconds by toggling off the "Show Full Screen Top Panel" in Settings: General.

8Store Button

When tapped on, the Store button takes you to the In-App Store (or to a Store info page in the Plug-in).

9Actions Button

Displays a pop-up menu with the following options:

  • Share...
    • Displays the Share screen where you can easily share the item as a Wotja URI.
  • Save Flow to Wotja Mix File (Pro mode only)
    • Saves the current Flow to a new Mix file (.wotja, see Filetypes).
  • Save Flow to Wotja Album File (Pro mode only)
    • Saves a new Album file (.wotja_al; see Filetypes) that includes the current Flow Mix file (.wotja, see Filetypes).
  • Full Screen [mobile] / Full Window [desktop]
    • Displays Wotja full screen on your device and the mix (if playing) continues to play. At any time tap the screen to leave full screen display and return to Display mode.
  • Full Screen with Camera Background (iOS/Windows)
    • Tip: Watch the Video tutorial (48 seconds in).
    • Displays your device Camera feed in a Window on top of Wotja (which may restart play on going into this mode).
    • At any time tap the screen to return to Full Screen Display mode.
    • For a composite live generative music and video feed use iOS Control Center / a relevant 3rd party app to screen mirror to a TV.
      • Perfect for use as a big screen audio-visual experience e.g. installations, nature video feeds etc.
  • Full Screen & Restart/Stop (for videos) [mobile] / Full Window & Restart/Stop (for videos) [desktop]
    • Wotja displays full screen on your device and the mix (if playing) is stopped and then restarted after 2 seconds, making it easier to find a start point in a screen video recording. At any time tap the screen to leave full screen display and return to Display mode. Alternatively, use the Record Seconds or Bars setting to have the mix auto-stop when that value is reached and then have Wotja wait 2 seconds before returning to Display mode.
    • macOS Desktop version:
      • The Wotja window title bar is hidden and a content area sized to e.g. 640x480 pixels is positioned top left of the screen below the App title bar. The available content area sizes are the same as those listed in the Titlebar > Window menu.
  • Mini Game - Follow the Line
    Wotja Mini Game - Follow the line
    • Displays a simple, but fiendishly hard, mini game in the Play Screen area.
    • Tap the line and keep following it to build up a score.
    • Score and top score (reset when Flow is exited) is shown below the top panel.
    • Tap the small top left X to close the game.
    • See this YouTube video example: https://youtu.be/fRfurwR4r5c?t=26
  • Mini Game - Bat & Ball
    Wotja Mini Game - Bat and ball
    • Displays a simple mini game in the Play Screen area.
    • Tap/drag on the the screen at the bottom to move the paddle.
    • Tap the small top left X to close the game.
    • See this YouTube video example: https://youtu.be/fRfurwR4r5c
  • Help - User Guide
10Settings Button

Takes you to the Settings: General or Settings: Audio MIDI+ screen, depending on what was last used.

11Mix Time Remaining

Displays the Play Time remaining for the current Flow mix.

Tip: To change how long mix will play for try changing the Duration/Max and Duration Max/Range values in the Schema that is being used. Doing that lets you override what is in the Schema. It's fun!

12Flow/Play/Sleep Time Remaining

If you are in 'Lite' mode or if you have an active 2Sleep Timer button then this indicator shows the time remaining before Wotja will stop playing.

Otherwise this area just show the word "Flow" to let you know you are in Flow mode.

13Text Area

Whether any text is displayed here depends on the Icon Text value used by the Schema (Settings > Randomization). The text is present in the underlying mix file and can be Cut-up or TTM text.

Tip: To change what is displayed try changing the 'Icon Text' value in the Schema that is being used. Doing that lets you override what is in the Schema. It's fun!

14Background/Screensaver

The background used in Flow Mode depends on the Icon Palette and Icon Graphic values used by the Schema.

Tip: To change what is displayed try changing the Icon Palette and Icon Graphic values in the Schema that is being used. Doing that lets you override what is in the Schema. It's fun!

15Wotja Watermark

This is where the Watermark displays if the Settings: General > Show Watermark toggle is on.

Wotja Album/Playlist Player

Add Button Save/Exit Button Sleep Timer Button Previous Mix Button Next Mix Button Play/Stop Button Playing Mix Name Store Button Actions Button Settings Button Sequential/Random Play Button Playlist Name/Sleep Time Remaining Mix Thumbnail Button Selected Mix Indicator Playing Mix Indicator Mix Number/Name Mix Duration/Range Mix Selector Mix Actions Button Mix Time Remaining

(tap circle for info, hover for tooltip; tap image for large)

Tutorials
Wotja Album/Playlist Player
  • The Wotja Album/Playlist Player is one of 3 generative music play-only modes in the Wotja App.
  • Documents > 9Albums Screen
  • Albums Screen: Albums Screen
  • Plays the following Wotja files:
    • Wotja Album (.wotja_al; see Filetypes):
      • Container files contain up to 20 Wotja mix files (.wotja), making them great for playing or sharing your favorite mix creations.
      • Note: Album files can include any mixes, even mixes that reference 3rd party templates, audio loops or Plug-ins. However, to play those mixes correctly the referenced content must be installed in the Wotja Folder and any relevant Plug-ins already installed.
      • Note: Built-in albums do not allow exporting of mixes or editing of Mix Overrides.
    • Wotja Playlist (.wotja_ls; see Filetypes):
      • Playlists contain references to Wotja mix files (.wotja) saved to your Wotja folder. If you change the file in Wotja, then the Playlist just references that changed file.
  • Also used to:
    • Create user created Albums from Playlists.
    • Add Wotja mix files (.wotja) to an Album.
    • Re-order the files in a Playlist.
    • Edit Mix Override settings for Albums and Playlists (these values are saved back to that file).

1Add Button

Tap this button for the following pop-up menu:

  • New Random Mix [Album files only] (Pro mode only)
    • Tap to add a new Random mix to your Album.
  • Browse Mixes (Pro mode only)
    • Browse the Wotja folder to add a Mix or Saved Mix to your Playlist or Album (as relevant).
  • Browse Schemas (Pro 24+ mode only)
    • Browse the Wotja folder to add any Schema you find there to your Playlist or Album (as relevant).
  • Cancel
    • Return to the Playlist or Album (as relevant).
2Exit/Save Button

Note: Saving changes to Albums/Playlists is a Pro mode feature.

Displays the Save Changes Menu pop-up before exiting to the Documents screen. For the menu items see the Music > 1Save/Exit button.

3/ Sleep Timer Button (Pro mode only)

Tutorial: Set a Sleep Timer

  • (Off) [Default]:
    • Sleep Timer is inactive.
  • (On):
    • Sleep Timer is active

Tip: When the Sleep Timer value is changed Wotja will auto-restart whatever is playing.

4Previous Mix Button

Takes you to the previous playlist item.

5Next Mix Button

Takes you to the next playlist item.

6 / Play/Stop Button

Tutorials: Play an Album | Play a Playlist

A Play/Stop toggle that will start or stop the mix.

7Playing Mix Name

Displays the name of the playing mix.

8Store Button

When tapped on, the Store button takes you to the In-App Store (or to a Store info page in the Plug-in).

9Actions Button
  • Share...
    • Displays the Share screen where you can easily share the item as a Wotja URI.
  • Full Screen [mobile] / Full Window [desktop]
    • Only shown when in Play screen (see 13Mix Thumbnail button).
    • Wotja displays full screen on your device and the mix (if playing) continues to play. At any time tap the screen to leave full screen display and return to Display mode.
  • Full Screen with Camera Background (iOS/Windows)
    • Tip: See the Video Feed Tutorial (48 seconds in).
    • Displays your device Camera feed in a Window on top of Wotja (which may restart play on going into this mode).
    • At any time tap the screen to return to Full Screen Display mode.
    • For a composite live generative music and video feed use iOS Control Center / a relevant 3rd party app to screen mirror to a TV.
      • Perfect for use as a big screen audio-visual experience e.g. installations, nature video feeds etc.
  • Full Screen & Restart/Stop (for videos) [mobile] / Full Window & Restart/Stop (for videos) [desktop]
    • Only shown when in Play screen (see 13Mix Thumbnail button).
    • Wotja displays full screen on your device and the mix (if playing) is stopped and then restarted after 2 seconds, making it easier to find a start point in a screen video recording. At any time tap the screen to leave full screen display and return to Display mode. Alternatively, use the Record Seconds or Bars setting to have the mix auto-stop when that value is reached and then have Wotja wait 2 seconds before returning to Display mode.
      • macOS Desktop version: The Wotja window title bar is hidden and a content area sized to e.g. 640x480 pixels is positioned top left of the screen below the App title bar. The available content area sizes are the same as those listed in the Titlebar > Window menu.
  • Export to Clipboard as Wotja Album
    • This is for when you want to share the Album as a Wotja URI ('WJURI'), .wotja_al; see Filetypes).
  • Save Wotja Album to File
    • Allows you to export your Wotja Album to a locally saved file (.wotja_al; see Filetypes). You might choose to do this to if you wish to share your Album.
    • Displayed in User Albums screen.
  • Refresh ALL mixes (Pro mode only)
    • This will refresh all items in the Album file with the latest versions that you have saved locally (this is for Album authors who have the local original files).
    • Displayed in Album files only.
  • Help - User Guide
10Settings Button

Takes you to the Settings: General or Settings: Audio MIDI+ screen, depending on what was last used.

11 / Sequential/Random Play Button

Tap to toggle between sequential play (shown) and random play.

12Playlist Name/Sleep/Play Time Remaining

If you are in 'Lite' mode or if you have an active Sleep Timer then this shows the time remaining before Wotja will stop playing. Otherwise this area just show the name of the Album or Playlist.

Tap the Sleep Timer button in the top toolbar to go to the Settings: General Screen where you can configure the Sleep Timer.

13Mix Thumbnail Button

Tap the mix thumbnail to go to "Play Screen" display mode below (see also the "Full Screen" option in the Action Button).

Play Screen
Play Screen

Play Screen
(tap image for large)

The Play Screen is a full screen mode of operation but it still has a toolbar. It is great when you want to sit back, look at any included image/message and reflect on the music, but also to have access to the top toolbar. When you first go into it a Fullscreen Top Panel background appears behind the Menu Bar to help you see the controls. To have it always on see: Settings: General & Show Play Screen Top Panel.

The Play Screen layout is similar to that of the Flow Player except that it has the Album/Playlist Player Menu Bar instead of the Flow Player Menu Bar. Although very similar, the Status Bar is also slightly different as the left hand area shows the Mix Name (instead of Flow) and the right hand area shows the Mix Remaining Play Time.

Tap in the center of the Play Screen to return to the Playlist Player screen.

14Selected Mix Indicator

A faint blue highlight indicates the currently selected mix, this may be different from the playing mix.

15Playing Mix Indicator

The center line displays "Playing" when the mix file is playing.

16Mix Number/Name

Show the number of the mix in the list and its name.

17Mix Duration/Range

Displays the minimum and maximum values for Mix Duration, i.e. the range of values for how long the mix can play for each time. These values are set in the mix file but can be overridden via the 19Mix Actions button (Album file only).

18Mix Selector

Tap the central area (not the thumbnail) to play or stop the mix without going into the Play Screen (see 13Mix Thumbnail button).

19Mix Actions Button

In the Mix Overrides screen below you can choose to override the related settings that are in the Mix File (i.e. Music Mode > Mix Properties > Mix Fades).

Note for Built-in Albums: This menu item shows only the "Share..." menu item and it allows you to share a link to a particular track in the Album. See Album Actions button > "Share..."

Menu options
  • Mix Overrides [Option not shown in Playlists] (Pro mode only) Mix Overrides

    Mix Overrides Screen
    (click image for large)

    • Ramp Up: Sets how long it takes for the file volume to ramp up once the file has started to play.
    • Duration: Sets how long the file will play for (Mix Duration).
      • Note: This Mix Override has a minimum value of 1 second, and the use case for that is when you want your album to have a custom thumbnail:
        • An album thumbnail is always based on the Display mode settings of the first mix file in the album.
        • If you don't want it to be what is in your "real" first mix then create a silent/empty mix file that displays as you want.
        • Add this mix file to the album, make it the first mix and use Mix Overrides to set its duration to 1 second.
        • When the Album plays it will play this silent mix file for 1 second (you will hardly notice!) and then play will immediately move to the next mix file (your "real" first mix).
    • Range: Sets a range on how long the file can play for (Mix Duration Range).
    • Ramp Down: Sets how long it takes for the file volume to ramp down before play moves to the next file.
  • Random Icon [Album file only] (Pro mode only)
    • Allows you to randomly generate a new icon according to the Schema > Visuals settings.
  • Export Mix to File (Pro mode only)
    • If the item is a mix file, this lets you export the mix file so that you can further edit it.
  • Export to Schema File (Pro 24+ mode only)
    • If the item is a schema file, this lets you export the schema file so that you can further edit it.
  • Refresh Item from File [Album file only] (Pro mode only)
    • If you have exported a mix, changed it and saved it, this allows you to refresh the file in the album. Only shown if you have exported that mix file and it is shown in the Documents screen.
  • Move Up (Pro mode only)
    • Allows you to move a file up.
  • Move Down (Pro mode only)
    • Allows you to move a file down.
  • Delete (Pro mode only)
    • Allows you to delete a file.
  • Cancel
    • Cancel out of the pop-up.
20Mix Time Remaining

This displays the Play Time remaining for the current file.

This value can only be adjusted in Mix Overrides (Box file only) - see 19Mix Actions button.

Note: The maximum duration for a mix is 4 hours.

Wotja URI Player

Back button Lite mode panel App name Store button Settings button Player name Play/Stop button Explore button Display area
Tutorial
Wotja URI Player

The Wotja URI Player is one of 3 generative music play-only modes in the Wotja App (24.1 and later). It is loaded when a Wotja URI (WJURI) is imported into Wotja from the clipboard. This can happen when:

Notes:

  • Always assume that the latest version of Wotja is required to correctly play a Wotja URI (all Wotja App updates are FREE!). If there are multiple versions of Wotja installed then this might actually launch one of those instead so either first delete or archive them.
  • If you are seeing the 2Lite mode panel, then Go Pro in Wotja 24 to remove the Auto-timeouts.
  • Wotja URI Mixes (and Mixes in Albums) can reference hosted AUv3/VST3 Plug-ins (e.g. see Fan Favorites) but to play as intended all Plug-ins MUST be already installed and available for use by Wotja on the "player" device!.
    • Note: The Wotja Plug-in cannot itself host Plug-ins.

1Back button

Takes you back to the screen you came from.

2Lite mode panel

This panel is displayed when Wotja plays a Wotja URI in Lite mode, which means it plays with Lite mode auto-timeouts.

This happens either because you are using Wotja in Lite mode, or because you have an older One Time Buy (OTB) IAP and the Wotja URI is using a New Feature from a later Feature Set.

To remove the auto-timeout, Go Pro for the 24 Feature Set.

3App Name

This shows the name of the App, which is Wotja!

4Store button

Takes you to the Wotja In-App Store where you can Go Pro in Wotja 24, should you wish to unlock any auto-timeout.

5Settings button

Takes you to the last used Settings screen, be that General Settings or Audio MIDI+ Settings.

6Player Name

This shows you this is the URI Player.

7Play/Stop button

Tap the Stop button to stop play in the URI Player; tap the Play button to restart play.

8Explore button

Tap the Explore button to close the Wotja URI Player and explore Wotja - perhaps to create something yourself!

9Display Area

This is where you see the Wotja URI as it plays. Depending on how it was created, you might see text, visualiser or screensaver and or background image.

See Mix Display Properties. For examples see Sharing Wotja Music.

Wotja TV Player (Apple, Android)

Settings Button Sleep Timer Status Sleep/Play Time Remaining Mix Time Remaining Repeat/Continuum Status Next Button Screen Text Background/Screensaver Wotja Watermark Version Mode Speech Synthesizer Use Text Display Selector Repeat/Continuum Selector Sleep Timer Selector Randomization Scheme Selector Settings Panel

(tap circle for info, hover for tooltip; tap image for large)

Wotja TV Player for Apple TV, Fire TV and Android TV
  • The Wotja TV Player is in included in the relevant Wotja App Bundle for Apple or Android.
  • It is generative music play-only app for your Apple TV, Fire TV or Android TV.
  • It is launched from the Wotja app icon on the TV and operates as a 'Flow Player' for built-in Schemas, meaning that it generates a succession of freshly created mixes, but it also lets you repeat the current mix if you so wish ('Pro' only Feature).
  • Once started, the player generates music until such time as you stop music generation via the TV control's Play/Stop button, the Sleep Timer kicks in (if active) or any auto-timeout is reached.
  • The music generated, screen background and any text displayed all depend on the various settings in the selected 16Schema (these are not editable in the TV Player).
  • Tip: Use the play/stop buttons on your TV remote control play/stop music being generated by the Wotja app.

1Settings Button

Displays the pop-up 17Settings Panel.

2Sleep Timer Status

The icon shows whether the Sleep Timer is on, where it has is a solid shape, or off [as shown], where it is an outline shape.

3Sleep/Play Time Remaining

If a Sleep Timer has been set this will reflect that time. If not, then when the TV Player is in Play or Pro mode it will show an infinity symbol.

4Mix Time Remaining

Shows how long the current mix has left to play before the next mix is generated or the mix is repeated (if the 14Repeat Selector is toggled to On).

5Repeat Status

The icon shows whether a new mix is to be generated at the end of the mix play time ("Continuum"; squiggle forward icon) or the current mix will repeat ("Repeat"; loopback icon).

See: 14Repeat Selector.

6Next Button

Select this button to force another mix to be generated.

7Screen Text

Whether any text is displayed here depends on the 16Schema being used.

8Background/Screensaver

The background used depends on the 16Schema being used.

9Wotja Watermark

This is where the Watermark displays.

10Version number

Displays the version number and copyright statement.

11Mode

Note: There is no In-App Store in the TV Player and any IAP must be made in the relevant Wotja App.

This button displays the current mode of operation.

Tap on this for a "Restore In-App Purchases" pop-up menu with OK/Cancel buttons.

  • Cancel:
    • If you select this the alert disappears and nothing happens.
  • OK:
    • If you select this then you’re prompted in the normal to enter your Store credentials and the app tries to restore any purchased IAP; if it can, then it updates the table to display the current mode of operation.
12Speech Synthesizer Toggle [Apple TV only]

Default (Use): Lets you turn on/off support for Text to Speech (TTS).

13Text Display Selector

Select this to choose whether any text is displayed on screen or not (which also depends on the selected 16Schema, as some simply do not show text). The text can be Cut-up or TTM text, depending on the Schema.

14 / Repeat Selector
  • (Off) [Default]:
    • A new Flow mix will be generated/play when the current Flow mix has reached its end.
  • (On):
    • The currently playing Flow mix is restarted when it reaches its end, rather than new one being generated.
    • This is a Pro feature.

Note: How long a mix will play for is a setting that is defined in the selected 16Schema.

15 / Sleep Timer Selector (Pro mode only)

Select this to display a list of available sleep times ranging from 'Off' to '8 hours'. Select the one you want to return to the Settings menu.

  • (Off) [Default]:
    • Sleep Timer is inactive.
  • (On):
    • Sleep Timer is active

Tip: When the Sleep Timer value is changed Wotja will auto-restart whatever is playing.

16Schema Selector

Select this to display a list of built-in Schema. Amongst other things, these determine how long each generated mix will be. Select the Schema you want to return to the Settings Panel.

Schemas are not editable in the TV Player.

17Settings Panel

The Settings Panel also displays the App Name, this being "Wotja".

Wotja Watch Player (Apple)

Play/Stop Button File Type File Info File Text App Name Next Button

(tap circle for info, hover for tooltip; tap image for large)

Apple Watch Player
  • The Watch Player is a Wotja companion app for Apple Watch. It controls playback of Wotja on an iPhone and requires that the relevant version of Wotja is installed on your iPhone.
  • To use it, first load Wotja on your iPhone. If you then press the 1Play/Stop button on the watch app it will by default start in "Flow Player" mode in the Wotja app for iPhone. You can use the 6Next button to force a new Flow mix to be created (using the currently selected Schema).
  • To use it, first load Wotja on your iPhone and in Documents either tap on a Schema to load it in the Flow Player, or open a Mix, Album or Playlist.
  • If you then press the 1Play/Stop button on the watch app it will start Wotja playing (if it is not already). For 'flows' you can use the 6Next button to force a new flow mix to be created; for albums and playlist this will cause the next file to be played.
  • The icon displayed in the 2File Type area will depend on whether Wotja for iPhone is in the Flow Player, or has a Mix, Album or Playlist file open.

1Play/Stop Button

Tap this to start or stop play of Wotja on your iPhone.

2File Type

Displays the icon for the relevant file type/mode, and the name of what is playing.

  • Flow:
    • Shows the Schema badge icon and "Flow".
  • Mix:
    • Shows a Wotja Mix icon and name of the mix.
  • Album:
    • Shows the Album badge, the number of mixes in the box/album and the name of the box/album.
  • Playlist:
    • Shows the Playlist badge, the number of mixes in the playlist and the name of the playlist.
3File Info

Depending on what is playing the text next to this icon displays as follows:

  • Flow
    • Name of the Schema in use.
  • Mix
    • Root and tempo of the playing mix.
  • Album
    • Number and name of the mix that is playing.
  • Playlist
    • Number and name of the mix that is playing.
4Screen Text

Where a mix or Schema is configured to display it, this area shows any included Cut-up or TTM text. This area can be scrolled with the crown.

5App Name

This is Wotja!

6Next Button

Tap this to move to the next mix in an Album or Playlist in Wotja on your iPhone or, using the currently selected Schema, to force a new mix to be created in the Flow Player.

Music Mode (Main UI)

Documents > 7EMix File button > 31Music Tab

Save/Exit Button Randomize Button Column Lock Button Grid Button File Tab: Mix File Tab: Template Generator Menu Button Generator Network View Selector Cell Mixer View Selector Mix Name Cell FX Button Track Mixer View Selector Cell Properties View Selector Track FX Button Mix FX Button Store Button Actions Button Selected Cell Cell Content Name Cell Generator Network Thumbnail Cell Content Type Cell Playing Indicator Cell Play Type Track Play Type OTT Cell Rules Computed Values Cell Play/Stop Button Track Play Type Button Track Mute Button Track Solo Button Music Mode Tab Generator Button MIDI Channel Assignment Text Mode Tab Mix Panel Display Mode Tab MIDI Channel Label Generator Synth Button Plug-ins Tab Generator FX Button Splitter Bar (Selected) Record Mode Tab Editor Panel 1 Editor Panel 2 Editor Panel 3 Splitter Bar Mix Properties View Selector Settings Button

(tap circle for info, hover for tooltip; tap image for large)

Tutorials
Music Mode (Main UI)
  • This is where you add/delete Templates to/from your mix Cells and edit all their Music (WME) parameters, Sounds & FX (WAE) parameters and Cell Rule related settings. You can also access the Cell Mixer and Track Mixer, edit Mix Rules & Mix FX - and so more.... but it can also be used just for mix playback.
  • The main mix editing tabs are as follows:
    • /Play/Stop button
      • Tap to stop or start your the generative mix (if any) in your wotja.
    • Music
      • The editing mode where you configure your mix, using to 16 Tracks each with 4 Cells, and can edit all parameters of the Intermorphic Music Engine (WME) and Intermorphic Synth Engine (WAE).
    • Text
      • The editing mode where you can create and edit Cut-up and text.
    • Display
      • The editing mode where you decide how you want your wotja to look, this being important should you wish to share it.
    • Plug-ins
      • The editing mode where you set up how you want the mix to use hosted 3rd party Plug-ins (Optional; iOS/macOS and Windows only).
    • Record
      • A special non-editing mode where you can make Audio or MIDI recordings of the open mix, as well as manage and preview them.

1Save/Exit Button

Displays the Save Changes Menu pop-up before exiting to the Documents screen:

  • Save & Close
    • Save the changes you have made to your file and return to the Documents screen.
  • Save & Continue
    • Save the changes you have made to your file and then continue working on it.
  • Save a Copy (Pro mode only)
    • Creates a new file (which you can rename) based on the current state of the open file (a snapshot of where you are if you like), but leaves you in the current open file - meaning if you then exit the file you will see this pop up dialog again letting you choose what to do with the file.
      • Note: This is NOT the same as Save As so please remember to save your file if you want to keep your changes to it.
  • Discard
    • Lose any changes made to your file since you opened it.
  • Cancel
    • Dismiss this popup and return to the Display screen.
2Randomize Button

Displays the Randomize Menu pop-up:

  • Randomize Mix
    • Replace your current mix with a new randomized mix created in accordance with the currently selected Schema.
  • Randomize Mix Patterns
    • For all Content Cells randomizes all melodic patterns (these being patterns of B or F type) being used by a Generator of type "Pattern".
  • Randomize Cell
    • Tap any cell (including looping cells) to replace its contents with another randomly selected template. This template is chosen from paks/templates in the Template List that are tagged as available for selection and also uses relevant settings in Randomization Settings (see Edit Randomization Settings).
  • Randomize Cell Melodic Patterns
    • Tap any cell to randomize all melodic patterns used in it by a Generator of type "Pattern", these being patterns of B or F type.
  • Randomize Column
    • Tap any cell in a column to randomly replace the contents of all currently populated cells in the column EXCEPT those that are set to be looping (i.e. locked). Tip: By setting a cell to loop (tap/hold = orange bar) you can ensure that the contents of that cell are not changed when randomizing.
  • Randomize Column (ALL)
    • Tap any cell in a column to randomly populate / replace the content of potentially ALL cells in the column (including looping cells). The number of cells randomized is determined by the "Tracks" setting in Schema. Tip: Use carefully.
  • Randomize Track
    • Tap any cell in a track to randomly replace the contents of all currently populated cells in the track EXCEPT those that are set to be looping (i.e. locked). Tip: By setting a cell to loop (tap/hold = orange bar) you can ensure that the contents of that cell are not changed when randomizing.
  • Randomize Track (ALL)
    • Tap any cell in a track to randomly populate / replace the content of ALL cells in the track (including looping cells). The number of cells randomized is determined by the "Cells" setting in Schema.Tip: Use carefully.
  • Select Schema (Schema Name)
    • Lets you select the Schema you wish to use.
    • Wotja Schema Select Screen

      Tap for large

  • Cancel
    • Cancel out of the pop-up menu.
3/ Column Lock/Unlock Button

Tap on this button to lock a column to force the play of all cells in that column; tap again to unlock it. Locking of a column only has effect on Cells in a Track with 28Track Play Type of type "Sequence".

Tip: If you are in "One column" view (see 4Grid Button > "Display: One Column"), then you can see the column number in the Generator Editor 3 Details Label.

4Grid Button

Tap the Grid button for the pop-up "Grid Display Mode and Cell Action" Menu. Cell Actions are the same as the Cell Actions Menu

Tip: you can also double tap a Cell for this pop-up menu.

  • Display: Focussed Cell
    • Select this to display in the left area just the selected (focussed) Cell. This is great for when you just want to focus on editing the contents of just one Cell, perhaps for the creation of a Tempalate or even to create a complete 'piece' in one Cell.
  • Display: Column 1 / 2 / 3 / 4
    • Select the relevant item to display just that column of Cells in left area (which may or may not include the selected Cell). This mode still gives access to the Cell and Track Mixers to set the levels/pans in each Cell and for each Track and is particularly useful if you want to mix together just one column of Cells without Cell sequencing (i.e. a 1 column mix).
  • Display: 4 Columns
    • Select this to display a grid of 4 columns of Cells in left area. It is an overview mode that lets you see how "Cell Sequencing" is working when the Track Rule is set to Sequence. Cell Sequencing can used used to apply a level of arrangement to your mix, allowing spaces for example via empty Cells. It is particularly useful when using loops and if you want to loop different cells that use the same track FX. This mode is also great for "live performance" mixing, too, where you tap/hold a cell to force it to "loop".
5File Tab: Mix

Tabs for Mix files are coloured grey.

Select one to show the full Music Mix Editor, as shown in the Schematic above.

6File Tab: Template (Template Editor)

Template files (.wotja_tp; see Filetypes) are in effect the contents of a single Cell. They are loaded (just like a Mix file) by tapping on the File Button in the Mixes screen, when they open in the Template Editor (below).

Template Editor

The Template Editor is an abridged version of the Mix Editor that displays only in single ('focussed') Cell mode and with various menu options suppressed/changed. It shows the bottom toolbar with a teal colour (similar to that used for the Template file badge).

Template Editor Wotja Template Editor

Tap for large

7Generator Menu Button

Note: See the Wotja Music Engine (WME) Guide for details on Generator parameters.

Tap on this button (and/or right click in the Desktop version) for the pop-up "Generator Menu" below:

  • Edit {Selected Generator}
    • Go to that Generator in the full-screen Generator Editor screen where you can edit the generative music parameters for the Generator.
  • Browse Templates...
    • Displays the Templates screen where you can choose a Template to add to the selected Cell.
    • Note: You can either replace the Cell contents with this or, where the existing Cell content is generative, merge [Pro mode only] a selected Template into the existing Cell content.
  • Add Generator of Type...
    • Add a Generator of one of the WME Generator types.
  • Copy
    • Copy the Generator.
  • Paste
    • Paste the Generator.
      • Note: First copy the required Generator, then tap an existing Generator and select Paste.
  • Mute
    • Mute the Generator.
  • Solo
    • Solo the Generator.
  • Delete
    • Delete the Generator.
  • Rename
    • Rename the Generator.
  • Help - User Guide
8Generator Network View

Displayed in the 35Mix Panel when the Generator Network View Toolbar button is selected.

For the selected 26Cell, and ONLY if it contains generative content, the Generator Network View is where you can marry WME Generator Objects (note Generators) to MIDI channels and WAE Synth sounds & FX.

For details on its UI elements refer to the Music Mode schematic, which shows this view selected.

Operation

9Cell Mixer View

Displayed in the 35Mix Panel when the Cell Mixer View Toolbar button is selected.

Cell Mixer

Music Mode: Cell Mixer
(tap image for large)

Tip: To mix tracks against each other use instead the 12Track Mixer.

Shown in the 35Mix Panel (which is to the right of the 26Cells), the Cell Mixer is where you can easily change the volume and pan levels within the Cell and solo/mute each Generator. Double tap a slider for a pop-up menu where you can manually enter a value.

  • Volume Slider (blue)
    • Tap to change the volume for the relevant Generator's MIDI channel.
    • If you have multiple Generators on one MIDI channel try changing the Generator's Velocity parameters instead.
  • Pan Slider (grey)
    • Tap to change the pan position for the related Generator's MIDI channel.
    • Note: You may have multiple Generators using the same MIDI channel.
  • Mute or Solo button
    • Tap to mute or solo the relevant Generator.
    • Note: These buttons do not at present change color.
10Mix Name

The name of the open mix file.

11Cell FX Button

Displays the Synth & FX editor where you can add/edit FX Networks for the WHOLE Cell.

12Track Mixer View

Displayed in the 35Mix Panel when the Track Mixer View Toolbar button is selected.

Track Mixer

Music Mode: Track Mixer
(tap image for large)

Tip: To mix the internals of a Cell use instead the 9Cell Mixer.

Shown in the 35Mix Panel (which is to the right of the 26Cells), the Track Mixer is where you can easily change the volume and pan levels of each of the tracks used in the mix. Double tap a slider for a pop-up menu where you can manually enter a value.

  • Volume Slider (blue)
    • Tap to change the volume for the related Track.
  • Pan Slider (grey)
    • Tap to change the pan position for the related Track.
13Cell Properties: > List

Displayed in the 35Mix Panel when the Cell Properties View Toolbar button is selected.

Cell Properties

Music Mode: Cell Properties (List)
(tap image for large)

See the Wotja Music Engine (WME) section for information on WME parameters.

For each Cell, this is where you set any special properties such as how a Cell will play, as well as the rules used for the content in that Cell.

Tip 1: For general rules that apply to the whole Mix (such as Mix Rules, Tempo, Root, Ramp Up/Down as well as Playlist Duration settings) see the Mix Rules panel.

Tip 2: If you are going to be making your mix or piece available for others to use, you may well wish to include your own copyright statement for each Cell in the mix. Each Generator within a Cell can also have its own copyright statement.

How long does a Cell play for?

IMPORTANT: Cell Duration is ONE bar when the Cell is empty or references Audio/MIDI files, but is the calculated composite value of Generative Bars/Range when using Generative Content.

See also Track Play Type for details on how to sequence, loop and trigger Cells.

When you create multi-cell mixes it is important to understand how long a Cell will 'play' for, and that depends on two properties:

  1. Cell Duration: Governed by the 'Content Length'
    • MIDI / Audio and Generative content are different in many ways.
      • MIDI/Audio:
        • The Content Length is a fundamental property of the media itself; it is the time of the MIDI file in seconds, or the duration of the audio file in seconds.
        • If the Content Length is greater than the Cell Duration (which is 1 bar) then the Cell in effect expands its Duration to fit that Content and then pads with silence to the end of the next bar.
        • Note: if an audio file is loaded from a Wotja Pak, then Wotja can automatically time-stetch the audio file so that it exactly fits the Cell Duration, even as you change the tempo of the mix (see section below).
      • Generative (WME):
        • Generative Bars / Range: The Content Length of Generative (WME) content in a Cell is not fixed and is instead determined by the Generative Bars / Range properties of the Cell. This opens up a range of possibilities, which become clearer to you the more you experiment with Wotja.
  2. Cell Repeats: The number of times that the Cell is configured to repeat
    • Cell Repeats / Range: These parameters can be used irrespective of the media type, be that MIDI/Audio or Generative (WME).
    • If a Cell's Cell Repeats / Range parameters have been set so that the composite Repeats value is > 1, Wotja will play a Cell's Content just once before moving on the to the next cell in the track (assuming Track Play Type has been set to Sequence).
    • If the composite Repeats value is >1 it will 'repeat' that Cell the requisite number of times.
    • The Repeats Range value is there to to provide variation in how often a Cell will Repeat.
Interaction between Cell Duration and Cell Repeats

The Wotja mixing engine treats both Cell Duration and Cell Repeats separately, and for good reason. They mean different things, and have different effects in a multi-cell mix.

  • Use case:
    • I want a 4-bar fixed drum riff, repeated twice.
    • Solution: Use MIDI content of 4 bars (assuming you have one), repeated twice (Cell Repeats)
  • Use case:
    • I want a 4-bar generative drum riff, repeated twice.
    • Solution: Use any generative drum template that suits, repeated twice (Cell Repeats); simply set generative duration 4 bars (Generative Bars).
  • Use case:
    • I want a drum riff that plays one or two bars, repeated twice.
    • Solution: MIDI or Audio can't achieve this. The only way is to use generative drum template, repeated twice (Cell Repeats); set generative duration to 1 bar with range of 1 (Generative Bars / Range.
Audio/MIDI files within a Cell - what effect does Content Length have on Cell Duration?

Audio/MIDI files have fixed times measured in seconds (milliseconds/seconds) etc.

Special Case: Audio files loaded from "Audio" Wotja Paks are auto-stretched (tempo matched) to fit the Cell Duration or multiple of that according to how the Pak is configured (pak.xml).

A Cell containing an Audio/MIDI 'file' will start playing it when the Cell starts. After the last Audio sample/MIDI event from the file has been played Wotja will 'pad-out with silence' to the end of the Cell Duration or the next bar if it overruns. At this point it will then repeat the Audio/MIDI file if Cell Repeats/Range is >1, or start playing the next Cell.

For example, if the Cell Meter is set to 4/4 and Mix Tempo set to 60 BPM then that Cell Duration (one bar) is 4 seconds:

  • If the Cell's Audio/MIDI file is 3 seconds long and no Cell Repeats:
    • Wotja will play 3 seconds of Audio/MIDI and 1 second of silence to reach the end of the Cell Duration and then starts playing the next Cell.
  • If the Cell's Audio/MIDI file is 7 seconds long and no Cell Repeats:
    • Wotja will play 7 seconds of MIDI and 1 second of silence to reach the end of the next bar after overrunning the Cell Duration and then start playing the next Cell.
      • Audio Paks: See Special Case commment above; there is no silent padding added.

Clearly, if you change the Mix Tempo, that will affect the Cell Duration in seconds, and so how much (if any) 'pad-out' silence is used.

Generative (WME) Content within a Cell - what effect does Cell Duration have?
  • When using Generative Content (WME) the Cell Duration is the calculated composite value of the Generative Bars / Range parameters of the Cell.
  • WME generators continue to compose according to their various properties throughout the Cell Duration meaning, for example, a Sequence Generator can play any number of times within that.
  • Any Envelope (e.g. Velocity Envelope) used in the Generative Content spans the Cell Duration and gets 'traversed' accordingly as that Cell plays. This means if Cell Duration is very long it will seem to take a long time to traverse the envelope.
  • When the Cell has finished playing (i.e. reached the end Cell Duration) all of the Generators within the Cell stop playing and all envelope positions are reset ready for next time.
  • WME scripts can be used in whatever manner you find interesting, e.g. Bar scripts, Stop scripts etc.

Cell Properties List

Script

  • Cell Script

Cell General

  • Cell Root
    • Semitone Offset (Default value - Mix Root): Choose the Root you want to apply to the Cell. Its value is a Semitone offset from the Mix Root.
  • Meter
    • Various (Default value - 4:4): Choose the meter you want to apply to the Cell. Each cell can have a different meter.
  • Cell Repeats
    • 0-99 (Default value - 1; 0 Special Case): The minimum base value for the number of times a cell will repeat after it has played through once and to which the range value (below) is added. For a generative template each bar counts as one repeat; for audio or MIDI content this is the length of the content rounded up to the end of a bar).
    • This value is the first of a pair of numbers shown in black in the bottom line of text at the bottom of the cell.
    • 0 (Special Case): If the value is set to 0 a Cell will be "skipped" and "Skip" is then shown in this area. The Repeat Range value slider value is also then ignored.
    • Note: If the cell contains generative content and the Generative Bar Min is value is set to ∞ then this setting takes no effect as the cell never repeats!
  • Cell Repeats Range
    • 0-99 (Default value - 0): Sets the range that applies to the above base value.

    • This value is the second of a pair of numbers shown in black in the bottom line of text at the bottom of the cell.

Cell Generative

  • Gen Bars
    • 0 - 1000 (Default value - ∞): The minimum number of bars for which a cell will play generative content. This value is the first of a pair of numbers shown in the top line of text at the bottom of the cell. The value in brackets next to the Gen Bars value shows what this represents in terms of h:m:s and takes into account the mix tempo.
    • Special Value: If this value is set far left to ∞ [0] then once play in a Track reaches such a cell the generative content in that cell will continue to play either for as long as the mix plays or until you manually select another cell in that Track to play.
  • Gen Bars Range
    • 0 - 1000 (Default value - 0): A value that is added to the Gen Bars value to define the maximum number of bar for which a cell will play generative content. This value is the second of a pair of numbers shown in blue in the top line of text at the bottom of the cell. If the first value (above) is ∞ then this value is not shown.
  • Scale Rule
    • Various (Default value - Mix: Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Cell Scale Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.

      For information on Scale Rules and included "Standard Rule Values" refer to Scale Rule Object.

  • Harmony Rule
    • Various (Default value - Mix: Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Cell Level Harmony Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.

      For information on Harmony Rules and included "Standard Rule Values" refer to Harmony Rule Object.

  • Rhythm Rule
    • Various (Default value - ? [Use Random Cell Rule]): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Cell Rhythm Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.

      For information on Rhythm Rules and included "Standard Rule Values" refer to Rhythm Rule Object.

  • Next Note Rule
    • Various (Default value - Mix: Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Cell Next Note Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.

      For information on Next Note Rules and included "Standard Rule Values" refer to Next Note Rule Object.

  • Harmonize with Me
    • On/Off (Default value - On): This determines if Wotja needs to take the notes played by this Cell into account when composing/playing other Cells.
  • Harmonize with Others
    • On/Off (Default value - On): This determines if Wotja needs to take the notes played by other Cells into account when composing/playing notes for this Cell.

Cell Info

  • Cell Display Name
    • The Cell Display Name is an editable field and lets you name a Cell as you want.
    • By default, it displays the name of the Template (or audio/MIDI file) used in the Cell.
  • Template Path
    • Displays the path to the Template which includes the Pak zip file that it is in.
  • Content Duration
    • Displays the play length of the content in the cell, important to know for audio loops.
  • Template Title
    • Displays the Title of the Template used in the Cell. Editing this does not change the name of the Template shown in the Cell. If you want to create your own custom Template you can edit this so that if you then export the Cell as a Template this field will then be used in that Template.
  • Template Author
    • Displays the Author of the Template, if it is defined. If you have created your own custom Template you can edit this so that if you then export the Cell as a Template this field will then be used in that Template.
  • Template Notes
    • Displays any Notes in the Notes field the Template, if defined. See above.
14Track FX Button

Displays the Synth & FX editor where you can add/edit Track FX.

15Mix FX Button

Displays the Synth & FX editor where you can add/edit Mix FX.

16Store Button

When tapped on, the Store button takes you to the In-App Store (or to a Store info page in the Plug-in).

17Actions Button

Displays the Actions Menu pop-up:

  • Share... (Mix Editor only)
    • Displays the Share screen where you can easily share the item as a Wotja URI.
  • Import Wotja from Clipboard
    • Imports a Wotja Mix File that is on the Clipboard.
  • Export Template to Mix on Clipboard (Template Editor only)
    • Exports the Template to Clipboard as a Mix.
  • Export Template to Mix File (Template Editor only)
    • Exports the Template as a Mix File.
  • Mix UI Layout: Desktop/Tablet; Mobile/Phone
  • Script Sandbox
  • Help - User Guide
18Selected Cell

The selected Cell has a red border. The Generator Network and Cell Mixer shown in the RHS panel (as relevant) are those for this Cell.

See 26Cell.

19Cell Content Name

This is always the name of the Template that was first added to the Cell. The name is not editable.

Tip: If you wish the Cell to show a different name then you could export that Cell as a Template, giving it the name you wish, and then re-load that new Template.

Missing Content (Red Cell): The name and thumbnail area will display red if audio or MIDI content referenced in the cell cannot be found. This can happen, for example, if your mix references a loop on your device which you later delete, or you perhaps load someone's piece which references a loop that is not present on your device (i.e. you have not installed the relevant Pak of content).

20Cell Generator Network Thumbnail

If the Cell uses a Generator Network (i.e. it is not a Cell containing an Audio sample or MIDI file) then this area shows a thumbnail of the Generator Network.

21Cell Content Type

This icon shows the type of content in the Cell:

22Cell Playing Indicator

When the mix is playing the top band shows the Cell playing status as follows:

  • Green
    • This Cell is playing.
  • Transparent
    • This Cell is not playing or has no content in it (equivalent).
23Cell Play Type

This icon shows how the cell will play and is determined for each Cell in the Track by the Track Play Type setting.

Values:
  • Sequence :
    • When the content in the Track's current Cell is playing it will show this icon at the top right of the cell.
  • Loop:
    • When the content in the Track's current Cell is playing it will show this icon at the top right of the cell.
  • One Shot:
    • When the content in the Track's current Cell is playing it will show this icon at the top right of the cell.
    • When the content in the Cell has reached its end this icon will no longer display.
24Track Play Type OTT (One Tap Trigger)

A yellow-coloured band will display at the bottom of every Cell in a Track when the 28Track Play Type "One Tap Trigger" (OTT) option is toggled on.

25Cell Rules Computed Values

The bottom of a Cell shows the Cell's bar "arrangement" values, i.e. how many bars it will play for.

The first pair of items are the Cell's Generative Bar values.

The second pair of items show the Cell's Cell Repeats values.

  • Mix Stopped
    • Both pairs of values are shown with syntax X+Y where X is the set minimum value and Y is the set range.
  • Mix Playing
    • Both pairs of values for the playing cell are shown with syntax X/Y where X is the calculated minimum and Y is the calculated range value.
  • Infinite
    • The one exception to the above is that if a cell is playing and the Generative Bars value is infinite, an infinite symbol is used in place of both pairs.
26Cell

Cells are at the heart of Wotja as what is in them ("content") determines what Wotja creates in terms of music/audio and also, in some cases, how its sounds (i.e. FX).

Tip: To access the Cell Actions Menu below, either right click on the desired Cell or left click on a Cell you have already selected.

  • Add Template to Cell:
    • When in the 8Generator Network View, tap an empty Cell or its empty 35Mix Panel (which will display "Tap here to browse Templates") to display the Templates List from which you can select and add content to the Cell, be that a generative Template, Audio file or MIDI file (see below).
  • Saved to the Cell:
    • All Template parameter settings (e.g. WME and WAE etc.) and user edits made to them are saved to the Cell. This is so that the mix will work as intended whether or not the underlying Template is accessible in the file system. For more info see this FAQ.
  • Cell display:
    • Can be either: 1 Cell, a Column of Cells or 4 columns of Cells; this is set via the 4Grid Button and selecting the relevant "Display" option from the pop-up menu.
  • Selected Cell
    • Tap a Cell to select it ("selected Cell").
    • The border of a selected Cell has a red color.
  • Cell Content
  • Cell Actions Menu
    • Browse Templates...
      • Displays the Templates screen where you can choose a Template to add to the selected Cell.
      • Note: You can either replace the Cell contents with this or, where the existing Cell content is generative, merge [Pro mode only] a selected Template into the existing Cell content.
    • Copy Cell
      • Copies the currently selected Cell to the clipboard so it can be pasted to another Cell (this is different from exporting a Cell to the clipboard for an import or merge).
    • Paste Cell
      • Pastes a Cell that has been copied to the clipboard.
      • Only shown if a Cell have been copied to the clipboard.
    • Move Cell from here
      • Tap to be able to move the selected Cell.
    • Move Cell to here
      • Moves the contents of a Cell that has been selected with "Move from here".
      • Only shown if "Move from here" has been selected for a Cell.
      • Use with caution as there is no pop-up warning.
    • Loop Cell
      • Tap to force a Cell to Loop (i.e. lock/unlock).
      • See the "Loop" setting in Cell Rules.
    • Import Cell from Clipboard
      • Tap to import into the currently selected Cell a Cell that has been exported to clipboard. NB: Wotja files cannot be imported to a cell.
    • Merge Cell from Clipboard (Pro mode only)
      • Tap to merge into the currently selected Cell a Cell that has been exported to Clipboard. NB: Wotja files cannot be merged to a cell.
    • Replace Cell from Clipboard
      • Tap to replace the contents of a Cell with a Cell that has been exported to Clipboard. NB: Wotja files cannot be imported into a cell.
    • Export Cell to Clipboard (Pro mode only)
      • Tap to export the contents of a generative cell (i.e. a [.wotja_tp] file/template) to the clipboard.
      • This allows you to merge it into another populated Cell, if desired.
    • Export Cell to Template (Pro mode only)
      • Tap to export the contents of a generative Cell (i.e. a [.wotja_tp] file/template) to a Template. This file will then show up in Templates List > 9Documents Pak.
    • Clear Cell
      • Tap a Cell to clear out the Cell content.
    • Reset Cell to Defaults
      • Tap a Cell to delete the Cell content AND reset its Cell Properties to defaults.
    • Reset Row to Defaults
      • Tap any Cell in a Row to both delete the content in all Cells in the Track AND reset the Cell Properties of any Cell in the Track (including Track FX) to defaults.
    • Reset Column to Defaults
      • Tap any Cell in a Column to both delete the content in all Cells in the Column AND reset the Cell Properties of all Cells in the Column to defaults.
    • Keep Cell and Clear ALL Others
      • Tap the Cell you want to keep and delete the contents of all other Cells.
    • Keep Cell and Reset ALL Others
      • Tap the Cell you want to keep and both delete the content in all other Cells AND reset the Cell Properties of all Cells to defaults.
    • Clear ALL cells
      • Delete the content in ALL Cells.
    • Reset ALL cells
      • Delete the content in all Cells AND reset their Cell Properties to defaults.
27Play/Stop Button

This button is used to play/stop a mix and it is common to all Mix Edit Modes (i.e. Music, Text, Display, Plug-ins and Record).

Below the button is display the "Play Time Indicator". It shows time in two different ways:

  • Count Down
    • It will count down from some time if you have a Sleep Timer set (e.g 30 mins if you have a 30 minute Sleep Timer), or from 2 minutes if you are in Lite mode.
  • Count Up
    • It will otherwise count up from 0 so you can see how long the mix has been playing.
28Track Play Type Button

For each Track, how any Cell in that Track will play is determined by the settings in this pop-up menu. See also Cell Play Type.

Note: There are two different ways to trigger a Cell to play or to start/stop it looping.

  1. Method 1 (easiest):
    • Turn on the One Tap Trigger option below (when on, the bottom of each Cell in the Track is shown with a yellow bar), and then tap the Cell you want to play.
  2. Method 2:
    • If Loop or One Shot is selected, on mobile device long tap (tap/hold) the Cell or desktop right click the Cell and in the pop-up Cell Action menu select Loop Cell/Trigger Play or Unloop Cell/Trigger Stop.
Values:
  • Sequence (Default value):
    • When this selected and a mix is started, the first Cell in the Track will play.
    • Once that Cell has finished playing then the next Cell in the Track will start playing.
    • This "Cell Sequencing" behaviour will continue until the mix is stopped or another Cell in the Track has been forced to loop.
    • The Cell Playing indicator will be shown at the top of the playing Cell.
  • Loop:
    • When this is selected and a mix is started, no Cell in the Track will play UNTIL a Cell in the Track has been triggered (see above).
    • Once a Cell has been triggered, it will start or stop playing at the next (or nearest) bar boundary and the Cell Playing indicator will be shown at the top of the playing Cell.
    • The Cell will contine to loop until triggered again, or until another Cell in the Track is triggered.
    • Tip: When using the 2Randomize Button only the "Randomize Cell" item will randomize the Cell.
    • Advanced Tip: When a Column lock is first applied to a Column where some Cells contain Audio/MIDI content, those Cells will play ONCE (if the Cell is not already looping).
  • One Shot:
    • When this selected and a mix is started, no Cell in the Track will play UNTIL a Cell has been triggered (see above).
    • Once a Cell has been triggered it will start playing immediately and the Cell Playing indicator will be shown at the top of the Cell.
    • The Cell will continue to play until either A) the Cell content reaches its end (at which point th Cell stops playing); or B) it is triggered again before it reaches that point; or C) until another Cell in the Track is triggered.
  • One Tap Trigger: Off (default) / On:
    • When this is turned on for a Track, every Cell in that Track will show the 24Track Play Type "One Tap Trigger" indicator.
    • Simply tap any Cell in that Track to start/stop it playing (depending on Track Play Type set for that Track).
    • Note: Loop Cells will start playing at the beginning of a bar boundary; Sequence and Once Shot Cell start playing as soon as the music engine can start playing them.
29Track Mute Button

Tap to mute or unmute the related Track.

  • Cyan
    • Muted.
  • Light grey
    • Not muted.
  • Dark Cyan
    • When a track is soloed the M in non-soloed or non-muted buttons shows dark cyan to indicate they are temporarily muted.
30Track Solo Button

Tap to solo or unsolo the related Track.

  • Tangerine
    • Soloed.
  • Light grey
    • Not soloed.
31Music Mode Tab

The Tab in a Mix file that selects Music Mode.

Note 1: When a mix is playing, the label at the bottom of the button changes from "Music" to show "CPU: XX%" where XX provides an indication of how hard the mix is working the CPU of your device. If you are experiencing occasional artefacts then knowing this can be really helpful. For example, the CPU value might spike when a particular Cell plays. You can the investigate that particular Cell to see what is using the CPU.

Note 2: Things that have the biggest CPU impact are the WAE Reverb R2XL and Pitch Shifter units.

32Generator Button

See the Wotja Music Engine (WME) section for information on WME parameters.

Tap on a Generator button to select that Generator. The selected Generator has a red border.

Tip: Double tap the button (and/or right click on desktop) to display a pop-up menu (for menu details see the 7Generator Menu button).

33MIDI Channel Assignment

To assign a MIDI channel to a Generator, tap/hold the Generator button and drag it to a MIDI channel box.

34Text Mode Tab

The Tab in a Mix file that selects Text Mode.

35Mix Panel

The Mix Panel is show to the right of the 26Cells Grid. What displays in it depends on which of the following 5 toolbar buttons is selected:

36Display Mode Tab

The Tab in a Mix file that selects Display Mode.

37MIDI Channel Box

The MIDI channel box is an indicator (it shows the MIDI channel number); it is not a button. However, you can tap/hold a Generator button and drag it to a MIDI channel box.

Note: The Generator "WME Patch" parameter defines which MIDI Patch command to send for each MIDI channel. If you are using Wotja to drive any 3rd party MIDI synth/gear it is therefore recommended that all Generators on the same MIDI channel should use the same Patch parameter.

Note: MIDI Channel 10 is reserved for the Drum instrument. Every Generator with a Drum Patch, should generally be attached to MIDI Channel 10.

38Generator Synth Button

If the "WAE for Sounds & FX" toggle is checked in Settings: General > Audio MIDI+, then MIDI events are routed for each channel through a WAE Synth configuration. Tap on the Synth button for the Synth & FX editor.

Note: If there is no Synth network defined then the WAE will use its built-in MIDI Wavetable synth (using the Patch defined by the Generator's Patch parameter).

39Plug-ins Tab

The Tab in a Mix file that selects Plug-ins Mode.

40Generator FX Button

The output from every Synth box can be passed through a custom FX Network. If you want to use an FX on a Generator, click the FX button to invoke the Synth & FX editor.

41Splitter Bar (Selected)

A selected Splitter Bar shows in an orange colour. Once selected it can then be moved as you wish.

Tip: If you wish, you can move it to temporarily hide a panel. If you do that, just remember that you have done it!

42Record Tab

The Tab in a Mix file that selects Record Mode.

43Editor Panel 1

Depending on the 32Generator, 38Generator Synth, 40Generator FX, 11Cell FX, 14Track FX or 15Mix FX button that you select in the 8Generator Network View, Editor Panel 1 will show the relevant Editor as below.

Note: Editor Panel 1 is displayed below the 35Mix Panel in device portrait view and to the right of it in device landscape view.

Settings > General > Mix UI Layout: Mobile/Phone

Settings > General > Mix UI Layout: Desktop/Tablet

44Editor Panel 2

Editor Panel 2 will always show the Generator Editor for the 32Generator button that you select in the 35Mix Panel.

See Editor Panel 1 for the Synth & FX Editor.

45Editor Panel 3

Note: Editor Panel 3 is only visible with Settings > General > Mix UI Layout: Desktop/Tablet.

If the above is the case, then it will then show the Script Editor for the Script Parameter you have selected below:

46Splitter Bar

Tap on a Splitter bar for it to become a selected Splitter bar, and then drag it to resize the relevant panel (e.g. Mix Panel, Editor Panel 1, Editor Panel 2, Editor Panel 3 and/or sub-panels) according to your preference. UI elements are auto-resized as far as possible to accomodate the available panel size.

Being able to do this makes it easy to edit all Wotja parameters even on small form factor devices.

Tip: If you wish, you can move it to temporarily hide a panel. If you do that, just remember that you have done it!

46Mix Properties View: > List

Displayed in the 35Mix Panel when the Mix Properties View Toolbar button is selected.

Mix Properties

Music Mode: Mix Properties (List)
(tap image for large)

See the Wotja Music Engine (WME) section for information on WME parameters.

The "Mix Properties" panel is where you can easily set the parameters that define how a Mix will play (Mix Volume, Root, Tempo, Mix Rules and Mix Fades.

The Mix Tempo, Mix Root and Mix Ramp Up/Down settings apply to both a mix and/or that mix in an Album/Playlist.

The Duration/Duration Range are specific to that mix only in an Album/Playlist.

Tip: If you are going to be making your mix or Template available for others to use, you may well wish also to include your own copyright statement for each Generator in the mix as it can also have its own copyright statement.

Mix Properties List

Script

Mix General

  • Mix Volume
    • Sets the overall volume of the mix.
  • Mix Root
    • Select the root pitch you want to use for your mix (this value is shown on the Mix Properties button).
    • Note: When creating an automatic mix or a mix from a template a random root is chosen.
  • Mix Tempo
    • BPM (Default value - Template Root): Select the tempo you want to use for your mix (value shown on the Mix Rules button).
  • Mix Scale Rule
    • Various (Default value - Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Mix Scale Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen. For information on Scale Rules refer to WME Rule Object.
  • Mix Harmony Rule
    • Various (Default value - Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Mix Harmony Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen. For information on Harmony Rules refer to WME Rule Object.
  • Mix Rhythm Rule
    • Various (Default value - Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Mix Rhythm Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen. For information on Rhythm Rules refer to WME Rule Object.
  • Mix Next Note Rule
    • Various (Default value - Default): When the cell is playing any active rule element will flash; the color. is that of the Generator type of the playing Generator. To edit or change the Mix Next Note Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen. For information on Next Note Rules refer to WME Rule Object.

Mix Fades & Playlists

  • Ramp Up: Seconds
    • 1-20 (Default value - 2): This applies when the mix starts to play.
  • Duration: Seconds
    • 10-7200 (Default value - 300): This is how long the mix will play for in an Album/Playlist.
    • Double tap for a pop-up menu where you can edit the value via on-screen keyboard.
  • Duration Range: Seconds
    • 10-7200 (Default value - 0): A range value added to the Duration value above. Double tap for a pop-up menu where you can edit the value via on-screen keyboard.
  • Ramp Down: Seconds
    • 0-20 (Default value - 2): This applies when the mix stops playing in an Album/Playlist or Recording.
47Settings Button

Takes you to the Wotja Settings: General screen.

: Synth & FX Network Editor: WAE

31Music Tab > 43Editor Panel 1

Presets Button Randomize Button Connector Line Polyphony Button Selected SFX Unit SFX Network Label SFX Editor Help Button Selected Generator SFX Splitter Swap Button Undo Button Splitter Bar SFX Network Panel Generator Network Panel Audio-Rate Unit Audio Signal Path Add Controller Button Controllers Panel Delete Controller Button Controller Unit Selector Controller Parameter Selector Controller Scale Value SFX Unit Parameter Value SFX Unit Bypass SFX Unit Help SFX Unit Panel SFX Unit Undo Control-Rate Unit Actions Button

(tap circle for info, hover for tooltip; tap image for large)

A WAE Synth & FX Network ('SFX Network'), shown above, is used to generate sound when it is sent MIDI from a Wotja Music Engine (WME) 'Generator'. Refer to Wotja Audio Engine (WAE) section for detailed information on all units and their parameters.

Tutorials
Synth & FX Editor
  • The Synth & FX Editor is used to design / view and edit both Synth Networks or FX Networks ('SFX Network') and is quite easy to use one you understand how it works and how everything fits together.
  • The 12Synth/FX network panel shows a visual representation of the network design, but is also active as you can tap it to add a new unit.
  • 14Audio-rate units are shown in the top row of the network and 27Control-rate units are shown in the bottom row. Units are always numbered from left to right and from 1 upwards; they are automatically renumbered if you ever delete a unit.
  • Tips:
    • If there are no units shown then it means there is no Network defined.
    • The 5Selected Unit is highlighted with a red surround.
    • When you tap a button in the Music Mode > 8Generator Network View it will be highlighted as the 8Selected Generator SFX button; this can also be seen in the 6SFX Network Label.
    • Use the top 1Presets button for a range of included Synth (.tg) or FX (.fxm) presets (you can even load ones you have saved). What is shown depends on whether you are in Synth or FX network.
    • Synth Units are also called Sound Units or Tone Generators (TG); the terms are used interchangeably.
    • Use the top 2Randomize button to quickly change your Sound or FX Network. Every time you tap the button a Preset is chosen at random ("lucky dip") from ALL available presets (i.e. the built-in ones or ones you have saved). This allows quick experimentation with sounds and FX and is a lot of fun, too!
    • To build a stereo synth network, use a Synth Unit's pan parameter (or even a following Amp unit) to spatially position its sound. You can have as many Synth and FX Units, Controllers and Junctions in your network as you want (device capability permitting).

1Presets Button
WAE Synth Presets List

WAE - Synth Presets List
(tap image for large)

The WAE Presets List is launched from the "Presets" button at the top of the Network Editor. Using presets is a very easy way to quickly change the sounds and fx used in a mix. See also Use of Synth & FX in Schemas.

Whether you see the Synth Presets (.tg) list or the FX Presets (.fxm) list depends on whether you have accessed the WAE Network Editor via a:

To preview a preset first make sure you have your mix playing and then just tap on it. If you want to use it tap the top left < OK button to exit the list; if you want to discard it then press the top right Cancel button to exit the list.

Any custom presets you have saved can be found in the Saved Files grouping at the top on the left.

You can easily zip up your custom presets into a zip with the following paths being used for sounds and fx for your own folders:

/sounds/tg-preset-group-name/xxx.tg
/fx/fx-preset-group-name/xxx.fxm

Tip: The zip file just needs to be placed in the Wotja Folder.

Tip 2: The zip file can be called anything except wj_tgfxm.zip.

Use of Synth & FX Presets in a Schema

  • Synth Presets:

    • If ANY Synth Presets have been toggled on in the Schema WAE Network Presets > Synth Presets list, then one of those that are toggled on will be chosen at random to replace the WAE Sound Network for every TTM Template (i.e. TTM1 Players or TTM1 Players 2) created in a new auto-mix or Flow, or when a Cell is randomized and a TTM Template is selected.
    • Note: If no Synth Presets are selected in the Schema then no such random selection occurs.
  • FX Presets:

    • If ANY FX Presets have been toggled on in the Schema WAE Network Presets > FX Presets list, then one of those that are toggled on will be chosen at random to be used for the 15Mix FX setting for a new auto-mix or Flow.
    • Note: If no FX Presets are selected in the Schema then no such random selection occurs.
2Randomize Button

Tapping this button chooses a Synth or FX preset at random ("lucky dip") from ALL available presets (i.e. the built-in ones or ones you have saved). This allows quick experimentation with sounds and FX and is a lot of fun, too!

3Connector Line

The connector line shows which Synth or FX units are connected to and being modulated by Control-rate units.

The controller unit selected in the 17Controllers Panel has a red connector line.

4Polyphony Button

Displayed in Synth networks only. Tap this button to display a pop up list where you select the polyphony level used by the Generator(s) playing through this network. The default value is 4; set this too high, and your computer/device might slow down; set it too low, and you likely won't hear as many notes playing in chords or when notes have long decays (due to note stealing).

5Selected SFX Unit

The currently selected SFX Unit has a solid red outline.

6SFX Network Label

For the SFX Network used in the selected Generator Synth or FX Button, this text shows the MIDI Channel number (for Generator Sounds or FX), Cell, Track or Mix depending on the context, appended by either Synth or FX depending on whether it is a Synth or FX Network.

7SFX Editor Help Button
  • This displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version of the User Guide depends on the value of Settings > General > "Help: Use In-App User Guide".
8Selected Generator SFX

The currently selected Generator Synth or FX Button in the Generator Network Panel has a solid red outline.

9Splitter Swap Button

Toggles the arrangement the Splitter bars in the Synth & FX Editor between the following 2 options:

  1. Full width display of the Synth/FX Panel for easier editing the actually network design.
  2. Full height display of the selected SFX Unit Panel for easier editing the parameters in a SFX Unit.
10Undo Button

Tap to discard ALL changes you have made since entering the Synth & FX Editor.

11Splitter Bar

See Music Mode Splitter Bar.

12Synth/FX Network Panel
Synth & FX Editor Meter - Audio

Meter: Audio
(tap image for large)

Synth & FX Editor Meter - Oscilloscope

Meter: Oscilloscope
(tap image for large)

This panel is where you design/edit your SFX Network.

An Audio meter or Oscilloscope can be displayed for the selected unit, as shown below, if the "Synth & FX Editor: Show Meter/Scope" setting is toggled on.

Selecting/ Editing Units
Adding Units

See also Audio-rate Units and Control-rate Units.

  1. Tap on an empty/blank part in the panel where you want to add a Unit.
  2. This will display the "Select Unit to Add" pop up menu where you will see a list of all the WAE Units that are available.
    • If you are designing a Synth Network, then at least one of your units should be a Tone Generator Unit. In the pop-up menu these all have a "TG:" prefix.
    • Note: FX Networks cannot contain Synth Units, but Synth Networks can also include FX Networks.
  3. Tap on the Unit you want to add.
Deleting Units
  1. Tap the 28Actions Button and select either Delete Unit (which deletes the currently selected unit) or Clear Network (if you want to clear the entire network!).
  2. Double tap a Unit button for a pop-up menu where you can also do as above.
13Generator Network Panel

See Music Mode Generator Network View.

14Audio-Rate Unit

For the available Audio-Rate Units (Synth TG) see the WAE Audio Engine.

See also 12Synth/FX network panel.

Audio-rate units (see Glossary) are units that operate at the audio output frequency (e.g. 44kHz) - that means Synth units (i.e. "Tone Generators") and FX units.

Double tap a unit for the following "Unit Action" pop-up menu (all pretty self explanatory):

  • Edit Full Screen:
  • Add Unit Before:
    • Add a unit before the selected unit (displays the Add Unit pop-up menu).
  • Add Unit After:
    • Add a unit after the selected unit (displays the Add Unit pop-up menu).
  • Copy:
    • Copy the selected unit.
  • Paste Before:
    • Paste a copied unit before the selected unit.
  • Paste After:
    • Paste a copied unit after the selected unit.
  • Delete Unit:
    • Delete the selected unit.
  • Clear Network:
    • Clear the entire network.
15Audio Signal Path

All units on this line will be audio-rate units.

16Add Controller Button

This button allows you to add a new Controller to preexisting Audio-rate or Control-rate unit. This is how you do it:

  1. Select the Unit you want to be modulated (e.g. Osc Unit);
  2. Tap on an empty/blank part in the 12Synth/FX Network Panel to display the Unit Add menu and then select a Control-rate unit (e.g. Ctrl-Envelope Unit);
  3. Tap the unit you want to be modulated (i.e. that added in 1 above) and tap the Add Controller button to add a 3Connector Line;
  4. For that Connector, you then select the 19Controller Unit Selector to choose the Controller unit that will do the modulation (e.g. Envelope Unit);
  5. Non-Junctions Only: Tap the 20Controller Parameter Selector for a drop list of parameters (if any) that can be modulated in the Unit selected in step 1 and tap to select one (e.g. Amplitude);
  6. Finally, use the 21Controller Scale Value slider to change the Scale Value applied to the modulation (+/-2) before it is passed to the parameter of the Unit selected in step 1. Setting this to 0 means no modulation is applied. For Junctions the Scale Value is a way to balance how much of the output of each Unit is blended together. Note: If more than one control-rate unit feeds a specific parameter on a target unit, they will get added together automatically (including the appropriate scaling factor).
17Controllers Panel

IMPORTANT: The Synth & FX Editor does not support dragging to add Controllers; these have to be added via the Controller panel "+" button. This button is greyed until you select an Audio Rate Unit (e.g. Tone Generator or FX unit) that has a Controller Unit somewhere to the left of it otherwise no Controller can be added! Also, Controllers can not be added to some units, e.g. Compressor, as they have have no modulateable parameters.

All Units (i.e. both audio-rate and control-rate), except Junction Units (below), have some parameters that can be controlled (modulated) by control-rate Units (LFO, Envelope, Amp). Each Unit you want to control can have as many Connectors (lines) as you like, and these are separately numbered for each Unit. This allows all kinds of fun and clever sound design stuff to be done in the WAE. The Connectors and Controllers are displayed / selected at the bottom of the screen and/or on the bottom left.

You can tell if a Unit (audio-rate or control-rate) has been set up to be modulated by a Controller as you will see a blue or red line attached that is connected to control-rate unit to the left of it.

Junctions (audio-rate or control-rate):

These units are colored grey, have no interfaces, and are used only to sum together the outputs of a number of Units of the same audio-rate or control-rate type, meaning the units they sum are always on the same line.

Controller Editing:

See: 16Add Controller Button
18Delete Controller Button

Deletes the selected controller unit in the 17Controllers Panel.

19Controller Unit Selector

Displays a pop-up that allows you to choose the Controller unit (from those added/present in the network) that will do the modulation (e.g. Envelope Unit).

20Controller Parameter Selector

Displays a drop list of parameters (if any) that can be modulated in the Unit that the controller is connected to.

21Controller Scale Value

This sets the Scale Value applied to the modulation (+/-2) before it is passed to the parameter in the Unit that the controller is connected to. Setting this to 0 means no modulation is applied.

For Junctions the Scale Value is a way to balance how much of the output of each Unit is blended together. Note: If more than one control-rate unit feeds a specific parameter on a target unit, they will get added together automatically (including the appropriate scaling factor).

22SFX Unit Parameter Value

Each WAE Unit has a number of adjustable/editable parameters and settings that can be changed, as relevant, by slider, +/- increments or selection list.

23SFX Unit Bypass

When this checkbox is enabled you can bypass this unit altogether.

That means it is temporarily removed from the Audio Signal Path or Controller Path.

24SFX Unit Help

Takes you to the relevant section of this User Guide for that unit.

25SFX Unit Panel

This is an in-screen editing panel for the selected WAE Synth or FX Unit (as relevant). You can also edit the unit full screen by tapping 28Actions Button and selecting "Edit Unit Full Screen"; for an example see Edit Wavetable Full Screen..

26SFX Unit Undo

Tap to discard ALL changes you have made since editing the Unit.

27Control-Rate Unit

For the available Control-Rate (Ctrl-rate) Units (Controllers) see the WAE Audio Engine.

Control-rate units (see Glossary) are units that operate at a much lower frequency that audio-rate units and are used for modulation of parameters, e.g. the LFO and Envelope units.

Double tap a unit for the following "Unit Action" pop-up menu (all pretty self explanatory):

  • Edit Full Screen:
    • This allows you to edit a unit full screen (for an example see LFO Full Screen).
  • Add Unit Before:
    • Add a unit before the selected unit (displays the Add Unit pop-up menu).
  • Add Unit After:
    • Add a unit after the selected unit (displays the Add Unit pop-up menu).
  • Copy:
    • Copy the selected unit.
  • Paste Before:
    • Paste a copied unit before the selected unit.
  • Paste After:
    • Paste a copied unit after the selected unit.
  • Delete Unit:
    • Delete the selected unit.
  • Clear Network:
    • Clear the entire network.
28Actions Button

Displays the following pop-up Actions menu:

  • Save
    • As relevant, saves a Synth Network to a file with extension .wotja_sy or a FX Network to a file with extension .wotja_fx (see Filetypes). Files are saved to the Wotja folder.
  • Export to Clipboard
    • Select to export to clipboard your Synth Network or FX Network, depending on what kind you are editing.
  • Import from Clipboard
    • Select to import from clipboard a Synth Network or FX Network.
  • Edit Unit Full Screen
    • Select to edit the selected Unit in a full screen editor.
  • Delete Unit
    • Select to delete the selected Unit.
  • Clear Network
    • Select to clear the entire Synth or FX Network.
  • Help - User Guide

: Generator Editor: WME

31Music Tab > 43Editor Panel 2

OK/Back Button Sequence Item Preset Generator MIDI Ch, Track & Column Details Screen Title Undo Button Redo Button Help Button Generator Type Group Shortcut Parameter Groups Header Parameter Group Selector Array Item Editor Shortcut Generator Type Specific Group Selected Parameter Group Generator Type Indicator Array Editor Button Array Item Button Parameter Edit Control Parameter Group Header Generator Number Selector

(tap circle for info, hover for tooltip; tap image for large)

Tutorials
Generator Editor

1OK/Back Button

Tap to accept your changes and exit the Generator Editor

2Sequence Item Preset Button

Tap for a pop-up list of included Sequence Array Presets below. Selecting an item from this list will replace the currently selected Sequence Array Item.

Sequence Array Presets:

  • Text to Music (TTM) Custom
  • Text to Music (TTM) Cut-up
  • Euclidian (Euc)
  • Both (B): Random 1/4 notes; 1 bar
  • Both (B): Random 1/8 notes; 1 bar
  • Both (B): Random 1/16 notes; 1 bar
  • Both (B): Random Triplet notes; 1 bar
  • Both (B): Random syncopated; 1 bar
  • Both (B): Ascending pitch; 1 bar
  • Both (B): Descending pitch; 1 bar
  • Both (B): Whole Note Rest; 1 bar
  • Both (B): White Note; 1 bar
  • Fixed (F): 1/4 notes; 1 bar
  • Fixed (F): Notes and Rests; 1 bar
  • Rhythm (R): 1 bar
3Generator MIDI Ch, Track & Column Details

For the currently selected Generator, shows:

  • Generator Type |
  • MIDI Channel: value
  • Track Number: value
  • Cell Column: value

See also: Wotja Music Engine (WME) Parameters.

4Screen Title

Shows the name of the current screen.

5Help Button
  • This displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version of the User Guide depends on the value of Settings > General > "Help: Use In-App User Guide".
6Undo Button

Undo the last parameter change you have made.

7Redo Button

Redo the last parameter change you have made (i.e. perhaps after an Undo).

8Generator Type Group Shortcut

This selects the Parameter Group for the current Generator Type in the Parameter Groups List below the 9Parameter Groups Header.

9Parameter Groups Header

To make it easier to understand what each WME Parameter is for, related Parameters are grouped together into "Groups".

Tap on the Parameter Group in the Parameter Groups List to have the Parameter List scroll to show it at the top.

See also: Wotja Music Engine (WME) Parameters.

10Parameter Group Selector

Tap a Parameter Group selector to select your desired Parameter Group. This then auto-scrolls the right hand list to the Parameters for that Group.

The first Parameter Group item is the "Generator Group". The 14Generator Type Indicator to the right of it always has a color. related to the Generator Type of the selected Generator and it is where you can change key Generator settings such as Generator Type, Generator Name, Pitch, Pitch Range etc.

See also: Wotja Music Engine (WME) Parameters.

11Array Item Editor Shortcut

This button only displays when the Generator is of Type Sequence. It then shows the Sequence Generator sub-type in use for the currently active Array Item, and its number in the Array Editor list.

Tap on the button to go directly into the relevant Array Item editor.

Example: In the Schematic this button is displayed and shows "#1 Euc", which means that the first item the Sequence Array is selected for use and it is of type "Euclidian".

12Generator Type Specific Group

This group lists the main parameters for the selected Generator Type.

Example: If the Generator Type was Ambient, then tapping on the Group would auto-scroll the right hand parameter list to show the Ambient Generator parameters at the top.

See also: Wotja Music Engine (WME) Parameters.

13Selected Parameter Group

The selected Parameter Group shows with a light blue or dark teal background color, depending on UI Color Scheme (light or dark).

14Generator Type Indicator

This is a bar that has the color of the selected Generator's Generator Type.

15Array Editor Button

Shown only when the Generator is of Type Sequence and it shows the number of items in the Sequence Array (this is likely to be one, unless you have added Array Items). Tap it to launch the Array Editor.

16Array Item Button

This button only displays when the Generator is of Type Sequence. It then shows the Sequence Generator sub-type in use for the currently active Array Item, and its number in the Array Editor list.

Tap on the button to go directly into the relevant Array Item editor.

Example: In the Schematic this button is displayed and shows "#1 Euc", which means that the first item the Sequence Array is selected for use and it is of type "Euclidian".

17Parameter Edit Control

There are a number of different Parameter Edit Controls and these include: sliders, toggles, disclosure buttons.

18Parameter Group Header

When you select a Parameter Groups item in the left column then the Parameter List in the right column will scroll so that the Parameter Group Header is at the top. Swipe up / down in this panel to scroll up or down.

19Generator Number Selector

Tap for a pop-up list of all the Generators in the Cell. Select the Generator you want to edit.

See also: Wotja Music Engine (WME) Parameters.

: Generator Editor: Rule Editor

Generator Editor > Rule

OK/Back Button Element Playing Indicator Screen Title Rule Element Selector Interval Label Mix Rules List Use Mix Properties Rule Use Random Mix Rule Mix Rule Selector Selected for Use Cell Rules List Cell Rule Selector Selected for Editing Rule Actions Included Rules Add Rule

(tap circle for info, hover for tooltip; tap image for large)

Tutorials
Generator Editor: Rule Editor
  • IMPORTANT: Rules can be saved in 2 different places - i.e. Mix Rules or Cell Rules:
  • To display this editor, tap on a Rule item in the Generator Editor.
    • Tip: To display the Rule Editor full screen, first edit the Generator full screen (see Generator Editor) and then open the Rule Editor.
  • Tip 1: If you want to create/use custom Rules for use in Cells that you export as templates or for use in another mix, then you should create them as Cell Rules. These are saved to the Cell and get exported with a Cell.
  • Tip 2: If you don't want to do the above, but do want to use more than one Rule in a Mix we strongly suggest keeping all such Rules one place - i.e. save/use them as Mix Rules. Every Generator can use a different Mix Rule if you want!
  • Mix Rules:
    • Saved at the top level in the Mix itself, see 9Mix Rule Selector.
    • Mix Rules are available for selection/use by one/any/all Generators in one/any/all Cells, either
      • via the "magic" Mix Rule setting "Use Mix Properties Mix Rule" (which means "use whatever Rule is selected as the Mix Rule in the Mix Properties Panel"); or
      • via selecting one of the Mix Rules in the relevant Rule Editor.
    • Mix Rules have a unique name (there can be only one Mix Rule called e.g. "MyMixRule"). When the element values for a Mix Rule are changed it instantly affects the composition of any Generator that uses that Rule. To affect all Generators in one go, simply configure every Generator in the Mix to use the same Mix Rule!
    • Note: Mix Rules can only be added when the editor is accessed via the Mix Properties panel.
    • The available values are as follows:
      • Use Mix Properties Mix Rule: This is a magic rule that means "use whatever Rule is selected as the Mix Rule in the Mix Properties Panel". When creating a new mix most Templates will use this Rule for both Scale and Harmony Rule types - meaning your mix is already pre-configured to take advantage of Mix Rules.
        • The name of the Mix Rules can be changed but use of "?" is disallowed.
      • Use Random Mix Rule: If this is selected, then when the Mix starts it allows a Mix Rule to be chosen at random from the list of Mix or Cell Rules, as appropriate.
      • Other Rules in this list: Once you have added a Rule (using the Add New button) it can be selected for use by any Generator in a Mix and it can also be renamed. For a quick way to change their values see the Tip above.
      • Tip: You can manually edit the Rule elements in any Rule or, for a fast change of those elements, the use the 15Included Rules Button and select one of the Standard Rule values (e.g. "Chord Major triad"). The Rule element values in the Rule will then be REPLACED with the those of that selected Rule and you will be asked if you wish to rename the Rule.
  • Cell Rules:
    • Saved in the Cell itself, see 11Cell Rule Selector.
    • Cell Rules are only available for selection/use by Generators in that Cell.
    • Cell Rules do not have to have unique names (i.e. 2 different Cells can both have their own completely distinct Rule called e.g. "MyCellRule", but where each such Rule has different Rule elements). As Mix Rules are more powerful then in most cases you will likely want to use those instead. You can still use Cell Rules and might wish to do that when you want each Cell to use a variation on a Rule (i.e. 4 Cells in a Track where you want to use e.g. a "Chord Minor triad" Rule and then manually set up different element weightings for each Cell.
      • Use Cell Rule(Generator Rule Editor only): If this is selected, then the Generator will use whatever Rule has been selected in the Cell Rule Editor.
      • Use Random Cell Rule(Cell Rule Editor only): If this is selected, then when the Mix starts it allows a Cell Rule to be chosen at random from the list of Cell Rules.
      • Default: This is just the Default Cell Rule and has no special significance and the name can be edited.
      • Other Rules in this list: Once you have added a Rule (using the Add New button) it can be selected for use by any Generator in a Mix and it can also be renamed. For a quick way to change their values see the Tip above.
      • Tip: You can manually edit the Rule elements in any Rule or, for a fast change of those elements, the use the 15Included Rules Button and select one of the Standard Rule values (e.g. "Chord Major triad"). The Rule element values in the Rule will then be REPLACED with the those of that selected Rule and you will be asked if you wish to rename the Rule.

1X Button

Tap the X button to accept your changes and exit the Editor.

Note: There is no Cancel button to exit the Editor and discard all changes, and that is because it is too hard to implement at this time!

2Element Playing Indicator

When a Generator composes a note using the currently selected rule, the rule element that was used flashes with the color of the Generator type that composed it.

If there are other Generators that also rely on that rule for composition then this color. "flashing" helps to indicate that (in which case, be aware that changing it affect the composition of those other Generators, too).

3Screen Title

The screen title which shows whether you have accessed the Rule Editor from:

4Rule Element Selector

See the Wotja Music Engine (WME) section for information on WME parameters.

The Rule Element Selector lets you change the rule elements. Tap on a rule element to change its value from 0 to 100 (relative probability weighting). The composition engine accommodates all rule changes in real-time - which can be a lot of fun!

Note that if an element is grey, then it is not currently being used for a composed note.

5Interval Label

Show the elements "interval", i.e. m2 (minor second), P4 (fourth), M6 (major sixth) etc.

6Mix Rules List

The scrollable Rule List contains all of the Mix Rules available to select from - simply toggle on the one you want to use.

To add/edit/rename/delete rules see 14Rule Actions.

7Use Mix Properties Mix Rule

This special "magic" Rule allows use of a Mix Properties "Mix Rule" (the name of this special rule cannot be changed and is always Default).

8Use Random Mix Rule

This special "magic" Rule allows a mix, on starting, to randomly choose/use any Mix Rule (if any).

9Mix Rule Selector

Lets you choose a Mix Rule a from the list of Mix Rules. This will always include the "Default" Rule, but may also include others (i.e. if you have added any).

10Selected for Use

The Rule that is selected for use is determined by this checkbox. It is not necessarily the Rule that you are editing in the editor.

11Cell Rules List

This area houses the list of Cell Rules that are defined (if any) for the Cell.

12Cell Rule Selector

Lets you choose the Cell Rule to use from the list of Cell Rules (if any) - simply toggle on the one you want to use.

If you are selecting a Rule for a Generator then you will also see / can select "Use Cell Rule" (meaning use whatever Rule is selected in Cell Properties, e.g. Cell Scale Rule).

13Selected for Editing

The Rule selected for editing in the Editor shows with a light blue background. It is not necessarily the Rule that is being used by the Mix.

14Rule Actions

When you select the Rule Actions button you are presented with the following pop-up menu:

  • Rename:
    • Use this to rename your Rule. Note that you are not permitted to rename the Mix Properties Default rules.
  • Copy Rule:
    • Use this to copy a Rule so that you can paste it as a new Rule.
  • Paste Rule:
    • Pastes a Rule that has been copied.
  • Delete Rule:
    • Deletes the selected Rule. Note that you are not permitted to delete Default rules.
  • Cut Rule:
    • Use this to cut a Rule.
  • Help - User Guide
15Included Rules

When you select the Included Rules button you are presented with pop-up menu that lists all the included "Standard Rule Values". Simply select the one you want to use and the values of that Rule will REPLACE those of the currently selected Rule. You will also see a pop-up asking you if you want to rename the Rule.

For the list of included "Standard Rule Values" see the following:

16Add Rule

When you select the Add Rule button you are presented with a pop-up menu that lets you add a new Rule (and whether is shows as "Add New Cell Rule" or "Add New Mix Rule" depends on whether you are in the Generator Editor/Cell Rules View or Mix Rules View).

For the list of included Rules see the following:

: Generator Editor: Envelope Editor

Generator Editor > Envelope

OK / Back Button Selected Envelope Area Draw Mode Screen Title Macro Mode Envelope Area Actions Button Macro Selector Selected Macro

(tap circle for info, hover for tooltip; tap image for large)

Generator Editor: Envelope Editor
  • To display this (sub) editor, tap on a Envelope item in the Generator Editor.
  • Generator Envelopes are supported for the following WME parameters:
    • Volume
    • Pan
    • Velocity
    • Velocity Range
    • Velocity Change
    • Velocity Change Range
  • Envelopes work in the same way for all of these. This view is where you edit the Generator Envelopes.
  • Each envelope is a collection of up to 100 data points. A piece starts with the value at the left side of the envelope, and as it progresses, eventually ends up with the value from the far right of the envelope.

1X Button

Tap the X button to accept your changes and exit the Editor.

Tap the Cancel button to exit the Editor and discard all changes.

2Selected Envelope Area

Shows an area that has been selected in Macro Mode.

3Draw Mode

Draw Mode: Select this if you want to draw direct on to the envelope with your finger/mouse to change the values.

4Screen Title

The screen title.

5Macro Mode

Macro Mode: Select this to use one of the various macro envelope editing tools on a selected area (e.g. random, curve up etc.).

6Envelope Area

The envelope area is active meaning you can draw on it (Draw Mode) or select and area (Macro Mode).

7Actions Button

This displays the pop-up Actions menu with the "Help - User Guide" menu item.

  • This displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version of the User Guide depends on the value of Settings > General > "Help: Use In-App User Guide".
8Macro Selector

The following Macros can be selected:

  • Select All
  • Ramp Up
  • Ramp Down
  • Normal Curve Up
  • Normal Curve Down
  • Curve Ramp Up
  • Curve Ramp Down
  • Minimum
  • Maximum
  • 0 dB (CC7=90)
  • Center (CC10=64)
  • Up
  • Down
  • Invert
  • Random
9Selected Macro

The selected Macro is shown with a light blue background.

: Generator Editor: Seq Array

Generator Editor > 12Generator Type Specific Group > Sequence > Array Editor Button

Array Actions Button OK/Back Button Sequence Type – TTM Probability Indicator TTM Text Add Button Screen Title Move Up Button Move Down Button Cancel Button Delete Pattern Array Item Number Note Pattern Representation Sequence Type – Euclidian Sequence Type – Pattern B Sequence Type – Pattern R Sequence Type – Pattern F Sequence – Chain Sequence – Chain Syntax Sequence Item Menu Array Item Selector Sequence Item Selected

(tap circle for info, hover for tooltip; tap image for large)

Generator Editor: Sequence Array Editor
  • To display this (sub) editor for a Sequence Generator, tap on the Array Editor Button in the Generator Editor.
  • A Sequence Array is in effect a list one or more Sequence Array Items, each containing all the settings needed for use by one of the Sequence Generator sub-types, these being: Text-to-Music, Euclidian or Pattern (Both, Rhythm, Fixed).
  • Tip: Note sequences can be used to create hidden structure in a mix. Set up a Sequence Generator with your preferred sub-type and set its volume envelope to be zero, but do not mute it (or it will not count in terms of composition). Then, follow that Sequence Generator with a Generator of type Follow and which has Chords Strategy set to Chordal Harmony. You will never hear the original pattern but it will be used as an invisible skeleton around which to compose! If you do want to hear the pattern, set Follows Strategy to Semitone Shift in the Follow Generator.
  • IMPORTANT: If a TTM Sequence Array Item is used in a Sequence Array Chain then ensure that for every such TTM Sequence Array Item its After Tune Repeats setting is 'Select Next Sub-Pattern' - otherwise the chain will appear to get stuck on that Array Element Item.

1Array Actions Button

Displays a pop-up menu with the following options:

  • Export Sequence Array to Clipboard
  • Import Sequence Array from Clipboard
  • Replace Sequence Array with Preset...
    • Selecting one of these listed Preset items will replace the entire existing Array of Sequence Items:
      • Both (B): Whole note rest; 1 bar
      • Chain (S): #1 once, #2 once
      • Chain (S): #1 twice, #2 twice
      • Chain (S): #1 or #2 twice, then #1 or #2 twice
      • Chain (S): #1 once, #2 until end
  • Help - User Guide
2OK/Back Button

Tap the OK button to accept changes you have made.

3Array Item - Sequence: Pattern: Text to Music (TTM)

Sequence Array Item of type Text-to-Music (TTM).

Uses Text-to-Music techniques for melody generation.

4Probability Indicator

Displays the weighted probability for the Array Item. This can be between 0 and 100. When a mix starts (and if there is no Sequence Chain defined) then an Array Item is chosen for the Generator according to the Probabilities set for each Array Item.

You can set this for the Array Item via the 20Array Item Menu button, or via the Action Menu > "Probability" item in the relevant Array Item Editor.

Example: If there are 3 Array Items each with a Probability of 100, then the chance of any one Item being chosen is 100/(100+100+100).

5TTM Text

If the Generator is of type "Text to Music (TTM)", this shows the (first line) of text used for note generation.

6Add Sequence Item Button

Tap for a pop-up menu with a list of Sequence Item presets. See also Pattern Syntax.

Tap the item you want and it will add the preset to the bottom of the list (and above any Chain item).

  • Text to Music (TTM) Custom
  • Text to Music (TTM) Cut-up
  • Euclidian (Euc)
  • Both (B): Random 1/4 notes; 1 bar
  • Both (B): Random 1/8 notes; 1 bar
  • Both (B): Random 1/16 notes; 1 bar
  • Both (B): Random Triplet notes; 1 bar
  • Both (B): Random syncopated; 1 bar
  • Both (B): Ascending pitch; 1 bar
  • Both (B): Descending pitch; 1 bar
  • Both (B): Whole Note Rest; 1 bar
  • Both (B): White Note; 1 bar
  • Fixed (F): 1/4 notes; 1 bar
  • Fixed (F): Notes and Rests; 1 bar
  • Rhythm (R): 1 bar
  • Chain (S): 2 Sequences
  • Chain (S): 3 Sequences
  • Chain (S): 4 Sequences
7Screen Title

Displays the name of the screen.

8Move Up Button

Moves the selected Array Item up the Array (List).

9Move Down Button

Moves the selected Array Item down the Array (List).

10Cancel Button

Discard any changes you have made.

11Delete Item

Deletes the selected Array Item.

12Array Item Number

Display the Array Item number e.g. #1.

13Note Pattern Representation

This indicator gives you a visual representation of the generated note sequence.

14Array Item - Sequence: Pattern: Euclidian (Euc)

Tap on this Euclidian Array Item to launch the Sequence: Euclidian Editor.

Uses the Euclidian technique for melody and beat note sequence generation.

15Array Item - Sequence: Pattern: Both (B)

Tap this Pattern: Both (B) Array Item to launch the relevant Sequence: Pattern Editor.

Uses a Pattern Syntax technique for note sequence generation. Includes both scale interval and note duration and is used when you want to work with a "melodic" pattern.

16Array Item - Sequence: Pattern: Rhythm (R)

Tap this Pattern: Rhythm (R) Array Item to launch the relevant Sequence: Pattern Editor.

Uses a Pattern Syntax technique for note sequence generation. Includes note durations only and is used when you want the pitches to be chosen at random from any of those available in the Generator's Scale Rule (according also to Harmony, and Next Note Rules).

17Array Item - Sequence: Pattern: Fixed (F)

Tap this Pattern: Fixed (F) Array Item to launch the relevant Sequence: Pattern Editor.

Uses a Pattern Syntax technique for note sequence generation. Both the root pitch and note pitches are explicitly defined (i.e. there is no dependency on scale rule) and is used mainly for beat patterns using Channel 10 MIDI.

18Array Item - Sequence: Chain (S)

Tap this Chain (S) Array Item to launch the Sequence: Chain Editor.

Uses a Sequence Chain Syntax technique to allow random or sequenced selection of Array Items.

19Sequence – Chain Syntax

This indicator shows the Sequence Chain Syntax for a Chain Array Item.

20Array Item Action button

Displays the following pop-up menu:

  • Edit-Graphical
  • Probability (weighting)
    • Use this to set the 4Probability weighting for the Array Item, with values between 0 - 100.
  • Edit - Text
  • Export to Clipboard
  • Import from Clipboard
  • Sequence Item Presets...
  • Move Up
  • Move Down
  • Delete
21Array Item Selector

Tap an Array Item to load the relevant Sequence Item Editor, these being for Text to Music, Euclidian, Pattern (Both, Rhythm, Fixed) or Sequence Chain.

22Selected Item

The Array Item that is being used by the Generator has a light blue background.

: Generator Editor: Seq TTM Editor

Generator Editor > 12Generator Type Specific Group > Sequence (TTM) > Array Item button

OK / Back Button Randomize Button Note Sequence & Cut-up Text Graphic Screen Title Actions Button Cancel Button Cut-up Rule Selector Custom Text Button Parameter Control Value Up/Down controls

(tap circle for info, hover for tooltip; tap image for large)

Generator Editor: Seq TTM (Text-to-Music) Editor
1OK/Back Button

Tap the OK button to accept changes you have made.

2Randomize Button

Depending on what the 7Cut-Up Rule button option has been set to (as below; see Cut-up Rule options), tapping this button will randomize the text as follows:

  • Custom
    • The TTM Custom Text field is randomized according to the setting of the Shuffle Option Button (see 8Custom Text Editor).
  • Cut-up: Line# = Track#
    • All lines of the Text Mode cut-up are randomized (word locks are respected).
  • Cut-up: All Lines
    • All lines of the Text Mode cut-up are randomized (word locks are respected).
  • Cut-up: Line# (value)
    • Only the text of the specified line is randomized in the Text Mode cut-up (word locks are respected).
3Note Sequence & Cut-up Text Graphic

Shows you the number of notes your text generates as well as the Cut-up text that is being used to generate those notes.

4Screen Title

Displays the name of this Editor.

5Actions Button

Displays the following pop-up menu:

  • Probability
  • Export Sequence Text to Clipboard
    • Allows you to export the Sequence Array Item to the Clipboard.
  • Import Sequence Text from Clipboard
    • Import a Sequence Array Item from the Clipboard.
  • Edit Sequence Text
    • Allows you to directly edit the Sequence Array Item text string (for expert use only).
  • Export TTM Melody
    • Allows you to export the melody in a Pattern B format.
  • Rule Editor
    • Provides quick access to the Text Mode Rules List so that, if you wish, you can select a different cut-up rule to use for your Cut-up.
  • Help - User Guide
6Cancel Button

Tap the Cancel button to discard any changes you have made.

7Cut-up Rule Selector

Tap this button for a pop-up menu showing you the Cut-up Rule options available.

If you select the "Use Custom Text" option, then you can instead use text you enter via the 8Custom Text Editor.

8TTM Custom Text Button
Wotja Music Mode: Sequence Custom Text

Sequence - Custom Text Editor
(tap image for large)

The TTM Custom Text Button shows below it the Custom Text, if any, that is in this special field. Tap the button for the Custom Text Editor as shown above.

If you set the 7TTM Cut-up Rule parameter to be "Custom Text" then you can use the Custom Text Editor to enter your own custom text for TTM, rather than the Cut-up Rule line number association to text in Text Mode.

As with all TTM text, it can be in can be in any language and, in general, it takes 2 characters to generate a note.

Menu bar Action button:

  • Clear Text:
    • Clears the text area.
  • Export TTM Melody:
    • Exports the Sequence Array Item to the clipboard.
  • Export Text to Clipboard:
    • Exports the Custom Text to the clipboard.
  • Import Text from Clipboard:
    • Imports what is on the clipboard into the Custom Text Editor.

Shuffle Option Button (LHS Toolbar Button, setting used by RHS Toolbar Randomize button):

  • Shuffle Words:
    • Shuffles existing TTM words in this text area when the RHS Toolbar Randomize button is tapped.
  • Shuffle Text
    • Shuffles all characters in existing TTM words in this text area when the RHS Toolbar Randomize button is tapped.
  • Random Words:
    • Allows the creation of a simple cut-up derived from words in your word pool. How many words are used is governed by the TTM Min Words and TTM Max Words settings in Randomization Settings.

Randomize Button: Carries out the action set in Shuffle Option Button, above.

Text Area: Tap the screen to enter your TTM text.

9Parameter Control

Use the Slider control to adjust the parameter value, or double tap it for a pop-up menu where you can manually enter the value you want or randomize it.

For details on the TTM parameters refer to the Sequence: Text-To-Music (TTM) section of the Wotja Music Engine (WME) guide.

10Value Up/Down controls

Tapping a - / + button will decrement / increment the value by one.

: Generator Editor: Seq Euc Editor

Generator Editor > 12Generator Type Specific Group > Sequence (Euc) > Array Item button

OK / Back Button Randomize Button Note Sequence Graphic Screen Title Action Button Cancel Button Parameter Control Value Up/Down Controls Duration Rhythm Strategy Pitch Strategy

(tap circle for info, hover for tooltip; tap image for large)

Generator Editor: Seq (Euclidian) Editor
1OK/Back Button

Tap the OK button to accept changes you have made.

2Randomize Button

Tap to Randomize settings of Steps, Fills and Rotation (only).

For details on the Euclidian parameters refer to the Sequence: Euclidian section of the Wotja Music Engine (WME) guide.

3Note Sequence Graphic

Shows a simple representation of the generated note sequence.

4Screen Title

Displays the name of this Editor.

5Action Button

Displays the following pop-up menu:

  • Probability
  • Export Sequence Text to Clipboard
    • Allows you to export the Sequence Array Item to the Clipboard.
  • Import Sequence Text from Clipboard
    • Import a Sequence Array Item from the Clipboard.
  • Edit Sequence Text
    • Allows you to directly edit the Sequence Array Item text string (for expert use only).
  • Help - User Guide
6Cancel Button

Tap the Cancel button to discard any changes you have made.

7Parameter Control

Use the Slider control to adjust the parameter value, or double tap it for a pop-up menu where you can manually enter the value you want or randomize it.

For details on the Euclidian parameters refer to the Sequence: Euclidian section of the Wotja Music Engine (WME) guide.

8Value Up/Down controls

Tapping a - / + button will decrement / increment the value by one.

9Duration

Tap this for a pop-up menu with a range of Duration options.

For details on the above refer to the Duration parameter in the Sequence: Euclidian section of the Wotja Music Engine (WME) guide.

10Rhythm Strategy

Tap this for a pop-up menu with the following Rhythm Strategy options: "Built-In" and "Use Rhythm Rule".

For details on the above refer to the Rhythm Strategy parameter in the Sequence: Euclidian section of the Wotja Music Engine (WME) guide.

11Pitch Strategy

Tap this for a pop-up menu with the following Pitch Strategy options: "Pitch: Fixed MIDI Pitch", "Pitch: Interval in Scale Rule" and "Ignore: Let Wotja Compose Each Note".

For details on the above refer to the Pitch Strategy parameter in the Sequence: Euclidian section of the Wotja Music Engine (WME) guide.

: Generator Editor: Seq Pattern Editor

Generator Editor > 12Generator Type Specific Group > Sequence (Pattern) > Array Item button

OK/Back Button Edit Mode Button Bars Button Note Length Button Screen Title Note Align Button Undo Button Action Button Cancel Button Redo Button Grid X-axis Grid Y-axis Grid Note Button

(tap circle for info, hover for tooltip; tap image for large)

Generator Editor: Seq (Pattern) Editor
  • To display this (sub) editor for a Sequence (Pattern) Generator, tap on the Array Item button (or shortcut button) in the Generator Editor.
  • This is a special editor for editing parameter values for the Pattern generator sub-type.
  • Most of the interface is common, but what is shown in the grid area varies depending on the Pattern type - see 11Grid X-axis and 12Grid Y-axis.
  • Refer to the Pattern section of the WME Guide for information on all the Pattern parameters and syntax.
  • Both (B) Wotja Settings General screen

    Tap image for large

    This is what you see when editing Both (B) patterns.

    Rhythm (R) Wotja Settings Audio MIDI+ screen

    Tap image for large

    This is what you see when editing Rhythm (R) patterns.

    Fixed (F) Wotja Settings Randomization screen

    Tap image for large

    This is what you see when editing Fixed (F) patterns.


1OK/Back Button

Tap the OK button to accept changes you have made and return to Pattern List.

2Edit Mode Button

There are 3 Edit Modes:

  • Draw:
    • Tap on the grid to add a note.
  • Edit:
    • Tap on a note to see/edit the Velocity Scale (default: 100) and Velocity Scale Range (default: 0) for the note.
  • Delete:
    • Tap on a note to delete it.
3Bars Button

Tap for a pop-up dialog that lets you set how many bars your pattern has from 1 to 50 (Default 1).

4Note Length Button

Tap for the pop-up "Note Length" menu that lets you select the note length you wish new notes to have when you add them (see also Pattern Syntax):

  • 1 note (semibreve, 240 ticks)
  • 1/2. note (dotted minim, 180 ticks)
  • 1/2 note (minim, 120 ticks)
  • 1/4 note (crotchet, 60 ticks) [Default]
  • 1/8. note (dotted quaver, 45 ticks)
  • 1/8 note (quaver, 30 ticks)
  • 1/12 note (triplet, 20 ticks)
  • 1/16 note (semiquaver, 15 ticks)
  • 1/24 note (-, 10 ticks)
  • 1/48 note (-, 5 ticks)
5Screen Title

Displays the name of the screen.

6Note Align Button

Tap for the pop-up "note quantization" menu that lets you select the "snap to grid" resolution you have when you add a new note (see also Pattern Syntax):

  • 1 note (semibreve, 240 ticks)
  • 1/2. note (dotted minim, 180 ticks)
  • 1/2 note (minim, 120 ticks)
  • 1/4 note (crotchet, 60 ticks) [Default]
  • 1/8. note (dotted quaver, 45 ticks)
  • 1/8 note (quaver, 30 ticks)
  • 1/12 note (triplet, 20 ticks)
  • 1/16 note (semiquaver, 15 ticks)
  • 1/24 note (-, 10 ticks)
  • 1/48 note (-, 5 ticks)
7Undo Button

Tap to undo the last change you made (only 1 level of undo/redo is supported)

8Action Button

Tap the button for the following pop-up:

  • Probability
  • Randomize
    • Tap to randomize the Pattern using the note value currently defined by the Length button.
  • Replace with TTM Melody
    • Tap to replace the Pattern with the melody that has been created in the Text to Music parameter for the Generator - this requires either that the TTM "Cut-up Rule" is set to Custom and the "TTM Text" parameter includes text OR the "Cut-up Rule" is correctly set to use a line of Cut-up that has text in it. Refer to both the parameters for Generator Type Text-to-Music and the TTM Editor, as relevant to you.
  • Create Cut-up & Replace with TTM Melody
    • This is a powerful way to quickly create a new pattern, but it only applies if you have the "Cut-up Rule" correctly set to use a line of Cut-up (all TTM Templates are set up like that, so have a look at one of those).
  • Export Sequence Text to Clipboard
    • Exports the current Pattern (as text) to the clipboard.
  • Import Sequence Text from Clipboard
    • Imports a Pattern that is on the clipboard and replaces the existing Pattern with that.
  • Edit Sequence Text
    • Go to a simple text editor where you can manually edit the pattern.
  • Move All Notes Up
    • Moves all notes up one row.
  • Move All Notes Down
    • Moves all notes down one row.
  • Help - User Guide
9Cancel Button

Discards changes made since entering the Editor.

10Redo Button

Tap to redo the last change you made (only 1 level of undo/redo is supported)

11Grid X-axis

For Patterns of type Both, Rhythm and Fixed the grid has an X-axis of Bars. Beneath that, each bar is split into Beats (each bar has 240 Beats).

For Patterns of type Sequence the Grid has a different layout and is instead a "Sequence Element" list, see Y-axis below.

12Grid Y-axis

Pattern Type (see also Pattern Syntax):

  • Both:
    • The grid has a Y-axis of Scale Rule elements. That is to say, each row corresponds to an element that is available in the Scale Rule used by the Generator. "B1" (where "B" is both "Both") represents the first Scale Rule element that is available, B2 the next and so on (and remember that Scale Rules can have 1 to 12 elements in use per Octave!). What note this plays depends on the Base Pitch set for the Generator and the Pitch Range. The way that Scale Rules can "wrap" means this may or may not correspond to the Root note being used by the Cell or Mix.
  • Rhythm:
    • The grid has a Y-axis of just one row because there is no pitch information in a Rhythm rule - just note durations.
  • Fixed:
    • Similar to "Both" above, but where each row is a defined note pitch (e.g. F60). "F" refers to "Fixed" and the number that follows it is the pitch of the note.
  • Sequence:
    • The Grid has a different layout and is instead a "Sequence Element" list, as follows where each list item has the following parameters:
      • Sequence Minimum: Sets the Pattern List Item number that is used (e.g. item #2).
      • Sequence Range: Sets a range of Pattern List Items that can be used (e.g. 0 means none, 1 would mean also select item #3 etc.
      • Repeat Minimum: Sets how many times you want each select List Item to play.
      • Repeat Range: Sets the range on how many times you want each select List Item to play, where this number is added to the Minimum value.
13Grid Note Button

Each note in the pattern is shown as a Note Button. Tap on the button to select it. What you can then do depends on the Edit Mode Button2

: Generator Editor: Seq Chain Editor

Sequence Array Editor > 18Sequence Chain Item

Add OK/Back Button Move Up Button Move Down Button Screen Title Delete Undo Button Action Button Cancel Button Redo Button Chain Header Selected Chain Item Chain Item Number Chain Item Number Range Chain Item Repeat Chain Item Repeat Range

(tap circle for info, hover for tooltip; tap image for large)

Generator Editor: Seq (Chain) Editor

1Add Button

Tap to add a new Chain Item.

2OK/Back Button

Tap the OK button to accept changes you have made and return to the Sequence Array Editor.

3Move Up Button

Tap to move the selected Chain Item up one.

4Move Down Button

Tap to move the selected Chain Item down one.

5Screen Title

Displays the name of the screen.

6Delete

Tap to delete the selected Chain Item.

7Undo Button

Tap to undo the last change you made (only 1 level of undo/redo is supported)

8Action Button

Tap the button for the following pop-up:

  • Probability
    • You can use this to set the Probability weighting for the Chain Item, with values between 0 - 100.
  • Export Sequence Chain Text to Clipboard
    • Exports the Chain (as text) to the clipboard.
  • Import Sequence Chain Text from Clipboard
    • Imports a Chain that is on the clipboard and replaces the existing Chain.
  • Edit Sequence Text
    • Go to a simple text editor where you can manually edit the Chain.
  • Help - User Guide
9Cancel Button

Discards changes made since entering the Editor.

10Redo Button

Tap to redo the last change you made (only 1 level of undo/redo is supported)

11Chain Header

Shows the Header name, "Sequence Chain".

12Selected Chain Item

The selected Chain item has a light blue background.

13Chain Item Number

This is the number of the Array Item you want to sequence. See Array Editor > 12Array Item Number.

14Chain Item Number

The range in Array Item numbers.

15Chain Item Repeat

The number of times you want the Array Item to repeat.

16Chain Item Repeat Range

The range in number of repeats you want for the Array Item.

Text Mode - Properties

Documents > 7EMix File button > 34Text Tab

Save/Exit Button Rules Button Cut-up/Edit Screen EOL Rhyme? Toggle Text Sources Screen Screen Title Edit Text Button Saved Text Screen Text Properties Screen Store Button Actions Button Settings Button Character Count Text Line Number Text Button Unlocked Text Button Locked Selected Text Button Text Area Use Words Button Word Mix Control Play/Stop Button Music Mode Tab Text Mode Tab Display Mode Tab Plug-ins Tab Record Mode Tab Create Cut-up Button Cut-up Mode Button Text Alternatives Bar

(tap circle for info, hover for tooltip; tap image for large)

Tutorials
Text Mode
  • Text Mode comprises 4 screens: 3Cut-up/Edit, 5Sources, 8Saved Text and 9Text Properties.
  • It is where you create/edit text used in your mix, whether purely for display purposes, for "Text-to-Music" (TTM) (see the TTM Cut-up Rule) and also Text to Speech (TTS).
  • The powerful "cut-up technique" is great for generating ideas for lyrics, poems, haiku etc as it allows you to quickly generate random word associations from a pool of words. This pool can include words from:
    • Up to 5 user entered text fields ("Sources", saved in the mix file)
    • A user editable word library ("User Library", saved in Wotja)
    • A user editable general word library ("General Library", saved in Wotja)
    • A non-editable Wotja library ("Wotja Library")
  • You can lock down ("Lock") any words you want (a locked word will not be changed when you press the 19Create Cut-up Button) or, for just a selected word, choose one of the alternative cut-up words presented.
  • You can use Rules ("Rules") to constrain your cut-up by lines, words and syllables.
  • Keep iterating until you find the interesting, inspiring or serendipitous combinations of words you are looking for. Save the the best Cut-ups ("Saved") and then use in real-world lyrics, poems, haikus, tweets etc.
  • The 15Text or created Cut-up, 14Word Locks, associated 11Text Rules, 5Sources and 8Saved Text are all saved in your Wotja file.
  • For your cut-up you get to choose how many lines and how many words per line you want in it and whether you want Wotja to attempt End of Line (EOL) rhyming.
  • Tip: The Schema includes the "Text for Source #0" field into which you can enter text that you wish to be added to Source #0 whenever an auto-mix or flow is created using that Schema. If you set Word Mix to 0, then these words are your entire word pool for cut-up. You can use this if you wish to share your Schema and you will know the recipient will experience cut-up as you intend it.
  • Important: We respect copyright and strongly encourage you to do the same. That means if you use Wotja to come up with a lyric you like, make sure that it does not infringe the copyright of any of your source material. Wotja is pretty good at creating random "cut-ups", but it is just a tool for you to use to generate ideas. It is ultimately your responsibility to make sure you are not infringing anyone else's copyright.

1Save/Exit Button

Displays the Save Changes Menu pop-up before exiting to the Documents screen. For the menu items see the Music > 1Save/Exit button.

2Edit Rules Button

Default Rule: Uses value in the currently selected Schema

Values: Various included; user customized