Skip to main content Skip to docs navigation

Wotja 22 User Guide

Guides: Wotja 22 icon22 | Wotja 22 WME iconWME | Wotja 22 WAE iconWAE | Wotja 22 WSE iconWSE

Wotja Music Engine icon

Wotja 22 is a very powerful creativity system. This guide and the engine guides, together with our tutorials and FAQs, should be all you need to begin your creative journey with Wotja.

Heads up: Please bear with us as we complete a major website update. Most site links are now fixed but have yet to update the V22 Guide, WME Guide & Tutorial videos (sorry!). We've been working hard on this for ages & are going as fast as we can!

Looking for something?: Try page search with Cmd+F/Ctrl+F.

Intro, Files & Players Mix Editors Settings, Engines & PDF

Intro


Files


Players

Music


Text


Display


Plug-ins


Recording

Settings


iCloud


In-App Store


Engines


PDF

Overview

Guides: Wotja 22 icon22 | Wotja 22 WME iconWME | Wotja 22 WAE iconWAE | Wotja 22 WSE iconWSE

Wotja Music Engine icon

Wotja 22 is a very powerful creativity system. This guide and the engine guides, together with our tutorials and FAQs, should be all you need to begin your creative journey with Wotja.

Heads up: Please bear with us as we complete a major website update. Most site links are now fixed but have yet to update the V22 Guide, WME Guide & Tutorial videos (sorry!). We've been working hard on this for ages & are going as fast as we can!

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 29

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

File Types

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

  • Wotja can open:
    1. .wotja [Mix file]: Contains all parameters, text and image needed to play and display a mix (WME, WAE, WTE)
    2. .wotjabox [Box / Album file]: A playlist container including up to 20 .wotja files
    3. .wotjalist [Playlist file]: References .wotja files located in the Wotja folder
    4. .noatikl [Template ( Noatikl ) file]: Added to a Cell via the Template List ; auto-converted to .wotja file when opened via Documents
    5. .mixtikl [ Mixtikl file]: Auto-converted to .wotja file when opened via Documents
    6. .liptikl [ Liptikl file]: Auto-converted to .wotja file when opened via Documents
    7. .skd [ SSEYO Koan file]: Auto-converted to .wotja file when opened via Documents
  • Wotja can use but does not directly open:
  • Wotja can save/use:
    1. .noatikl [Template ( Noatikl ) file]: Via Music Mode > Grid > Cell Actions > Export to Template
    2. .wotjarp [ Randomization Preset file]: AKA "RP"
    3. .tg [ WAE Synth Network file]: AKA "Synth Preset "
    4. .fxm [ WAE FX Network file]: AKA "FX Preset "
    5. .wotja, .wotjabox, .wotjalist : any/all referenced .zip, .sf2, .midi, .wav, .ogg files are not included
  • Wotja can (mixdown) record to:
    1. .wav, .midi, .mv4 / .mov
  • Wotja can export/import:
    1. Wotja URL (WJURL): a wotja file in the form of a URL (i.e. a text string, see Export Mix to Clipboard and Sharing )
    2. Plain text : words/characters, cut-up, cut-up rules, patterns etc.
    3. .tg, .fxm: as above

Glossary

SYNOPSIS: The Wotja Generative Music System uses one or more Wotja Music Engine (WME) "Generators" in a Generator Network to generate MIDI notes/controller events. Each Generator can use a Wotja Audio Engine (WAE) Synth or FX "Unit" in a Synth & FX Network to generate sound for its notes (although use of the WAE is optional and you can just use Wotja as a MIDI generator if you wish). A Generator or Generator Network is used (modified or unmodified) in the context of a Cell. A Wotja Mix can include up to 48 Cells (that being 4 Cells in up to 12 Tracks) however for each Track only one Cell can play at a time. See: Music Mode Schematic.

Tip: Wotja uses chance to create what it does - it does not do "musical styles".

  • 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 Playlist Player.
  • Audio Unit (AU): An Audio Unit / Audio Unit Extension / Audio Unit Plug-in is most easily thought of as a self-contained program that can run in an Audio Unit Host. Audio Unit (V)3 is Apple's latest Plug-in format and is different to Steinberg's VST format. 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.
    • 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.
    • Pattern: Composes just like a Rhythmic Generator unless it is being used to play note patterns (there are 4 different types). 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); for beat generation. See: Generator - Pattern.
    • Text to Music: Composes melodies 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: Generator - Text to Music.
    • 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 Editor.
  • 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 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 Editor.
  • 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

See the "How To" tutorials - Create an "Auto-Mix", "Empty Mix", "Album" & "Playlist" | "Delete a File" & "Rename a File"

Menu Bar Flows Mixes Albums Action Button Tip Jar (TJ) 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 Playlist Badge Included Album Button Template Badge Locked File Badge Subscriber Album Badge Albums Sort Button Mixes Sort Button

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

The Documents screen is what you see after you have launched the app. In it you can use the Screen Selector3 to select one of three main different file views or screens: FlowsB, MixesC or AlbumsD. What you see on the Feature Set5 button depends on the version you have and (as available) the active Subscription tier(s).

Desktop vs Mobile

In the Create screens the Desktop version allows multiple files (mixes, playlists, Boxes and Albums) to be open at the same time. Each file is shown in a different tab at the top of the screen. See also the Desktop Titlebar Menu section.

  • Tip: To close an open tab in the Desktop version use Cmd+W (macOS) or Ctrl+W (Windows).
iOS & macOS

When you first start the app you're prompted if you want to use iCloud or Local. Go your device's iCloud Settings screen, scroll down that and look for this Wotja app and go into that screen. You will see a "Use iCloud" toggle and you then set it as you wish. See iCloud Settings.

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:

  • Refresh
    • Refreshes the display in the Documents screen and resyncs to iCloud (if in use).
  • Help & Documentation
    • Visits this User Guide online.
  • Cancel
    • Closes the popup menu.
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 Pro 21 (paid-for version)
    • Button shows Pro.
  • Wotja 21 (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 Pro 21 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 Pro 21 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, 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 following pop-up menu:

  • Mix (Automatic)
  • Empty Mix
    • Creates a mix with no Cells populated (but still includes a Cut-up) and then opens it in Music Mode.
  • Mix (from Clipboard)
    • Imports a mix file on the Clipboard (if any) and creates a new mix file.
  • Cut-up Text
    • Creates a mix that includes a Cut-up (but that has no Cells populated) and then opens it in Text Mode.
14Mix File Button

See also: How to create a mix file (auto-mix) (.wotja).

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
    • 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' 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 Albums.
    • The value is discarded if you restart the app.
17Add New (Album) Button

Tap the button for the following pop-up menu:

18User Album Button

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

Tap the button to load the Album in the 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
    • Duplicate the file.
  • Cancel
    • Exit the pop-up menu.
20Playlist Badge

See also: How to create an Playlist file (.wotjalist).

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

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

21Included 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 Playlist Player.

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

22Template Badge

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.

How to create a Template file (.noatikl)
  1. Open a mix and go into Music Mode.
  2. Select the Cell button17 you want to export as Template and tap the Grid button4.
  3. In the ensuing pop-up menu select "Export to Template" and choose a name for your Template.
  4. Once saved, your Template will show in MixesC; you can also find it in the Template list under Documents "Pak" (Wotja Folder)9.
23Locked 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.

24Subscriber Album Badge

This badge is shown to the bottom right of Subscriber Albums. These Albums are only included in the free iOS/macOS versions.

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 (available only in 'Pro' mode)
  • Sort: A-Z (available only in 'Pro' mode)
  • Sort: Z-A (available only in 'Pro' mode)

Note: Subscriber albums are always shown after Included Albums and Included Albums are always shown after User Albums and Playlists.

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 (available only in 'Pro' mode)
  • Sort: A-Z (available only in 'Pro' mode)
  • Sort: Z-A (available only in 'Pro' mode)

Templates

See the "How To" tutorials - "Add Template to Cell" & "Export Template from Cell"

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

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

Editable "Templates" are at the core of Wotja and Wotja includes 100s of them. Every mix file uses them, whether auto-created e.g. in the Flow Player, or created by you.

The reason is quite simple actually. Mix files are comprised of Cells17. For a 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 - or an Audio or MIDI file (the latter 2 must be in Paks, see Filetypes).

Interested in editing mixes?

If so then it definitely helps to know a bit about Templates, which is why this section comes before the other "Edit Mode" sections.

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 Cell17 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 Documents "Pak" (Wotja Folder)9).

How are Templates used?

Automatic Mixing:

Manual Mixing:

AMenu Bar

UI Elements: 1,6,7,8.

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 > 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
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 Grid Button4 > 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 7 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 7 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).
  • Pattern: A Generator of Type Pattern (you will hear something).
  • Repeater: A Generator of Type Repeater (you will hear something).
  • Rhythmic: A Generator of Type Rhythmic (you will hear something).
  • Text to Music Custom: A Generator of Type Text to Music, configured to use custom text (you will hear something).
  • Text to Music: A Generator of Type Text to Music, configured to use Cut-up Text line (you will hear something).
11Selected Pak

A light blue background indicates the selected Pak.

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.
  • BP21 Drones 1
    • A collection of Drone Templates optimised for Wotja 21.
  • 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 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 File Window Help
About New Show Window Show Data Folder
Open Resize Check for Latest Version
Close About
Save
Recent
Exit

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

See the "How To" tutorial - "Play a Flow"

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

Documents > Flow ScreenB > Included Flow Button10 or User Flow Button9

The Flow Player (see Quick Start) shows a list of all the Randomization Presets (RP) included in Wotja (as well as any that are in the Wotja Folder i.e. any you have created yourself) and is used to:

  • Generative a succession of freshly created mixes whose play time is governed by the Mix Duration values in Settings.
  • Playback will continue until either the Sleep Timer kicks in (if active) or if in the Lite Feature Set the auto-timeout is reached.
  • How each mix is generated depends on the various settings in the currently selected Randomization Preset.
AFlow Player Menu Bar

UI Elements: Menu Bar buttons1,3,4,6,7,9,11.

BFlow Player Status Bar

UI Elements: Indicators2,5,11.

1Exit Button

Takes you back to the Documents screen.

2Flow/Play/Sleep Time Remaining

If you have an active Sleep Timer button3 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.

3Sleep Timer Button

When the timer is not active it is a line outline; when it is active the icon takes on a more solid form (as shown).

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

How to set the Sleep Timer
  1. Tap the Sleep Timer button3 which takes you to the Settings Screen
  2. The Sleep Timer is found at the top of the General segment.
4Repeat Button

Default: "Continuum" (Off; squiggle forward icon).

When toggled to "Repeat" (On; loopback icon) the current mix is restarted when it reaches its end rather than another being generated.

5Randomization Preset Name

Displays the name of the Randomization Preset currently in use.

6Play/Stop Button

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

7Next Button

Forces another 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 "Always 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
    • Saves the current Flow to a new Mix file (.wotja, see Filetypes).
  • Save Flow to Wotja Box File
    • Saves a new Box 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 and More
    • Visit our website for online help on the Flow player.
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 and Wotja Pro 21 apps.

Player: Album/Playlist

See the "How To" tutorial - "Play an Album" & "Play a Playlist"

Menu Bar Toolbar Status Bar Save/Exit Button Add Button Sleep Timer Button Previous Mix Button Mix Selector Play/Stop Button Playing Mix Name Next Mix Button Action Button Sequential/Random Play Button Settings 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

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

Documents > Albums ScreenD > User Album18 / Playlist20 / Included Album 21 / Subscriber Album 24.

The Playlist Player (see Tutorials) is used to play the following file types:

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

The Playlist Player is 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)

Tip: To create a playlist, see AlbumsD > Add New button17 > "Play List."

APlaylist Player Menu Bar

UI Elements: Menu Bar buttons1,3,4,6,8,9,11.

BPlaylist Player Toolbar

UI Elements: Toolbar buttons2,5,10.

CPlaylist Player Status Bar

UI Elements: Indicators12,7,20.

1Save/Exit Button

Note: This Button is shown only in the mobile versions; the Deskstop versions use the File Menu.

Displays the Save Changes Menu pop-up (see below) before exiting to the Documents screen.

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

When the timer is not active it is a line outline; when it is active the icon takes on a more solid form (as shown).

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

How to set the Sleep Timer
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 Mix Thumbnail button13).

6Play/Stop Button

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 Mix Thumbnail button13).
    • 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 Mix Thumbnail button13).
    • 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 Box
    • This is for when you want to share the album or playlist as a Wotja URL for a "Box" (.wotjabox, see Filetypes).
  • Save Wotja Box to File
    • Allows you to export your Wotja playlist to a Box file (.wotjabox, see Filetypes) that is then saved locally. You might choose to do this to if you wish to share your Box.
    • Displayed in User Albums screen.
  • Refresh ALL mixes
    • This will refresh all items in the Box file with the latest versions that you have saved locally (this is for Box authors who have the local original files).
    • Displayed in Box files only.
  • Help & More
    • Visit the User Guide online.
10Sequential/Random Play Button

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

11Settings Button

Takes you to the Settings screen.

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
Click 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 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 Mix Actions button18 (Box file only).

18Mix Actions Button

Button not shown in Included Albums

Tap to display a pop-up menu with the following options:

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

    Mix Overrides
    Click image for large

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

    • 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 (Box file only)
  • Export Mix to File
    • Where availble, this item lets you export your mix so that you can further edit it.
  • Refresh Item from File (Box 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 Mix Actions button18.

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 Status Next Button Screen Text Background/Screensaver Wotja Watermark Version Feature Set Speech Synthesizer Use Text Display Selector Repeat Selector Sleep Timer Selector Randomization Preset Selector App Name

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

The Wotja TV Player is 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.

It operates as a 'Flow Player' meaning that it generates a succession of freshly created mixes, but it also lets you repeat the current mix if you so wish.

The music generated, screen background and any text displayed all depend on the Randomization Preset that has been selected. A number of these are included in the TV app and are non-editable.

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.

Wotja TV Player capability summary:

  • Generates a succession of freshly created mixes when 'Continuum' is selected.
  • When 'Repeat' is selected it forces the current mix to replay.
  • 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.
  • What is generated depends on the various settings in the selected Randomization Preset16 (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.

AMenu Bar

The top part of the screen that includes 2 buttons - Settings button1 and Next button6.

BSettings Panel

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

1Settings Button

Displays the pop-up Settings PanelB.

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 Pro 21 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 Repeat Selector14 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: Repeat Selector14.

6Next Button

Select this button to force another mix to be generated.

7Screen Text

Whether any text is displayed here depends on the Randomization Preset16 being used.

8Background/Screensaver

The background used depends on the Randomization Preset16 being used.

9Wotja Watermark

This is where the Watermark displays.

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

10Version number

Displays the version number and copyright statement.

11Feature Set

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

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

14Repea Selector

Default: "Continuum" (Off; squiggle forward icon).

When toggled to "Repeat" (On; loopback icon) the current mix is restarted when it reaches its end rather than another being generated.

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

15Sleep 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. When there the Sleep Timer is on the Sleep Timer icon looks more solid.

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 Pro 21" for the paid-for version. or "Wotja"/"Wotja Lite" for the free version.

Player: Watch

Play/Stop Button Next Button Flow Mode App Name File Type Playlist File Type Box File Type Mix File Info Screen Text File Type Album

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

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 Play button (1) on the watch app it will by default start Flow mode (3) playing in the Wotja app for iPhone. You can use the Next button (2) to force a new 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 File Type area (3,5,6,7,10) will depend on whether Wotja for iPhone in 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.

2Next 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.

3Flow Mode

Indicates that your Wotja for iOS app is playing in Flow mode.

4App Name

This will be either Wotja or Wotja Pro 21.

5File Type Playlist

Displays the number of mixes in the playlist and the name of the playlist.

6File Type Box/Album

Displays the number of mixes in the box/album and the name of the box/album.

7File Type Mix

Displays the relevant icon and the name of the playing mix.

Icons can be as follows: 3, 5, 6, 7, 10
8File 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.
9Screen 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.

10File Type Included Album

Displays the number of mixes in the included album and the name of the album.

Player: Mix File

See the "How To" tutorial - "Play a Mix"

Documents > Mix File14

The Mix Player has 4 "Mix Edit" Modes, as below.

Once the mix is has been loaded (it should open in the last used Edit Mode) then, whichever of those modes it is in, simply tap the bottom Play/Stop button33 to control playback:

  • Mix Edit - 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).
  • Mix Edit - Text Mode
    • The editing mode where you can create and edit Cut-up and text.
  • Mix Edit - Display Mode
    • The editing mode where you decide how you want your wotja to look, this being important should you wish to share it.
  • Mix Edit - 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.

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.

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!

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:
    • Visit a webpage with an embedded WJURL.
  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.

Editor: Music: Overview

See the "How To" tutorials - "Edit Mix Properties", "Edit Cell Properties", "Cell Display", "Cell Sequencing" & "Mix Volume"

Menu Bar Toolbar Tab Bar Cells & Tracks Panel Mix Editor Panel Generator Editor Panel Generator Button Area Generator Synth & FX Button Area FX Button Area Save/Exit Button Randomize Button Column Lock Button Grid Button Generator Network Editor Panel Selector Generator Menu Button Cell FX Button Cell Mixer Panel Selector Track FX Button Mix Name Track Mixer Panel Selector Mix FX Button Cell Properties Panel Selector Mix Properties Panel 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 Music Mode Tab Track Cell Sequencing Button Track Solo Button Track Mute Button Text Mode Tab Generator Button MIDI Channel Assignment MIDI Channel Label Play/Stop Button Generator Synth Button Generator FX Button Display Mode Button Record Mode Button

Mix Edit - Music Mode
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Music Tab23 (see Tutorials for how to create a Mix file)

Of the four Mix Player "Edit Modes" (Music, Text, Display, Record), the Music Mode is likely to be the most important for you. It is where you add/delete Templates to/from your mix Cells and edit all their Music (IME) parameters, Sounds & FX (ISE) parameters and Cell Rule related settings. You can also access the Cell Mixer and Track Mixer, edit Mix Rules & Mix FX - and so more....

The following Mode selectors, common to all the Edit Modes, are accessed via the Tab BarC:

  • Mix Edit - Music Mode25
    • 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).
  • Mix Edit - Text Mode29
    • The editing mode where you can create and edit Cut-up and text.
  • Play/Stop button33
    • Tap to stop or start your the generative mix (if any) in your wotja.
  • Mix Edit - Display Mode36
    • The editing mode where you decide how you want your wotja to look, this being important should you wish to share it.
  • Mix Edit - Record Mode37
    • The mode where you can make recordings of your mix.
AMenu Bar

The Menu Bar at the top of the screen has a number of buttons, 1,2,15,16.

BToolbar

The Toolbar, below the Menu BarA, houses a number of buttons including the Editor Panel selectors 5,8,11,13,14.

CTab Bar

The Tab Bar at the bottom of the screen provide access to the Editing Modes 25,29,36,37 and a Play/Stop button33.

DCells & Tracks Panel

Shown to the left of the screen the Cells & Tracks panel is is where you access the Cells17 and Track Controls 26,27,28.

Tip: To select between a left panel display of One Cell, One Column or 4 Columns tap the Action Menu button and select one of the "Display" settings in the pop-up (see below).

EMix Editor Panel

Select the Editor you wish to use here with the Mix Editor Panel selectors: Generator Network Editor Panel5, Cell Mixer Panel8, Track Mixer Panel11, Cell Properties Panel13 and Mix Properties Panel14.

FGenerator Editor Panel

The Generator Editor panel (see RHS of image below) is an in-screen view of the full screen Generator Editor.

It lets you edit parameters in-situ without having to use the full screen editor. Simply select the Parameter Group on the left hand side of panel (shown on the right), and then edit parameters on the right side of the panel.

Generator Network

Music Mode: Generator Editor Subpanel (on RHS)
Click image for large

Hide/Display the Panel: Generator Menu Button6 and selecting "Show/Hide Generator Editor Panel". Alternatively, double tap on a Generator Button30 and select "Show/Hide Generator Editor Panel" from the pop-up menu.

See the WME Parameter List for info on all the available parameters.

Note: The two items below are only shown in the Full Screen Generator Editor.

  • Undo/Redo (screen top right)
    • Undo or Redo your last parameter change.
  • Generator Selector bar (above Basics Group Header)
    • The Generator selector bar shows the number of Generators in the piece (in the selected cell). Tap in the left or right side of this bar to move to another.
GGenerator Button Area

The Generator Editor button area is where all the Generators buttons are shown. These can be used to access the Generator Editor.

See the WME Parameter List for info on all the available parameters.

HGenerator Synth & FX Button Area

The Synth & FX button area is where all the Synth & FX Buttons are shown. These launch the Synth & FX Editor.

See the WAE Synth & FX Units for info on all the available synth & FX units.

IFX Button Area

The FX button area is where the Cell FX, Track FX and Mix FX Buttons are shown. These launch the Synth & FX Editor.

See the WAE Synth & FX Units for info on all the available synth & FX units.

1Save/Exit Button

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

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

Displays the Randomize Menu pop-up:

  • Randomize Mix
  • 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 (sticky)
    • 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). The Randomize button shows as a fuschia colour (to show sticky behaviour). Tap the button again to turn off sticky behaviour.
  • Randomize Cell Melodic Patterns (sticky)
    • 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 Settings. 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 Settings.Tip: Use carefully.
  • Randomization Settings
  • 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" and where cells are not looped (i.e. no orange band).

In "One column" view (see Action Button13 > "Display: One Column", the column number shown at the top is that of the selected Cell15.

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 Editor Panel / Selector
Generator Network

Music Mode: Generator Network
Click image for large

See also: Generator Editor (shown as a sub-panel to right of this image).

For the selected Cell17, and ONLY if it contains generative content, the Generator Network Editor panel 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.

Important: In any mix Cell from Wotja V20.1.5 onwards, 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.

  • Tap on a Generator button30 to show its Intermorphic Music Engine (WME) parameters in the Generator PanelF (if on screen) or double tap it or tap the Generator Menu button6 for a pop-up menu where you can select a full screen editor.
  • Tap on a Generator's Synth button34 or FX button35 to access the Intermorphic Synth Engine (WAE) parameters and carry out any sound design you wish to do.
  • Go to the Cell Rules panel13 to set Cell and Mix level settings such as Cell Rules and Mix Tempo.
  • Tap/hold on a Generator and you can drag it up/down to change the Generator order. 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

See also: WME Parameter List.

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.

See also the Wotja Music Engine (WME) Guide for details on what the parameters do.

7Cell FX Button

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

8Cell Mixer Panel / Selector
Cell Mixer Panel

Cell Mixer Panel
Click image for large

This is where you can easily change the volume and pan levels within the Cell and solo/mute each Generator.

  • Generator button
    • Tap to go into the Generator Editor.
  • 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.
    • There buttons do not at present change colour.

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

Tip: Double tap a slider for a pop-up menu where you can manually enter a value.

9Track FX Button

Tap this button to go into the Synth & FX editor where you can add Track FX.

10Mix Name

The name of the open mix file.

11Track Mixer Panel / Selector
Track Mixer Panel

Track Mixer Panel
Click image for large

This is where you can easily change the volume and pan balance of each of the tracks used in the mix.

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

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

Tip: Double tap a slider for a pop-up menu where you can manually enter a value.

12Mix FX Button

Tap this button to go into the Synth & FX editor where you can add Mix FX.

13Cell Properties Panel / Selector
Cell Properties Panel

Music Mode: Cell Properties
Click image for large

The "Cell Properties" panel is where, amongst other things, you can easily set the parameters that define how a Cell will play, as well as the rules used for the content in that Cell.

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

    • 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.
    • 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
    • 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.
    • File Name
      • Displays the name of the Template (or audio/MIDI file) used in the Cell. See above.
    • File Path
      • Displays the path to the Pak zip file that includes the Template.
    • Content Duration
      • Displays the play length of the content in the cell, important to know for audio loops.
14Mix Properties Panel / Selector
Mix Properties Panel

Music Mode: Mix Properties
Click 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 FX
    • Edit Mix FX
      • Tap the FX button to go the the Synth & FX Network Editor where you can create or edit a FX network (an active FX Network is shown in the top thick line on the Mix Rules button; if there isn't one this line shows as grey).
  • 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.
15Action Button

Displays the Action 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 & More
    • Link to this online Wotja 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.

Cells
  • Cell display can be either: 1 Cell, a Column of Cells or 4 columns of Cells; this is set via the Grid Button4 and selecting the relevant "Display" option from the pop-up menu.
  • For the pop-up "Cell Actions" menu, below, tap a selected Cell or double-tap any Cell.
  • Tap an empty Cell or its empty Network Panel5 (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).
Selected Cell
  • Tap a Cell to select it ("selected Cell").
  • The border of a selected Cell has an orange colour.
  • A light blue background is shown at the top of the Cell when in Editor Panels5, 8,11 and at the bottom of the Cell when in Editor Panel13.
  • There is no background shown when in the Mix Properties Panel14.
Cell Content

The icon at the top of a Cell shows the content that is in it, as follows:

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.
  • 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 > Saved Files Pak9.
  • 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: Cell / Selector17.

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: Cell / Selector17.

24Cell Content - Audio File

The Cell includes an Audio file.

For further information see: Cell / Selector17.

25Music Mode Tab

The Tab that selects Music Mode.

26Track Cell Sequencing Button

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

  1. Tap the Cell and in the pop-up Cell Action menu select Loop or Unloop.
  2. Display the Cell Properties panel and toggle on/off the Loop toggle.
Track Cell Sequencing button 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 (Zap icon):
    • 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 (Loop icon):
    • 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 Randomize Button2 "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.
29Text Mode Tab

Takes you to Text Mode.

30Generator Button

See also: Parameter List.

Tap on a Generator button to select that Generator. The selected Generator has a red border. If the Generator Editor panelF 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 to display a pop-up menu (for details see the Generator Menu button6).

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 "IME Patch" parameter (see Generator Editor) 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.

33Play/Stop Button

This button is used to play/stop a mix and it is common to all Mix Player Modes (i.e. Music, Text, Display 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.
34Generator Synth Button

If the "ISE for Sounds & FX" toggle is checked in the Settings screen, then MIDI events are routed for each channel through an 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).

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

36Display Mode Button

Takes you to Display Mode.

37Record Mode Button

Takes you to Record Mode.

Editor: Music: Generator

See the "How To" tutorial - "Edit Generator Parameters"

Menu Bar OK/Back Button Generator Selector Generator Summary Screen Title Undo Button Redo Button Parameter Groups List Selected Parameter Group Parameter Group Selector Music Mode Tab Parameter Edit Control Generator Name Button Generator Type Button Parameter List / Group Header WME Parameters

Generator Editor (Full Screen)
(tap circle for info, hover for tooltip; tap image for large)

The Generator Editor is where you can edit all the parameter values for each of the Generators in the Cell. It can be used full screen (as shown above) or as a sub-panelF in the Network Editor panel5.

Full Screen Editor: In the Network Editor panel5 tap the Generator Menu button6 or double tap on a Generator Button30 and selecting "Edit" from the pop-up menu.


AMenu Bar

UI Elements: 1,4,5,6.

1OK/Back button

Tap to accept your changes and exit the Generator Editor

2Generator Selector button

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

3Generator Summary

Shows the Template Name, MIDI Channel, Track Number and Cell Column being used by a Generator.

See also: WME Parameter List.

4Screen Title

Shows the name of the current screen.

5Undo Button

Undo the last parameter change you have made.

6Redo Button

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

7Parameter Groups List

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: WME Parameter List.

8Selected Parameter Group

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

See also: WME Parameter List.

9Parameter Group Selector Button

Tap the Parameter Group selector to select your desired Parameter Group.

See also: WME Parameter List.

10Music Mode Tab

The Generator Editor is only available in Music Mode.

11Parameter Edit Control

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

See also: WME Parameter List.

12Generator Name

Shows the name of the Generator. Tap to edit it.

See also: WME Parameter List.

13Generator Type

Shows the Generator Type. Tap for a pop-up list where you can change it if you want to.

See also: WME Parameter List.

14Parameter List / Group Header

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

15WME Generators & Parameters

See the Wotja Music Engine Guide.

Editor: Music: Synth & FX

See the "How To" tutorial - "Select Synth or FX Preset" & "Edit Synth & FX Networks"

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 Delete Controller Button Control-Rate Unit Controllers Panel Add Controller Button Controller Unit Selector Controller Parameter Selector Controller Scale Value Music Mode Tab

Music Mode: Synth & FX Editor
(tap circle for info, hover for tooltip; tap image for large)

The Synth & FX Editor is used to design / view and edit both Synth Networks or FX Networks.

Whether you are viewing/editing a Synth or FX Network in Music Mode depends on which button in the Network Editor5 that you tap on to access it. You can tell which Sound or FX network you are editing as the Screen Title5 of the Mix Editor tells you - it refers either to "Synth" or "FX".

The Editor is quite easy to use one you understand how it works and how everything fits together.

Top Tip: Use the top "Presets" button to open the Presets List where you can select from a range of included Sounds (.tg) or FX (.fxm) presets (you can even load ones you have saved). What is shown depends on whether you are in sound or fx network.

Top Tip: Synth Units are also called Sound Units or Tone Generators (TG); the terms are used interchangably.

Top Tip: Use the top "Dice" button quickly change your Sound or FX Network. Every time you tap the Dice 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!

Top Tip: 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

Buttons: 1, 8, 9.

BToolbar

Buttons: 2, 3, 6, 7, 10.

CWAE Units & Parameters
1OK/Back Button

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

2Presets Button
ISE Presets List

WAE Presets List
Click 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:

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 Randomization Presets

  • 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 Mix Properties 12 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

The synth/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.

The currently selected unit is highlighted with a red surround (see: Selected Unit13).

Audio-rate units are shown in the top row of the network and control-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.

If there are no units shown then it means there is no Network defined.

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.

Synth & FX Editor Meter - Audio

Audio Meter for Audio-rate Unit
Click image for large

Synth & FX Editor Meter - Oscilloscope

Oscilloscope for Control-rate Unit
Click image for large

Adding Units:

Note if you are designing a Synth Network, then at least one of your units should be a Tone Generator Unit! In the pop-up menu these all have a "Tone:" prefix.

Tap on an empty/blank part in the top half of this network design area to display the "Unit Add" menu below where audio-rate (Tone) units are listed first, then FX and then Control Rate units (Ctrl-):

Selecting/ Editing Units:

  • Tap the unit whose settings you want to edit in the Synth & FX Editor.
  • Alternatively, double tap a Unit button for a pop-up menu where the first item in it lets you edit the unit full screen (for an example see Edit Wavetable Full Screen).
  • Note: Some units do not have editors (Random, Junction) as they just sum the inputs of anything feeding, so nothing happens when you tap on them.

Deleting Units:

  • Tap the Action Button10 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

Goes to the relevant webpage in the online user guide (internet connection required).

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.

10Action Button

Displays the following pop-up 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.
11Audio-Rate Unit

Audio-rate units 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: This allows you to edit a unit full screen (for an example see Edit Wavetable 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 Controllers Panel17 has a red connector line.

15Delete Controller Button

Deletes the selected controller unit in the Controllers Panel17.

16Control-Rate Unit

Control-rate units 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.
17Controllers Panel

IMPORTANT: The Synth & FX Editor does not support dragging to add Controllers; these have to be added via the Controller panel "+" button. This button is greyed until you select an Audio Rate Unit (e.g. Tone Generator or FX unit) that has a 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: Add Connector19
18Add 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 Synth/FX Network area4 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 Connector14;
  4. For that Connector, you then select the Controller Unit Selector19 to choose the Controller unit that will do the modulation (e.g. Envelope Unit);
  5. Non-Junctions Only: Tap the Controller Parameter Selector20 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 Controller Scale Value slider21 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).
19Controller Unit Selector

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

20Controller Parameter Selector

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

21Controller Scale Value

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

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

22Music Mode Tab

This editor is only available in Music Mode.

Editor: Music: Rule

See the "How To" tutorial - "Use Included Rules" & "Edit Rule Values"

Menu Bar Toolbar OK Button Rule Element Selector - Note Playing Rule Element Selector Screen Title Mix Rule Selector Cell Rule Selector Rule Selected Rule List Music Mode

Music Mode: Rule Editor
(tap circle for info, hover for tooltip; tap image for large)

There are four different Rule Types (Scale, Harmony, Rhythm and Next Note) and they are fundamental to how Wotja works as Generators use them when composing.

The Rule Editor is where you select and (real-time) edit these Rules, e.g. their names, elements and element weightings.

To Add Rules or Copy/Paste/Rename etc. see ToolbarB.

You can access the Rule Editor from:

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 5Mix 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 Rules 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 Rules button in ToolbarB 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 6Cell 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 Rules button in ToolbarB 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

UI Elements: OK button1.

BToolbar

The Toolbar contains three buttons - Add, Rules and Action.

  • Add New Rule:
    • When you select the Add Rule button you are presented with pop-up menu "Base New Rule On...". To add a new Rule select one of the "Standard Rule Values" items in the list (whether you add a Cell or Mix Rule depends on whether you are in the Cell Rules or Mix Rules screen).
    • For the list of included "Standard Rule Values" see the following:
  • Rules Button:
    • When you select the 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 (the displayed name of the Rule will not change however).
    • For the list of included "Standard Rule Values" see the following:
  • Action Button:
    • Rename: Use this to rename your Rule. Note that you are not permitted to rename 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.
1OK Button

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

2Rule Element Selector - Note Playing

A note is playing with this rule element (see above for example of one with no note playing).

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!

So that you can tell when a Generator using the currently selected rule composes using it, it flashes the colour of the Generator type used by that Generator (as in this case). This is primarily to remind you that other Generators rely on that rule, so if you are going to change it then the way other Generators compose may change, too. It can be useful to have the same rule used by all Generators, but if you want to, then each Generator can have its own rule!

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

3Rule Element Selector

There is no note playing that uses this rule element (see above for example of one playing).

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!

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:

5Mix Rule Selector

Lets you choose a Mix Rule list item.

6Cell Rule Selector

Lets you choose a Cell Rule list item.

7Rule Selected

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

8Rule List

The scrollable Rule List (in either Mix Rules or Cell Rules) contains all of the Rules available to select from.

To add/edit/rename/delete rules see the ToolbarB.
9Music Mode Tab

This editor is only available in Music Mode.

Editor: Music: Pattern List

Menu Bar Toolbar Add Pattern Button OK/Back Button List Item Selector Move Up Button Screen Title Move Down Button Action Button Cancel Button Delete Pattern Listen Item Number/Type Pattern Type - Both Pattern Type - Rhythm Pattern Type - Fixed Pattern Type - Sequence Pattern Editor Button Selected Pattern

Pattern List (Pattern Editors below)
(tap circle for info, hover for tooltip; tap image for large)

Access is via the Music Mode Generator Editor PanelF > Parameter Groups > Pattern Parameter.

Tip: Patterns can be used to create hidden structure in a mix. Set up a Generator to be of Type Pattern 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 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.

Pattern Types (see the Pattern Editor and Pattern Syntax):

  • Both: Includes both scale interval and note duration; used when you want to work with a "melodic" pattern.
  • Rhythm: Includes note durations only; 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).
  • Fixed: Both the root pitch and note pitches are explicitly defined (i.e. there is no dependency on scale rule); used mostly for beat patterns using Channel 10 MIDI.
  • Sequence: Allows sequencing, if required, of any combination of the patterns above, i.e. types B, R or F.
AMenu Bar

Menu Buttons: 2,6,7.

BToolbar

The Toolbar has buttons that allow you to add and delete patterns, and change their order.

1Add Pattern Button

Tap for a pop-up menu (the Pattern type is shown at the end in brackets, e.g. B,R or F). See also Pattern Syntax.

Tap the item you want and it is added to the bottom of the Pattern List:

  • 1 Bar - Random 1/4 notes (B)
  • 1 Bar - Random 1/8 notes (B)
  • 1 Bar - Random 1/16 notes (B)
  • 1 Bar - Random Triplet notes (B)
  • 1 Bar - Random syncopated (B)
  • 1 Bar - Ascending pitch (B)
  • 1 Bar - Descending pitch (B)
  • 1 Bar - 1/4 notes (R)
  • 1 Bar - Whole Note Rest (B)
  • 1 Bar - Whole Note (B)
  • 1 Bar - Fixed 1/4 notes (F)
  • 1 Bar - Fixed & Rest 1/4 notes (F)
  • Sequence: 2 Patterns
  • Sequence: 3 Patterns
  • Sequence: 4 Patterns
2OK/Back Button

Tap the OK button to accept changes you have made.

3Pattern Selector

Tap a Pattern item to select it and display the following pop-up menu:

  • Edit - Graphical
  • Edit - Text
  • Export to Clipboard
  • Import from Clipboard
  • Pattern Presets...
  • Move Up
  • Move Down
  • Delete
4Move Up Button

Moves the selected pattern up the Pattern List.

5Screen Title

Displays the name of the screen.

6Move Down Button

Moves the selected pattern down the Pattern List.

7Action Button

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

Tap the item you want and it will replace everything in the Pattern List.

  • 1 Pattern - 1 Bar Rest (B)
  • Sequence: #1 once, #2 once...
  • Sequence: #1 twice, #2 twice...
  • Sequence: #1 or #2 twice, then #1 or #2 twice...
  • Sequence: #1 once, #2 until end...
8Cancel Button

Discard any changes you have made.

9Delete Pattern

Deletes the selected pattern.

10Pattern List Item Number/Type

Display the list item number and the Pattern type, e.g. #1 Both.

11Pattern Type - Both

The text string for a Pattern of type "Both". See also Pattern Syntax.

12Pattern Type - Rhythm

The text string for a Pattern of type "Rhythm". See also Pattern Syntax.

13Pattern Type - Fixed

The text string for a Pattern of type "Fixed". See also Pattern Syntax.

14Pattern Type - Sequence

The text string for a Pattern of type "Sequence". See also Pattern Syntax.

15Pattern Editor Button

Displays the appropriate Pattern Editor for the Pattern type, these being Both, Rhythm. Fixed or Sequence. See also Pattern Syntax.

16Selected Pattern

The selected pattern has a light blue background.

Editor: Music: Pattern

Menu Bar Toolbar OK/Back Button Edit Mode Button Bars Button Note Length Button Screen Title Note Align Button Undo Button Action Button Cancel Button Redo Button Bars Scale Rule Elements Grid Note Button

Music Mode: Pattern Editor (type "Both" shown)
(tap circle for info, hover for tooltip; tap image for large)

Pattern: Both

Pattern: Both
Tap image for large


Sub-Pattern: Rhythm

Pattern: Rhythm
Tap image for large

Pattern: Fixed

Pattern: Fixed
Tap image for large

Pattern: Sequence

Pattern: Sequence
Tap image for large

Access is via: Pattern Selector3 > "Edit - Graphical" menu option or the Pattern Editor Button15

Most of the interface is common, but what is shown in the grid area varies depending on the Pattern type - see Grid X-axis11 and Grid Y-axis12.

See the Pattern List. See also Pattern Syntax.

AMenu Bar

UI Elements: 1,8,9.

BToolbar

UI Elements: 2,3,4, 6, 7, 10.

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 a pop-up dialog that lets you select the note length you wish new notes to have when you add them (Default 60 / 1/4 note - see also Pattern Syntax):

  • 240 (semibreve / whole note)
  • 120 (minim / 1/2 note)
  • 60 (crotchet / 1/4 note)
  • 30 (quaver / 1/8 note)
  • 20 (triplet)
  • 15 (semiquaver / 1/16 note)
  • 10
  • 5
5Screen Title

Displays the name of the screen.

6Note Align Button

Tap for a pop-up dialog that lets you select the "snap to grid" resolution you have when you add a new note (Default 60 / 1/4 note - see also Pattern Syntax):

  • 240 (semibreve / whole note)
  • 120 (minim / 1/2 note)
  • 60 (crotchet / 1/4 note)
  • 30 (quaver / 1/8 note)
  • 20 (triplet)
  • 15 (semiquaver / 1/16 note)
  • 10
  • 5
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
    • Lets you set the selection weighting for this Pattern (Defualt: 100)
  • 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 Pattern Text to Clipboard
    • Exports the current Pattern (as text) to the clipboard.
  • Import Pattern Text from Clipboard
    • Imports a Pattern that is on the clipboard and replaces the existing Pattern with that.
  • Edit Pattern 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
    • Goes to the Pattern Syntax page in the online WME 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

Editor: Music: TTM

Toolbar OK Button Display Text Toggle Calculated Notes Indicator Screen Title Shuffle Option Button Action Button Cancel Button Randomize Button Text Area Music Mode Tab

Music Mode: TTM Editor
(tap circle for info, hover for tooltip; tap image for large)

This is a special editor for entering custom TTM text, rather than relying on cut-up being generated in the Text Mode and then associated via a line number association (see WME TTM Cut-up Rule parameter).

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.

Tip: Use the Randomize button for a quick and easy way to create some custom cut-up text!

AMenu Bar

UI Elements: Menu Bar buttons1,6,7.

BToolbar

UI Elements: Menu Bar buttons2,5,8.

1OK Button

Tap the OK button to accept changes you have made.

2Display Text Toggle

When this toggle is on and you use in a TTM Generator, your TTM text will show in full screen mode.

3Calculated Notes Indicator

Shows you the number of notes your text generates.

4Screen Title

Displays the name of this Editor.

5Shuffle Option Button

Tap the button for a Popup menu where you can set what happens when you press the Randomise Button8.

Popup Menu:

  • Shuffle Words
    • Existing TTM words in this text area will be randomly shuffled.
  • Shuffle Text
    • All characters in existing TTM words in this text area will be randomly shuffled.
  • Random Words (Default)
    • 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.
6Action Button

Popup Menu:

  • Clear Text
    • Clears the text in the text area.
  • Export to Clipboard
    • Allows you to export the TTM text e.g. randomizations you have made (there are some restrictions prior to an IAP tier being active).
  • Import from Clipboard
    • Import text to be used for your TTM.
7Cancel Button

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

8Randomize Button

Carries out the action set in Shuffle Option Button5.

9Text Area

Tap the screen to enter your TTM text.

10Music Mode Tab

This editor is only available in Music Mode.

Editor: Music: Envelope

Menu Bar Toolbar OK Button Envelope Area Draw/Macro Selector Screen Title Selected Envelope Area Macro Selector Selected Macro Music Mode

Music Mode: Envelope Editor
(tap circle for info, hover for tooltip; tap image for large)

Generator Envelopes are supported for the following 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

UI Elements: OK button1.

BToolbar

UI Elements: Draw/Macro Selector3.

1OK Button

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

2Envelope Area

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

3Draw/Macro Selector

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

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

4Screen Title

The screen title.

5Selected Envelope Area

Shows an area that has been selected in Macro Mode.

6Macro 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
7Selected Macro

The selected Macro is shown with a light blue background.

8Music Mode Tab

This editor is only available in Music Mode.

Editor: Text: Overview

See also the quick "How To" tutorial - "Edit Cut-up Text"

Menu Bar Screens Save/Exit Button Screen Selector Button Screen Title Action Button Settings Button

Text Mode: Cut-up & Edit (shown)
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Text Tab29

Wotja Text Cut-Up & Edit screen

Cut-Up & Edit Screen
Tap here for large; Tap image for info

Wotja Text Sources screen

Sources
Tap here for large; Tap image for info

Wotja Text Saved screen

Saved Screen
Tap here for large; Tap image for info

Wotja Text Properties screen

Properties Screen
Tap here for large; Tap image for info

Cool Tip: Your text in Text Mode can be used for "Text-to-Music" (TTM). See the TTM Cut-up Rule.

Text Mode is where you create/edit text used in your mix, whether purely for display purposes or also for "Text-to-Music". Use the Sources Screen to input any source text used for creating cut-up, the Cut-up & Edit Screen to create/edit Cut-up, select cut-up rules, lock words etc. and the Saved Screen to access saved text sections (saved in a mix file).

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

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

UI Elements: 1,4,5.

BScreens

There are 3 different screens in Text Mode, the screen being selected with the Screen Selector Button3.

1Save/Exit Button

Same as the Music Mode Save/Exit1.

2Screen Selector Button

Tap to select one of the 4 different screens in Text Mode.

3Screen Title

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

4Action Button

Displays the Action menu for the Text Screen you are in.

5Settings Button

Takes you to the Settings screen.

Editor: Text: Cut-up & Edit

Menu Bar Screens Toolbar Toolbar Bottom Save/Exit Button Screen Selector Button EOL Rhyme? Toggle Screen Title Edit Text Button 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 Create Cut-up Button Cut-up Mode Button Text Alternatives Bar Selected Text Button Character Count

Text Mode: Cut-up & Edit
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Text Tab15 (above)

The Text "Cut-Up & Edit" screen is the second of the three Text related screens.

It is where you can create a "Cut-up" Text via the Create Cut-up Button16 as well as edit your Text via the Edit Text Button5. The Text or created Cut-up12, Word Locks11, associated Text Rules8 and Saved Text are saved in your Wotja file.

Tapping a word will Lock11 / Unlock10 it (a locked word will not be changed when you press the Create Cut-up Button16).

AMenu Bar

UI Elements: 1,6,7.

BScreens

The three Text Mode screens are selected with the Screen Selector3.

CTop Toolbar

UI Elements: 2,8,5, 20.

DBottom Toolbar

UI Elements: 13,14,16,17.

1Save/Exit Button

Same as the Music Mode Save/Exit1.

2Screen Selector Button

Tap to select one of the 3 different screens in Text Mode. The Cut-up & Edit screen is shown as being selected.

3EOL Rhyme? Toggle

Default Value: Set by the 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.

4Screen Title

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

5Edit Button
Text Mode - Text Editor

Text Mode - Text Editor
Click 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).

6Action Button

Popup Action 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 & More: Takes you to the relevant section of the User Guide.
7Settings Button

Takes you to the Settings screen.

8Edit Rules Button

Default Rule: Set by the 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
Click 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: Add a new 4 4 4 4 rule to the bottom of the Rules List (see also "How to Add/Edit Rules" below.
    • 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
Click 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): Rules List > Action Button > Add Rule.
  • 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: Use the Rule Editor.

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"

9Text Line Number

Show the line number of the Cut-up (see also Rule Syntax).

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

11Text 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.

12Text 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.

13Word Mix Control

Default Value: Set by the 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!

14Use Words Button
Text Mode - Use Words

Text Mode - Use Words - User Library
Click image for large

Default Value: Set by the 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 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!
15Text Mode

The Text screens are only available in Text Mode.

16Create 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.

17Cut-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.
18Text 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.

19Selected Text Button

The selected word is indicated by an underscore.

20Character 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.

Editor: Text: Sources

Menu Bar Screens Toolbar Save/Exit Button Screen Selector Source Selector Button Screen Title Clear Button Action Button Text Area Text Mode Tab Source Selector Menu

Text Mode: Sources
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Text Tab8 (above)

The Sources screen is the first of the four Text related screens.

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

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.

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.

AMenu Bar

UI Elements: 1,6,7.

BScreens

The three Text Mode screens are selected with Screen Selector2. The Sources screen is shown as having been selected.

CToolbar

Shows the Source Toolbar which contains only the Source Selector Button3.

1Save/Exit Button

Same as the Music Mode Save/Exit1.

2Screen Selector

Tap to select one of the 3 different screens in Text Mode. The Sources screen is shown as being selected.

3Source Selector Button

The button shows the selected Source. Tap it to show the Select Source pop-up menu.

4Screen Title

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

5Clear Button

Tap to clear the text from the currently selected Source.

6Action Button

Popup Action 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 & More: Takes you to this online User Guide.
7Text Area

This editable text area displays your source and supports plain text only, i.e. no emoji and no formatting.

8Text Mode Tab

The Tab that selects Text Mode.

9Source Selector Menu

Select from the menu the Source you want to view/edit.

Editor: Text: Saved

Menu Bar Screens Save/Exit Button Screen Title Screen Selector Button Edit Button Action Button Selected Saved Text Saved Text Item Text Mode

Text Mode: Saved
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Text Tab8 (above)

The Saved screen is the third of the four Text related screens / sections.

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

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.

AMenu Bar

Menu Buttons: 1,4,5.

BScreens

The three Text Mode screens are selected with the Screen Selector3.

1Save/Exit Button

Same as the Music Mode Save/Exit1.

2Screen Title

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

3Screen Selector Button

Tap to select one of the 3 different screens in Text Mode. The Saved Screen is shown as being selected.

4Edit Button

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

5Action Button

Popup Action 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 creted 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
                
6Selected Saved Text

A grey background indicates the currently selected item in the list.

7Saved Text Item

Tap a Saved Text Item to select it.

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.

8Text Mode Tab

The Tab that selects Text Mode.

Editor: Text: Properties

Go to the Mix Text Properties List

Wotja Mix Text Properties screen

Text Mode: Properties
(tap circle for info, hover for tooltip; tap image for large)

The Text Properties screen is the last of the four Text related screens.

It is where, for each mix, you set how you want text to be used by the mix (see below).

Text to Speech (TTS)

iOS 13+; macOS 10.14+; tvOS 13+ only

How it works

Text to Speech is based around a concept of Speech Voices and Locales.

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 Properties List

  • Mix Automatic Text Change
    • At Mix Start
      • Default Value: Set in the 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: Set in the 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: Set in the 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: Set in the Randomization Preset
      • Values: 3-1000
      • The range in value that can apply to the above time.
    • Use Saved Section Text?
      • Default Value: Set in the 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: Set in the 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
  • Text to Speech: Voice Selection
    • Voice Name
      • Default Value: Set in the 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
    • Allow Regional Variations
    • Speech Gender
      • Default Value: Set in the 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

Editor: Display

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

Display Mode: Display (shown)
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Display Tab10

The Display Mode (also referred to as Display Screen) is where you set up how your wotja mix is displayed. Those settings for that are located in the Display Properties screen.

Wotja Display Show screen

Display: Show
Tap here for large; Tap image for info

Wotja Display Properties screen

Display: Properties
Tap here for large; Tap image for info

AMenu Bar

Menu Buttons: 1,5,6 and 3.

BToolbar

Toolbar Buttons: 2,4.

1Save/Exit Button

Same as the Music Mode Save/Exit1.

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
Mix Display Properties Screen

Display Properties Screen
Click image for large

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

The Display Properties parameter list ordering 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: We know it is 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.

Note 1: Palettes have an opacity setting of about 25% which allows the lower layer background color to also have an affect.

Note 2: SVG images can include transparency/opacity in which case a Visualizer and/or Background color below it can also been seen.

  • Display Properties Screen

    • Text Color
      • Default Value: White/black as set by the palette selected in the 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: Set by the 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
      • 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.
        • See the Tutorials and the Included Album Calm or Relax for an example of use of an SVG with transparency.
      • Select Palette
        • Default Value: Set by the 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.
        • 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   - - - - - - -
          Dark Zone   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   - - - - - - -
          Light Zone   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   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: Set by the 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: Set by the Randomization Preset
      • Values: None; Lattice; Vortex
        Wotja Visualizer - Lattice

        Lattice
        Click image for larger


        Wotja Visualizer - Lattice

        Vortex
        Click image for larger

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

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 Text Area

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

8Screen Background

This displays either a solid colour, a screensaver or a background image depending on what has been selected in the Display Mode Background and Picture buttons. See the Picture Button5 and the settings in the Background Button3.

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.

Editor: Plug-in Host

Some initial information is captured here, but this section is still very much work in progress, sorry!

Wotja 22: we've added added support for plug-in hosting by the main Wotja app (iOS, macOS, Windows). Plugins can be in AUv3 format (iOS 14+, macOS) or VST3 format (Windows 10/11).

The hosted plug-ins are "external" to the main Wotja application.

You can view the hosted plug-ins in the new Plug-ins tab.

Wotja plug-in hosting works by presenting you with a number of Chains of Instruments / FX. The first several chains are "Instrument" chains, that allow you to (first) choose a 'source' instrument (AUv3/VST3, depending on platform) in the first 'slot', and one or more FX in the following slots in the chain. The last 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.

Instrument chains

There are 5 of these. You can use as many, or as few, as you want.

Instrument slot (the first slot):
  • Touch/click the slot to browse from the available instrument plug-ins. Choose your favourite instrument plug-in!
Wotja Instrument:
  • the "final output" from Wotja's Mix-level effects is presented as a "Wotja Output" 'Instrument' in the plug-ins tab when you try setting the instrument slot browser. If you select the "Wotja Output" as 'Instrument' for an FX Chain, then you can of course add other AUv3 FX within the chain to further treat it.
Wotja Instrument - audio filtering:
  • By default, your Wotja Mix output in a chain will have output from the Mix FX. However, if you only want it to be driven by the sum of Wotja outputs from Tracks 2 and 3, select these tracks as your Track filter option.
AUv3/VST Instrument:
  • create a chain with your fave AUv3 Instrument as the Instrument
AUv3/VST Instrument - MIDI filtering:
  • The instrument you select, gets its MIDI data from all MIDI data delivered by all Wotja tracks. However, if you only want it to be driven by (say) MIDI channel 2, select this as your filter using the option you see in the chain.
Slot menu:
  • Menu icon might show on right of the slot, if you have certain extra options available to you.
Chains - how they're mixed:
  • If you have 2 or more FX 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.

Master FX Chain

  • You have a Master FX chain at the end, where you can apply AUv3/VST3 FX to the summed outputs of all the other FX chains you have set up. You can configure this to use zero, 1 or more FX that are applied the summed output of all Instrument chains.

More info

  • 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
  • Easy to use Wotja Audio and/or audio from external Instruments Plug-ins and/or external Effects
  • Your plug-ins work even when using the Recording tab!
  • Your plug-ins work even when in albums / playlists!

Using Plug-in Hosting: Example

Tip: The "final output" from Wotja's Mix-level effects is presented as the "Wotja Output" 'Instrument' in the Plug-ins tab when you try setting the slot instrument.

  1. Tap "Select Instrument"Plug-in Hosting 1
  2. Tap "Browse Plug-ins"Plug-in Hosting 2
  3. Select "Wotja Output"Plug-in Hosting 3
  4. To add an FX Plug-in, tap "Select FX" and select "Browse Plug-ins"Plug-in Hosting 4
  5. To filter the Wotja Mix Tracks used, tap the "Wotja Tracks" filter button above itPlug-in Hosting 5
  6. Select the Tracks you want and returnPlug-in Hosting 6
  7. You can now see the Wotja Mix Tracks are filtered (1,3,5,7)Plug-in Hosting 7
  8. Instead of using Wotja Out in 3), select an Instrument Plug-in, e.g. AUMIDISynthPlug-in Hosting 8
  9. To filter MIDI by Wotja Mix Track and/or MIDI Channel, tap the "MIDI:" button above it (see 8)Plug-in Hosting 9
  10. Make your selections for either/bothPlug-in Hosting 10 Plug-in Hosting 11
  11. Here you have selected only Wotja Track 2 and MIDI Channel 6Plug-in Hosting 12
  12. Exit this screen and see you are MIDI Filtering for Wotja Track 2 and MIDI Channel 6Plug-in Hosting 13

Editor: Record

See the "How To" tutorials - "Make a Recording", "Delete a Recording" & "Preview a 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

Music Mode: Record
(tap circle for info, hover for tooltip; tap image for large)

Documents > Mix File14 > Mix Edit Modes > Record Tab37

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 Recording Format Selector2).

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.

Usage:

  • Select your desired recording format: Recording Format Selector2.
  • Start the mixdown: Tap the Record Button9 in the bottom toolbar.
  • Recording progress: The Title Bar3 will show the recording progress (e.g. 4% - 2.67 Mb) and in the middle of the screen a pop-up Recording Progress Indicator8 will display whilst the recording is being made (e.g 35%).
  • Recording complete: The popup will disappear and you will see your recording show up in the Recordings List12 (if you are using iCloud it might take some time depending on how long your recording is).
  • Preview recording: Audio/MIDI recording: Tap the Recording Item7 you want to play/stop, or use the Recording Action Button13 and select Open With.
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 iOS 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)
AMenu Bar

Menu Buttons: 1,4,5.

BToolbar

Toolbar Buttons: 2.

CBottom Toolbar

Bottom Toolbar Items: 9,11.

1Save/Exit Button

Same as the Music Mode Save/Exit1.

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.

4Action Button

When you are using iCloud it can take time for a recording to sync with it. Press this button for an opion to update the recordings list.

5Settings Button

Takes you to the Settings screen.

6Recording Time

Dependent on the setting of the Record Units Toggle11, 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. 4% 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

See the "How To" tutorials - "Desktop Audio Output", "Set a Sleep Timer" & "Set a Mix FX Override"

Menu Bar Screens Toolbar Back Button Randomization Preset Select Button Screen Title Randomization Preset Name Button Group Header Screen Selector Randomization Preset Save Button Store button Info button

Settings (Randomization Screen shown)
(tap circle for info, hover for tooltip; tap image for large)

Wotja Settings General screen

Settings: General Screen
Tap here for large; Tap image for info


Wotja Settings Audio MIDI+ screen

Settings: Audio MIDI+ Screen
Tap here for large; Tap image for info

Wotja Settings General screen

Settings: Randomization Screen
Tap here for large; Tap image for info

Access is via the Settings button found in many screens: Settings Button16.

  • General: Where you set the Sleep timer if required, the User Interface mode (Light or Dark) and UI related settings such as text fade in/out
  • Audio MIDI+: Select your Audio Output Device (macOS/Windows) and settings related to 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 recording etc.
  • Randomization: Where you select and configure Randomization Presets.
AMenu Bar

Menu Buttons: 1,8,9.

BScreens

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

Select the screen you want with the Screen Selector7.

CSettings Toolbar

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

1Back Button

Tap to return to the Mode you came from.

2Randomization Preset Select Button

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

3Screen Title

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

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

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+ | Randomization.

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

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

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.

Settings: General

Go to General Settings List

Wotja Settings General screen

Settings: General Screen
Tap image for large


This is where you set the Sleep timer (if required), the User Interface mode (Light or Dark) and UI related settings such as text fade in/out, display language and see the version number.

See the list below.

General Settings List

  • Sleep Timer
    • Sleep Timer
      • Off; 1 min to 8 hours (Default value - Off)
      • The sleep timer can take values from 1m to 8 hours mins. 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).
    • 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.
    • Show 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).
    • 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.
    • Interaction Colour for Videos
      • Red, Green, Blue, None (Default value - None)
      • This setting enables/disables a Red, Green or Blue "blob" overlay on many UI events and it is for those wanting to create videos of Wotja operation.
      • Note: When it is on it is easier to see what is going on, but the UI will also be a little slower to update.
  • 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

Go to Audio MIDI Video Settings List

Wotja Settings Audio MIDI+ screen

Settings: Audio MIDI+ Screen
Tap image 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.



Audio MIDI Video Settings List

  • 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 versions V21.3+ 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 macOS note below, and also this FAQ.
        • Note 1: V21.2.1 and earlier versions require a restart of Wotja for any change to be applied.
        • Note 2 (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)
      • 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 21 versions 21.3+ 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.
        • Note: V21.2.1 and earlier versions require a restart of Wotja for any change to be applied.
    • 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 21 versions 21.3+ 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.
        • Note: V21.2.1 and earlier versions require a restart of Wotja for any change to be applied.
    • 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 21 versions 21.3+ 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.
        • Note: V21.2.1 and earlier versions require a restart of Wotja for any change to be applied.
    • 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
      • 10-500ms (Default value - 100ms)
      • 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 the AUv3 Host.
      • User Selected (Default value - None)
      • Notes: MIDI Input is only used by Listening Generators.
      • Tap the MIDI Input Devices button to go to the MIDI Input Devices screen where you will see toggles for all MIDI Input Devices detected by Wotja.
      • Network Session (iOS/macOS)
        • Used for detecting MIDI sent via a network (e.g. from a Mac or iOS device over WiFi).
      • IAC Driver Bus (macOS) / loopMIDI port (Windows)
        • Used for detecting MIDI routed via OS system level capabilities.
      • Wotja + Tracks/Channels (iOS/macOS)
        • These allow Wotja to detect MIDI it sends out over Virtual MIDI (see below). As it is a kind of MIDI feedback it is for specialist use and unlikely you will need to use it.
      • App / MIDI Device + Channels
        • All 3rd party MIDI emitting Apps or MIDI devices that Wotja detects (e.g. Thumbjam, MIDIKeys apps, Roland UM-ONE MIDI Interface etc.) will be shown here; toggle on the ones you want Wotja to recieve MIDI input from.
        • Note: Each of the apps have created virtual MIDI ports named after themselves (e.g. Thumbjam, MIDIKeys etc.). You'll only get their output (sent on those ports) into Wotja, if you enable those input ports. For Wotja to see these ports, however, you need to first load the app you want to generate MIDI, e.g. MIDIKeys or Thumbjam and then load Wotja.
        • Tip: When MIDI input triggers notes in Wotja then, as the audio will be playing in Wotja via the WAE, in Settings make sure "ISE for Sounds & FX" is toggled on, and you set the Audio Latency to be some low value. If that is set to 850ms (the default) then your notes will take about 1 second to play!
    • MIDI Transport Control
      • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
      • On/Off (Default value - Off)
      • Wotja's MIDI Input Transport Control / External Clock Sync features allow it to be able to sync to e.g. a DAW:
        • Sequencer
          • Configure your sequencer (e.g. Reaper/Logic, or whatever) to send Transport commands (MMC) and/or MIDI clock to a specific MIDI port
            • Note for iOS: You can route via Network MIDI
          • Make sure your piece in the sequencer is long enough; sequencers will stop sending clock events when they reach the end of their content, and they’ll also automatically emit a stop event.
        • Wotja
          • Activate the MIDI input port/device that you have configured your sequencer to send Transport (MMC)/Clock to (in the previous step)
          • Set tick for MIDI Transport Control
          • Set tick for External Clock Sync
          • Open a Wotja mix, press Play
          • Wotja will say "MIDI: Wait" under the play/stop button rather than elapsed time, and won’t (immediately) show tempo
          • Start your sequencer playing (e.g. Reaper/Logic):
            • Wotja will now start playing
            • The Elapsed time will now display/update
            • The calculated tempo (from the sequencer’s MIDI clock) will display (rather than the internal Wotja tempo)
      • NOTE: There is an oustanding issue that can be revealed if you sync to the incoming MIDI clock using a different tempo.
    • External Clock Sync
      • Note: Setting not available in the Wotja AUv3 Plug-in as that uses the settings of the AUv3 Host.
      • On/Off (Default value - Off)
      • See MIDI Transport Control above as the details are the same.
  • Recording
    • Note: Setting not available in the Wotja AUv3 Plug-in; use the recording facilities of the AUv3 Host.
    • Max Recording Seconds
      • 4-3600s (Default value - 3000s)
      • This setting lets you increase how long you can record for in Record Mode.
      • IMPORTANT: Use with care as recordings are large and your device must have sufficient free memory available. If you try to change this value take note of the pop up message warning before you change it. Also be aware that these the recordings are stored in iCloud (if you are using that), so that could hit your bandwidth.
    • Max Recording Bars
      • Note: Setting not available in the Wotja AUv3 Plug-in; use the recording facilities of the AUv3 Host.
      • 4-3600s (Default value - 100 bars)
      • This setting lets you increase the number of bars you can use to make mixdown recordings in the Record Mode.
      • IMPORTANT: Use with care as recordings are large and your device must have sufficient free memory available. If you try to change this value take note of the pop up message warning before you change it. Also be aware that these the recordings are stored in iCloud (if you are using that), so that could hit your bandwidth.
    • MIDI File Track Grouping
      • Note: Setting not available in the Wotja AUv3 Plug-in which sends MIDI in Omni mode.
      • MIDI Channel/Wotja Track (Default value - "by MIDI Channel")
      • This option determines how MIDI is saved in a MIDI file recording and allows you to have Wotja's MIDI output summed either by Wotja MIDI Channel (default) or by Wotja Track.
      • Each MIDI track in the MIDI file recording is labelled either by MIDI Channel Number or by Wotja Track Number, as appropriate.
      • Use setting "by Wotja Track" if you want the MIDI sent from all generators in Cell 1 summed to MIDI track 1 in the MIDI file and the MIDI sent from all generators in Cell 2 summed to MIDI track 2 in the MIDI file.
      • Use setting "by MIDI Channel" if instead you want the MIDI sent on MIDI channel 1 in Cell 1 and the MIDI sent on MIDI channel 1 in Cell 2 to be summed to MIDI track 1 in the MIDI file.
      • Example: Wotja can have multiple Cells playing at the same time and all generating MIDI. Cell 1 could have say 9 generators each sending MIDI to a different MIDI channel (e.g. 1 to 9) and the same might be the case for Cell 2.
    • Video Recording Size (iOS/macOS)
      • Note: Setting not available in the Wotja AUv3 Plug-in.
      • 640x480, 960x540, 1280x720, 1920x1080 (Default value - 640x480)
      • This setting lets you set the size of the video you wish to record. The larger the size, the longer the recording will take to make.
      • Tip: Recordings featuring a background image do take a *long time* to create.

Settings: Randomization

Go to Randomization Preset Settings List

Wotja Settings General screen

Settings: Randomization Screen
Tap image for large

Wotja has both powerful and customisable randomization capabilities. It is something that one day you may wish to explore and at such time you will be glad that there are so many possibilities!

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

With a Pro Feature Set you can change selections for the currently open/used Randomization Preset and you can save your changes to it, or even save as another one.

What is a Randomization Preset "RP" (AKA previously "Scheme" or "RS")?

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.

What are Randomization Presets for?

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 TTM Text Editor screen - plus a lot more, too.

How do I select/save Randomization Presets?


Randomization Preset Settings List

  • General/Mixes
    • TTM Cells/Column (min)
      • Values: 0-8
      • The minimum number of TTM Players that will be in a column, assuming you have a TTM Pak available for selection when randomizing.
      • See: Cells.
    • TTM Cells/Column (max)
      • Values: 0-8
      • The maximum number of TTM Players that will be in a column, assuming you have a TTM Pak available for selection when randomizing.
      • See: Cells.
    • TTM Words (min)
      • Values: 1-100
      • The minimum number of words that will be added to a Text to Music (TTM) Text field on creating a new random mix or in the TTM Text Editor when using the Randomize button with Randomise option selected.
      • See: Text to Music.
    • TTM Words (max)
      • Values: 1-100
      • The maximum number of words that will be added to a Text to Music (TTM) Text field on creating a new random mix or in the TTM Text Editor when using the Randomize button with Randomise option selected.
      • See: Text to Music.
    • Tracks
      • Values: 1-12
      • The number of Tracks that will have their cell contents (below) randomized (starting with Track 1).
      • See: Cells and Tracks Panel
    • Cells
      • Values: 1-4
      • The number of Cells in the Tracks above that will have their contents repopulated from the list of available templates.
      • See: Cells and Tracks Panel
    • Generative %
      • Values: 0-100%
      • The chance that a randomized Cell will be repopulated with a generative template.
      • See: Cells.
    • Blank Cell %
      • Values: 0-100%
      • The chance that a randomized Cell will be empty.
      • See: Cells.
    • Tempo (Min)
      • Values: 20-400 bpm
      • The minimum tempo of a new, random mix.
      • See: Mix Tempo.
    • Tempo (Max)
      • Values: 20-400 bpm
      • The maximum tempo of a new, random mix.
      • See: Mix Tempo.
    • Volume (Min)
      • Values: 1-127
      • The minimum volume of a track in a new, random mix.
      • See: Track Mixer.
    • Volume (Max)
      • Values: 1-127
      • The maximum volume of a track in a new, random mix.
      • See: Track Mixer.
    • Pan +/-
      • Values: 1-64
      • How far away from center that pan can be for a Track in a new, random mix.
      • See: Track Mixer.
    • Ramp Up
      • Values: 0-20 s
      • How long a mix takes to ramp up to its full volume.
      • See: Mix Ramp Up.
    • Ramp Down
      • Values: 0-20 s
      • How long a mix takes to ramp down to zero volume.
      • See: Mix Ramp Down.
    • Duration
    • Duration Max
    • Duration Range
    • Duration Range Max
  • Cells
    • Generative Bar Min
      • Values: Infinite(0)-1-100
      • The minimum base value for the number of bars a generative template will play for and to which the range value (below) is added. Special Value: If this value is set far left to ∞ then once play in a Track reaches such a cell the generative content in that cell will continue to play either for as long as the mix plays or until you manually select another cell in that Track to play.
      • See: Cell Gen Bars.
    • Generative Bar Max
      • Values: 0-100
      • The maximum base value for the above.
      • See: Cell Gen Bars.
    • Generative Bar Range
    • Cell Repeat Min
      • Values: 0-100
      • The minimum base value for the number of times a cell will repeat after it has played through once and to which the range value (below) is added. For a generative template each bar counts as one repeat; for audio or MIDI content this is the length of the content rounded up to the end of a bar). Note: If the cell contains generative content and the Generative Bar Min is value is set to ∞ then this setting takes no effect as the cell never repeats!
      • See: Cell Repeats.
    • Cell Repeat Max
      • Values: 0-100
      • The maximum base value for the above.
      • See: Cell Repeats.
    • Cell Repeat Range
      • Values: 0-100
      • Sets the range that applies to the above base value.
      • See: Cell Repeats Range.
  • Auto Boxes/Flow
    • Mixes in Box
      • Values: 1-20
      • The minimum number of mixes in an automatically generated Box.
      • See: Playlist Player.
    • Max (Mixes in Box)
      • Values: 1-20
      • The maximum number of mixes in an automatically generated Box.
      • See: Playlist Player.
  • Reset
    • Reset Settings of this Randomization Preset to Defaults
      • Displays a pop-up message allowing you to reset all values back in the Randomization Preset back to their Defaults.

iCloud

iCloud Settings Screen

Wotja Use iCloud (iOS)
Click image for large


iCloud Drive Settings Screen

Set Up/Use iCloud Drive (iOS)
Click image for large


iCloud Settings Screen

iCloud Drive (macOS)
Click image for large


iCloud Drive Settings Screen

iCloud Drive App (Windows)
Click image for large

IMPORTANT: To use iCloud in Wotja you MUST have set up/toggled on iCloud Drive ("iCloud Drive") - See also Apple's iCloud Help resource.

IOS IMPORTANT: You must ALSO have the relevent Wotja App's "Apps Using iCloud" toggle AND the relevent app's Settings "Use iCloud" both toggled on. If you do not want to use iCloud with Wotja turn them both off. If both have different toggle states then when you launch Wotja it can crash. We know it is confusing, sorry!

Using Wotja with iCloud enabled makes it easy to edit/use Wotja files across multiple devices, be they iPhones, iPads, Macs or Windows PCs. When it is enabled then all Wotja files in the iCloud Drive folder are all stored in the cloud, also a great form of backup!

iOS - Set up/Use iCloud Drive:

This screen is where you both turn on the "iCloud Drive" toggle and then set what apps can use it for file saving using the relevant "Apps Using iCloud" toggle.

This screen is accessed as follows: From the iOS Settings Screen > Apple ID, iCloud, iTunes & App Store (Your Name) > iCloud (see also Apple's iCloud Help resource)

  • "iCloud Drive" toggle: This is found after the iCloud Backup toggle. It must be toggled on for any app (including Wotja!) to use iCloud Drive to save data.
  • "Apps Using iCloud" section toggles: Scroll further down the screen to find the version of Wotja that you have installed and then turn the toggle on (e.g. Wotja Pro 20). Both this and the Wotja "Use iCloud" must have the same toggle status or you can get a crash on launching Wotja.

iOS - Wotja "Use iCloud" toggle:

This screen is where you set whether Wotja can use Mobile Data and whether or not it uses iCloud for file saving. It is accessed from the iOS Settings Screen.

  • Wotja "Use iCloud" toggle: Scroll down the iOS Settings screen to find the version of Wotja that you have installed, tap on it and then in the ensuing screen find the App Settings section (e.g. Wotja Pro 20 Settings) and turn on the toggle "Use iCloud". Both this and the Wotja "Use iCloud" must have the same toggle status or you can get a crash on launching Wotja.

macOS - "iCloud Drive" / Wotja "Use iCloud":

See also Apple's iCloud Help resource.

  • "iCloud Drive" toggle: From the macOS System Preferences screen go into iCloud and in the ensuing iCloud screen ensure the iCloud Drive setting is toggled on.
  • Wotja "iCloud Drive" toggle: In the iCloud screen above tap on the iCloud Drive "Options" button and in the ensuing screen (shown left) select the Documents tab and scroll down the screen to find the version of Wotja that you have installed and then turn the toggle on (e.g. Wotja Pro 19).

Wotja iCloud Drive App screen (Windows):

The Windows iCloud Drive app is required to enable/synch iCloud files on your Windows PC (and thus the Wotja iCloud Drive folder). To set it up find/load the Windows iCloud Drive app and ensure iCloud Drive is toggled on.

Important Note: Wotja for Windows will by default save Wotja files to the Wotja Folder (you can however choose to save to the Wotja iCloud Drive folder using File Save As). All mixdown recordings are always saved to the Wotja Folder. The Wotja Documents screen will, however, only display/load files from the Wotja Folder. If you have saved Wotja files to the Wotja iCloud Drive folder then to see them in the Documents screen simply move them to the Wotja Folder and then press the Action button in the Documents screen and select refresh.

In-App Store

Wotja In-App Store

Wotja In-App Store
Tap image for large

Subscriptions are common to iOS, iPadOS, macOS and tvOS apps. This means you can purchase your desired 'Play' or 'Pro' Feature Set (FS) Subcription and it will unlock it on the relevant devices!

Tip: If you want a Pro Feature Set but don't like Subscriptions, tap the top "Pro" button to go the App Store page where you can purchase the paid-for version.

The free versions for macOS/iOS and iPadOS contain an In-App Store that allows purchase of In-App Feature Set (FS) Subscriptions.

In these versions The In-App Store can be accessed from Documents > Store button or the Settings Screen > Store button (shown only in macOS/iOS/iPadOS versions).

Note: The In-App Store is not available in the AUv3 Plug-in.

  • 'Feature Set (FS)' [more info] Group:
    • Pro (All Devices):
      • Whilst active, this Subscription unlocks the 'Pro' Feature Set in the Wotja App and Wotja AUv3 Plug-in for macOS, iOS and iPadOS, as well as the Wotja App on tvOS (the 'Lite' Feature Set is re-instated when the Subscription expires).
    • Pro (Mobile Devices):
      • Whilst active, this Subscription unlocks the 'Pro' Feature Set in the in the Wotja App and Wotja AUv3 Plug-in for iOS and iPadOS only (the 'Lite' Feature Set is re-instated when the Subscription expires).
    • Pro (All Devices):
      • Whilst active, this Subscription unlocks the 'Play' Feature Set in the Wotja App for macOS, iOS and iPadOS, as well as the Wotja App on tvOS (the 'Lite' Feature Set is re-instated when the Subscription expires).
    • Play (Mobile Devices):
      • Whilst active, this Subscription unlocks the 'Play' Feature Set in the in the Wotja App for iOS and iPadOS only (the 'Lite' Feature Set is re-instated when the Subscription expires).

Wotja 22 Pro: There is no In-App Store in the paid-for Wotja 22 Pro because it does not include any auto-renewing In-App Subscriptions. If you need or want them, simply get one of the free macOS/iOS/iPadOS versions. In the future we may add an In-App Store but only for one-off tips.

Note: When a Subscription is active "Subscribed" is shown in blue instead of the price. To restore a Subscription tap the top right Restore button.

Manage Subscriptions

It is easy to manage your Wotja Subscriptions, as follows:

  • Tap the "Manage Subscriptions" button in the "Miscellaneous" section (this is just below the Subscriptions themselves).
  • This takes you to a page in the relevant Apple App Store where you can see your active Subscriptions and manage them.
  • Apple info: For Apple information on managing subscriptions please refer tohttps://support.apple.com/en-us/HT202039
  • See also the FAQ entry on In-App Subscriptions.

© 2004-2022 Intermorphic Ltd. All Rights Reserved. Subject to Change. E & OE. See also Credits.