Skip to main content Skip to docs navigation

Wotja® User Guide V22

Engines: Wotja 22 WME iconWME | Wotja 22 WAE iconWAE | Wotja 22 WSE iconWSE

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

V22.5.0 Intro; Files; Players Mix Editing Settings, , ; Engines; PDF

Intro


Files


Players





Settings, ,


Engines


Other


PDF

Overview

Wotja icon

Wotja is powerful Generative Music Software. Easily generate live ambient music, MIDI + more. Or just relax with awesome 1-tap 'flows'. Includes 100s of editable templates and supports use of add-on Paks. This User Guide also includes sections on the Wotja 22 WME / WAE / WSE engines. With it and our Tutorials and FAQs you have all you need to begin your creative journey with Wotja.

Broken links or suggested improvements? Please do let us know!

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

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

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

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

How does Wotja work?

See also: Music Mode Schematic.

  • At the core of the Wotja Generative Music System are user-editable Wotja Templates ("Templates"; filetype: .noatikl) and Wotja Mix Files ("Mix Files"; filetype: .wotja).
  • Each Wotja Template comprises:
  • Mix Files include 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.
  • The MIDI notes/events from each Generator can be turned into sound either with a WAE Synth & FX Network (use of the WAE is optional, and it can be turned off), via 3rd Party Hosted Plug-ins or sent to a 3rd Party DAW/Synth for use by that.

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.

Quick start

The best way to start getting a feel for Wotja it simply to start by play a "Flow".

Either check out the Play a Flow tutorial, or:

  1. Load Wotja.
  2. In the Documents screen, tap the BFlows Screen tab.
  3. Tap any one of the 10Included Flows.
  4. Wotja will start generating music for you in the Flow Player!

Guide Schematics

This User Guide provides schematics for each key screen, making it easy to get to grips with Wotja. Each schematic is surrounded by colour-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!

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

# : Panel area e.g. Menu Bar A

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

# : Display item e.g. MIDI Channel 32

# : WME (Generators) e.g. Generator Button 30

# : WAE (Sounds, FX) e.g. Gen erator FX 34

File Types

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

Glossary

  • Album (Box): A Wotja Album (AKA Box) (File Type .wotjabox ) includes a number of Wotja Mix files and is packaged as a zip file. Albums can be exported to the Clipboard as a WJURL (Wotja URL). See: File Types and Album/Playlist Player.
  • Audio Unit (AU): 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: 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: 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: 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: Cells.
  • 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: 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 Randomization Preset (RP). See: Flow Player and Randomization Preset (RP).
  • 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: 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: 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: 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: Sequence - Euclidian.
      • Text to Music: A Sequence Generator sub-type, it composes note sequences from manually entered or auto-generated text and the Generator's Scale Rule. Typical use: Easy and FAST creation of melodies requiring no musical knowledge. See: Sequence - Text to Music.
      • Pattern: A Sequence Generator sub-type, it composes note sequences just like a Rhythmic Generator unless it is being used to play note patterns (there are 3 different kinds: B, R, F). Typical use: Providing a melodic structure (muted or not) for other Generators to compose around and/or to be followed (Follower); for playing pre-defined melodies (and sequences) See: 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: 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: 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: Generator - Listener.
  • Generator Network: The particular combination of Generators in a Cell. See: Generator Network View.
  • Mix: A Wotja mix (File Type .wotja ) that includes all the settings Wotja needs to play it. Mixes can be exported to the Clipboard as a WJURL (Wotja URL). See: File Types and Mix Player.
  • Playlist: A Wotja Playlist (File Type .wotjalist ) references Wotja Mix files that exist in your Wotja Folder (it does not include them like an Album does). See: File Types and Album/Playlist Player.
  • Plug-in or Plugin: See: Audio Unit (AUv3) above or VST below.
  • Randomization Preset (RP) [formerly referred to as Randomization Scheme (RS)]: A collection of parameter settings that can be used to create an automatic mix, flow or when a mix is manually randomized. See: Randomization Preset (RP) and manual randomization.
  • 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: 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: 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: 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: Rhythm Rule.
  • Synth & FX Network: A particular configuration of WAE units created in the Synth & FX Editor. See: Synth & FX Editor.
  • Template: To create generative music a Cell requires in it a Template (File Type .noatikl ). 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 Feature Set). See: 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: 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: Grid Button , Track Cell Sequencing and Track FX.
  • TTM (Text to Music): The technique of generating melodies from manually entered or auto-generated text and a Generator's Scale Rule. See: Generator - Text to Music.
  • VST3: An VST3 Plug-in is most easily thought of as a self-contained program that can run in an VST3 Host. VST3 is Steinberg's latest Plug-in format and is different to Apple's Audio Unit format. See: Plug-in Hosting and Wikipedia Steinberg VST.
  • Wotja Folder: This is where Wotja finds and saves files. See: Wotja Folder.
  • WJURL: A WJURL (Wotja URL) is a Wotja Mix or Album exported as a long text string in the form of a URL. It can be embedded in a web page, shared in a message or saved as a .wotja file. See: File Types and Sharing.
  • WAE: The optional WAE (Wotja Audio Engine) is what Wotja uses for audio/sound generation (it can be turned off in Settings > Audio MIDI+ > WAE for Sounds & FX). It comprises a number of audio-rate tone generators (synths), FX units, control-rate units and connectors and junctions (to hook up more complex configurations). Complex networks of these units can be created in the Synth & FX Editor. See: WAE , Setting WAE for Sounds & FX and Synth & FX Editor.
  • WME: The WME (Wotja Music Engine) is what Wotja uses for MIDI note and MIDI controller event generation . It utilises 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: WME.

Documents

Menu Bar Flows Mixes Albums Action Button Sleep Timer Button Screen Selector Screen Title Feature Set (FS) Button Store Button Settings Button Flows Show Button User Flow Button Included Flow Button Flow Name Mixes Show Button Add New Mix Button Mix Button Mix Name Button Albums Show Button Add New Album Button User Album Button Album/Playlist Name Locked File Badge Playlist Badge File Tab Included Album Badge Template Badge Albums Sort Button Mixes Sort Button

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

Documents Screen
  • The screen you see after you have launched the app.
  • It is where you open/delete/rename files, and also create files with the Add New buttons.
  • It comprises three different file views or screens: FlowsB, MixesC or AlbumsD.
  • The 5Feature Set (FS) button in the Menu Bar shows the active Feature Set.
  • Desktop versions: These allow multiple files (Mixes, Playlists and User Albums) to be open at the same time. Each file is shown in a different tab at the top of the screen. The User Guide schematics use Desktop screenshots and so show this. See also Desktop Menu.
  • iOS/macOS versions: When you first start the app you're prompted if you want to use iCloud or Local. See iCloud Settings.
Tutorials

AMenu Bar

UI Elements: Menu Bar buttons12567 and a Screen title4 that is always "Wotja".

BFlows Screen

The "Flows" screen is selected with the Screen Selector3.

It shows a number of buttons where each button represents an underlying Randomization Preset ("RP").

The buttons shown depends on the filter settings selected in the Flows Show8 menu.

CMixes Screen

The Mixes screen is one of the Create screens and is selected with the Screen Selector3.

Note: For a mix file or template to be shown it must be in the (relevant) Wotja folder.

The Create screens (Mixes and User Albums) are selected with the Screen Selector3.

DAlbums Screen

The Albums screen is selected with the Screen Selector3.

This screen display buttons for all User Album and Playlist files (.wotjabox, .wotjalist, see Filetypes) that are in your Wotja folder as well as buttons for Included Albums and Subscriber Albums (these last type are only shown in the free versions for iOS/macOS).

To easily identify them, Playlist files, Included Albums and Subscriber Albums have a small badge overlay in the bottom right corner of the button.

Note: For an album or playlist to be shown it must be in the (relevant) Wotja folder and you have not deselected that type in the "Show" filter.

1Action Button

The Action button presents a pop-up menu with the following options:

2/ Sleep Timer Button

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.

3Screen Selector

Tap a "segment control" to select the screen you want, these being the Create MixesC and User AlbumsD screens or the Play FlowsF (with two sub-screens) and Included AlbumsG screens.

4Screen Title

The Screen title in Documents is always Wotja.

5Feature Set Button

The Feature Set button displays the name of the active Feature Set.

  • Wotja 22 Pro (paid-for version)
    • Button shows Pro.
  • Wotja 22 (free/subscription version)
    • Button shows Pro if you have an active 'Pro' Feature Set Subscription (as available).
    • Button shows Play if you have an active 'Play' Feature Set Subscription (as available).
    • Button shows Lite if you don't have an active 'Pro' or 'Play' Feature Set Subscription.
6Store Button

NB: The Store button is not shown in the Wotja 22 Pro version.

  • iOS/macOS
    • Tap to go to the In-App Store where you can purchase/manage Subscriptions.
  • Windows, Android
    • Tap for a pop-up with links to the Wotja 22 Pro version on the relevant App Store.
7Settings Button

The Settings button takes you to the Settings screen.

8Flows Show Button

Displays a pop-up menu with filter options that govern what Flow buttons are shown.

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

Select any of the following:

  1. User
    • Select (tick) to display Flows (Randomization Presets [RP]) that you have saved to or otherwise added to the Wotja folder.
    • Note: These are shown as locked (meaning they cannot be used) unless Wotja is in 'Pro' mode.
  2. Built-in: Higher CPU impact
    • Select (tick) to display built-in Flows (Randomization Presets [RP]) 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 Flows (Randomization Presets [RP]) 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.
9User Flow Button

This icon is used by any non-included Randomization Preset ("RP") that you have saved or otherwise added to your Wotja folder.

Tap it to start the 'Flow Player'.

10Included Flow Button

Wotja includes a number of "Flows". Tap the button to start that Flow playing in the 'Flow Player'.

Flows are actually a succession of mixes auto-generated by a Randomization Preset ("RP"), the name of which is shown below the button (e.g. Flow "Mixed 1" is generated by a RP called "Mixed 1.wotjarp").

See: Flow Name11.

Tip: In Pro Mode you can edit the paramters of an included RP and then save your changes as a new RP. It will appear as a User Flow button9).

11Flow Name

This shows the name of the Randomization Preset ("RP") that is used by the Flow button above it.

The name of an included (built-in) Randomization Preset is not editable but you can edit the name of your own saved Randomization Preset as follows:

  • In Finder/Explorer (Desktop) or Files (Mobile) or equivalent find the relevant .wotjarp file in the Wotja folder and rename to what you want.
  • Alternatively, within Wotja itself (and in Pro Mode), you can go to Settings > Randomization Presets, open your Randomization Preset and then re-save it with a different name.
12Mixes Show Button

Displays a pop-up menu with filter options that govern what Mix buttons are shown.

The button text indicates the selected items, where each one is represented by a number, and the search name if any is also shown if used e.g. "Show..." if nothing set, "Show: 1, 2", "Show: 1; abc" etc.

Select any of the following:

  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 Templates (.noatikl, see Filetypes) that you have created or otherwise added to the Wotja folder.
  3. Search: ('Pro' mode)
    • Allows you to enter a search term to search for a file by name or part name.
    • The value you enter here applies only to Mixes.
    • The value is discarded if you restart the app.
13Add New Mix Button

Tap the button for the pop-up "Add New Mix" menu:

14Mix File Button

See also: Add New Mix.

Tap the button to open the mix in the Mix Player (it should open in the last used "Edit Mode").

The appearance of a mix file (.wotja, see Filetypes) button depends on a number of factors:

  1. Randomization Preset
    • When a mix is created, the mix button can display Cut-up, TTM or no text and with a background of black/white, or solid colour or thumbnail of the screensaver, all depending on the settings in the Randomization Preset that is used.
  2. Cells
    • Is content in one or multiple cells (this is important?
  3. Filetype
    • Is it an old format Wotja file, Mixtikl file or Template file (.noatikl, see Filetypes)?
  4. Manually changed
    • If you have added a background image to your mix it will show in the thumbnail (see: Display Mode > Picture button5).
    • If you have created an Empty Mix or Cut-up Mix then the button will have a white background until you select your preferred Display settings (see: Display Mode > Properties4).
15Mix Name Button

Tap on this text button (below the Mix File button14) for the following popup menu:

  • Open
    • Open the file.
  • Delete
    • Delete the file.
  • Rename
    • Rename the file.
  • Duplicate (Pro only)
    • Duplicate the file.
  • Cancel
    • Exit the pop-up menu.
16Albums Show Button

Displays a pop-up menu with filter options that govern what Album buttons are shown.

The button text indicates the selected items, where each one is represented by a number, and the search name if any is also shown if used e.g. "Show..." if nothing set, "Show: 1, 2, 3, 4", "Show: 1; abc" etc.

Select any of the following:

  1. Boxes
    • Select (tick) to display 'box' Albums (.wotjabox, see Filetypes) that you have created or otherwise added to the Wotja folder.
  2. Playlists
    • Select (tick) to display Playlists (.wotjalist, see Filetypes) that you have created or otherwise added to the Wotja folder.
  3. Built-In
    • Select (tick) to display the built-in Albums, currently 'Calm' and 'Relax'.
  4. Search: (Pro only)
    • Allows you to enter a search term to search for a file by name or part name.
    • The value you enter here applies only to Albums.
    • The value is discarded if you restart the app.
17Add New Album Button

Tutorials: Create an Album | Create a Playlist

Tap the button for the following "Add New Album" pop-up menu:

18User Album Button

See also: How to create an Album file (.wotjabox).

Tap the button to load the Album in the Album/Playlist Player.

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

19Album/ Playlist Name

The name of an Album (.wotjabox, see Filetypes) or Playlist (.wotjalist, see Filetypes).

Tap on the button for the following popup menu:

  • Open
    • Open the file.
  • Delete
    • Delete the file.
  • Rename
    • Rename the file.
  • Duplicate (Pro only)
    • Duplicate the file.
  • Cancel
    • Exit the pop-up menu.
20Locked File Badge

This badge is shown to the bottom right of a file and only displays in 'Lite' mode.

It is a simple visual indicator that shows you files that, in 'Lite' mode, you are not permitted to open. These being anything other than the most recent user file in the Mixes or Albums screens or any non-included Randomization Preset (Flow Player) in the Flows screen.

See the Feature Set Table.

21Playlist Badge

Tutorial: How to create an Playlist file

This badge is shown to the bottom right of a Playlist file (.wotjalist, see Filetypes). Tap the button to load the playlist in the Album/Playlist Player.

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

24File Tab

File tabs are only shown in the Desktop versions which allow multiple Wotja Mixes, Playlists and User Albums to be open at the same time.

23Included Album Button

This badge is shown to the bottom right of an Included Album (.wotjabox, see Filetypes). Tap the button to load the album in the Album/Playlist Player.

Note: Included Albums cannot be renamed, deleted or duplicated.

24Template Badge

Tutorial: Export a Template

This badge is shown to the bottom right of a Template file (.noatikl, see Filetypes). Tap the button for a Template File to auto-convert it to a .wotja mix file before being opened in the Mix Player.

25Albums Sort Button

Displays a pop-up menu that lets you select Albums sort order.

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

Select one from the following:

  • Sort: New-Old
  • Sort: Old-New (Pro only)
  • Sort: A-Z (Pro only)
  • Sort: Z-A (Pro only)
26Mixes Sort Button

Displays a pop-up menu that lets you select Mixes sort order.

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

Select one from the following:

  • Sort: New-Old
  • Sort: Old-New (Pro only)
  • Sort: A-Z (Pro only)
  • Sort: Z-A (Pro only)

Templates

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

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

Templates
  • Wotja includes 100s of editable "Templates" (see What is a Template?).
  • Templates are at the core of Wotja because every Mix file is comprised of 17Cells and for any Cell to play it must have in it either:
    • a Template, be that in an included one or one one you or a 3rd party has created.
    • an Audio or MIDI file (both must be in Paks, see Filetypes).
  • Mix files can be auto-created e.g. in the Flow Player, or created by you, which is why this section comes before the other "Edit Mode" sections.
Tutorials
What is a Template?

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

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

How are Templates used?

Automatic Mixing:

Manual Mixing:


AMenu Bar

The Menu Bar contains the 1Back, 6Actions, 7Replace and 8Merge buttons.

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 Settings > Randomization > Templates.

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

4Screen Title

Displays the name of the screen.

5Templates List

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

6Action 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 Randomization Presets > Templates > Select Template):

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

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

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

8Merge Button

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

Note: You are not allowed to Merge in a Template if there are insufficient free MIDI channels to accomodate 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 accesss. It is not really a "Pak" at all, but just lists all the generative templates (.noatikl files) that are present in the Wotja Folder, whether you have saved some to there (see 4Grid Button > Export Cell to Template) or have copied/moved into it.

10Generator Types Pak

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

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

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

Here is what is included:

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

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

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

12Pak Selector

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

See "How are Templates Used?".

These are what some of the Paks are:

  • WME Generator types
    • Simple templates that let you start a cell with just one Generator type.
  • BP22 Drums
    • A collection of (Euclidian) Drum Templates for Wotja 22.
  • BP22 Drums Ambient
    • A collection of Ambient Drum templates for Wotja 22.
  • BP22 Mixed
    • A mixed collection of templates for Wotja 22.
  • BP21 Drones 1
    • A collection of Drone Templates optimised for Wotja 22.
  • TTM 1 Players/TTM 1 Players 2
    • Templates that use Text-to-Music techniques to generate melodies.
  • BP20 Drones 1
    • A collection of Drone Templates optimised for Wotja 20.
  • BP1-4 Paks
    • These include templates optimised for Wotja 19.
  • BP0 Paks
    • These include templates optimised for Wotja 4.
  • Flows Pak
    • A Pak that includes special Templates used in some Flows.
  • BP00 Paks (see Action > Older Paks: Hidden > Show / Shown > Hide)
    • Shown in dark grey, and only if "Older" Paks are selected to be shown in Actions
    • The Paks that were available for Noatikl 3 and Mixtikl 7
  • BP000 Paks (see Action > Older Paks: Hidden > Show / Shown > Hide)
    • Shown in dark grey, and only if "Older" Paks are selected to be shown in Actions
    • These include generative templates that came with Noatikl 1 and Mixtikl 1-5.
  • 3rd Party Paks
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 Randomization Preset.

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.

16Preview Indicator

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 a light green background.

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

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

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

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

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

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

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

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

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

  • Various weblinks

Player: Flow

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

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

Documents > BFlow Screen > 10Included Flow Button or 9User Flow Button.

Tutorial
Flow Player
  • Generates a succession of freshly created auto-mixes from the various settings in the currently selected Flow icon, AKA as a Randomization Preset (RP).
  • The Documents screen lists all the RP 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 RP.
  • Playback will continue until either the Sleep Timer kicks in (if active) or if in the Lite Feature Set the auto-timeout is reached.

AFlow Player Menu Bar

The Menu Bar contains the 1Exit, 3Sleep Timer, 4Repeat, 5Play/Stop, 7Next, 9Action and 11Settings buttons.

BFlow Player Status Bar

The Status Bar contains the 2Time/Sleep, 6Randomization Preset and 10Mix Time Remaining status indicators.

1Exit Button

Takes you back to the Documents screen.

2Flow/Play/Sleep Time Remaining

If you have an active 3Sleep Timer button then this indicator shows the time remaining before Wotja will stop playing.

If there is no Sleep Timer active this area just show the word "Flow" to let you know you are in Flow mode.

3/ Sleep Timer Button

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.

4Repeat 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.
5 / Play/Stop Button

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

6Randomization Preset Name

Displays the name of the Randomization Preset currently in use.

7Next Button

Forces another Flow mix to be generated.

8Full 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.

9Action Button

Displays a pop-up menu with the following options:

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

11Settings Button

Takes you to the Settings screen.

12Text Area

Whether any text is displayed here depends on the Icon Text value used by the Randomization Preset (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 Randomization Preset that is being used. Doing that lets you override what is in the Randomization Preset. It's fun!

13Background/Screensaver

The background used in Flow Mode depends on the Icon Pallete and Icon Graphic values used by the Randomization Preset (Settings > Randomization).

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

14Wotja Watermark

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

There are different Wotja watermarks for the Wotja 22 and Wotja 22 Pro apps.

Player: Album/Playlist

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

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

Documents > DAlbums Screen > 18User Album | 20Playlist | 21Included Album.

Tutorials
Album/Playlist Player
  • Plays the following Wotja files:
    • Wotja Playlist (.wotjalist):
      • 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.
    • Wotja 'Box' (.wotjabox):
      • Container files contain up to 20 Wotja mix files (.wotja), making them great for sharing your favourite mix creations.
      • Note: Box files can include any mixes, even mixes that reference 3rd party templates or audio loops. However, to play those mixes correctly the refernced content must be installed in the Wotja Folder.
    • Wotja 'Album':
      • A special kind of built-in play-only Box that does not allow exporting of mixes or Mix Overrides.
  • Also used to:
    • Export user created Boxes from Playlists.
    • Add Wotja mix files (.wotja) to a Box.
    • Re-order the files in a Playlist.
    • Edit Mix Override settings for Playlists and Boxes (these values are saved back to that file).

APlaylist Player Menu Bar

The Menu Bar contains the 1Add, 2Exit/Save, 3Sleep Timer, 4Previous, 5Mix Selector, 6Play/Stop, 8Next, 9Action, 10Settings and 11Sequential/Random buttons.

BPlaylist Player Toolbar

The Toolbar contains the 3Add and 11Sequential/Random buttons.

CPlaylist Player Status Bar

The Status Bar contains the 12Playlist Name/Sleep Remaining, 7Playing Mix Name and 19Mix Time Remaining status indicators.

1Add Button

Tap this button for the following pop-up menu:

  • New Random Mix (Box files only)
    • Tap to add a new Random mix to your playlist.
  • Browse Mixes
    • Browse the Wotja folder to add a Mix or Saved Mix to your playlist.
  • Cancel
    • Return to the playlist.
2Exit/Save Button

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

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

3/ Sleep Timer Button

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.

5Mix Selector

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

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.

8Next Mix Button

Takes you to the next playlist item.

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

Takes you to the Settings screen.

11 / Sequential/Random Play Button

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

12Playlist Name/Sleep/Play Time Remaining

If you have an active Sleep Timer then this shows the time remaining before Wotja will stop playing. If there is no Sleep Timer active this area just show the name of the playlist.

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

13Mix Thumbnail Button

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

Play Screen
Play Screen

Play Screen
(tap image for large)

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

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

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

14Selected Mix Indicator

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

15Playing Mix Indicator

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

16Mix Number/Name

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

17Mix Duration/Range

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

18Mix Actions Button

Button not shown in Included Albums

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

Menu options
  • Mix Overrides (Option not shown in Playlists) Mix Overrides

    Mix Overrides Screen
    (click image for large)

    • Ramp Up: Sets how long it takes for the file volume to ramp up once the file has started to play.
    • Duration: Sets how long the file will play for (Mix Duration).
      • Note: This Mix Override has a minimum value of 1 second, and the use case for that is when you want your album to have a custom thumbnail:
        • An album thumbail 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)
  • Export Mix to File
    • Where available, this item lets you export your mix so that you can further edit it.
  • Refresh Item from File (Album file 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
    • Allows you to move a file up the list.
  • Move Down
    • Allows you to move a file up the list.
  • Delete
    • Only shown if you have a subscription enabled or are using the Annual version.
  • Cancel
    • Cancel out of the pop-up.
19Mix 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 18Mix Actions button.

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

Player: TV

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

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

TV Player
  • A simple 'player' app that, once installed on your TV (Apple TV, Fire TV or Android TV), is launched from the relevant Wotja app icon on your TV.
  • Operates as a 'Flow Player' meaning that it generates a succession of freshly created mixes, but it also lets you repeat the current mix if you so wish (Pro 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 if you are using the free version and the auto-timeout is reached.
  • The music generated, screen background and any text displayed all depend on the various settings in the selected 16Randomization Preset (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.
  • Note: The paid-for iOS and Android apps include a TV player that has no auto-timeout; the free versions all have the Lite Feature Set auto-timeout.

AMenu Bar

The top part of the screen that includes 2 buttons - 1Settings button and 6Next button.

BSettings Panel

A pop-up panel that displays when you select the 1Settings button.

1Settings Button

Displays the pop-up BSettings 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 in the Wotja 22 Pro version it will show an infinity symbol and in the free version it will a countdown timer with a maximum value of 5 mins.

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 16Randomization Preset being used.

8Background/Screensaver

The background used depends on the 16Randomization Preset being used.

9Wotja Watermark

This is where the Watermark displays.

There are different Wotja watermarks for the Wotja 22 and Wotja 22 Pro apps.

10Version number

Displays the version number and copyright statement.

11Feature Set

Displays the active Feature Set (not shown in Wotja 22 Pro version).

In the 'Lite' version 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 tvOS way to enter your Store credentials and the app tries to restore the IAP; if it can, then it updates the table to display the latest IAP state.
12Speech Synthesizer Toggle

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 16Randomization Preset, as some simply do not show text). The text can be Cut-up or TTM text, depending on the Randomization Preset.

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 16Randomization Preset.

15 / Sleep Timer Selector

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.

16Randomization Preset Selector

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

Randomization Presets are not editable in the TV Player.

17App Name

Displays the App Name, this being either "Wotja 22 Pro" for the paid-for version. or "Wotja"/"Wotja 22" for the free version.

Player: Watch

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

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

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 revelant 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 Flow mode playing in the Wotja app for iPhone. You can use the 6Next button to force a new Flow mix to be created.
  • 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 Flow mode playing in the Wotja app for iPhone. You can use the 6Next button to force a new Flow mix to be created.
  • Alternatively, if in Wotja for iPhone you first select a Flow or a Box, a Playlist or Mix file (and then open it) the watch app can control play of that, including moving to the next mix (as relevant).
  • The icon displayed in the 2File Type area will depend on whether Wotja for iPhone is in Flow mode, or has a box/album, playlist or mix 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 default Flow icon and "Flow".
  • Mix:
    • Shows the Wotja icon and name of the mix.
  • User Album:
    • Shows the User Album icon, the number of mixes in the box/album and the name of the box/album.
  • Playlist:
    • Shows the Playlist icon, the number of mixes in the playlist and the name of the playlist.
  • Included Album:
    • Shows the Included Album icon, the number of mixes in the Included Album and the name of the Album.
3File Info

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

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

Where a mix or Randomization Preset 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 will be either Wotja 22 Pro or Wotja 22.

6Next Button

Tap this to move to the next mix in a box/album or playlist in Wotja on your iPhone or to force a new mix to be created in Flow.

Player: Mix File

Documents > 14Mix File.

Tutorial
Mix Player
  • Tip: Once the mix is has been loaded it should open in the last used Edit Mode, below.
  • In the bottom tab bar of the Mix Player is a start/stop button and 5 "Mix Edit" Modes, as below.
    • /Play/Stop button
      • Tap to stop or start your the generative mix (if any) in your wotja.
    • Music Mode
      • The editing mode where you configure your mix, using to 16 Tracks each with 4 Cells, and can edit all parameters of the Intermorphic Music Engine (WME) and Intermorphic Synth Engine (WAE).
    • Text Mode
      • The editing mode where you can create and edit Cut-up and text.
    • Display Mode
      • The editing mode where you decide how you want your wotja to look, this being important should you wish to share it.
    • Plug-ins
      • The editing mode where you set up how you want the mix to use hosted 3rd party Plug-ins (Optional; iOS/macOS and Windows only).
    • Record Mode
      • A special non-editing mode where you can make Audio or MIDI recordings of the open mix, as well as manage and preview them.

Player: Safari App Extension

Wotja Mix or Wotja Box files ("Wotja Files") are actually text files. They have a .wotja or .wotjabox extension, but they can be opened in a text editor.

A Wotja URL ("WJURL") is simply the text in a Wotja File. It is really a kind of deep link and it always starts with wotja://. WJURLs can be as little as 3Kb in size.

Tip: WJURLs are not just for use in webpages! You can paste a WJURL into an email, message or any text-supporting app and a 'Pro' mode user can copy it to the clipboard and then import it into Wotja. No file attachment needed!

The Wotja 22 Safari App Extensions for iOS and macOS are included in the Wotja App Bundle for Apple devices. The extensions are facilitors for the relevant Wotja 22 App in that they allow it to play a Wotja URL that is embedded in a webpage.

WJURL mixes can reference hosted AUv3 Plug-ins (e.g. see Fan Favourites) but to play as intended all AUv3 Plug-ins MUST be already installed on the "player" device!

Web-page embedding WJURLs is a cool, fun and is also an easy way for Wotja users to share with others what they have made - try some examples!

Examples

See the examples.

How to Wotjafy a webpage

Create and save a Wotja mix file (.wotja) or a Wotja Box file (.wotjabox).

Open it in a text editor and copy the text to clipboard or use Export mix to Clipboard - this is the WJURL.

The text includes all the WME and WAE settings required by Wotja to play the file and generate its music and/or reference to plug-ins that the relevant mix might refer to, and need to be present and loaded, for the mix to sound as intended.

Paste the WJURL anywhere in a webpage, even in a weblink (href).

How far you want to take your web page design (e.g. text, images, animation etc.) is entirely up to you.

Tip: Wotjas that include background images are much, much larger than those that don't, and use of plug-ins also adds to size (especially plug-ins that can/do save audio samples to a session). We recommend that if you want to allow people to download such Wotja files then you place them on a separate download page - but that is up to you, too.

Advanced: If content in a Wotja URL references content in an add-on Pak then, provided that Pak is located in your Wotja iCloud Drive folder (iOS/macOS), the content will play as expected.

How to Play in Safari

First: See Requirements.

  1. Enable the relevant Wotja App Extension for Safari:
    • Safari > Preferences > Extensions > set relevant "Wotja" checkbox to on.
      • Tip: If you don't want to enable for this website the Wotja App Extension for Safari (our website does not request or require ANY sensitive information, including passwords, phone numbers and credit cards), you can still download the mixes embedded in each page and play them directly in Wotja.
  2. Launch Wotja:
    • Either tap the app icon on your iOS or macOS device to launch it in the usual manner, or;
    • Web developers: Add an embedded a href link "wotja://command=launchapp" to your webpage.
      • When this link is tapped (try tapping the example link above) it will launch and foreground Wotja provided:
        • The visitor already has Wotja installed, and;
          • Important: If there are multiple versions of Wotja installed then this might actually launch one of those instead. Wotja V22+ is required for the Safari App Extension to work!
        • They select "Allow" in the pop-up message "Do you want to allow this page to open 'Wotja.app'?"
  3. Return to Safari:
  4. To stop Wotja playing:
    • Either open a page that includes the text wotja://command=stop in it, such as this one; or
      • NB: This must be the first WJURL in the page (if you have others) - it can even be hidden, as it is in this page
    • Leave the page (by loading a different Safari tab); or
    • In the Wotja app itself, tap the bottom orange "Stop Safari Extension Player" button; or
    • Tap the plugin icon in the Safari URL bar, tap the entry for the Wotja Safari Extension and in the popup menu tap the "Stop" button.

Music Mode: UI

5 Menu Bar Toolbar Cell Grid Area Tab Bar Mix Editor Area Generator Button Area Generator Synth & FX Button Area Cell, Track & Mix FX Button Area Generator Editor Panel Save/Exit Button Randomize Button Column Lock Button Grid Button Generator Network View Selector Generator Menu Button Cell FX Button Cell Mixer View Selector Track FX Button Mix Name Mix FX Button Track Mixer View Selector Cell Properties View Selector Mix Properties View Selector Action Button Settings Button Cell / Selector Cell Playing Indicator Cell Content Name Cell Content - Generative Cell Loop Indicator Cell Rules Computed Values Cell Content - MIDI File Cell Content - Audio File Play/Stop Button Track Cell Sequencing Button Track Solo Button Track Mute Button Music Mode Tab Generator Button MIDI Channel Assignment MIDI Channel Label Generator Synth Button Generator FX Button

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

Documents > 14Mix File > 29Music Tab

Tutorials
Music Mode

AMenu Bar

Contains the 1Save/Exit, 2Randomize, 15Action and 16Settings button and the 10Screen Title indicator.

BToolbar

Contains the 3Column Lock and 4Grid buttons as well as the 5Generator Network, 8Cell Mixer, 12Track Mixer, 13Cell Properties and 14Mix Properties view selectors.

CCell Grid Area

Shown to the left of the screen the Cells Grid area where you access the 17Cell and Track 26Cell Sequence,27Solo,28Mute Controls.

Tip: To select between a left panel display of One Cell, One Column or 4 Columns tap the 4Grid button and select one of the "Display" settings in the pop-up menu.

DTab Bar

The Tab Bar at the bottom of the screen provide access to the 25Play/Stop button button and the various Mix Editing modes: Text Mode, Display Mode, Hosted Plug-ins and Mix Recording.

EMix Editor Area

Select the Editor you wish to use here with the view selectors in the BToolbar.

FGenerator Button Area

The Generator Editor button area is where all the Generators buttons are shown.

Tip: To access the full screen Generator Editor, double tap (or also right click on desktop) a Generator button and from the pop-up Generator Menu select the "Edit:" item.

See the Wotja Music Engine (WME) for info on all the available parameters.

GGenerator Synth & FX Button Area

This area shows the Generator Synth & FX buttons (i.e. for Synth & FX settings that apply to specific generators). These buttons launch the Synth & FX Editor.

See the Wotja Audio Engine (WAE) for info on all the available Synth & FX units and parameters.

HCell, Track & Mix FX Button Area

This area shows the Cell FX, Track FX and Mix FX Buttons. These launch the Synth & FX Editor.

See the Wotja Audio Engine (WAE) for info on all the available Synth & FX units and parameters.

IGenerator Main Editor Panel

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

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

How to hide/display the Panel

  • Option 1:
  • Option 2:
    • Double tap on a Generator Button30 and select "Show/Hide Generator Editor Panel" from the pop-up menu.
1Save/Exit Button

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

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

Displays the Randomize Menu pop-up:

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

Tap on this button to lock a column to force the play of all cells in that column; tap again to unlock it. Locking of a column only has effect on cells for a Track with Track Rule of type "Sequence" (i.e. the Cell Loop indicator does not show orange). See also: 26Track Cell Sequencing button.

Tip: If you are in "One column" view (see 6Generator Menu Button > "Display: One Column"), then you can see the column number at the top of the IGenerator Editor Panel (assuming you have set it to show).

4Grid Button

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

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

  • Display: One Cell
    • Select this to display in the left area just the selected Content Cell. This is great for when you just want to focus on editing the contents of just one cell, or even to create a complete piece in one Cell (c.f. Noatikl).
  • Display: One Column
    • Select this to display one column of Cells in left area, one that always includes the selected Content Cell. This mode still gives access to the Cell and Track Mixers to set the levels/pans in each Cell and for each Track and is particularly useful if you want to mix together just one column of Cells without Cell sequencing (i.e. a pure generative mix).
  • Display: 4 Columns
    • Select this to display a grid of 4 columns of Cells in left area. It is an overview mode that lets you see how "Cell Sequencing" is working when the Track Rule is set to Sequence. Cell Sequencing can used used to apply a level of arrangement to your mix, allowing spaces for example via empty Cells. It is particularly useful when using loops and if you want to loop different cells that use the same track FX. This mode is also great for "live performance" mixing, too, where you tap/hold a cell to force it to "loop".
  • Show/Hide Generator Editor Panel
    • Default value - Visible: For in-screen editing of a Generator's WME parameters this toggle governs the display or hiding of an optional Generator Editor sub-panel to the right or below (according to device orientation) in the Generator Network Editor panel.
    • Layout:
      • Landscape: The panel is shown to the right of the Generator Network.
      • Portrait: The panel is shown below the Generator Network.
    • Operation:
      • Simply tap/click a Generator button/icon in the Network view to update what is shown in the parameter panel.
      • Clicking the Generator button in the network view on an unfocused Generator will give focus to that Generator and update the panel but doesn’t show the pop-up Generator menu.
      • Clicking on previously focused Generator does show the menu.
5Generator Network View

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

For the selected 17Cell, and ONLY if it contains generative content, the Generator Network View is where you can marry WME Generator Objects (note "Generators") to MIDI channels, WAE synth sounds and FX. The buttons in the network and associated WAE network all provide quick links to the underlying paramaters and editors.

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

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

6Generator Menu Button

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

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

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

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

8Cell Mixer View
Cell Mixer

Music Mode: Cell Mixer
(tap image for large)

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

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

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

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

10Mix Name

The name of the open mix file.

11Mix FX Button

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

12Track Mixer View
Track Mixer

Music Mode: Track Mixer
(tap image for large)

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

Shown in the EMix Edit Area (which is to the right of the CCell Grid Area), the Track Mixer is where you can easily change the volume and pan levels of each of the tracks used in the mix. Double tap a slider for a pop-up menu where you can manually enter a value.

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

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

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

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

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

For full information on the Wotja Music Engine (WME) parameters refer to the WME User Guide.

Cell Properties List

Track Cell Sequencing

  • Sequence/One Shot/Loop
    • Sequence (Default value):
      • When the content in the Track's current cell has finished playing, the next Cell in the track will play (unless it has been forced to loop).
    • One Shot
      • No Track Cell will play UNTIL it has been triggered (it will display the green "play marker" in the middle of the cell). Once triggered, any content will play through ONCE (like a sting) and then the cell will stop playing.
    • Loop
      • No Track Cell will play UNLESS it is forced to loop - either by tap/hold on the cell or by setting the Cell Rules "Loop" value to on. Advanced Tip: Cells in Loop tracks containing Audio/MIDI content will play ONCE when the Column lock is first applied to a Column (if a cell is not already looping); cells containing generative content will be set to play for the length of the mix (∞).

Script

Cell General

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

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

Cell Generative

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

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

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

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

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

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

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

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

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

Cell Info

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

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

The "Mix Properties" panel is where you can easily set the parameters that define how a Mix will play (Mix FX, Root, Tempo, Mix Rules [if used] and also how you can get text to automatically change (Automatic Text Change group).

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

The Duration/Duration Range are specific to that mix only in Playlists.

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

For full information on the Wotja Music Engine (WME) parameters refer to the WME User Guide.

Mix Properties List

Script

Mix General

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

Mix Fades & Playlists

  • Ramp Up: Seconds
    • 1-20 (Default value - 2): This applies when the mix starts to play (also in a Playlist).
  • Duration: Seconds
    • 10-7200 (Default value - 300): This is how long the mix will play for in a Playlist (overridden by Music Play Time).
    • Double tap for a pop-up menu where you can edit the value via on-screen keyboard.
  • Duration Range: Seconds
    • 10-7200 (Default value - 0): A range value added to the Playlist Duration value (overridden by Music Play Time). Double tap for a pop-up menu where you can edit the value via on-screen keyboard.
  • Ramp Down: Seconds
    • 0-20 (Default value - 2): This applies when the mix stops playing in a Playlist.
15Actions Button

Displays the Actions Menu pop-up:

  • Export Mix to Clipboard (no image)
    • Creates the smallest Wotja URL (WJURL) from your mix.
  • Export Mix with Image
    • Creates a Wotja URL (WJURL) from your mix that includes your a background image (if you have selected one).
  • Import Wotja from Clipboard
    • Only shown if you have a Wotja on the clipboard and you will see a message about having to Import a Wotja via the Documents screen (Documents > Add New > Mix (from Clipoard).
  • Script Sandbox
  • Help - User Guide
16Settings Button

Takes you to the Wotja Settings screen.

17Cell / Selector

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

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

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

The middle of a Cell displays the Cell Status band and its green colour indicates the following:

  • Green
    • Playing but not looping.
  • Orange
    • Playing and continuously looping.
  • Grey
    • Playing an empty cell (no sound).
  • White
    • Not playing.
19Cell Content Name

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

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

20Cell Content - Generative

The Cell includes a Wotja Template (see also Templates).

For further information see: 17Cell / Selector.

21Cell Loop Indicator

The middle of a Cell displays the Cell Status band and within that is the name of the file in the Cell. The orange colour of this band indicates the following:

  • Green
    • Playing but not looping
  • Orange
    • Playing and continuously looping
  • Grey
    • Playing an empty cell (no sound)
  • White
    • Not playing
22Cell Rules Computed Values

The bottom of a Cell shows a two line indicator of the Cell's bar "arrangement" values, i.e. how many bars it will play for, and these are presented differently depending on whether the mix is playing or stopped.

The top line of these values shown are the Cell's Generative Bar values.

The bottom line of these values shows the Cell's Cell Repeat Bar values.

  • Mix Stopped
    • Both sets of values are shown with syntax X+Y where X is the set minimum value and Y is the set range.
  • Mix Playing
    • The values for the playing cell are shown with syntax X/Y where X is the calculated minimum and Y is the calculated range value.
  • Infinite
    • The one exception to the above is that if a cell is playing and the Generative Bars value is infinite, an infinite symbol is used for the Generative Bars value.
  • Missing (Red Cell)
    • If audio or MIDI  content referenced in the cell cannot be found then the bottom area displays red. This can happen, for example, if your mix references a loop on your device which you later delete, or you perhaps load someone's piece which references a loop that is not present on your device (i.e. you have not installed the relevant Pak of content).
23Cell Content - MIDI File

The Cell includes a MIDI file.

For further information see: 17Cell / Selector.

24Cell Content - Audio File

The Cell includes an Audio file.

For further information see: 17Cell / Selector.

25Play/Stop Button

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

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

  • Count Down
    • It will count down from some time if you have a Sleep Timer set (e.g 30 mins if you have a 30 minute Sleep Timer), or from 5 minutes if you are using a Lite Feature Set.
  • Count Up
    • It will otherwise count up from 0 so you can see how long the mix has been playing.
26Track Cell Sequencing Button

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

  1. Method 1:
    • Tap the Cell and in the pop-up Cell Action menu select Loop or Unloop.
  2. Method 2:
Values:
  • Sequence (Default value - Shown):
    • When the content in the Track's current Cell is playing it will display the green "play marker" in the middle of the cell. When it has finished playing, the next Cell in the track will play (unless it has been forced to loop).
  • One Shot:
    • No Track Cell will play UNTIL it has been triggered. It will display the green "play marker" in the middle of the cell whilst it is playing. Once triggered, any content will play through ONCE (like a sting) and then the cell will stop playing.
  • Loop:
    • No Track Cell will play UNLESS it is forced to loop and when it does it displays an orange bar in the middle of the cell whilst it is looping.
    • Tip: When using the 2Randomize Button "Randomize" menu functions only the item "Randomize Cell (sticky)" will randomize the Cell.
    • Advanced Tip: Cells in Loop tracks containing Audio/MIDI content will play ONCE when the Column lock is first applied to a Column (if a cell is not already looping); cells containing generative content will be set to play for the length of the mix (∞).
27Track Solo Button

Tap to solo or unsolo the related Track.

  • Gold
    • Soloed.
  • Light grey
    • Not soloed.
28Track Mute Button

Tap to mute or unmute the related Track.

  • Dark grey
    • Muted.
  • Light grey
    • Not muted.
  • White
    • When a track is soloed the M in non-soloed or non-muted buttons shows white to indicate they are temporarily muted.
29Music Mode Tab

The Tab that selects Music Mode.

30Generator Button

Tap on a Generator button to select that Generator. The selected Generator has a red border. If the in-situ IGenerator Editor Panel is displaying then you will see the parameters for that Generator and can edit them straight away in that panel.

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

For full information on the Wotja Music Engine (WME) parameters refer to the WME User Guide.

31MIDI Channel Assignment

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

32MIDI Channel Box

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

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

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

33Generator Synth Button

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

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

34Generator FX Button

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

Generator: Main Editor

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

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

Music Mode > IGenerator Editor Panel

Tutorials
Generator: Main Editor
  • This Music Mode editor lets you edit most of the WME parameter values for each of the Generators in the Cell and provides access to the relevant specialist editor(s) for the remainder. It can be used full screen (as shown above) or in-screen.
  • Full Screen Editor: In the 5Generator Network View tap the 6Generator Menu Button or double tap on a 30Generator Button and select "Edit" from the pop-up menu.
  • In-Screen Editor: In Music Mode, tap the 4Grid Button and in the pop up menu toggle the "Generator Editor Panel" menu item to be "Show Generator Editor Panel".

AMenu Bar

The menu bar contains the 1OK/Back, 5Undo and 6Redo buttons.

BStatus Bar

The Status Bar contains the 7Generator Type Group Shortcut, 9Parameter Group Selector and 2Sequence Item Preset buttons and 3Generator MIDI Ch, Track & Column Details.

1OK/Back Button

Tap to accept your changes and exit the Generator Editor

2Sequence Item Preset Button

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

3Generator MIDI Ch, Track & Column Details

For the currently selected Generator, shows its Type, MIDI Channel, Track Number and Cell Column.

See also: Wotja Music Engine (WME) Parameters.

4Screen Title

Shows the name of the current screen.

5Help Button

The Help Button displays the User Guide in a pop-up window.

6Undo Button

Undo the last parameter change you have made.

7Redo Button

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

8Generator Type Group Shortcut

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

9Parameter Groups Header

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

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

Tip: Tap "Basics" to scroll the Parameter Values panel to the top so you can see the Generator name.

See also: Wotja Music Engine (WME) Parameters.

10Parameter Group Selector

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

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

See also: Wotja Music Engine (WME) Parameters.

11Array Item Editor Shortcut

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

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

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

12Generator Type Specific Group

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

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

See also: Wotja Music Engine (WME) Parameters.

13Selected Parameter Group

The selected Parameter Group shows with a light blue background colour.

14Generator Type Indicator

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

15Array Editor Button

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

16Array Item Button

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

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

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

17Parameter Edit Control

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

Wotja also includes the following specialist Generator Parameter editors:

18Parameter Group Header

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

19Generator Number Selector

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

See also: Wotja Music Engine (WME) Parameters.

Generator: Rule Editor

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

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

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

AMenu Bar

The menu bar contains the 1OK/Back button.

BToolbar

The Tool Bar contains the 13Add Rule, 15Included Rules and 14Rule Actions buttons.

1OK/Back Button

Tap the OK/Back button to accept your changes and exit the Editor.

2Element Playing Indicator

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

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

3Rule Element Selector

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

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

For full information on the Wotja Music Engine (WME) parameters refer to the WME User Guide.

4Screen Title

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

5Interval Label

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

6Mix Rules List

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

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

7Use Mix Properties Mix Rule

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

8Use Random Mix Rule

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

9Mix Rule Selector

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

10Cell Rules List

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

11Cell Rule Selector

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

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

12Selected Rule

The selected (and active) rule has shows with a light blue background.

13Add Rule

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

For the list of included Rules see the following:

14Rule Actions

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

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

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

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

Generator: Envelope Editor

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

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

Music Mode > IGenerator Editor Panel > Generator Groups List > Envelope Parameters (see below).

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

AMenu Bar

The menu bar contains the 1OK/Back button.

1OK Button

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

2Selected Envelope Area

Shows an area that has been selected in Macro Mode.

3Draw Mode

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

4Screen Title

The screen title.

5Macro Mode

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

6Envelope Area

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

7Actions Button

The Help Button displays the User Guide in a pop-up window.

8Macro Selector

The following Macros can be selected:

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

The selected Macro is shown with a light blue background.

Sequence: Array Editor

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

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

Music Mode > IGenerator Editor Panel > Generator Groups List >Sequence Button > Array Editor.

Sequence: Array Editor
  • A Sequence Array is in effect a list one or more Sequence Array Items, each containing all the settings needed for use by one of the Sequence Generator sub-types, these being: Text to Music, Euclidian or Pattern (Both, Rhythm, Fixed).
  • Tip: Note sequences can be used to create hidden structure in a mix. Set up a Sequence Generator with your preferred sub-type and set its volume envelope to be zero, but do not mute it (or it will not count in terms of composition). Then, follow that Sequence Generator with a Generator of type Follow and which has Chords Strategy set to Chordal Harmony. You will never hear the original pattern but it will be used as an invisible skeleton around which to compose! If you do want to hear the pattern, set Follows Strategy to Semitone Shift in the Follow Generator.

AMenu Bar

The menu bar contains the 2OK/Back and 10Cancel buttons.

BToolbar

The tool bar contains the 1Actions, 6Add, 8Up, 9Down and 11Delete buttons.

1Array Actions Button

Displays a pop-up menu with the following options:

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

Tap the OK button to accept changes you have made.

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

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

Uses Text-to-Music techniques for melody generation.

4Probability Indicator

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

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

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

5TTM Text

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

6Add Sequence Item Button

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

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

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

Displays the name of the screen.

8Move Up Button

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

9Move Down Button

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

10Cancel Button

Discard any changes you have made.

11Delete Item

Deletes the selected Array Item.

12Array Item Number

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

13Note Pattern Representation

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

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

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

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

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

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

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

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

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

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

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

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

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

18Array Item - Sequence: Chain (S)

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

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

19Sequence – Chain Syntax

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

20Array Item Action button

Displays the following pop-up menu:

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

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

22Selected Item

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

Sequence: TTM Editor

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

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

Sequence: TTM (Text to Music) Editor
  • This is a special editor for editing parameter values for the Text to Music (TTM) generator sub-type.
  • Refer to the Text to Music (TTM) section of the WME Guide for information on all the TTM parameters and settings.
  • To edit Text used by the 7Cut-Up Rule parameter use the editor in Text Mode.
  • To edit Text used by the 8Custom Text parameter use its own editor below.
AMenu Bar

The menu bar contains the 1OK/Back and 5Actions buttons.

1OK/Back Button

Tap the OK button to accept changes you have made.

2Randomize Button

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

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

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

4Screen Title

Displays the name of this Editor.

5Actions Button

Displays the following pop-up menu:

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

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

7Cut-up Rule Selector

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

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

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

Sequence - Custom Text Editor
(tap image for large)

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

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

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

Menu bar Action button:

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

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

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

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

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

9Parameter Control

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

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

10Value Up/Down controls

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

Sequence: Euc Editor

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

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

Sequence: Euclidian (Euc) Editor
  • This is a special editor for editing parameter values for the Euclidian generator sub-type.
  • Refer to the Euclidian (Euc) section of the WME Guide for information on all the Euclidian parameters and settings.
AMenu Bar

The menu bar contains the 1OK/Back button.

1OK/Back Button

Tap the OK button to accept changes you have made.

2Randomize Button

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

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

3Note Sequence Graphic

Shows a simple representation of the generated note sequence.

4Screen Title

Displays the name of this Editor.

5Action Button

Displays the following pop-up menu:

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

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

7Parameter Control

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

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

8Value Up/Down controls

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

9Duration

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

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

10Rhythm Strategy

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

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

11Pitch Strategy

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

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

Sequence: Pattern Editor

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

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

Access: Generator: Main Editor > 10Array Item Editor Shortcut or Sequence: Array Editor > 21Array Item Selector

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

    Tap image for large

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

    Rhythm (R) Wotja Settings Audio MIDI+ screen

    Tap image for large

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

    Fixed (F) Wotja Settings Randomization screen

    Tap image for large

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


AMenu Bar

The menu bar contains the 1OK/Back, 8Action and 10Cancel buttons.

BToolbar

The toolbar contains the 2Mode, 3Bars, 4Note Length, 6Note Align, 7Undo and 10Redo buttons.

CEditing Area

The area where you edit the pattern.

1OK/Back Button

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

2Edit Mode Button

There are 3 Edit Modes:

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

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

4Note Length Button

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

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

Displays the name of the screen.

6Note Align Button

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

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

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

8Action Button

Tap the button for the following pop-up:

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

Discards changes made since entering the Editor.

10Redo Button

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

11Grid X-axis

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

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

12Grid Y-axis

Pattern Type (see also Pattern Syntax):

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

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

Sequence: Chain Editor

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

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

Access: Sequence: Array Editor > 18Sequence Chain Item

Sequence: Chain Editor

AMenu Bar

The menu bar contains the 1OK/Back, 8Action and 10Cancel buttons.

BToolbar

The toolbar contains the 1Add, 3Move Up, 4Move Down, 6Delete, 7Undo and 10Redo buttons.

1Add Button

Tap to add a new Chain Item.

2OK/Back Button

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

3Move Up Button

Tap to move the selected Chain Item up one.

4Move Down Button

Tap to move the selected Chain Item down one.

5Screen Title

Displays the name of the screen.

6Delete

Tap to delete the selected Chain Item.

7Undo Button

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

8Action Button

Tap the button for the following pop-up:

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

Discards changes made since entering the Editor.

10Redo Button

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

11Chain Header

Shows the Header name, "Sequence Chain".

12Selected Chain Item

The selected Chain item has a light blue background.

13Chain Item Number

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

14Chain Item Number

The range in Array Item numbers.

15Chain Item Repeat

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

16Chain Item Repeat Range

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

SFX Network Editor

Menu Bar Toolbar Unit Editors OK/Back Button Presets Button Randomize Button Synth/FX Network Area Screen Title Polyphony Button Help Button Settings Button Cancel Button Action Button Audio-Rate Unit Audio Signal Path Selected Unit Connector Line Control-Rate Unit Add Controller Button Controller Unit Selector Controller Scale Value Controller Parameter Selector Delete Controller Button Controllers Panel

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

Access: Music Mode > 33Generator Synth button or 34FX button or 7Cell FX button or 9Track FX button or 11Mix FX button

Refer to Wotja Audio Engine (WAE) section for detailed information on all units and their parameters.

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

AMenu Bar

The menu bar contains the 1OK/Back, 8Settings and 9Cancel buttons.

BToolbar

The toolbar contains the 2Presets, 3Randomize, 6Polyphony, 7Help and 10Action buttons.

CUnit Editor

This panel is where you can edit the settings for the selected WAE unit.

Refer to the Wotja Audio Engine (WAE) section for detailed information on all units and their parameters.

1OK/Back Button

Tap the OK button to accept the preset and return to the Synth & FX Editor.

2Presets Button
WAE Synth Presets List

WAE - Synth Presets List
(tap image for large)

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

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

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

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

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

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

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

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

Use of Synth & FX Presets in a Randomization Preset

  • Synth Presets:

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

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

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

4Synth/FX Network Area
Synth & FX Editor Meter - Audio

Meter: Audio
(tap image for large)

Synth & FX Editor Meter - Oscilloscope

Meter: Oscilloscope
(tap image for large)

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

Adding Units
Selecting/ Editing Units
  • Tap the unit whose settings you want to edit in the CUnit Editor, or double tap a Unit button for a pop-up 10Action menu (where the first item in it lets you edit the unit full screen; for an example see Edit Wavetable Full Screen).
  • Note: The Junction unit does not have an editor as it is just sum the inputs of anything feeding it (so nothing happens when you tap on it).
Deleting Units
  • Tap the 10Action Button and select either Delete Unit (which deletes the currently selected unit) or Clear Network (if you want to clear the entire network!).
  • Double tap a Unit button for a pop-up menu where you can also do as above.
5Screen Title

The Title will display the MIDI Channel number (for Generator Sounds or FX), Cell, Track or Mix depending on the context, appended by either Synth or FX depending on whether it is a Synth or FX network.

6Polyphony Button

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

7Help Button

The Help Button displays the User Guide in a pop-up window.

8Settings Button

Tap this button to go to the Settings screen.

9Cancel Button

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

10Actions Button

Displays the following pop-up Actions menu:

  • Save
    • Select to save your Synth Network "Tone Generator" (XML file with extension .tg) or FX Network (XML file with extension .fxm), depending on what kind you are editing.
  • Export to Clipboard
    • Select to export to clipboard your Synth Network or FX Network, depending on what kind you are editing.
  • Import from Clipboard
    • Select to import from clipboard a Synth Network or FX Network.
  • Edit Unit Full Screen
    • Select to edit the selected Unit in a full screen editor.
  • Delete Unit
    • Select to delete the selected Unit.
  • Clear Network
    • Select to clear the entire Synth or FX Network.
  • Help - User Guide
11Audio-Rate Unit

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

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

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

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

13Selected Unit

The currently selected unit has a solid red outline.

14Connector Line

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

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

15Control-Rate Unit

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

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

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

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

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

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

18Controller Scale Value

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

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

19Controller Parameter Selector

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

20Delete Controller Button

Deletes the selected controller unit in the 21Controllers Panel.

21Controllers Panel

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

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

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

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

Controller Editing:

See: 16Add Connector

Text Mode

Menu Bar Screens Top Toolbar Bottom Toolbar Save/Exit Button Cut-up/Edit EOL Rhyme? Toggle Text Sources Screen Title Edit Text Button Saved Text Text Properties Action Button Settings Button Rules Button Text Line Number Text Button Unlocked Text Button Locked Text Area Word Mix Control Use Words Button Text Mode Tab Create Cut-up Button Cut-up Mode Button Text Alternatives Bar Selected Text Button Character Count

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

Documents > 14Mix File > 18Text Tab

Tutorials
Text Mode
  • Text Mode comprises 4 screens: 2Cut-up/Edit, 4Sources, 7Saved Text and 8Text Properties.
  • It is where you create/edit text used in your mix, whether purely for display purposes or also for "Text-to-Music" (TTM) (see the TTM Cut-up Rule).
  • The powerful "cut-up technique" is great for generating ideas for lyrics, poems, haiku etc as it allows you to quickly generate random word associations from a pool of words. This pool can include words from up to 5 user entered text fields ("Sources"), a user word library ("Word Library"), the customisable Wotja Word Bank ("Word Bank") and a non-editable Wotja Word Database ("Word Database").
  • You can lock down ("Lock") any words you want (a locked word will not be changed when you press the 19Create Cut-up Button) or, for just a selected word, choose one of the alternative cut-up words presented. You can use Rules ("Rules") to constrain your cut-up by lines, words and syllables.
  • Keep iterating until you find the interesting, inspiring or serendipitous combinations of words you are looking for. Save the the best Cut-ups ("Saved") and then use in real-world lyrics, poems, haikus, tweets etc.
  • The 2Text or created Cut-up, 14Word Locks, associated 11Text Rules and 7Saved Text are all saved in your Wotja file.
  • For your cut-up you get to choose how many lines and how many words per line you want in it and whether you want Wotja to attempt End of Line (EOL) rhyming.
  • Important: We respect copyright and strongly encourage you to do the same. That means if you use Wotja to come up with a lyric you like, make sure that it does not infringe the copyright of any of your source material. Wotja is pretty good at creating random "cut-ups", but it is just a tool for you to use to generate ideas. It is ultimately your responsibility to make sure you are not infringing anyone elses copyright.

AMenu Bar

Contains the 1Save/Exit, 9Action and 10Settings button and the 5Screen Title indicator.

BScreens

There are four Text Mode screens.

CTop Toolbar

Contains the 11Rules Button, 3EOL Toggle and 6Edit Text button and the 23Character Count indicator.

DBottom Toolbar

Contains the 16Word Mix control, 17Use Words button, 19Create Cut-up button and 20Cut-up Mode button.

1Save/Exit Button

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

2Cut-up/Edit Screen

This is the screen shown in this Schematic.

3EOL Rhyme? Toggle

Default Value: Setting in the currently selected Randomization Preset

Values: On/Off

Setting determines whether Wotja, when creating a Cut-up, attempts to rhyme the ends of lines with other lines. For true, random, cut-up, then you would leave this set to EOL - OFF.

4Sources Screen
Wotja Text Mode: Sources Screen

Text Mode: Sources Screen
(tap image for large)

This is where, for each mix, you input and store all the custom (i.e. non-Library) text you want to be used as a source in that mix for a Cut-up. The sources are saved in the your Wotja file and you can have up to 5 of them.

To select the Source field, tap the top "Source: #" control for a pop-up menu (shown above).

The Source text area is editable and supports plain text only. You can move words around by cutting and pasting, or even edit or manually add in new words.

Tap to clear the text from the currently selected Source.

Actions button menu:

  • Export Source to Clipboard:
    • Exports the currently selected source.
  • Export all Sources to Clipboard:
    • Exports all 5 source fields to the clipboard.
  • Import Source from Clipboard:
    • Imports what is on the clipboard to the currently selected source.
  • Help - User Guide

Tip 1: The more interesting the source material you use, the more interesting the cut-up suggestions generated. You can think of your favourite source materials like spices or ingredients, and then build up a collection of your favourites to add when you want. You can then add as little or as much as you like!

Tip 2: Why not try using text from some current news item as a Source - that way you can make sure you use words that are current, and some interesting themes can seemingly come out of nothing!

Tip 3: The more words there are in your Sources the more options for cut-ups.

Tip 4: To use the "Sources Only" cut-up mode requires that you have at least one source defined.

5Screen Title

Displays the name of the Text Mode Screen you are in.

6Edit Text Button
Text Mode - Text Editor

Text Mode: Edit Screen
(tap image for large)

Found in the top toolbar, the "Edit Text" button takes you to a full screen text editor where you can manually edit and enter text. This is so you can change a word in a cut-up or add new words or even replaces with your own words (in both cases a suitable new matching Rule will be generated).

When you have finished editing your text then press "OK" or "Cancel" to return back to the Text "Edit & Cut-up" screen.

Note: When you have changed the number of words in any line and exit this screen you will be presented with a pop up message of "Change the Rule?". Select "Yes" if you want a new rule to be created to match your words (this is important if you want to use that word arrangement for new cut-ups).

7Saved Text Screen
Text Mode: Saved Text Screen

Text Mode: Saved Text Screen
(tap image for large)

This is where you can see all the Text or Cut-ups ("Text Items") you have chosen to save. These are saved in your Wotja file.

Tap a Saved Text Item to select it - a grey background indicates the currently selected item in the list.

Each Saved Text Item includes the text and all text locks that were used. At the top right of the item is displayed the Rule used for the text and a character count showing the total characters and the line characters in brackets after that.

The Edit button copies the selected Saved Text Item to the Cut-up & Edit screen, replacing what is there.

Tip: The Automatic Text Change > Use Saved Text toggle allows Saved Text Items to be used in a very creative manner in a mix. When the above toggle is on, your mix can sequentially display Saved Text Items according to the various Change settings, instead of randomly generating a cut-up. Any words in your Saved Text Items that are not locked will be randomized just as it if was a cut-up.

The Action button displays the following pop-up menu:

  • Edit:
    • Copy the selected Saved Text Section to the "Cut-Up & Edit" screen for editing.
  • Move Up/Down:
    • Use these buttons to change the order of Saved Text Sections.
  • Delete:
    • Delete the selected Saved Text Section.
  • Saved Text to Clipboard:
    • Copies the selected Saved Text Item to the Clipboard.
  • All Saved Text to Clipboard:
    • Copies all Saved Text Items to the Clipboard.
  • Append Sections from Clipboard:
    • Populate your Saved Text with something you have created in a text editor.
    • Tips: Use a blank line to separate sections; use a <br> if you want a blank line within a section.

      Example 1 - two sections

      This is section 1
      
      This is first line of section 2
      This is last line of section 2
                

      Example 2 - four sections

      This is this is section 1
      
      This is section 2
      And this last line of section 2
      
      Yeah! - this is section 3
      
      Wow - this is section 4
      <br>
      With two lines
                
  • Help - User Guide
8Text Properties Screen
Text Mode: Text Properties Screen

Text Mode: Text Properties Screen
(tap image for large)

For each mix, this is where you set how you want text to be used by the mix, and how Text to Speech is used.

Text Properties List

Mix Automatic Text Change

  • At Mix Start
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: On/Off
    • This setting allows a new mix cut-up to be created automatically on mix start.
  • Change After Seconds
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: 3-1000
    • This mix setting allows a new mix cut-up to be created automatically after a certain time, specified in the parameters below.
  • Seconds Between
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: 3-1000
    • If the Change After Seconds toggle is on, this determines the minimum time before a new cut-up is generated.
  • Seconds Between Range
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: 3-1000
    • The range in value that can apply to the above time.
  • Use Saved Section Text?
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: On/Off
    • When on, this setting allows your mix to sequentially display Saved Text sections according to the Change settings above, instead of randomly generating a cut-up.
    • Tip: Any words in your Saved Text sections that are not locked will be randomized just as it if was a cut-up.
  • Use Saved Text: Random Sequence?
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: On/Off
    • When on as well as the setting above, this setting allows a Saved Text section to be selected at random, rather than sequentially.

Text to Speech: On/Off

  • Speech Enabled
    • Text to Speech (TTS): iOS 13+; macOS 10.14+; tvOS 13+ only
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: On/Off
    • This must be toggled on for you to hear TTS, as well as Use Speech Synthesizer being toggled on in Settings.
    • Text to Speech is based around a concept of Speech Voices and Locales.
    • How TTS works:
      • Speech Voice
        • Every voice has a unique name (e.g. Daniel), and this has a particular sound.
        • Every Voice is associated with a specific Locale (e.g. English - US).
      • Locale
        • Every Locale is represented by one or more Voices (e.g. there is more than one English - US voice).
        • Every Locale e.g. English - US - might have 1 or more regional variations (e.g. English - GB).
      • Speech Voice Change
        • You define when Wotja chooses which Voice to use moving forwards, by the "Voice Change" property.
        • The "Voice Change" (Manual, Automatic etc...) defines *when* a new Voice changes.
        • NB if Manual is set, then the last selected voice will be used when mix next re-opened.
      • Speech Voice Selection
        • You define the Voice to use by a variety of Filters, based around Name, Locale, Locale variations and Gender (requires iOS 14.3+, tvOS 14.3+ and macOS TBA).
        • If you want to, you can force a Wotja Mix to always use a specifically named Voice.
        • Alternatively, you can set the Voice name to be "Random"; in which case, your Voice is selected at random according to whatever Locale you specify (which might in turn be "Random", or could be (say) "English US").
        • If you're selecting a voice at random, for a given locale; you can allow the Voice to be selected from the pool of all regional variations of the locale you've specified; e.g. rather than just English (US), you might allow *all* English regional variations.
        • NB: Every voice is identified by it's name. Every voice is also associated with one locale. Every locale might have zero or more voices associated with it. Where we dispaly the voice name list, we display the locale alongside it (so you can see that (say) Daniel has locale of en-gb); otherwise, it'd be impossible to really understand the operation of the various Locale rules.
        • NB: If Speech Name is set to anything other than "Random", we disable the other Filter cells (locale name, locale regional variations switch and gender)
      • Style
        • If you set Style to Speak, each *line* of text has rate/volume/pitch applied to it.
        • If you set Style to Sing or Speak, the rate/volume/pitch are applied at the Word level.
      • Pitch/Rate/Volume Sliders
        • Volume slider:
          • 0 : quietest speech
          • 50: middle point (neutral)
          • 100: loudest speech
          • Wotja selects a volume between the Volume, and Volume + Volume Range.
          • Wotja applies a further random variation across words, if Style is Speak or Sing.
        • Rate slider:
          • 0 : slowest speech
          • 50: middle point (neutral)
          • 100: fastest speech
          • Wotja selects a rate between the Rate, and Rate + Rate Range.
        • Pitch slider:
          • 0 : halve the pitch (shift down by up to 1 octave)
          • 50: middle point (neutral pitch)
          • 100: double the pitch (shift up by up to 1 octave)
          • Wotja selects a pitch between the Pitch, and Pitch + Pitch Range.
          • Wotja applies a random variation across words, if Style is Sing.
          • Pitch slider effect is harder to hear when you have the "Sing" option, because the Pitch slider is used as an overall scale to shift in additional to any pitch changes generated by the engine, and unfortunately the internal "pitch" property in iOS/macOS actually only works in a rather narrow range of 2 octaves; any pitch values outside of this are clamped.

Text to Speech: Voice Selection

  • Voice Name
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: List of values
    • Select the voice you want or set to Random.
    • Note: If on loading a mix a specifically named speech voice isn't found (e.g. macOS voice, not present on your iOS device or vice veras) we use the system voice instead.
    • Refer to Text to Speech section above.
  • Language
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: List of values
    • Can only be set if Voice Name is set to Random.
    • Refer to Text to Speech section above.
  • Allow Regional Variations
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: On/Off
    • Can only be set if Voice Name is set to Random.
    • Refer to Text to Speech section above.
  • Speech Gender
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: Any; Male; Female
    • Can only be set if Voice Name is set to Random.
    • Requires iOS 14.3+, tvOS 14.3+ and macOS TBA.
    • Refer to Text to Speech section above.

Text to Speech: Other

9Actions Button

Popup Actions menu:

  • Lock All:
    • Locks all words in the Text.
  • Unlock All:
    • Unlocks all words in the Text.
  • Save Text / Save Text (x/y):
    • Save Text: Displayed if your Saved Text list is empty; Select this to save your Text to the Saved Text list.
    • Save Text (x/y): Displayed if you are editing Text (x) from the Saved Text list of (y) items; Select this to replace that Text with your amended Text. Example: Say you have 3 sections of Saved Text and you are editing the second one. The menu item will then display Save Text (2/3).
  • Append New / Append to Saved:
    • Append New: Displayed if there are no Saved Text sections; Select this to save your Text as the first Saved Text section.
    • Append to Saved: Shown when you have already some Saved Text sections; Select this to appended your Text as a new Text section at the end of the Saved Text list.
  • Export Text to Clipboard:
    • Exports the Cut-up to the clipboard (i.e. so you can share it e.g. in a message, email, chat, instant message or other communication etc.).
  • Import Text from Clipboard: Imports a Cut-up from the clipboard.
    • Any "non-breaking space" is replaced with normal space to prevent very confusing behaviour when subsequently toggling word locking.
    • All imported/edited words are locked by default
  • Export Mix to Clipboard:
    • Exports the Mix to the clipboard (without background image).
  • Export Mix with Image:
    • Exports a Mix from the clipboard with to include any background image.
  • Help - User Guide
10Settings Button

Takes you to the Settings screen.

11Edit Rules Button

Default Rule: Uses value in the currently selected Randomization Preset

Values: Various included; user customised

The Rules Button button displays the Cut-up Rule ("Rule") currently being used to create cut-ups. If it has a name then that will also be shown, otherwise you will see the Rule Syntax (below).

  • Tap on the Rules button to go to the Rules List (below) where you will see a list of all the Rules available for selection - simply tap on a rule to select it for use.
  • Tap on a Cog Button in the Rules List to go to the Rule Editor (below).
  • To add Rules see "How to Add/Edit Rules" (below).

Tip: Rules are stored in a Wotja file. When you create a new Cut-up then the Rules List is populated with the default rules. The cut-up uses only the rule you select and you can delete any of these rules you don't want to be used for cut-up.

Use of "Custom Rule" field in Randomization Presets

  • Tap on the "Cut-up Rules" RP item and select "Custom Rule" from the drop down Rule List to be shown the Rule Editor screen where you can enter your rule.

Rules List

Text Mode - Rule List

Text Mode: Rules List
(tap image for large)

See also the Rule Syntax.

  • Tap a Rule to select it.
  • Tap the Cog Button to the right of it for the Rule Editor.
  • Action Button pop-up menu:
    • Add Rule:
    • Move Up:
      • Move the Rule item up.
    • Move Down:
      • Move the Rule item down.
    • Delete:
      • Delete the Rule item.
    • Export to Clipboard:
      • Select to export all rules to the clipboard.
    • Import from Clipboard:
      • Select to import rules that are on the clipboard. Wotja ensures there are no duplicates.
    • Prune Rules:
      • Remove all rules from the list that are not actually used in this Wotja file.
    • Use Default Rules:
      • Replace all the rules in your Wotja file with the default rules (use carefully!).

Rule Editor

Text Mode - Rule Editor

Text Mode: Rule Editor
(tap image for large)

See also the Rule Syntax.

  • Rules Field: This is editable.
  • Title Field: This is editable.
  • Line Summary: This displays the word and syllable count for the line. Tap the line to expand it so you can use the sliders to change the rule values.
  • Slider controls:
    • Words Minimum: The minimum number of words in the line of cut-up.
    • Words Maximum: The maximum number of words in the line of cut-up.
    • Syllables Minimum: The minimum number of syllables in the line of cut-up.
    • Syllables Maximum: The maximum number of words in the line of cut-up.
  • Action Button pop-up menu:
    • Add: Add a new line to the Rule.
    • Move Up: Move the Rule line item up.
    • Move Down: Move the Rule line item down.
    • Delete: Delete the Rule line item.

How to Add/Edit Rules

  • Add New Rule (4 4 4 4):
  • Add New Custom Rule:
    • Tap the Text Edit Button5 and in the Text Editor screen type any old text for the kind of rule you want (where any single letter counts as a word, you do not have to type full words), e.g.:
      A A A A A 
      A A
      A A A
      would be a "5 2 3" rule. On leaving the screen select Yes in the "Change the rule?" pop-up.
  • Add New Custom Rule:
    • Create a Rule in any text editor (e.g. 3 5 6 6), copy it and then from the Action Menu select "Import All from Clipboard".
  • Add New Custom Rule:
    • Create a Rule in any text editor (e.g. 3 5 6 6), copy it and then paste it into the Rule Editor "Rule" field.
  • Edit Rule:

Cut-up Rule Syntax

A basic Cut-up Rule is very simple - it is just a text string that consists of a series of numbers. Each number stands for the number of words to put in a particular line of the cut-up. For example, the four spaced numbers 3 4 5 6 would represent four lines of cut-up. The first line would have three words, the second would have four words, the third would have five words, and the fourth would have six words.

Line Rule Syntax - Advanced

Tip: Items in [ ] are optional.

LineWordsMin [- LineWordsMax[:SyllablesMin [-SyllablesMax]]]

Composite Syntax

LineRule1 LineRule2 LineRule1 [title:"Name"]

Using the above syntax it is easy to create a Haiku rule with 3 lines of words within a range and and fixed number of syllables of 5,7,5 for those lines. e.g.:

1-5:s5 2-7:s7 1-5:s5 title:"Haiku"

12Text Line Number Button

A button that shows the line number of the Cut-up (see also Rule Syntax).

Tap the button to perform a Cut-up on just that line. Word locks are respected.

13Text Button Unlocked

An unlocked word (shown) can be replaced whenever a new cut-up is created (e.g. tap the Create Cut-up Button). Tap a word to lock or unlock it.

14Text Button Locked

An locked word (shown) will not be replaced when a new cut-up is created (e.g. tap the Create Cut-up Button). Tap a word to lock or unlock it.

15Text Area

The text area is where your cut-up (text) is shown.

Lines are alternatedly coloured so that if your Text wraps you can easily see which line the words are in.

Tap a word to lock or unlock it (it shows in blue when locked). When you select a word (locked or unlocked) it also underlines it to show that it is the selected word (e.g. "Text-to-Music" in the screenshot above). To select a word without changing its lock state tap on it and then drag away from it and release. Even though the word does not display an underline, it is now selected.

16Word Mix Control

Default Value: Uses value in the currently selected Randomization Preset

Values: 0-100 [set manually]

The position of the Word Mix slider determines what proportion of words are selected from your Sources or from the User Library and/or Wotja Word Bank.

Left means use words only from Sources, and right means use words only from your Word Library. Any where in between is a blend!

17Use Words Button
Text Mode - Use Words

Text Mode: Use Words Button
(tap image for large)

Default Value: Uses value in the currently selected Randomization Preset

Values:

  • Sources + User Library (S+U):
    • Your wordpool for cut-up includes Sources and the User Library.
  • Sources + Libraries User & General (S+UG):
    • Your wordpool for cut-up includes Sources as well as the User Library and General Library.
  • Sources + Libraries User & Wotja (S+UW):
    • Your wordpool for cut-up includes Sources as well as the User Library and Wotja Library.

Tap the "Use Words" Button to select what words you want to be available in the "wordpool" available for selection when creating Cut-ups.

Tip: The Randomization Preset includes the "Text for Source #0" field into which you can enter text that you wish to be added to Source #0 whenever an auto-mix or flow is created using that Randomization Preset. If you set Word Mix to 0, then these words are your entire word pool for cut-up. You can use this if you wish to share your Randomization Preset and you will know the recipient will experience cut-up as you intend it.

Sources

  • 5 Sources fields
    • 5 user editable fields that are stored in the mix file. To edit these, tap the Sources Segment Control and select the Source you want to edit.

Word Libraries

  • User Library:
    • A user-editable text library that can contain your own favourite words ("spices"). It is stored in Wotja, i.e. not stored in a mix file. To edit it, tap the "Use Words" button and select "Edit User Library".
  • General Library:
    • A user-editable library of over 650 words included in Wotja. It is stored in Wotja, i.e. not stored in a mix file. To edit it, tap the "Use Words" button and select "Edit General Library".
  • Wotja Library:
    • A large non-editable library of older stranger words which when used can lead to some interesting results!
18Text Mode Tab

The Text screens are only available in Text Mode.

19Create Cut-up Button

Provided you have first added some words to at least one of the Sources text boxes above (or you have some words in your User Library or the Wotja Word Bank toggle is on AND the Library slider is not hard over to the right) then when you click this you'll see a Cut-up appear in the text area. Each time you click this button all non-locked words will be replaced by words selected at random from your word pool and/or Library/Word Bank.

20Cut-up Mode Button

Tap the Cut-up Mode button to choose how your cut-up is created.

  • Word Lock (WL):
    • In this classic mode, words can be locked, and the non-locked words are changed using the active rule (including syllables), and are sourced from Sources text, User Library and any Word Bank data you might have defined. This mode is very useful for fine-tuning a cut-up.
  • Sources Only (SO):
    • This new cut-up mode analyses the structure of the Sources text and lets you create cut-up with a more natural feel; in this mode the cut-up is created from Sources ONLY and it uses the active rule (ignoring syllables) but EOL rhyming and word locks are ignored.
  • Edit Text; no Cut-up (ET):
    • Word locking doesn't apply in this mode so the cut-up button is shown greyed out.
    • The text is treated as just plain text and punctuation is retained.
21Text Alternatives Bar

This is displayed just above the bottom toolbar. If you tap on one of the four alternative words (e.g. "restful" in the screenshot above) then that word will replace the selected word (e.g. "Text-to-Music" in the screenshot above). To refresh the alternative words shown, either tap a blank part of the cut-up area or tap the Create Cut-up button.

22Selected Text Button

The selected word is indicated by an underscore.

23Character Count

Displays the number of characters in your Cut-up (useful to know if you plan on tweeting your Cut-up) and number of syllables in each line.

Display Mode

Menu Bar Toolbar Save/Exit Button Show Button Screen Title Display Properties Button Action Button Settings Button Screen Background Screen Text Area Wotja Watermark Display Mode Tab

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

Documents > Mix File14 > Display Tab10

Display Mode
  • ShowWotja Display Show screen

    Tap image for large

    The "Show" segment is where you can see or preview how things will look, and you can also go full screen from the Action menu.

    Properties Wotja Display Properties screen

    Tap image for info; Tap here for large

    The "Properties" segment is where you set how Wotja displays text and whether the background is a solid colour/images/screensaver/visualiser etc.


AMenu Bar

Menu Buttons: 1,5,6 and 3.

BToolbar

Toolbar Buttons: 2,4.

1Save/Exit Button

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

2Show Button

Shows the screen with the current Display Property settings.

3Screen Title

Displays the name of the screen. This is "Display" as there is only one screen in Display Mode.

4Display Properties Button

The Display Properties screen is where you can easily set the Display Properties that define how a Mix will display when played (whether in a Flow, Album, Playlist or Mix).

Tip: If you want to export an imageless (i.e. small) wotja to clipboard for embedding in a webpage, then from the Action menu select "Export Mix to Clipboard".

5Action Button

Popup Action menu:

  • 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: 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]
    • 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 Mix to Clipboard
    • Exports the Mix to the clipboard (without background image).
  • Export Mix with Image
    • Exports a Mix from the clipboard with to include any background image.
  • Help & More
    • Takes you to the relevant section of the User Guide.
6Settings Button

Takes you to the Wotja Settings screen.

7Screen Background

This displays either a solid colour, a screensaver or a background image depending on what has been selected in the Background Image/Screensaver properties.

8Screen Text Area

The text area can display either Cut-up, TTM text or no text at all. See the settings in the Text Display Mode property.

9Wotja Watermark

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

10Display Mode Tab

The Display Mode is accessed via this Tab Bar button.

Display Properties

  • Text Color
    • Default Value: White/black as set by the palette selected in the currently selected Randomization Preset
    • Values: Any RGB/HSB [set manually]
    • Selecting the menu item displays a pop-up color wheel where you can set the text colour (RGB or HSB).
  • Text Display Mode
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values:
      • Show Cut-Up Text
        • If there is any Cut-up Text used in the mix then show it on screen. This text is also used in the icon thumbnail in the Documents screen.
      • Show TTM Text
        • If there is any TTM Text used in the mix then show it on screen. This text is also used in the icon thumbnail in the Documents screen.
      • Hide All (Use Cut-up Text for Speech)
        • Hide all text but still use Cut-up for Text to Speech.
      • Hide All (Use TTM Text for Speech)
        • Hide all text but still use TTM Text for Text to Speech.
  • Background Image/Screensaver
    • The ordering below reflects that of the graphics layer stacking order (i.e. the order in which graphic elements are composited), the top most graphics layer setting (i.e. text settings) being at the top of the list and the bottom graphics layer (i.e. background color) being at the bottom.
    • Important: It may be a bit confusing, but for now there one data field for the "background image" and it can contain either a bitmap image (e.g. photo), the settings for a screensaver or a SVG (with/without transparency). If you select one it replaces the data for whatever was previously being used. Likewise, if you use Clear (below) you remove whatever data is in that field.
    • Browse Images
      • Values: User selected [set manually]
      • Select a bitmap image or SVG using Finder/Explorer/Files.
      • See the Tutorials and the Included Album Calm or Relax for an example of use of an SVG with transparency.
    • Select SVG (iOS only)
      • Values: User selected [set manually]
      • Select an SVG from any that are available in the Wotja iCloud Folder and use that as the background image for your mix.
      • SVG images can include transparency/opacity in which case a Visualizer and/or Background color below it can also been seen.
      • See the Tutorials and the Included Album Calm or Relax for an example of use of an SVG with transparency.
    • Select Palette
      • Default Value: Uses value in the currently selected Randomization Preset; see also Random Screensaver below
      • Values: Included palettes (below); Random (only in RP; means select a palette at random)
      • The Screensaver Palette determines the colours available for use by the screensaver which can be seen in Flow Mode, Play Screen and Full Screen. It can also be seen in Display Mode, but in that you can use the Background images/screensaver menu item to override it either with an image or clear it so you can instead use a background color.
      • Palettes have an opacity setting of about 25% which allows the lower layer background color to also have an affect.
      • When creating an auto mix or creating mixes for an auto box the values of the Screensaver Palette are used for the mix file's auto-generated thumbnail (unless you have chosen an image or background color, see Browse Images and SVG above).
      • There are 35 palettes included, see below:

        Awesome listen   lighttext  
        - - - - - -
        Been painting   lighttext  
        - - - - - -
        Black gold   lighttext  
        - - - - - -
        Bold space   lighttext  
        - - - - - -
        Breathe slow   lighttext  
        - - - - - -
        Citrus zest   darktext  
        - - - - - -
        Comforting cotton   darktext  
        - - - - - -
        Deck chair   lighttext  
        - - - - - -
        Deep thought   lighttext  
        - - - - - -
        Drifting upbeat   lighttext  
        - - - - - -
        Flow Go   lighttext  
        - - - - - -
        Flutter words   lighttext  
        - - - - - -
        From imagination   lighttext  
        - - - - - -
        Hedge row   lighttext  
        - - - - - -
        Ideal discover   lighttext  
        - - - - - -
        Incredible relation   lighttext  
        - - - - - -
        Inventing decision   lighttext  
        - - - - - -
        Lilt dimension   darktext  
        - - - - - -
        Look light   darktext  
        - - - - - -
        Love heart   lighttext  
        - - - - - -
        Mono chrome   lighttext  
        - - - - - -
        Noodle safe   lighttext  
        - - - - - -
        Ocean travel   lighttext  
        - - - - - -
        Pastel healing   lighttext  
        - - - - - -
        Pebble vision   lighttext  
        - - - - - -
        Rainbow 12 (1-6)   lighttext  
        - - - - - -
        Rainbow 12 (7-12)   lighttext  
        - - - - - -
        Rainbow 6 cool   lighttext  
        - - - - - -
        Rainbow 6 warm   lighttext  
        - - - - - -
        Random hand   lighttext  
        - - - - - -
        Reflecting time   lighttext  
        - - - - - -
        Sun flower   lighttext  
        - - - - - -
        Teal leaves   lighttext  
        - - - - - -
        That filter   lighttext  
        - - - - - -
        Value union   lighttext  
        - - - - - -
        Vibrant feeling   lighttext  
        - - - - - -
        Wander happiness   lighttext  
        - - - - - -
        Why incredible   lighttext  
        - - - - - -
        Winter scene   lighttext  
        - - - - - -
        Wood finish   lighttext  
        - - - - - -
    • Random Screensaver
      • Default Value: Uses value in the currently selected Randomization Preset
      • Values: None/Blobs/Geometric [style]
      • For an example of the screensaver see the Video Feed Tutorial.
      • Important: If you select this menu option, be aware this it replaces replaces whatever "background image" is currently in use, be that a screensaver, bitmap image or SVG, and it will use the "style" as set in the Randomization Preset.
    • Clear
      • Removes any image, screensaver or visualizer data associated with the mix (but not the palette data).
  • Image Autopan
    • Values: Enabled/Disabled [set manually]
    • If one has been added to the mix, this allows auto-panning of any background bitmap image.
  • Visualizer
    • Default Value: Uses value in the currently selected Randomization Preset
    • Values: None; Lattice; Vortex
      Wotja Visualizer - Lattice
      Wotja Visualizer - Lattice
    • The visualizers use the palette defined above.
    • They are "music sensitive" in that notes generated by the WME do affect them, but not in a direct linear (note-by-note) fashion.
    • For an example of the Lattice visualizer see the Video Feed Tutorial.
  • Background Color
    • Default Value: Black
    • Values: Any RGB or HSB value [set manually]
    • Selecting this menu item displays a pop-up color wheel where you can set the text colour (RGB or HSB).

Plug-in Hosting

Menu Bar Save/Exit Button Plug-in Scanner Button File Tab Plug-in Chain Active Indicator Plug-in Chain Selector Screen Title Plug-in Chain Header Master Plug-in Chain Action Button Settings Button Wotja Track Filter Control MIDI Filter Control Plug-in Icon Chain Slot Selector Chain Volume Level Control Plug-ins Tab Chain Bypass Toggle Chain Slot Menu

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

Documents > 14Mix File > 15Plug-ins Tab

Hosted Plug-ins
  • The Wotja App [but not Plug-in] supports Plug-in Hosting (iOS, macOS, Windows variants).
  • Plug-ins are "external" to the main Wotja App and can be in AUv3 format (iOS 14+, macOS 10.15+) or VST3 format (Windows 10/11) - see Requirements.
  • 5 "Chains" of Plug-in Instruments / FX are supported and each Chain has 4 "Slots".
  • The first "Slot" in a Chain is for the "Instrument" Plug-in, be this the "Wotja Output" 'Instrument', or a 3rd party Instrument Plug-in. The other 3 slots are for FX Plug-ins.
  • By default, the "Wotja Output" 'Instrument' uses output from the Mix FX (i.e. for ALL Wotja Tracks). Use the Wotja Track Filter to specify only those tracks that you want to process in the Chain. This can also be used in conjunction with the MIDI Event Filter below.
  • The Instrument Plug-in you select gets its MIDI data from all MIDI data delivered by all Wotja tracks. Use the MIDI Event Filter to filter what MIDI is to be used, e.g. only MIDI channel 2 from e.g. only Wotja Track 4.
  • The 6th Chain is an optional "Master FX Chain", where you can have zero, 1 or more FX that are applied the summed output of all Instrument chains.
  • If you have 2 or more Chains set-up, then simply adjust the relative outputs from the two chains using the Sliders at the bottom of the chain - they're all added together.
  • Plug-ins are applied as a 'post process' to all the other work that Wotja does, so your Mix still stands alone and works even without those Plug-ins present
  • Recordings made via the Recording tab also capture the output from Plug-ins (i.e. the Recording should be what you hear).
  • Mixes that reference Plug-ins should play as expected in albums and playlists - provided of course that the relevant Plug-in is available to Wotja on your device!
Usage

AMenu Bar

The Menu Bar contains the 1Save/Exit Button, 2Plug-in Scanner Button, 9Actions and 10Settings buttons.

1Save/Exit Button

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

2Plug-in Scanner Button

Tap this at any time to show the Plug-in scanner screen, below:

Wotja Mix Plug-ins Scanner

Plug-in Scanner Screen
(tap image for large)

  • Back Button
    • Tap to return to where you came from.
  • Scan Button
    • Tap for the "Scan for Hosted Plug-ins?" pop-up.
        Wotja Mix Plug-ins Start Scan popup

        Plug-in Scanner "Scan for Hosted Plug-ins?" popup
        (tap image for large)

        Wotja Mix Plug-ins Scanner Failed sandboxSafe

        macOS: Failed Validation (Sandbox Safe) pop-up
        (tap image for large)

      • When the scan is underway the Plug-in Scanner "Screen Title" area changes to show which Plug-in is currently being scanned.
      • When completed you will see the list of available Plug-ins, alphabetically sorted on manufacturer name, and below that a "Blocked Plug-ins" list of any Plug-ins that have failed validation or that you have Blocked using the Block button below.
      • macOS: A pop-up menu (see above image) lists any Plug-ins that have failed because they are not "Sandbox Safe". To notify a Plug-in developer of this issue, use your mouse to select the name of the failed Plug-in and copy it to the Clipboard. Then, for next steps, see this FAQ: What is a "Sandbox Safe" Audio Unit Plug-in on macOS?.
  • Block Button
    • Tap for the "Select Plug-ins to Scan / Block" Screen.
    • Wotja Mix Plug-ins Scanner

      Select Plug-ins to Scan / Block Screen
      (tap image for large)

    • Plug-ins that fail to scan are put in the Block list automatically; this will happen even if Wotja crashes while scanning.
    • If a Plug-in crashes a little bit later we cannot catch this automatically. If this happens, you need to block what you think is the crashing plug-in manually:
      • Restart Wotja, move the plug-in to the "Block" list, and try another scan.
      • Repeat until you?ve found the problem plug-in.
    • To manually block a Plug-in, tap its right side Actions button and select "Block Plug-in".
    • To unblock a Plug-in, in the "Blocked Plug-ins" section at the bottom (blocked Plug-ins are shown in red) tap its right side Actions button and select "Unblock Plug-in".
    • Blocked Plug-ins are not scanned.
  • Actions Menu Button
    • Re-Scan Plug-ins.
    • Reset Blocked Plug-ins list, and Re-scan.
  • Settings
  • Plug-in List
    • Plug-ins
      • This shows the names of all the Plug-ins that have been scanned and passed validation.
      • These are the Plug-ins available for you to use in Wotja.
    • Blocked Plug-ins
      • Shown below the above, this displays in red the names of any Plug-ins that have failed validation and that are thus not available to use, or that you Blocked using the Block button above.
        • macOS note: The pop-up Failed Sandbox Safe message above shows only after completing a scan, and then lists only those Plug-ins that are not marked as Sandbox Safe (and which cannot thus be used in Wotja).
3File Tab Button

Only shown in Desktop version, File tab buttons allow for a number of files to be open at the same time.

4Plug-in Chain Active Indicator

This indicator displays green for any "Chain" that uses one more Plug-ins.

5Plug-in Chain Selector

Tap any Chain selector to scroll that Chain to the top and underline that Chain number.

6Screen Title

Displays the name of the screen.

7Plug-in Chain Header

Shows the Chain number, i.e. "Plug-in Chain #1" or "Plug-in Chain #2".

8Master Plug-in Chain

Chain #6 is a Master FX chain. It allows you to apply, as relevant, AUv3/VST3 FX to the summed outputs of all the other Chains you have set up.

It can use zero, 1 or more FX Plug-ins.

9Actions Button
  • Re-Scan Plug-ins
  • Reset Blocked Plug-ins list, and Re-scan
10Settings Button

Takes you to the Settings screen.

11Chain: Wotja Track Filter Control

The "Chain: Wotja Track Filter" allows you to select only certain Wotja Tracks for use with the Plug-in Chain.

It displays slightly differently depending on whether the Instrument in the Chain is "Wotja Output" (A) or a 3rd Party Plug-in (B).

Use the Action menu in the Wotja Track Filter to easily select/deselect all.

Wotja Mix Plug-ins Scanner Failed sandboxSafe

Chain: Wotja Track Filter (A)
(tap image for large)

Wotja Mix Plug-ins Scanner Failed sandboxSafe

Chain: Wotja Track Filter (B)
(tap image for large)

12Chain: MIDI Event Filter Control

The "Chain: MIDI Event Filter" will only show if you have selected a 3rd Party Instrument Plug-in (it does not show if the Instrument is "Wotja Output").

It allows you filter the MIDI going from Wotja to your 3rd Party Instrument Plug-in by both Wotja Track and/or by MIDI Channel.

Wotja Mix Plug-ins Scanner Failed sandboxSafe

MIDI: Wotja Track Filter
(tap image for large)

Wotja Mix Plug-ins Scanner Failed sandboxSafe

MIDI: MIDI Channel Filter
(tap image for large)

13Plug-in Icon

Shows the icon for the Plug-in (where it is available to Wotja).

14Chain Slot Selector

There are FOUR Chain Slots and tapping the Selector displays the following pop-up menu (only displays if the chain is empty, otherwise tap the Chain Item Menu button:

  • Browse Plug-ins
    • Shows the Available Plug-ins list - you must have first scanned for Plug-ins! See the Plug-in Scanner button.
    • FIRST Chain Slot: Select either
      • "Wotja 22 WAE Built-in" > Wotja Output to use audio from the Wotja Audio Engine.
      • A 3rd Party Instrument Plug-in.
    • OTHER THREE Chain Slots: Choose any 3rd party FX Plug-in from the Plug-in list.
  • Export Slot (Pro)
    • Lets you export the slot settings to the Clipboard, perhaps to import into another slot.
  • Import Slot (Pro)
    • Lets you import into the slot any slot settings on the clipboard.
  • Third Party Plug-ins
15Chain Volume Level Control

Adjust this for each Chain to set the desired output volume for each Chain.

16Plug-ins Tab

Tap to select this Hosted Plug-ins screen.

17Chain Bypass Toggle

Allows you to quickly toggle on/off the output from a Chain. This lets you isolate a Chain so you can focus on each one in turn.

IMPORTANT: If ALL chains are bypassed then you will not hear anything coming from Wotja.

18Chain Slot Menu

Shows the relevant pop-up menu for each Chain Slot.

  • Show
    • Shows the Plug-in UI (this can be embedded or in a window dependent on this System Setting:).
  • Bypass?
    • The Chain "Audio" Bypass can be toggled on or off.
  • Delete
    • Delete the Plug-in from the Slot.
  • Replace (Delete and Browse)
    • Replace the Plug-in in the slot with another one.
  • Export Slot (Pro)
    • Lets you export the slot settings to the Clipboard, perhaps to import into another slot.
  • Import Slot (Pro)
    • Lets you import into the slot any slot settings on the clipboard.
  • Third Party Plug-ins

Mix Recording

Menu Bar Toolbar Bottom Toolbar Save/Exit Button Recording Format Selector Screen Title / Recording Progress Action Button Settings Button Recording Time Recording Item Button Recording Progress Indicator Record Button Record Mode Tab Recording Units Toggle Recordings List Recording Manage Button

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

Documents > 14Mix File > Mix Edit Modes > 10Record Tab

Tutorials
Record Mode
  • Although not strictly an "Editing Mode" as there is no actual editing that goes on in it, this screen is where you can create and preview WAV and MIDI (Pro Feature Set) "mixdown" recordings (selected via the 2Recording Format Selector).
  • Tip: Recordings are all saved to the "Wotja Folder", the location of which depends on the OS and/or whether iCloud is enabled for Wotja.
  • MIDI Recording Tip: To specify grouping by MIDI Track, or MIDI Channel, see Settings > Audio MIDI+ > MIDI File Track Grouping.
  • Notes:
    • Recordings you make are saved to the Wotja iCloud folder or Wotja folder depending on the "Use iCloud" setting (iOS > Settings > Wotja > Use iCloud).
    • Mixdown recordings are not live recordings and they are made as fast as your device allows. To be made they require sufficient device memory to be available.
    • When a recording is made it is held in memory before Wotja flushes it to the file system.
    • Bytes per second = 48000 x 2 x 2 =192,000. 100 bars of 4:4 at 60 bpm is 400 seconds of recording (just over 6 minutes). In terms of bytes this is 192000 * 400 = 77 MB. At 30 bpm, that is 154 MB.
    • For every 100 MB recording, you need to have space in the file system. 10 recordings will be 1 GB.
    • If you're using iCloud, e.g. 10 files totalling 1 GB, remember that those files are synced with the cloud.
    • MIDI File Type: MIDI file recordings are saved as Type 1 files. The "MIDI File Track Grouping" option in Settings determines how MIDI is saved. Basically, it allows you to group MIDI File recordings into Tracks by Wotja Track or by MIDI Channel ( default) and where each MIDI File Track is labelled by Wotja Track Number or MIDI Channel Number as appropriate.
    • Ramp in/out: For audio/video recordings you can set the music Ramp in and Ramp down times (from 0 - 20 seconds) in the Mix section of the Cell & Mix Rules panel.
    • Sharing recordings: Use the following apps to locate and then export/share a mixdown recording:
      • iOS: iCloud enabled - Use the Apple Files app (See also this FAQ)
      • iOS: iCloud not enabled - From the Wotja Mixdown & Recordings screen > Actions button > Open With... and try sharing via the options presented there; alternatively use App File Sharing (See also this FAQ)
      • macOS: Finder
      • Windows: Explorer
      • Android: Files app (or other File Manager app); Once you have selected the file(s) you want to export/share (e.g. recordings), use the Share Menu in the Files app to do what you want (alternatively use USB to copy files off your device)
Usage
  • Select your desired recording format: 2Recording Format Selector.
  • Start the mixdown: Tap the 9Record Button in the bottom toolbar.
  • Recording progress: The 3Title Bar will show the recording progress (e.g. 7% - 3.34 Mb) and in the middle of the screen a pop-up 8Recording Progress Indicator will display whilst the recording is being made (e.g 7%).
  • Recording complete: The popup will disappear and you will see your recording show up in the 12Recordings List (if you are using iCloud it might take some time depending on how long your recording is).
  • 7Preview recording: Audio/MIDI recording: Tap the Recording Item you want to play/stop, or use the 13Recording Action Button and select Open With.

AMenu Bar

The Menu Bar contains the 1Exit/Save, 4Action and 5Settings button and the 3Screen Title/Recording Progress indicator.

BToolbar

The Toolbar contains the 2Recording Format selector.

CBottom Toolbar

The Bottom Toolbar contains the 9Mix Record button and 11Mix Record Units toggle.

1Exit/Save Button

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

2Recording Format Selector

Select the mixdown recording format: WAV or MIDI (Pro Feature Set).

The supported mixdown recording formats are:

  • WAV
    • 48Khz/44Khz (hardware dependent) Stereo WAV file
  • MIDI
    • Type 1 MIDI file
3Screen Title / Recording Progress

When a recording is being made the screen title (normally "Record") will change to indicate the progress of the mixdown.

4Actions Button
  • Refresh
    • When you are using iCloud it can take time for a recording to sync with it. Select this menu item to update the recordings list.
  • Help - User Guide
5Settings Button

Takes you to the Settings screen.

6Recording Time

Dependent on the setting of the 11Record Units Toggle, you use this slider control to set the number of bars or seconds you want to record (up to 100 bars or 600 seconds maximum by default, but extendable via the Max Bars/Max Settings slider control in the mix segment of Settings).

Tip: To change the bars value either tap the "-" or "+" buttons, drag your finger along the slider or double tap it for a pop up to manually enter a value.

7Recording Item Button

The recording item uses an icon to indicate the file type and the description shows the name, bars, tempo and date/time.

Tap an audio (grey icon) or MIDI (black icon) recording to preview it/stop it being previewed. When it is playing the item selector will have a light green tint.

When previewing MIDI recordings these play only with a default GM MIDI Wavetable; MIDI is also sent out at the same time.

Note: When a recording is being made, or previewed, any playing mix will stop playing.

8Recording Progress Indicator

Shows the % progress of the mixdown recording, e.g. 7% done.

9Record Button

Tap this to start a recording. Once a recording is being made it changes to "Stop". You can press that to stop the recording being made.

As the recording is being made you will see the recording progress is displayed at the top of the screen instead of the screen title.

Note: MIDI is not sent out when MIDI recordings are being made.

10Record Mode Tab

The Record Mode is accessed via this Tab Bar button.

Note: In the AUv3 Plug-in this button is replaced with a Settings button.

11Recording Units Toggle

Choose between Seconds (toggle is on) or Bars (toggle is off).

12Recordings List

Displays the list of mixdown recordings you have made.

13Recording Manage Button

Tap this button shown to the right of the recording to present a pop-up action sheet with the following options:

  • Show in Finder/Explorer (Desktop)
    • 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
    • In Wotja this is how you delete your recording.

Settings: Overview

Back Button Randomization Preset Select Button Randomization Preset Name Button Version Number Group Header Screen Selector Store Help Button Info Button Randomization Preset Save Button

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

Documents > Settings (Settings button is found in many screens)

System Settings are not saved to mixes and each configures a different aspect of the Wotja System.

Tutorials
System Settings
  • General Wotja Settings General screen

    Tap image for info; Tap here for large

    This is where you set User Interface related things such as UI mode (Light or Dark) and plug-in UI display, Text Display, Display Language etc.

    Audio MIDI+ Wotja Settings Audio MIDI+ screen

    Tap image for info; Tap here for large

    This where you set how you want Wotja to play its sounds, how it is used with Audiobus / Inter-app Audio / Ableton Live [all iOS only], MIDI Out/In and screen sizes for video recordings etc.

    Randomization Presets Wotja Settings Randomization Presets screen

    Tap image for info; Tap here for large

    This screen is where with a Pro Feature Set you can select the Randomization Preset you wish to use as well as being able to edit any of the settings in it.

What is a Randomization Preset (RP)?
  • All the settings in the currently selected Randomization Preset can be edited in the Randomization Presets screen, selected via the Settings Screen Selector.
  • A Randomization Preset is a collection of settings that can be used for Randomization. There are over 40 different settings described below included in each one. 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 Scheme 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 Randomization Preset determine how it is used. Examples of this are how the mixes in Flow and Automatic albums ('Boxes') are created and whether e.g. text is displayed on screen in Flow mode 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 randomisation is applied to mixes and how Cut-up is generated in the Text Editor screen - plus a lot more, too.
  • Select/Delete a Randomization Preset:
  • Save a Randomization Preset:
    • Tap the 10Randomization Preset Save button for a pop-up menu where you can save changes to the current Randomization Preset or to save as another one (i.e. create your own!).

AMenu Bar

Includes buttons for 1Back, 8 Store (not shown, but only in Free versions) and 9 Info.

BScreens

There are three different Settings screens: General, Audio MIDI+ and Randomization Presets.

Select the screen you want with the 6Screen Selector.

CSettings Toolbar

This toolbar is only shown in the Randomization Presets Screen. It contains the following Toolbar Buttons: 2,4,7.

1Back Button

Tap to return to whatever screen you originally entered Settings from (e.g. Documents, or Music/Text/Display/Plug-ins/Recordings etc.).

2Randomization Preset Select Button
Cell Properties

Randomization Preset List
(tap image for large)

Does the same as the Randomization Preset Name Button3, namely it lets you select a Randomization Preset from the Randomization Preset List screen (which also lets you delete a Randomization Preset, using the Delete button).

3Randomization Preset Name Button

Shows the name of the current Randomization Preset but otherwise does the same as the Randomization Preset Select Button2, namely it lets you select a Randomization Preset from the Randomization Preset List screen (which also lets you delete a Randomization Preset).

4Screen Title

Displays the name of the screen and the version number for this version of the software.

5Group Header

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

6Screen Selector

Lets you select one of the 3 Settings screens: General, Audio MIDI+ and Randomization Presets.

7Store Button

The Store button is only shown in the free versions of Wotja.

iOS/macOS versions: Tap the button in the iOS/macOS versions to go to the In-App Store screen.

Windows/Android versions: Tap the button to launch a web redirection page that takes you to the paid-for app in either the Microsoft Store or Amazon Appstore (as relevant).

8Help Button

The Help Button displays the User Guide in a pop-up window.

9Info Button

The Info button shows the About Wotja screen. These details are also on the Wotja webpage here.

The About screen has a button at the bottom which lets you visit a page on our website to check what the latest version is.

10Randomization Preset Save Button

Use this button to save changes to your Randomization Preset or to save as a new Randomization Preset (Pro Feature Set only).

Settings: General

Timer

  • Sleep Timer
    • Off; 1 min to 8 hours (Default value - Off)
    • The sleep timer can take values from 1 minute to 8 hours. Use it to set how long you want to Wotja to play before fading out over the last few seconds of play time. Wotja will stop playing and restart whenever you change the value of the Sleep Timer, with the new Sleep Timer setting then being operational.
    • When the Sleep Timer is operational the Play button in the Mix Player will show the time counting down to show how long the mix has left to play.
    • If you are running in 'Lite Mode' then Wotja will always stop playing after 5 minutes whatever the value of the timer.
    • If the Sleep Timer is off then it means there is no sleep timer active. The only timer that might then be in operation is the auto-timeout in Lite Mode.

User Interface

  • Colour Scheme
    • Light/Dark (Default value - Light)
    • Lets you choose whether you want the app to use a Light or Dark scheme to suit your preference. Select the Light or Dark option to change theme - it is that simple!
    • This User Guide uses the Light scheme.
  • Auto Play on File Open
    • Enabled/Disabled (Default value - Enabled)
    • When enabled, this setting means that when you open any file (or select a Flow) it will:
      • Start to play
        • Note: If Wotja Mix Mode was last closed in Display Mode then if a mix is opened it will play full screen.
    • Tip: Disable the toggle if you do not want Wotja to go Full Screen when opening a file (it won't then autoplay though).
  • Embedded Host Plug-in UIs
    • On/Off (Default value - Apple: On; Windows: Off)
    • Note: In Wotja for Windows, the embedded option is experimental.
    • When set to "On", the Plug-in UI is shown in the Plug-in Hosting screen window. If the Plug-in has been created to have a resizable UI (i.e. responsive design), then it should resize nicely to fit in this window.
    • When set to "Off", the Plug-in UI is shown in its own window, this being of particular use in desktop versions or if you are having problems with the embedded option.
  • Show Play Screen Top Panel
    • Enabled/Disabled (Default value - Enabled)
    • This setting determines whether the top toolbar background panel in Play Screen mode in the Flow/Box/Album Player is visible or hidden.
    • Note: If you are in Full Screen display (see the Action menu in each mode) then whatever the setting of this toggle the toolbar is hidden.
  • Templates: Auto-change Patterns
    • Enabled/Disabled (Default value - Enabled)
    • This is a very important setting and unless you have a specific requirement we strongly recommend that you leave it enabled. When enabled it means that when creating an auto-mix or adding a Template to a mix all B/F (melodic) patterns in use by a Generator Type "Pattern" are randomized, AND, all other patterns that might be in the Template are set to <100 B 240 1>. This is a default pattern and it is a way of clearing out any "junk DNA" patterns that might be in the Template and that you might end up using inadvertently. If you disable this toggle then no melodic patterns are randomized and no other patterns are overwritten when creating an auto-mix or adding a Template to a mix - it is for a very specialist use case where you are using your own patterns.
  • Hide Watermark
    • Enabled/Disabled (Default value - Enabled)
    • When enabled the stylish Wotja watermark will be overlaid at the bottom of the Display mode screen or an Full Screen mode. Disable it to prevent the watermark from displaying.
    • Note: This is a Pro tier feature (see Feature Sets).
  • Help: In-App (uncheck for Online Help)
    • Enabled/Disabled (Default value - Enabled)
    • Enabled: In-app versions of documentation are used when "Help - Resources" or "Help - Guide" are selected from the Actions menu.
    • Disabled: Online documention is used instead - use our website Translate option to see them in your own language.
  • Synth & FX Editor: Show Meter/Scope
    • Enabled/Disabled (Default value - Enabled)
    • To make sound design easier the Synth & FX Editor has two visual displays ("inspectors"), these being a meter for audio-rate units/junctions and an oscilloscope for control-rate units/junctions; Show or hide these inspectors with this toggle.

Text Display

  • Duration
    • 0-4000ms (Default value - 4000)
    • Sets how long (milliseconds) text will display for in the Display screen and in fullscreen in the Playlist player.
  • Duration Range
    • 0-4000ms (Default value - 0)
    • Sets the range (milliseconds) that can be applied to Duration.
  • Fade In
    • 0-4000ms (Default value - 4000)
    • Sets how long (milliseconds) it takes for text to fade in.
  • Fade Out
    • 0-4000ms (Default value - 4000)
    • Sets how long (milliseconds) it takes for text to fade out.

Help & More

  • Help & Documentation
    • Web link to this User Guide.
  • Video Tutorials
  • Give us Feedback
  • Privacy Policy
  • Website Terms of Service
  • End User License Agreement
    • Web link to our EULA.
  • About
  • Display Language
    • A setting saved across sessions that lets you manually select the language used in the Wotja UI (should you not wish to use your devices's System setting):
      • System (default) - what your device is set to
      • English
      • Chinese (simplified)
      • Japanese
  • Cancel (iOS/ Android)
    • Cancel the pop-up menu.

Settings: Audio MIDI Video

Flow & Randomization Preset Override

  • Mix FX Override
    • On/Preset/Custom (Default value - Off)
    • The Mix FX Override setting allows you to override the Mix FX that is applied in a Randomization Preset (i.e. when playing Flows or when creating auto-mixes/boxes).
    • It provides a quick and very easy way to use the kind of Mix FX YOU want for any Flow or a new auto-mix.
    • The preset options are from the included FX Presets and are as follows:
      • Off
      • (CPU-) Mix FX - Combi Chorus Delay Reverb
      • Ambience - Big reverb hard edge (R1)
      • Ambience - Big reverb chorus input pan (R1)
      • (CPU+) Ambience - Big reverb space (R2XL) [for device with faster CPU]
      • (CPU++) Ambience - Shimmer dual (R2XL) [for device with even faster CPU]
      • Custom...
        • This option is selectable only in the Pro Feature Set.
        • When selected it takes you to the FX Presets screen where you can select ANY included FX preset or ANY saved FX preset (i.e. one of your own).
        • Tip: If you want no Mix FX to be applied at all (perhaps you want instead to apply 3rd party FX in a DAW or AUv3 Host), select the "App" > "- Amp default" FX preset.

Audio Output

  • Output Device
    • Desktop App Setting (macOS/Windows; not in AUv3 Plug-in): Select the Output audio device to be targeted by Wotja's internal sound generator (the WAE Synth) from the list of available detected options e.g. 'Built-In Output' on macOS and 'Speakers' / 'Primary Sound Driver' for Windows.
    • Wotja 22 allows dynamic change of the audio output device with no Wotja restart required (but it can take a few seconds for it to be applied). See macOS note below, and also this FAQ.
      • Note 1 (macOS): If your Mac is outputting to an AirPlay device and you change it to another one you may need to restart Wotja for it to be able to see this new device.
  • WAE for Sounds & FX
    • On/Off (Default value - On)
    • IMPORTANT: This must be ON to use Wotja as a Plug-in Host.
    • Enables WAE sounds, which all Generators use as this is the sound generator for Wotja. Turn this to off when you want to play through an external synth(s) and you do not want to hear the WAE sounds as well. NOTE: When this is set to OFF you will not hear anything from Wotja unless you have a MIDI device connected (and you will hear sounds through that instead).
    • Inter-App Audio / Audiobus (iOS only; on by default): For Wotja to work correctly with an Inter-App Audio/Audiobus enbabled app (i.e. without artefacts) then:
      1. The Wotja Audio Sample Rate MUST have the same value as the Sample Rate in those apps.
      2. The Audio Block Size MUST have the same value as the Buffer Size (samples) / Latency Control (frames) in those apps [different apps refer to the same thing in different ways]. We recommend that this value is 1024.
      3. If you getting noises/glitches/buzzing etc. see this video.
  • WAE Volume
    • 0-127 (Default value - 100)
    • Global volume control over all sound generated by the ISE.
    • Useful if want tracks to send MIDI but not to hear them, or hear them at a lower volume.
  • Audio Sample Rate
    • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
    • 48 kHz or 44 kHz (Default values - auto selected depending on device capabilities [iOS, macOS, Windows]; 22Khz [Android])
    • iOS: If you experience noise with Wotja in AudioBus, consider changing the sample rate between 48000 and 44100 Hz. If, after changing sample rate, you get occasional audio break-up, consider experimenting with the Audio Latency value, below.
    • Wotja 22 allows dynamic change of the audio output device with no Wotja restart required (but it can take a few seconds for it to be applied). See also this FAQ.
  • Audio Block Size (iOS, Android)
    • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
    • 256-2048 samples (Default values - 1024 samples [iOS]; 2048 [Android])
    • This setting is of particular use if you are using Wotja on an older device or are using it routed via Audiobus or Inter-App Audio - higher values minimise audio artifacts which also depend on device power and mix/sound/fx complexity. Used in conjuction with Audio Block Count.
    • If you are using Wotja to drive external MIDI synths you may need to tweak the values both here and for MIDI Latency. Example: You're driving an external synth via MIDI and want to sync the audio output of that with audio output from Wotja (i.e. via the WAE sounds). Try setting the Audio Block Size and Audio Block Count to be as low as you are happy with. Then, change the MIDI Latency until the output from 3rd party synth is in sync. Many dependencies are outside control of Wotja, however.
    • Wotja 22 versions allow dynamic change of the audio output device with no Wotja restart required (but it can take a few seconds for it to be applied). See also this FAQ.
  • Audio Block Count (iOS, Android)
    • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
    • 3-40 blocks (Default values - 10 [iOS]; 5 [Android])
    • This setting is of particular use if you are using Wotja on an older device or are using it routed via Audiobus or Inter-App Audio - higher values minimise audio artifacts which also depend on device power and mix/sound/fx complexity. Is the number of Audio Blocks of size determined in Audio Block Size setting.
    • If you are using Wotja to drive external MIDI synths you may need to tweak the values both here and for MIDI Latency. Example: You're driving an external synth via MIDI and want to sync the audio output of that with audio output from Wotja (i.e. via the WAE sounds). Try setting the Audio Block Size and Audio Block Count to be as low as you are happy with. Then, change the MIDI Latency until the output from 3rd party synth is in sync. Many dependencies are outside control of Wotja, however.
    • Wotja 22 versions allow dynamic change of the audio output device with no Wotja restart required (but it can take a few seconds for it to be applied). See also this FAQ.
  • Speech Synthesizer (iOS, macOS)
    • On/Off (Default value - On)
    • To hear Text to Speech (TTS) this setting must be set to "On".
    • Turn it off if you never want to hear TTS.

MIDI Output

  • Output Devices
    • User Selected (Default value - None)
    • Wotja will send-out MIDI events to whichever device you have selected in the MIDI Output Device List of detected outputs.
    • Note that 'Lite Mode' will send/receive MIDI only on Channel 1; if you want to send/receive on multiple MIDI channels then you will need to get the Pro version of Wotja (see Wotja Downloads).
    • MIDI routing on iOS
      • On iOS this is via Core MIDI. Apps that are Core MIDI enabled can take advantage of this.
      • The entry you will see will be "Network Session 1" (this is how iOS [CoreMIDI] refers to the name of the network MIDI device).
    • MIDI routing on a Mac
    • MIDI routing on Windows
      • We have found that loopMIDI is an easy to use virtual loopback MIDI cable. If you cannot seem to get MIDI Out working with your laptop Windows MIDI drivers, then give this a try!
      • Once you have installed it you may well need to restart Wotja and/or your DAW. Then, in Wotja > Settings > Mix tab select MIDI Out > Devices and ensure that loopMIDI is selected.
      • If you need a Network MIDI driver for Windows you might also wish to check out rptMIDI.
      • See also the rptMIDI tutorial.
    • MIDI routing on Android device
      • On Android devices we refer to Wotja MIDI Out as an experimental feature because we require it to be supported in the OS AND by the device manufacturer, but this is not always the case. We expect that most devices running Android 8+ should support MIDI Out in the OS, but some devices using Android 6+ may also support MIDI Out (e.g. some Samsung / Google devices). There seems to be no public list of such MIDI enabled Android devices but you can at least check that it works on your device in the free version of Wotja.
      • When it is supported it will let you control external MIDI devices via a suitable USB MIDI Interface (e.g. Roland UM-One mk2). If you just want to make MIDI file recordings on Android, see this FAQ.
      • Getting it working:
        • BEFORE loading Wotja, plug into your Android device your USB MIDI Interface (e.g. Roland UM-One mk2; we know this works as we have tried it); you will likely also need a Micro USB Male to USB Female OTG Adapter cable to be able do that.
        • Load the Wotja app, go into Wotja Settings, find the MIDI Output section and tap the "Output Devices" selector.
        • In the MIDI Output Devices screen that then displays, you should see your MIDI Interface in the MIDI Output Device List (e.g. Roland UM-ONE).
        • Tap the checkbox to the left to select it (you will see the checkbox show a green dot).
        • Create or load a Wotja mix and start it playing; you should see your MIDI Interface show that it is receiving MIDI notes.
        • You should then be all set!
  • Virtual MIDI (iOS/macOS only)
    • Note: Setting not available in the Wotja AUv3 Plug-in for iOS as it does not support Virtual MIDI.
    • On/Off (Default value - Off)
    • When enabled, causes Wotja to present a number of Virtual MIDI ports - one Omni (all channels) and 16 per-channel virtual MIDI ports - and Wotja sends MIDI events as Virtual MIDI ports over Core MIDI.
  • MIDI Clock
    • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
    • On/Off (Default value - Off)
    • When enabled, tells Wotja to send-out MIDI Clock events over Core MIDI / Omni channel.
    • Important: The iOS version can emit MIDI clock but it doesn’t support MIDI transport controls.
  • Send Patch Change Events
    • On/Off (Default value - On)
    • When enabled, tells Wotja to send-out MIDI Patch Change Events. Turn this off if you want ONLY MIDI Note Event information to be sent.
  • Send Start/Stop Events
    • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
    • On/Off (Default value - On)
    • When enabled, tells Wotja to send-out Start/Stopr Events. Turn this off if you do not want them sent.
  • Send Controller Events
    • On/Off (Default value - On)
    • When enabled, tells Wotja to send-out MIDI Controller Events. Turn this off if you do not want them sent.
  • MIDI Latency
    • 0-500ms (Default value - 0ms)
    • Sets Latency (milliseconds) to apply to MIDI events sent-out to Core MIDI / Virtual MIDI by Wotja. Use to help remove jitter if using e.g. Network MIDI.
  • Tuning Mode
    • Note: Setting not available in the Wotja AUv3 Plug-in.
    • Off / C4 (60) / A4 (69) (Default value - Off)
    • Useful option for tuning external analog synths - causes all notes sent-out by Wotja to be "forced" to the specified pitch, which is either C4 (60) and A4 (69).
    • Important: This setting is ALWAYS turned off when you restart Wotja.

MIDI Input

  • Input Devices
    • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of th