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

What is Wotja? | FREE

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

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

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

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

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

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

Generative Music Creator, Lab & DAW

• Powerful built-in Music, Audio & Script Engines.
• Many editable generative Templates, Schemas and SFX Presets.
• Many built-in SoundFonts & Audio samples.
• App is also a generative music DAW as it supports AUv3 (iOS/macOS)/VST3 (Windows) Plug-in hosting.
• Allows easy sharing your creations, too (see some examples).

3 Generative Music Players

• 'Flow Player' (akin to a live local radio station just for you) to play Schemas for use e.g. as a sleep music aid.
• 'Album Player' to play Albums of Mixes & Schemas + lets you auto-create/edit Albums.
• 'URI Player' to play, imported from clipboard, a shared Wotja URI (WJURI); supports API commands for use by developers of 3rd Party Apps & Games to generate live background music.

Other things to know...

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

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

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

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

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

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

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

How does Wotja work?

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

• See the Quick Start and our short Tutorials (start with the 4 in the Play section).

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

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

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

See also: Music Mode Schematic.

• At the core of Wotja are 4 main types of user-editable files:
  • Wotja Template File ("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 24 has a number of exciting new features, capabilities, content and improvements at launch, and more will be added during the course of 2024. Below are some of the biggest things (refer also to the Releases page).

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

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

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

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

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

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

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

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

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

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

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

# : Splitter Bar e.g. 46Splitter Bar

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

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

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

Wotja Quick Start

Close

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

Quick Start Screen: Documents > Quick Start Button

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

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

1Back Button

Tap to return to the Documents Screen.

2Screen Title

Quick Start is the name of this screen.

3Show Checkbox

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

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

4Store

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

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

5Settings

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

7Create or Play a Wotja Mix File

Takes you to the Mixes (& Templates) Screen.

• Tutorial: Open/Play a Mix
• Tutorial: Create an Auto-mix

6Play or Edit a Schema (Flow)

Takes you to the Schemas Screen.

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

8Play or Create a Wotja Album File

Takes you to the Albums (& Playlists) Screen.

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

9Import a Wotja URI from Clipboard

Imports a Wotja URI (WJURI) from Clipboard.

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

• Tutorial: Import from Clipboard
• Tutorial: Export to Clipboard

10Play a Recording

Takes you to the Recordings Screen.

• Play an existing Recording that is in the Wotja Folder
• Tutorial: Make a Recording
• Note: Making an audio or MIDI recording in Record Mode is a Pro mode only feature.

11Change a Setting

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

• Tutorial: Change Desktop Audio Output

12Scan Plug-ins

Takes you to the Plug-in Scanner Screen.

• If you wish to use Wotja as a Plug-in host, this screen is where you scan for Plug-ins.

13Make an In-App Purchase

Takes you to the Store Screen.

• Tutorial: How to Go Pro

14Show User Guide

Takes you to this User Guide.

15Tutorials

Takes you to our online Tutorials.

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

• Unless you have the Quick Start Screen selected to show, the Documents Screen is shown after you have launched Wotja and it is where you add/open/delete and rename files.
• It comprises four different document file views/screens, each of which can be selected by tapping the relevant Screen selector:
  5Schemas

  7Mixes (& Templates)

  9Albums (& Playlists)

  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

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

1Add File Button

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

See:

• Schema Add File buttons
• Mixes Add File buttons
• Albums File Add buttons

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.
• Latest Wotja News...
  • Takes you to News page on the wotja.com website.
• 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)".
• Help - Feature Set...
  • Takes you to Feature Set section of the User Guide on the wotja.com website.
• Help - Sharing...
  • Takes you to Sharing section of the User Guide on the wotja.com website.
• Import to Documents/Wotja... (Android only)
  • IMPORTANT: Wotja for Android can only load files from/save files to internal device memory (i.e not an SD Card), specifically a folder called <Internal Storage>/Documents/Wotja ('Internal Storage' might be referenced slightly differently on different devices).
  • This menu item lets you select files to import into the <Internal Storage>/Documents/Wotja folder from a temporary folder e.g. <Internal Storage>/Documents/tempWotja.
  • For details on the work flow required to move files in/out of the '/Documents/Wotja' folder see How do I copy files (Wotja, audio, MIDI, SF2 etc.) into the 'Documents/Wotja' folder for use in Wotja?.
• Demo Files...
  • 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 in all desktop, tablet and mobile variants of the Wotja App and Wotja Plug-ins, however they are not in the TV variants. They permit multiple Wotja files to be open at the same time (Schemas, Mixes, Albums and Playlists). Any open Mix, Album and Playlist files can be played, including simultaneously (subject to the capabilities of your PC).

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

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

5Schemas Screen

Wotja Documents: Schemas

Close

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

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

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

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

---

5AAdd File buttons

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

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

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

    Wotja Schema Select Screen

    

    Close

    Tap for large

5BFile Display button

Toggles the file display between grid and list views.

See the common 6File Display button.

5CFile Filter button

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

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

5DFile Sort button

See the common 14File Sort button.

5EFile button

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

See also: GSchema Actions Button.

5FBuilt-in File badge

Shown bottom right on a built-in Schema file.

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

5GActions button

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

• Flow Player
  • Play the Schema, as a 'flow', in the Flow Player.
• Edit Schema (Pro mode only)
  • 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.
• Share...
  • Displays the Share screen where you can easily share the item as a Wotja URI.
• Show in Finder (macOS only)/Show in Explorer (Windows only)
  • Opens a window with the file selected.
• Cancel
  • Exit the pop-up menu.

5HTop Left badge

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

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

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

6/ File Display button

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

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

• 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 (GSchema 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 (GSchema Actions Button, GMix Actions Button and GAlbum Actions Button).

7Mixes (& Templates) Screen

Wotja Documents: Mixes (& Templates)

Close

Documents: Mixes (& Templates)

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

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

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

---

7AAdd File buttons

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

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

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

    Wotja Schema Select Screen

    

    Close

    Tap for large

7BFile Display button

Toggles the file display between grid and list views.

See the common 6File Display button.

7CFile Filter button

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

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

7DFile Sort button

See the common 14File Sort button.

7EFile button

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

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

See also: GMixes Actions Button.

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

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

7FTemplate File badge

Tutorial: Export a Template

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

7GActions button

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

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

7HPlug-in File badge

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

7ITop Left badge

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

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

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

8Screen Title

Desktop versions: The Screen title is "Documents".

Mobile versions: The Screen title shows "Wotja".

9Albums (& Playlists) Screen

Wotja Documents: Albums (& Playlists)

Close

Documents: Albums (& Playlists)

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

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

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

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

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

---

9AAdd File buttons

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

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

• Auto (Schema name)
  • 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.
• Import From Clipboard
  • Imports from the Clipboard (if any) an album file and saves it to the Wotja folder.
• Playlist only (Pro mode only)
  • Creates a new empty Playlist file (.wotja_ls, see Filetypes).
• Select Schema
  • Lets you select the Schema you wish to use when adding files.
  • 

    Wotja Schema Select Screen

    

    Close

    Tap for large

9BFile Display button

Toggles the file display between grid and list views.

See the common 6File Display button.

9CFile Filter button

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

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

9DFile Sort button

See the common 14File Sort button.

9EFile button

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

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

See also: GAlbums Actions button.

9FPlaylist File badge

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

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

9GActions button

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

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

9HBuilt-in File badge

Shown bottom right on a built-in Album file.

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

9IPlug-in File badge

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

9JTop Left badge

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

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

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

10File Filter Button

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

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

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

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

12Quick Start Button

See Quick Start

13Store Button

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

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

14Settings Button

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

15File Sort Button

This control is shown in all four screens.

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

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

Select one from the following:

• Sort: New-Old
• Sort: Old-New
• Sort: A-Z
• Sort: Z-A

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 24

• 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.
    • New Template (From Existing) (Pro mode only)
      • Tutorial: New Template from Existing
      • Select a built-in Template and duplicate it to the Wotja folder. You can then customise that and save your own variant which you can select from the Documents Pak.
  • 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.
    • 

      Wotja Schema Select Screen

      

      Close

      Tap for large

• 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 > Schemas Screen > FActions Button > Edit Schema > Schema Items

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

Overview: What is a Schema?

• Schemas Screen:
• A Wotja Schema is a bit like a recipe. It is a collection of settings that are used for creating auto-mixes and for in-mix randomization. It was previously referred to as a "Randomization Preset".
• Schemas can also be "played" in the Flow Player where they generate a succession of auto-mixes, one after another, hence a "Flow".
• Schemas are found in the Schemas screen. All the settings in the currently selected Schema can be edited in the Schema Editor which is selected via the "Edit Schema" menu item in the Schema Actions button.
• There are over 40 different settings in each one, described below. These range from Template selections (including ones you have made), Sound & FX preset selections (again including ones you have made) right through to Cut-up rules and the number of cells/tracks in an auto mix.
• Each Schema can have completely different settings, too, meaning they can be configured exactly as you want - whether you want to change just one setting or all of them is up to you.
• Randomization can be used in a number of places in Wotja and the randomization parameters in a Schema determine how it is used. Examples of this are how the mixes in 'flows' and Albums are created and whether e.g. text is displayed on screen in Flow Player and/or the Playlist Player Fullscreen mode. They are also used to determine how mix Cells are populated with templates when using the Random function in Wotja, how TTM Generator text randomization is applied to mixes and how Cut-up is generated in the Text Editor screen - plus a lot more, too.
• Select a Schema:
  • Documents > Schemas Screen > File Button
• Rename / Delete / Duplicate a Schema:
  • Documents > Schemas 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
  • Creates a new file (which you can rename) based on the current state of the open file (a snapshot of where you are if you like), but leaves you in the current open file - meaning if you then exit the file you will see this pop up dialog again letting you choose what to do with the file.
    • Note: This is NOT the same as Save As so please remember to save your file if you want to keep your changes to it.
• Discard
  • Lose any changes made to your file since you opened it.
• Cancel
  • Dismiss this popup and return to the Display screen.

2File Tab

The File Tab shows the name of the Schema.

Note: Tabs are only supported in the Desktop variants.

3File Name

Shows the name of the Schema.

4Group Header

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

5Item/Parameter Control

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

See: Schema Items

6Actions Menu Button

Displays the Actions Menu pop-up:

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

Schema Items

Wotja Templates List

Close

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

Templates

NEW Templates for W24: 24 Arps and 24 Strings

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

Tutorials

• 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, 7Generator 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
  • A-Z
  • Z-A
• Select All Paks *
• Deselect All Paks *
• Select All Templates in Pak *
• Deselect All Templates in Pak *
• Select All Paks and All Templates *
• Deselect All Paks and All Templates *
• Older Paks: Hidden > Show / Shown > Hide
• Help - User Guide
  • 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.

10WME Generator Types Pak

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

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

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

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

Here is what is included:

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

11Selected Pak

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

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

12Pak Selector

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

See "How are Templates Used?".

These are what some of the Paks are:

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

133rd Party Pak

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

14Template Toggle

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

See "How are Templates Used?".

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

15Template Selector

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

16Content Type Icon

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

• Generative
• Audio file
• MIDI file

Notes:

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

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

Wotja Documents: Share URI

Close

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

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

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

• Schemas screen > Actions > "Share...", Albums screen > Actions > "Share...", Mixes screen > Actions > "Share..."
• Flow Player > Actions > "Share...", Album Player > Actions > "Share..." or Mix > Actions > "Share..." etc.

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

See also Help on Sharing.

1Back button

Takes you back to the screen you were last in.

2Copy (to clipboard) button

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

3Share button (Apple only)

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

4Screen Title

The title of this screen.

5Export & Test Import button

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

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

6Store button

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

7Settings button

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

8Help button

Takes you to this Sharing section of the User Guide.

9Wotja URI Type

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

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

10Option selector

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

Only one option in each a group can be selected.

11Wotja URI Format

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

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

12Wotja URI Purpose

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

See our Wotja Sharing Examples.

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

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

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

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

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

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

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

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

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

    WJURI.....

13Characters

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

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

14Code for sharing panel

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

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

Wotja Player: Flow

Close

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

Tutorial

• Play a Flow

Wotja Flow Player

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

1Exit Button

Takes you back to the Documents screen.

2/ Sleep Timer Button (Pro mode only)

Tutorial: Set a Sleep Timer.

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

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

3Repeat Button

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

4Next Button

Forces another Flow mix to be generated.

5Schema Name

Displays the name of the Schema currently in use.

6 / Play/Stop Button

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

7Full Screen Top Panel

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

8Store Button

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

9Actions Button

Displays a pop-up menu with the following options:

• Share...
  • Displays the Share screen where you can easily share the item as a Wotja URI.
• Save Flow to Wotja Mix File (Pro mode only)
  • Saves the current Flow to a new Mix file (.wotja, see Filetypes).
• Save Flow to Wotja Album File (Pro mode only)
  • Saves a new Album file (.wotja_al; see Filetypes) that includes the current Flow Mix file (.wotja, see Filetypes).
• Full Screen [mobile] / Full Window [desktop]
  • Displays Wotja full screen on your device and the mix (if playing) continues to play. At any time tap the screen to leave full screen display and return to Display mode.
• Full Screen with Camera Background (iOS/Windows)
  • Tip: Watch the Video tutorial (48 seconds in).
  • Displays your device Camera feed in a Window on top of Wotja (which may restart play on going into this mode).
  • At any time tap the screen to return to Full Screen Display mode.
  • For a composite live generative music and video feed use iOS Control Center / a relevant 3rd party app to screen mirror to a TV.
    • Perfect for use as a big screen audio-visual experience e.g. installations, nature video feeds etc.
• Full Screen & Restart/Stop (for videos) [mobile] / Full Window & Restart/Stop (for videos) [desktop]
  • Wotja displays full screen on your device and the mix (if playing) is stopped and then restarted after 2 seconds, making it easier to find a start point in a screen video recording. At any time tap the screen to leave full screen display and return to Display mode. Alternatively, use the Record Seconds or Bars setting to have the mix auto-stop when that value is reached and then have Wotja wait 2 seconds before returning to Display mode.
  • macOS Desktop version:
    • The Wotja window title bar is hidden and a content area sized to e.g. 640x480 pixels is positioned top left of the screen below the App title bar. The available content area sizes are the same as those listed in the Titlebar > Window menu.
• Mini Game - Follow the Line
  

  • 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

Wotja Album/Playlist Player

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

1Add Button

Tap this button for the following pop-up menu:

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

2Exit/Save Button

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

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

3/ Sleep Timer Button (Pro mode only)

Tutorial: Set a Sleep Timer

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

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

4Previous Mix Button

Takes you to the previous playlist item.

5Next Mix Button

Takes you to the next playlist item.

6 / Play/Stop Button

Tutorials: Play an Album | Play a Playlist

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

7Playing Mix Name

Displays the name of the playing mix.

8Store Button

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

9Actions Button

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

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

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

Menu options

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

  Mix Overrides Screen
  (click image for large)

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

20Mix Time Remaining

This displays the Play Time remaining for the current file.

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

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

Wotja Player: URI

Close

Tutorial

• Play a Wotja URI

Wotja URI Player

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

• You tap on a web-linked embedded Wotja URI (for examples see Sharing Wotja Music).
  • Note: If the you are presented with a pop-up dialog giving you the choice to "Auto-Play or Save?", then choose "Auto-Play" to play in the URI Player.
• You import a Wotja URI from clipboard using the Quick Start > Import Wotja URI from Clipboard button.
  • Note: If the you are presented with a pop-up dialog giving you the choice to "Auto-Play or Save?", then choose "Auto-Play" to play in the URI Player.
• You tap the Export and Test Import button in the Share screen.
• A 3rd Party App or Game loads Wotja via a Wotja URI (developers see this FAQ section).

Notes:

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

1Back button

Takes you back to the screen you came from.

2Lite mode panel

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

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

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

3App Name

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

4Store button

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

5Settings button

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

6Player Name

This shows you this is the URI Player.

7Play/Stop button

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

8Explore button

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

9Display Area

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

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

Wotja Player: TV

Close

Wotja Player: TV

Close

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

Wotja TV Player for Apple TV, Fire TV and Android TV

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

1Settings Button

Displays the pop-up 17Settings Panel.

2Sleep Timer Status

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

3Sleep/Play Time Remaining

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

4Mix Time Remaining

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

5Repeat Status

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

See: 14Repeat Selector.

6Next Button

Select this button to force another mix to be generated.

7Screen Text

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

8Background/Screensaver

The background used depends on the 16Schema being used.

9Wotja Watermark

This is where the Watermark displays.

10Version number

Displays the version number and copyright statement.

11Mode

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

This button displays the current mode of operation.

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

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

12Speech Synthesizer Toggle [Apple TV only]

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

13Text Display Selector

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

14 / Repeat Selector

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

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

15 / Sleep Timer Selector (Pro mode only)

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

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

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

16Schema Selector

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

Schemas are not editable in the TV Player.

17Settings Panel

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

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