Wotja is FREE for: Phone, Tablet, Laptop, Desktop, TV, Watch; OS: iOS, iPadOS, macOS, Windows, Android, tvOS, Android/Fire TV, watchOS; Bundle: AUv3/VST3 Host + AUv3/VST3 Plug-in

What is Wotja? |

Wotja ( "whah-chah" [alt "wot-yah"; Siri "woa-chah"]) is a FREE and powerful Generative Music & MIDI 'Creator Player System'. It is lovingly developed by us at Intermorphic Ltd..

Use it to CREATE & PLAY live generative music, relaxing soundscapes, ambient drones, text-to-music melodies + more - and to do it all locally on your device, i.e. not in the cloud.

If all you want to do is to sit back and chill out to relaxing generative music - then you can! Simply play a 1-tap 'Flow' (a Flow is a succession of auto-generated mixes created in the Flow Player, akin to a local radio station just for you), or easily create & play an Album. Enjoy 30 mins play for FREE!

Wotja for Apple OS and Windows both include an App, which is also a Plug-in Host, and a Wotja Plug-in (either AUv3 for Apple or VST3 for Windows respectively). Wotja for Android is just an App.

Wotja operates by default in capable and powerful Lite mode - which is FREE to use. If you want to do the max then there are a number of low cost options to Go Pro.

Actively developed & extended, and our life passion, Wotja has a distinguished provenance stretching right back to 1992+ SSEYO Koan, 2007+ Noatikl & Mixtikl etc. and we have continued to evolve it ever since.

Wotja includes 100s of editable templates and supports use of add-on Paks. This User Guide also includes sections on the Wotja WME / WAE / WSE engines. With it and our Tutorials and FAQs you have all you need to begin your creative journey with Wotja.

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.

• See the Quick Start and How does Wotja work?

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 the Wotja Generative Music System are 4 main types of user-editable files:
  • Wotja Template File ("Template"; filetype: .wotja_tp);
  • Wotja Schema File ("Schema"; filetype: .wotja_sc;
  • Wotja Mix File ("Mix"; filetype: .wotja));
  • Wotja Album File ("Album"; filetype: .wotja_al).
• Wotja Template File:
  • User 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 Generator creates MIDI notes and events according to its Generator Type, the settings of the Rule Objects it uses (e.g. Scale, Harmony, Rhythm and Next Note), as well as other related parameters like Phrasing, Chording and Articulation etc.
  • Each Wotja Template 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.
      • WAE Wavetable Units in Templates can also refer to external SF2 files.
      • Any such SF2 and Paks must be located in the Wotja Folder.
  • Various mix-related settings such as Cell Properties and Mix Properties.
    • See How long does a Cell play for?

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.

Wotja 23 has a host of exciting new features, capabilities, content and improvements. Below are some of the biggest things (refer also to the Releases page).

IMPORTANT: Wotja 23 saves files to a new format that cannot be opened in Wotja 22. This is because of support required for its new features. Do not save any earlier Wotja files in Wotja 23 unless you intend to move to Wotja 23 or you back them up first!

Major New Features, Capabilities, Content and Improvements

• 'Featuregrade' Business Model: There is now just one free Wotja App or bundle/download per App Store and all updates are free. To unlock Pro mode there are 3 different types of In-App Purchase (IAP) options: Subscription (SUB), 30 Day Unlock (30U) and One Time Buy (OTB).
  • See also: Do I ever need to get the next major version of Wotja?
• WAE Sample Player Unit: New modulatable & polyphonic Tone Generator (TG) unit that plays Ogg and (generative) Template file data (Templates are "cooked" in memory to audio before use); it has support for (MIDI & Controller) pitch shifting, direction reverse and several loop/play modes as well as an optional built-in envelope.
• WAE Filter Unit: New 2-pole and 4-pole Filter Types.
• WAE LFO Unit: New Euclidian LFO Type: Euclidian for modulation with euclidian patterns.
• WAE R2XL FX Unit: 10 new 'go to' ABC Reverb Presets (also included as ABC Reverb FX Presets).
• Mix files: Sample Player source data (loaded via the WAE Sample Player Unit) can be saved to the mix file for sharing of completely self contained and unique-sounding mixes.
• Schemas (formerly called Randomization Presets): Now edited in the Schema Editor, accessed from Flows screen > Flow Actions Button.
• Documents Screen: Flows screen where non-included Schemas have thumbnails generated from colours in the Schema.
• Documents Screen: New Recordings Screen to make it easy to find/play your Wotja folder (saved) recordings.
• Documents Screen: New List view and faster loading of mix files.
• Add File: You can now edit the file name before saving a newly created file.
• Music Mode: Much improved and simplified Cell layout with badges and thumbnails, Track Mute/Solo highlighting, and new options to display a specific column in the Grid button menu.
• Music Mode: New "One Tap Trigger" Track Play Type for quick/easy playing of a cell and live performance.
• Music Mode: Template browser now supports Cell referencing of Audio (WAV, Ogg) and MIDI files directly from the Wotja Folder (they no longer have to be in Paks [zip files]).
• Music Mode: Template Editor for easy editing/saving/exporting of Template Files.
• Recording: New auto and manual Ogg encoding (export a .WAV file to an .Ogg file for use in WAE Sample Player Unit).
• TV Player: Android version re-instated.
• Included SF2: New "UK Woodland Birds" with many awesome samples for use in the WAE Wavetable unit.
• Included Templates: New "WJ23 Drones", "WJ23 Basses", "WJ23 Classic Polysynth", "WJ23 Environments" and "Sample Player Resources" Paks which include many awesome Templates and Ogg samples.
• Schemas: Two new settings Environment Cells and Drone Cells settings to control how many Cells are populated with the related Templates.
• Included Schemas: New "Environments 1" and "Drones 2" (subject to change).
• Filetype extensions: Changed to be .wotja_tp (Template), .wotja_al (Album), .wotja_ls (Playlist),.wotja_sc (Schema), .wotja_sy (Synth Preset) and .wotja_fx (FX Preset), plus revised web file sharing extensions.
• Wotja URL (text string) format for Schemas: This now makes this Wotja filetype easy to share (see Schema Editor > Actions Menu) via emails, web files and even to webplay via the Safari Extension (see Sharing).
• Documents > Actions > Import to Documents/Wotja [Android only]: Menu option to allow 'missing' Wotja files to be recovered via import.
• Performance improvements: Better CPU & UI performance plus addition of a CPU % indicator.
• "V23 Play me!" mix: Shows some of the new templates and capabilities in action.
• Lite mode improvements: 30 mins play time for all Flows and Albums now supported (enjoy!), removed all Lite mode Mix file locks, removed 'Pro mode only' limitations from several features (e.g. Script Editing, some Import/Export options etc.), removed limitations on creating auto-Albums - (see the list)!
• Wotja App icon: No longer references version number as all major version updates are free!

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 :

# : Area/screen e.g. 5Flows (Schemas) Screen

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

# : Display item e.g. 35MIDI Channel

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

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

IMPORTANT: As they support new V23 capabilities, opening/loading/using a Wotja 23 mix file or filetype requires Wotja 23 or later.

Wotja File Sharing | 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.
     • Web file (W23.5+): Change the above file extension to .SKM, where M stands for Mix
     • Note: .SKD was used prior to W23.5+ and might still work in W23.5+.
  2. .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. See also: Sharing Wotja Files.
     • Web file (W23.5+ required): Change the above file extension to .SKD, where D stands for Design
     • Legacy extension: .noatikl (see legacy below).
  3. .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.
     • Web file (W23.5+ required): Change the above file extension to .SKP, where P stands for Play
     • Legacy extension: .wotjabox (see legacy below).
  4. .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.
     • Web file (W23.7+ required): Change the above file extension to .SKT, where T stands for Transmute
     • Legacy extension: .wotjarp (see legacy below).
  5. .wotja_ls [Playlist file]: References .wotja files located in the Wotja folder
     • 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"
     • Legacy file extension:
       • .tg: Import, but not export.
  2. .wotja_fx [WAE FX Network file]: AKA "FX Preset"
     • Legacy file extension :
       • .fxm: Import, but not export.
  3. 'WJURL'(Wotja URL):
     • A wotja file (.wotja, .wotja_al or .wotja_tp) in the form of a URL (i.e. a text string, see Export Mix to Clipboard and Sharing);
       • Any/all referenced .zip, .sf2, .midi, .wav files are not included;
       • .ogg files can be embedded in a mix file via a Sample Player unit.
  4. Plain text: words/characters, cut-up, cut-up rules, patterns etc.
• Wotja can use:
  • .sf2: Referenced from the Wotja Folder or SF2 Paks via an WAE Wavetable Unit.
  • .wav: Referenced from an Audio Pak or Wotja folder and added to a Cell via the Template List.
    • Formats: WAV (8/16/24-bit PCM, 32-bit float)
  • .ogg: Referenced from an Audio Pak or the Wotja folder and added to a Cell via the Template List or added via a Sample Player.
    • Formats: Any kHz
  • .midi: Referenced from a MIDI Pak or the Wotja folder and added to a Cell via the Template List.
  • .jpg/.png: Image files can be added as a background to a mix file via the picture setting
  • See also the FAQ: The "Wotja Folder" - Where is it and when should I use it?.
• Wotja can record to:
  1. .wav (convertable to .ogg), .midi

• 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 WJURL (Wotja URL). See also: Filetypes and Album/Playlist Player.
• 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 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.
    • 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 WJURL (Wotja URL). 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.
• 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.
• TTM (Text to Music): The technique of generating melodies from manually entered or auto-generated text and a Generator's Scale Rule. See also: Generator - Text to Music.
• 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.
• WJURL: A Wotja URL ('WJURL') is a Wotja Mix, Album or Schema exported as a long text string in the form of a URL. It can be embedded in a web page, shared in a message or saved as the relevant Wotja file. See also: File Types and Sharing.
• 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.
• 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.

The easiest way to get going with Wotja is to check out the following two quick Tutorials.

These show 2 easy, yet different, ways to generate your own personal live ambient generative music which, in FREE Lite mode, you can enjoy for 30 minutes(!):

• Play a 'Flow'
  • A Flow is a succession of auto-generated Mixes.
• Create & Play an Album
  • An Album is a collection of Mix files.
  • Albums can be entirely auto-generated (as shown in the Tutorial), or you can add your own Mix files.

Other Quick Tutorials

• Open/Play an Album
• Create an Auto-mix
• Open/Play a Mix
• More quick tutorials...

How to Play a 'Flow'

If you don't want to watch the 'Play a 'Flow'' tutorial above (it's under 30 seconds!), then just do this:

1. Load Wotja.
2. In the Documents screen, tap the 5Flows (Schema) Screen Selector to show the Schemas screen, below.
   • 

     Wotja Flow Buttons

     

     Close

     Tap for large

3. Tap any one of the EFlow Buttons.
   • or for that button tap the GFlow Actions Button (the file name below the thumbnail or the menu button to the right, depending on the File Display Button) and then select 'Flow Player' from the pop-up Actions menu.
4. Wotja will start generating flows for you in the Flow Player!

Wotja Documents: Common Items

Close

(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

• Documents is shown after you have launched the app 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:
  5Flows (Schemas)

  7Mixes (& Templates)

  9Albums

  11Recordings
• 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

• Create an Auto-Mix
• Create an Empty Mix
• Create an Album
• Create a Playlist
• Delete a File
• Rename a File

1Add File Button

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 the button for the relevant pop-up menu (button not shown in Recordings screen).

See:

• Schema Add Button
• Mixes Add Button
• Albums Add Button

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)
  • Shows the Plug-in Scanner screen.
• Help - Resources
  • Displays the Help Resources pageHelp Resources page (for a quick overview / links etc.) in a pop-up window.
  • Whether this is an in-app or online page depends on the value of Settings > General > "Help: In-App (uncheck for Online)".
• Help - User Guide
  • Displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version depends on the value of Settings: General > "Help: In-App (uncheck for Online)".

• 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...
  • Takes you to this weblink on the wotja.com website.
• 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 only shown in the Desktop variants which 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: Included Albums and Included Schemas are non-editable so they do not open in a tab.

5Flows (Schemas) Screen

Wotja Documents: Flows (Schemas)

Close

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

The Flows (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 play a 'flow' 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'.

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

---

5AAdd File Button

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 (Flow) (base on Schema name) (Pro mode only)
  • Creates a new Schema file based on the selected Schema (below).
• 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.
  • Schema Select Screen

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.

5ETop 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 and that you are using an earlier major version of Wotja. 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.

5FFile Button

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

See also: GFlow Actions Button.

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)
  • Edit the Schema in the Schema Editor.
• Delete [User Added Schemas only]
  • Delete the file.
• Rename [User Added Schemas only]
  • Rename the file.
• Duplicate
  • Duplicate the file.
• Show in Finder (macOS only)/Show in Explorer (Windows only)
  • Opens a window with the file selected.
• Cancel
  • Exit the pop-up menu.

5HBuilt-in File Badge

Shown bottom right on a built-in Schema file.

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

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.

• Grid

  Wotja Documents Grid View

  

  Close

  Tap for large

  Files are displayed in a grid. The Actions menu button is the File Name shown below the thumbnail (GFlow Actions Button, GMix Actions Button and GAlbum Actions Button).

  List

  Wotja Documents List View

  

  Close

  Tap for large

  Files are displayed in a list. The Actions menu button is the button to the right of the list (GFlow Actions Button, GMix Actions Button and GAlbum Actions Button).

7Mixes (& Templates) Screen

Wotja Documents: Mixes (& Templates)

Close

(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 Button

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)
  • Tutorial: Create an Auto-mix
  • Creates a new Mix file (.wotja, see Filetypes) based on the currently selected Schema which is then opened in Music Mode.
• Empty
  • Tutorial: Create an Empty Mix
  • Creates a new empty Mix file (a mix with no Cells populated) based on the currently selected Schema which is then opened in Music Mode.
• From Clipboard
  • Tutorial: Import a Mix
  • Imports from the Clipboard (if any) a mix file and saves it to the Wotja folder.
• Select Schema
  • Lets you select the Schema you wish to use when adding files.
  • Schema Select Screen

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: (Pro mode only)
   • 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.

7ETop 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 and that you are using an earlier major version of Wotja. 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.

7FFile 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).

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.
• Show in Finder (macOS only)/Show in Explorer (Windows only)
  • Opens a window with the file selected.
• Cancel
  • Exit the pop-up menu.

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

7IPlug-in File Badge

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

8Screen Title

Desktop versions: The Screen title is "Documents".

Mobile versions: The Screen title shows "Wotja".

9Albums Screen

Wotja Documents: Albums

Close

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 Button

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)
  • Tutorial: How to create an Album file (.wotja_al)
  • Creates a new Album file (.wotja_al, see Filetypes) populated with with collection of Wotja mix files generated according to the currently selected Schema, which is then opened in the Album Player.
• 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.
• 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.
  • Schema Select Screen

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: (Pro mode only)
   • 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.

9ETop 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 and that you are using an earlier major version of Wotja. 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.

9FFile 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.

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

9IPlaylist 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.

9JPlug-in File Badge

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

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.

• Flows File Filter
• Mixes File Filter
• Albums File Filter

11Recordings Screen

Wotja Documents: Recordings

Close

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.

12Store 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).

The Store button in Flow and Album Player screens toggles between 2 display states:

• Active mode:
  • To the left of the Store button is shown the active mode of operation. In Wotja 23 this can be either: Lite, Pro, 23 Pro, Play or 23 Play.
• 'Love it!' Tip:
  • To the left of a 'Cup' icon is shown the words 'Love it!'

13Settings Button

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

14File 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 (Pro mode only)
• Sort: A-Z (Pro mode only)
• Sort: Z-A (Pro mode only)

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.

Wotja 23

• About (macOS)
  • Displays the Wotja version number.
• Other entries (macOS)
  • Various usual Mac items.
• Quit (macOS)
  • Quit Wotja; if you have unsaved changes you can choose to quit without first saving.
  • Keyboard shortcut: Cmd+Q.

File Menu

• New...
  • Mix
    • Auto (Schema name)
      • Tutorial: Create an Auto-mix
      • Creates a new mix file (.wotja, see Filetypes) based on the currently selected Schema and then opens it in Music Mode.
    • Empty
      • Tutorial: Create an Empty Mix
      • Creates a mix with no Cells populated (but still includes a Cut-up) and then opens it in Music Mode.
    • From Clipboard
      • Tutorial: Import a Mix
      • Imports a mix file on the Clipboard (if any) and creates a new mix file.
  • Album
    • Auto
      • Creates a new Album (.wotja_al; see Filetypes) and opens it in the Album/Playlist Player.
      • The Album is populated with with collection of Wotja mix files generated according to the currently selected Schema.
    • Empty (Pro mode only)
      • Creates a new empty Album (.wotja_al; see Filetypes) and opens it the Album/Playlist Player.
      • Add to it the Wotja mix files you want to be in it.
    • From Clipboard
      • Imports an Album (.wotja_al; see Filetypes) from clipboard and opens it the Album/Playlist Player.
    • Playlist (Pro mode only)
      • Creates a new empty Playlist file (.wotja_ls; see Filetypes) and then opens it in the Album/Playlist Player.
      • Add to it the Wotja mix files you want to be in it.
  • Schema
    • Schema (Flow) (Base on Schema name) (Pro mode only)
      • Lets you add a new Schema, based on the currently selected Schema.
    • From Clipboard
      • Imports a Schema that is on the Clipboard.
  • Select Schema
    • Lets you select the Schema you wish to use.
    • Schema Select Screen
• Open...
  • Shows a list of openable files using a standard Finder or Windows Explorer browse dialog.
  • The filetypes that Wotja can open directly are: .wotja, .wotja_al, .wotja_ls, .wotja_tp and legacy variants (see Filetypes).
  • Note: Wotja cannot directly open .zip or .sf2 files, but it can play .midi, .wav or .ogg files via the Recordings screen.
    • .sf2: can be referenced in templates via an WAE Wavetable Unit
    • .wav, .ogg, .midi: can be added to a Content Cell via the Template List
    • .ogg: can be added to a WAE Sample Player Unit
  • See the FAQ: The "Wotja Folder" - Where is it and when should I use it?.
  • Keyboard shortcut: Cmd+O (macOS) or Ctrl+O (Windows).
• Close
  • Close the currently open file (i.e. tab).
  • Keyboard shortcut: Cmd+W (macOS) or Ctrl+W (Windows).
• Save / Save As... (With Lite mode restrictions)
  • For the currently open file displays the Save dialog allowing you to browse to where you want to save to:
    • If you have iCloud enabled then for your files to show in the Documents folder you must save to the Wotja iCloud folder.
    • If you are not using iCloud, we strongly recommend saving files to the Wotja Folder.
    • See the FAQ: The "Wotja Folder" - Where is it and when should I use it?.
  • Keyboard shortcut(s): Cmd+S/Cmd+shift+S (macOS) or Ctrl+S/Ctrl+shift+S (Windows).
  • Saving mix files: See 23 Feature Set for limitations when saving in Lite or Play mode.
• Open Recent
  • Shows a list of recently opened files. You can clear this list using the bottom "Clear Menu" menu item.
• Exit
  • Close the Wotja app.
  • Keyboard shortcut: Ctrl+Q.

Window Menu

• Show Window
  • Brings the Wotja app window to the front.
• Resize content area
  • Available options are 640x480, 960x540, 1280x720, 1920x1080, 3840x2160.
  • An option is only presented if your screen size is larger.
  • These options are particular use when it comes to capturing videos, this option resizes the Wotja content area below the window title bar to 640x480 pixels and positions the Wotja window top left of the screen. Tip: To hide the window title bar itself see Display > Actions and select either "Full Window" or "Full Window & Restart/Stop (640x480)".

Help Menu

• Show Wotja data folder
  • This will display in Finder (macOS) / Explorer (Windows) the Wotja folder where you save Wotja files, i.e. mixes, albums/boxes, playlists, Sound & FX presents, Schemas and recordings (WAV/MIDI).
• Various weblinks
  • Useful weblinks to this User Guide, video tutorials and the EULA.
• Find out about Wotja
  • Takes you to the Releases page on our website to check what the latest version is.
• VST3 Related Menu Items (Windows)
  • These items all relate to manual installation of the Wotja VST3 Plug-in. See this FAQ.
• About (Windows)
  • Shows the version number.

Wotja Schema Editor

Close

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

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

Schema Editor: Documents > Flows (Schemas) Screen > FActions Button > Edit Schema > Schema Items

Play a 'flow': Documents > Flows (Schemas) Screen > FFlow Button

Overview: What is a Schema?

• Schemas Screen:
• Schemas are found in the Flows (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 Flows Actions button.
• Previously referred to as a "Randomization Preset", a Schema is a collection of settings used for creating mixes, 'flows' and for in-mix randomization.
• 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:
  • Documents > Flows Screen > File Button
• Rename / Delete / Duplicate a Schema:
  • Documents > Flows Screen > Actions Menu > Rename / Delete / Duplicate
• 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 (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.

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

Schema Items

Wotja Templates List

Close

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

Templates

• Wotja includes 100s of editable "Templates" (.wotja_tp; see Filetypes) - see also What is a Template?
• 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

• Add Template to Cell
• Export Template from Cell

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:

• A Schema is used to create Flow Player mixes, AAuto mixes and AAuto albums from random selections of Templates.
• To select Paks and Templates for the Schema see: 12Pak Selector, 14Template toggle

Manual Mixing:

• Templates are selected, 16previewed, and added to a Cell via the Template List which is accessed via a 26Cell Selector Button, 5Generator Menu Button or a pop-up menu from a 32Generator Button.
• Templates can also be selected in the Schema Editor for use in Schemas.

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 (Pro mode only)
  • A-Z (Pro mode only)
  • Z-A (Pro mode only)
• 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
  • Displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version depends on the value of Settings: General > "Help: In-App (uncheck for Online)".

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.

10Generator 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.

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)
  • A Sequence Generator of Type Pattern: Both (B) (you will hear something).
• Sequence - Euclidian (Euc)
  • A Sequence Generator of Type Euclidian (you will hear something).
• Sequence - Fixed (F)
  • A Sequence Generator of Type Pattern: Fixed (F) (you will hear something).
• Sequence - Rhythm (R)
  • A Sequence Generator of Type Pattern: Rhythm (R) (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.
• BP22 Drums
  • A collection of (Euclidian) Drum Templates.
• BP22 Drums Ambient
  • A collection of Ambient Drum templates.
• BP22 Mixed
  • A mixed collection of templates.
• BP21 Drones 1
  • A collection of Drone Templates.
• TTM 1 Players/TTM 1 Players 2
  • Templates that use Text-to-Music techniques to generate melodies.
• BP20 Drones 1
  • A collection of Drone Templates optimized for Wotja 20.
• BP1-4 Paks
  • These include templates optimized for Wotja 19.
• BP0 Paks
  • These include templates optimized for Wotja 4.
• Flows Pak
  • A Pak that includes special Templates used in some Flows.
• BP00 Paks (see Actions > Older Paks: Hidden > Show / Shown > Hide)
  • Shown in dark grey, and only if "Older" Paks are selected to be shown in Actions.
  • The Paks that were available for Noatikl 3 and Mixtikl 7.
• BP000 Paks (see Actions > Older Paks: Hidden > Show / Shown > Hide)
  • Shown in dark grey, and only if "Older" Paks are selected to be shown in Actions.
  • These include generative templates that came with Noatikl 1 and Mixtikl 1-5.
• 3rd Party Paks
  • Paks such as the free Morphing Drum and Bass (MDB) and Audio Loop Collections Paks
  • Note: Loading Zips from the file system is a 'Pro' mode feature.

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.

Note: Loading Zips from the file system is a 'Pro' mode feature.

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 the icon for the filetype.

• Schema: Only templates are shown and can be selected.
• Cells: Templates, audio and MIDI files are shown and can be selected.

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.

Wotja Player: Flow

Close

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

Tutorial

• Play a Flow

Flow Player

• Documents > 5Flows Screen > EFile Button
• Schemas 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).

The Store button in Flow and Album Player screens toggles between 2 display states:

• Active mode:
  • To the left of the Store button is shown the active mode of operation. In Wotja 23 this can be either: Lite, Pro, 23 Pro, Play or 23 Play.
• 'Love it!' Tip:
  • To the left of a 'Cup' icon is shown the words 'Love it!'

9Action Button

Displays a pop-up menu with the following options:

• 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
  

  • 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
  

  • 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
  • Displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version depends on the value of Settings: General > "Help: In-App (uncheck for Online)".

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 Player: Album/Playlist

Close

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

Tutorials

• Play an Album
• Play a Playlist
• Create an Album
• Create a Playlist

Album/Playlist Player

• Documents > 9Albums 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.
• Cancel
  • Return to the playlist.

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

The Store button in Flow and Album Player screens toggles between 2 display states:

• Active mode:
  • To the left of the Store button is shown the active mode of operation. In Wotja 23 this can be either: Lite, Pro, 23 Pro, Play or 23 Play.
• 'Love it!' Tip:
  • To the left of a 'Cup' icon is shown the words 'Love it!'

9Action Button

• 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 URL ('WJURL'), .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
  • Displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version depends on the value of Settings: General > "Help: In-App (uncheck for Online)".

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
(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

Button not shown in Built-in Albums

Note: 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).

Menu options

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

  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)
  • Where available, this item lets you export your mix 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 Player: TV

Close

Wotja Player: TV

Close

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

TV Player for Apple TV, Fire TV and Android TV

• A simple TV 'player' app (included in the Wotja App Bundle) that is launched from the Wotja app icon on your Apple TV, Fire TV or Android TV (requires the relevant OS version of Wotja to be installed).
• It operates as a 'Flow Player' 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".

See: Web Play a WJURL

The Wotja Safari Extension is included in the Wotja App Bundle for Apple devices. It is a facilitator for the Wotja App and allows it to load and play a webpage-embedded Mix or Album WJURL.

• Note 1: Always assume that the latest version of Wotja is required to correctly play a WJURL! If there are multiple versions of Wotja installed then this might actually launch one of those instead so either first delete or archive them.
• Note 2: WJURL 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!

Wotja Player: Watch

Close

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

Wotja Mix: Music

Close

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

Tutorials

• Play a Mix
• Edit Mix Properties
• Edit Cell Properties
• Cell Display
• Cell Sequencing
• Mix Volume

Music

• Documents > 5Mix File > 31Music Tab
• 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.
  • Schema Select Screen
• 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 30Track 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 at the top of the 42Generator Editor Panel (assuming you have set it to show).

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".
• Show/Hide Generator Editor Panel
  • Default value - Visible: For in-screen editing of a Generator's WME parameters this toggle governs the display or hiding of an optional Generator Editor sub-panel to the right or below (according to device orientation) in the Generator Network Editor panel.
  • Layout:
    • Landscape: The panel is shown to the right of the Generator Network.
    • Portrait: The panel is shown below the Generator Network.
  • Operation:
    • Simply tap/click a Generator button/icon in the Network view to update what is shown in the parameter panel.
    • Clicking the Generator button in the network view on an unfocused Generator will give focus to that Generator and update the panel but doesn’t show the pop-up Generator menu.
    • Clicking on previously focused Generator does show the menu.

• Other items: See Cell Actions Menu

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). The Desktop version also uses that colour for its File Tab.

Tech: The Template file is actually loaded/saved in the top-left cell within a hidden container Mix.

• Important: For testing of your Template the Template Editor does allow you to edit various e.g. Mix-related properties but those are NOT saved to the Template when it is saved/exported.
  • Tip: You can still export your Template as a Mix, either to Clipboard or File, via the Actions Button.
• This is why when it opens you will see a popup message "Mix-specific properties will not be saved in this mode, but are useful for testing your template (e.g. Text, Display, Plug-ins; and Mix / Cell level rules, Track FX, Mix FX)." If you do not want to see that again just tap the button "Don't tell me again".
• What is saved to the Template includes ONLY Cell-related data, meaning the following:
  • Generator parameters, Generator FX, Cell FX, Cell Mixing, Cell Rules (if custom ones are specified).
  • As well as: Cell Script, Cell Meter, Template Title, Template Author and Template Notes (but no other Cell Properties), Mix Root and Mix Tempo (but no other Mix Properties).
  • Tip: Templates can contain custom TTM text in a Generator (TTM Custom Text), but if you want to set up Generators to use/reference Cut-Up then we auto-generate Cut-Up text (for the hidden container mix file) using the currently selected Schema.

Template Editor

Wotja Template Editor

Close

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
  • Displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version depends on the value of Settings: General > "Help: In-App (uncheck for Online)".

8Generator Network View

For details on all the UI elements in this main view refer to the Music Mode schematic, which shows this view 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, WAE synth sounds and FX. The buttons in the network and associated WAE network all provide quick links to the underlying parameters and editors.

Tip 1: Tap/hold on a Generator and you can drag it up/down to change the Generator order.

Tip 2: If you drag from a Generator button to a MIDI channel box that will tell the system that the Generator will play through the defined MIDI channel. If a new Generator is added to a piece, the Generator won't be assigned to a specific MIDI channel; if you haven't yet hooked-up a Generator to a MIDI channel, the WME will decide on a free MIDI channel to hook-up the Generator to when it starts playing.

9Cell FX Button

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

10Cell Mixer View

Music Mode: Cell Mixer
(tap image for large)

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

Shown in the 39Editor Area (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.

11Mix Name

The name of the open mix file.

12Track FX Button

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

13Mix FX Button

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

14Track Mixer View

Music Mode: Track Mixer
(tap image for large)

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

Shown in the 39Editor Area (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.

15Cell Properties: > List

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
  • Root
  • Meter
  • Repeats
  • Repeats Range

• Cell Generative
  • Generative Bars
  • Generative Bars Range
  • Scale Rule
  • Harmony Rule
  • Rhythm Rule
  • Next Note Rule
  • Harmonize With Me
  • Harmonize With Others
• Cell Info
  • Cell Display Name
  • Template Path
  • Content Duration
  • Template Title
  • Template Author
  • Template Notes

Script

• Cell Script
  • Show the first line of any Cell level script. Tap on it for the Wotja Script Editor.

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.

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:

• Import Wotja from Clipboard (Mix Editor only)
  • Only shown if you have a Wotja on the clipboard and you will see a message about having to Import a Wotja via the Documents screen (Documents > Add New > Mix (from Clipboard).
• Export Mix to Clipboard (Mix Editor only)
  • Creates the smallest Wotja URL (WJURL) from your mix.
• Export Template to Mix to 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.
• Export Mix with Image (Mix Editor only)
  • Creates a Wotja URL (WJURL) from your mix that includes your a background image (if you have selected one).
• Script Sandbox
  • Opens the Script Sandbox window where you can try out scripts.

• Help - User Guide
  • Displays the User Guide in a pop-up window.
  • Whether this is the in-app or online version depends on the value of Settings: General > "Help: In-App (uncheck for Online)".

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:

• Generative
  • The Cell contents are based on an underlying editable Wotja Template (.wotja_tp; see Filetypes).
  • Templates include 1 or more Generators.
  • Templates can be added to a Cell from the Templates List - either from the 9Documents "Pak" (Wotja Folder) folder or from zipped Template Paks.
• Audio file
  • The Cell references an Audio file in the Wotja folder.
  • Audio files (.wav, .ogg; see Filetypes) can be added to a Cell from the Templates List - either from the 9Documents "Pak" (Wotja Folder) folder or from zipped Audio Paks.
  • WAE Sound FX, be that 7Cell FX, 9Track FX or 11Mix FX, can be applied to the sound from the Cell.
• MIDI file
  • The Cell references a MIDI file in the Wotja folder.
  • MIDI files (.midi; see Filetypes) can be added to a Cell from the Templates List - either from the 9Documents "Pak" (Wotja Folder) folder or from zipped MIDI Paks.
  • MIDI files will play ONLY through the WAE General MIDI Wavetable set, and patches cannot be changed.
  • WAE Sound FX, be that 7Cell FX, 9Track FX or 11Mix FX, can be applied to the sound from 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 6Generator Network View, tap an empty Cell or its empty 39Editor Area (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
  • See 21Cell Content Type.
• 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 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. If the in-situ 42Editor Panel is displaying then you will see the parameters for that Generator and can edit them straight away in that panel.

Tip: Double tap the button (and/or right click on desktop) to display a pop-up menu (for menu details see the 5Generator 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 that selects Text Mode.

35MIDI 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 (see also 42Editor Panel) 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.

36Generator 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).

37Display Mode Tab

The Tab that selects Display Mode.

38Generator 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.

39Editor Area

This area to the right of the Cells is where the various Editors display.

40Plug-ins Tab

The Tab that selects Plug-ins Mode.

41Record Tab

The Tab that selects Record Mode.

42Editor Panel (WME)

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

The in-screen Generator Main Editor Panel lets you edit generator parameters in-situ without having to use the full screen Generator Editor.

Note: Only the full screen Generator Editor shows the Undo/Redo buttons and the Generator Number Selector bar.

How to hide/display the Panel

• Tap the 4Grid Button and select "Show/Hide Generator Editor Panel".

43Mix Properties View: > List

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 Script
• Mix General
  • Mix Volume
  • Mix Root
  • Mix Tempo
  • Mix Scale Rule
  • Mix Harmony Rule
  • Mix Rhythm Rule
  • Mix Next Note Rule

• Mix Fades & Playlists
  • Ramp Up: Seconds
  • Duration: Seconds
  • Duration Range: Seconds
  • Ramp Down: Seconds

Script

• Mix Script
  • Show the first line of any Mix script. Tap on it for the Wotja Script Editor.

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.

44Settings Button

Takes you to the Wotja Settings: General screen.