V20.12.7 | 21st Dec 2020 | | IME ISE IWS Pak

Wotja ( "watch-ah" [Siri "Woa-chah"]) is an awesome 'generative music' creator/composer, mixer, lab & player system.

It is regularly updated and has got a rich history, being the evolution of SSEYO Koan, Noatikl, Mixtikl, Liptikl & Tiklbox.

Use it to generate royalty-free background music, ambient & melodic soundscapes, lush drone mixes, reflective text-to-music, MIDI & ideas e.g. for personal enjoyment or for use in videos, podcasts & presentations, on CDs & DVDs etc. as well as in live installations.

Wotja Users say: "Essential music app", "Nothing compares", "Masterpiece", "A gem", "Incredible, fantastic, wonderful, inspiring", "Simply the best ambient app ever made!"

• Create, Explore & Experiment: Easily make generative mixes from 100s of editable templates. Optionally explore powerful generative music, adaptive music, text-to-music, sound design, mixing, cut-up, scripting & randomization techniques.
• Play & Relax: With one tap use 'Flow' to auto-generate & play a continuous stream of live mixes - perfect for relaxation, reflection, meditation, sleep & installations. Playlist your own mixes too!
• Experience the 'Now': Being more 'In the Moment' has never been so important. As a live music generator Wotja can help with that - experience many beautiful moments to treasure.
• Share: Distribute your creation by email or as a web-shareable mix, box or URL, or as a video, audio or MIDI recording.
• Business Use: Easy licensing for Commercial Use by businesses.
• Use Wotja for free: Get the powerful Wotja creator player!

Wotja Platforms, Devices & Languages

Platforms: iOS, macOS, Windows, Android/Android TV, tvOS/watchOS | See Wotja V20 Requirements

Devices: iPhone, iPad, iPod touch, Mac, PC, Laptop, Tablet, Mobile, Watch | Apple TV, Fire TV, Android TV

Languages: English, Chinese, Japanese

Guide & Companion Guides

This User Guide is for all Wotja V20 versions and Feature Sets. It is complemented by these standlaone companion Guides:

• V20 Intermorphic Music Engine (IME)
• V20 Intermorphic Sound Engine (ISE)
• V20 Intermorphic Wotja Script (ISE)
• V20 Pak Creator 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 BarA

#: Button/selector e.g. Cell Selector15

#: Display item e.g. MIDI Channel31

#: IME (Generators) e.g. Generator Button29

#: ISE (Sounds, FX) e.g. Generator FX Button34

It's very easy to use Wotja, especially as a generative music player; see the Flow Player and Playlist Player Quick Starts below.

Wotja is also rewarding to use as a powerful creativity system for generating ideas, melodies, music and even cut-up text. If you want to try using it for that then check out the Create & Play Quick Start below. See also our video tutorials.

Let's start off by playing some things - you could also check out the Wotja TV Player & companion Wotja Watch Player apps, too!

Note: In Lite Mode all files have a bottom left badge which shows the auto-timeout time, that being either minutes (60) or minutes (2). This badge is not shown in Play or Pro Feature Sets.

Flow Player - Quick Start

"Flow" Screen
Click image for large

The Flow segment shows a list of all the Randomization Schemes (RS) included in Wotja (as well as any that are in the Wotja Folder i.e. any you have created yourself). These are used by the Flow Player to auto-generate a succession of generative music mixes. 2 taps is all you need - what could be easier!

1. In Documents use the Screen Selector7 to choose the Flow screenB.
2. Tap any one of Flow buttons8 (e.g. "Go") to start the Flow Player with that Randomization Scheme.

It auto-generates mixes until stopped or a sleep timer (or Lite Mode timeout) kicks in.

Tip: To save a Flow to a mix file (Pro Mode) or Box file (Play or Pro Mode) use the relevant Flow Player > Action button menu item.

It really is as easy as that!

Playlist Player - Quick Start

"Included" Albums Screen
Click image for large

The easiest way to check out the Playlist Player is with an "Included" Album. An Album is just a 'Box' playlist that is specially packaged for inclusion in Wotja.

1. In Documents use the Screen Selector7 to choose the Albums screenC.
2. Tap the "Included" segment and then an Album button11 (only the first button is available in Lite Mode) and the Album will start playing in the Playlist Player.
3. In the Playlist Player press the Play button6 to stop/start playback.

Alternatively, create (see below) and play your own playlist/box of mix files:

1. Tap on an existing Box file12 or Playlist file13; it will auto-open in the Playlist Player.
2. In the Playlist Player press the Play button6 to stop/start playback.
3. Edit your playlist: Try out the Mix Actions button19; change mix ordering etc. and use Mix Overrides to change the mix duration (Box only).

Create & Play - Quick Start

"Mixes" Screen
Click image for large

The Mix Player can be used to create, play and edit 'mix' files (.wotja).

1. In Documents use the Screen Selector7 to choose the Mixes screenD.
2. To auto-generate a new mix file based on the settings in the currently selected Randomization Scheme tap the Add New button15 and from the pop-up menu select 'Mix (Automatic)'.
3. Tap on the Mix file button16 to open it in the Mix Player.
4. In the Mix Player press the Play button8 to stop/start playback.
5. Edit your mix: Try one of the Mix Player "Editing Modes" (Music, Text or Display).

Alternatively, make and play an auto-generated 'box' (.wotjabox) of mix files:

1. In Documents use the Screen Selector7 to choose the Albums > User screenD.
2. Tap the Add New button10 and from the pop-up menu select 'Box (Automatic)' to auto-generate a new Box file12 based on the settings in the currently selected Randomization Scheme; this will auto-open in the Playlist Player.
3. In the Playlist Player press the Play button6 to stop/start playback.

See also this Youtube video: Wotja: 'Lite' vs 'Pro' - Which is right for you? (10 mins)

The Wotja V20 app range includes two creator player variants - a paid-for version and a free version (see below).

The features and capabilities that each operates with is called its Feature Set (abbreviation FS) or Feature Mode (AKA 'Mode'). There are 3 distinct Feature Sets, these being Pro, Play and Lite - see the Feature Set Table below.

Wotja Pro 20

A paid-for app with a Pro Feature Set (AKA 'Pro Mode'), meaning all Feature Set Restrictions are unlocked. These versions have no In-App Store, are only available in 2020 and will get all relevant Wotja V20 updates during the course of that year.

Wotja

A free app with a default Lite Feature Set (FS) (AKA 'Lite Mode'). These versions get rolling updates whatever the year.

The iOS & macOS versions include an In-App Store that allows purchase of monthly "Dual" In-App Subscriptions that work in both. Subscriptions are easy to cancel should you no longer wish to Subscribe.

• 'Feature Set (FS)' Subscription:
  • Pro: Unlocks the Pro Feature Set (AKA 'Pro Mode').
    • Other names have been used for this in the past e.g. S, Pro S and Pro LX.
  • Play: Unlocks the Play Feature Set (AKA 'Play Mode').
• 'Special Options (SO)' Subscription:
  • T0/1/2/3/4 for tip jar donations or Commercial Use (CU) by businesses.

Wotja Feature Set Table

The table below shows the main differences between the Pro, Play and Lite Feature Sets (AKA 'Modes') for Wotja V20.12.7. Feature Set Restrictions shown in red.

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 (IME, ISE, ITE)
  2. .wotjabox [Box 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:
  • .zip, .sf2, .midi, .wav, .ogg (or image) files
    • .sf2 [and in Paks] can be referenced in templates via an ISE Wavetable Unit.
    • .wav, .ogg, .midi [in Paks] can be added to a Cell via the Template List.
    • .jpg/.png image files can be added as a background to a mix file via the picture setting
    • See also the FAQ: File Management - Where should I put or look for App Files, Zips, SF2, WAVs etc.?.
• Wotja can save/use:
  1. .noatikl [Template (Noatikl) file]: Via Music Mode > Grid > Cell Actions > Export to Template
  2. .wotjarp [Randomization Scheme file]: AKA "Scheme" or "RS"
  3. .tg [ISE Synth Network file]: AKA "Synth Preset"
  4. .fxm [ISE 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: a mix file webpage embedded as a URL (see Export Mix to Clipboard and Sharing)
  2. Plain text: words/characters, cut-up, cut-up rules, patterns etc.
  3. .tg, .fxm: as above

The Documents screen is what you see after you have launched the app. In it you can use the Screen Selector7 to select one of three different file views or screens: FlowB, AlbumsC or MixesD. What you see on the Live Use2 and Feature Set4 buttons depends on the version you have and (as available) the active Subscription tier(s).

Note: In Lite Mode all files have a bottom left badge which shows the auto-timeout time, that being either minutes (60) or minutes (2). This badge is not shown in Play or Pro Feature Sets.

Desktop vs Mobile

In the User segment 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^

Menu Bar^

UI Elements: Menu Bar buttons12456 and a Screen title3 that is always "Wotja".

BFlow Screen^

Flow Screen^

The Flow screen is selected with the Screen Selector7.

UI Elements: Flow button8 and Randomization Scheme Name9.

CAlbums Screen^

Albums Screen^

The Albums screen is selected with the Screen Selector7. It includes 2 sub-segments, "User" and "Included".

Note: For an album to be shown it must be in the (relevant) Wotja folder.

DMixes Screen^

Mixes Screen^

The Mixes screen is selected with the Screen Selector7.

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

1Action Button^

Action 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).
• Sort
  • Selected Option...
    • Sort: New-Old
    • Sort: Old-New
    • Sort: A-Z
    • Sort: Z-A
• Help & Documentation
  • Visits this User Guide online.
• Cancel
  • Closes the popup menu.

2Special Options (SO) Button^

Special Options (SO) Button^

The Special Options (SO) button will display the name of the active Special Options Subscription Tier. These are Subscriptions are for Commercial Use Licensing and for 'Super-fans'. Tap on it for a screen with further information.

• Wotja Pro 20 (paid-for version)
  • Button always shows SO:None as there is no In-App Store to allow purchase of a Special Options (SO) Subscription
• Wotja (free/subscription version)
  • Button shows SO:None by default meaning there is no active Subscription
  • Button shows SO:C0, SO:C1, SO:C2, SO:C3 or SO:C4 (as appropriate) if you have an active Special Options Subscription (as available)
  • Note: Special Options Subscriptions (as available) can also be used as a form of tip jar!

3Screen Title^

Screen Title^

The Screen title in Documents is always Wotja.

4Feature Set Button^

Feature Set Button^

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

• Wotja Pro 20 (paid-for version)
  • Button shows Pro
• Wotja (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 S' Feature Set Subscription

5Store Button^

Store Button^

NB: The Store button is not shown in the Wotja Pro 20 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 Pro 20 version on the relevant App Store.

6Settings Button^

Settings Button^

The Settings button takes you to the Settings screen.

7Screen Selector^

Screen Selector^

Tap a "segment control" to select a screen, these being the FlowB, AlbumsC (with two sub-screens) or MixesD screens.

8Flow Button^

Flow Button^

1. Tap a Flow button8 to start the 'Flow Player'.
2. The Flow Player will use the Randomization Scheme Name9 shown beneath the button.
3. Both Built-In and user-saved Randomization Schemes are shown, e.g. My Scheme9.

9Randomization Scheme Name^

Randomization Scheme Name^

This shows the name of the Randomization Scheme that is used by the Flow button above it.

The name of a built-in Randomization Scheme is not editable but you can edit the name of your own saved Scheme 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, you can go to Settings > Randomization, open your Scheme and then re-save it with a different name.

10Add New Button^

Add New Button (Albums)^

Tap the Add New button13 for the following pop-up menu:

• Play List
  • Creates a new playlist file (.wotjalist) and then opens it in the Playlist Player where you can add to it the Wotja files you want to be in it.
• Box (Automatic)
  • Creates a new automatic collection of mixes (a 'Box') based on the Randomization Settings and opens in the Playlist Player.

11Album Button^

Album Button^

1. Tap a Built-In Box Album button11 (presently Calm or Relax) to load it in the Playlist Player.
2. Each Album displays an Album badge11.
3. Below the Album button is the Album name12.

12Album Badge^

Album Badge^

The Album badge is used to indicate this is an Album (Box file .wotjabox, see Filetypes). Included albums have an IM icon as a badge.

Tap the Album button to load it the Playlist Player.

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

How to create an Album/Box file (.wotjabox)

1. In the Mixes screenD tap the Add New button10 and select "Box (Automatic)" from the pop-up menu; or
2. In the Playlist Player tap the Action button and select "Save Wotja Box to File".

13Playlist Badge^

Playlist Badge^

Tap the button for a Playlist File19 to load the playlist in the Playlist Player.

A Playlist file button (.wotjalist, see Filetypes) has a playlist badge. If the Playlist includes a background image then you will see that image on the Playlist File button otherwise it will display a list of the included files.

How to create a Playlist file (.wotjalist)

1. In the Albums > User screenD tap the Add New button13 and select "Play List" from the pop-up menu.

14Album Name^

Album Name^

The name of a Album (i.e. Box file). Tap the button to edit the name (see File Name button17).

Note: the names of Included Albums cannot be changed.

15Add New Button^

Add New Button (Mixes)^

Tap the Add New button15 for the following pop-up menu:

• Mix (Automatic)
  • Creates a new random mix file based on the Randomization Settings (meaning you do not have to make one via the Templates List) 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.
• Empty Mix (Cut-up Text)
  • Creates a mix with no Cells populated (but still includes a Cut-up) and then opens it in Text Mode.

16Mix File Button^

Mix File Button^

Tap a Mix File button14 to open the mix in the Mix Player.

A Mix File button (.wotja, see Filetypes) has no badge. Its appearance depends on a number of factors:

1. Randomization Scheme
   • 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 Scheme that is used.
2. Cells
   • Is content in one or multiple cells?
3. Filetype
   • Is it an old format Wotja file or Mixtikl file?
4. Manually changed
   • You may have removed the background (Mix File button16) or added a background image (Mix File button17).

How to create a Mix file (.wotja)

1. In the User screenD tap the Add New button13.
2. From the pop-up menu select (as relevant) "Mix (Automatic)", "Mix (from Clipboard)" or "Empty Mix (Cut-up).

17File Name Button^

File Name Button^

Tap on the File Name button17 (below a Mix File button16) 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.

18Mix File Button^

Mix File Button^

This is the Mix File button for a mix file created with Add New > Mix Empty.

See also: Mix File button14

19Mix File Button^

Mix File Button^

This is the Mix File button of a mix file to which you have added a background image (see: Display Mode > Picture button5).

See also: Mix File button14

20Template Badge^

Template Badge^

Tap the button for a Template File20 to auto-convert it to a .wotja mix file before being opened in the Mix Player.

A Template file button (.noatikl, see Filetypes) has a template badge.

How to create a Template file (.noatikl)

1. Open a mix in the Mix Player and go to Music Mode.
2. Select the Cell button15 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 the User screenD and you can also find it in the Template list under Saved Files9.

The Desktop versions of Wotja 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 in 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: If you change the Audio Output device selection you will need to restart Wotja. See this FAQ.

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

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

Wotja (App Name)^

Note: Depending on the version you have the App Name is either "Wotja" (free app) or "Wotja Pro 20" (paid-for app).

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

File Menu^

• New...^
  • Mix (Automatic)
    • Creates a new random mix file based on the Randomization Settings and then opens it in the last opened Mix Mode.
  • Mix (from Clipboard)
    • Imports a mix file on the Clipboard and creates a new mix file.
  • Empty Mix (Cut-up Text)
    • Creates a mix with no Cells populated (but still includes a Cut-up) and then opens it in the last opened Music Mode.
  • Play List
    • Creates a new playlist file (.wotjalist) and then opens it in the Playlist Player where you can add to it the Wotja files you want to be in it.
  • Box (Automatic)
    • Creates a new automatic collection of mixes (a 'Box') based on the Randomization Settings and opens in the Playlist Player.
    • Keyboard shortcut: Cmd+N (macOS) or Ctrl+N (Windows).
• Open^
  • Shows a list of openable files using a standard Finder or Windows Explorer browse dialog.
  • The filetypes that this app can open directly are: .wotja, .wotjalist, .wotjabox, .noatikl and .mixtikl and .liptikl.
  • Note: Wotja cannot directly open .zip, .sf2, .midi, .wav or .ogg files
    • .sf2: can be referenced in templates via an ISE Wavetable Unit
    • .wav, .ogg, .midi [in correctly formatted Paks]: can be added to a Content Cell via the Template List
  • See the FAQ: File Management - Where should I put or look for App Files, Templates, Randomization Presets, Zips, SF2, WAVs etc.?.
  • Keyboard shortcut: Cmd+O (macOS) or Ctrl+O (Windows).
• Close^
  • Close the currently open file (i.e. tab).
  • Keyboard shortcut: Cmd+W (macOS) or Ctrl+W (Windows).
• Save / Save As^
  • For the currently open file displays the Save dialog allowing you to browse to where you want to save to:
    • If you have iCloud enabled then for your files to show in the Documents folder you must save to the Wotja iCloud folder.
    • If you are not using iCloud, we strongly recommend saving files to the Wotja Folder.
    • See the FAQ: File Management - Where should I put or look for App Files, Zips, SF2, WAVs etc.?.
  • Keyboard shortcut(s): Cmd+S/Cmd+shift+S (macOS) or Ctrl+S/Ctrl+shift+S (Windows).
• Open Recent(Windows)^
  • Shows a list of recently opened files. You can clear this list using the bottom "Clear Menu" menu item.
• Exit (Windows)^
  • Close the Wotja app.
  • Keyboard shortcut: Ctrl+Q.

Options Menu^

• Show Wotja data folder^
  • This will display in Finder (macOS) / Explorer (Windows) the Wotja folder where you may have added Boxes and Randomization Schemes either created with another Wotja app or from a 3rd party or your files have been saved to.
• Output Devices^
  • Select the Output audio device to be targeted by Wotja's internal sound generator (the ISE Synth) from the list of available detected options e.g. 'Built-In Output' on macOS and 'Speakers' / 'Primary Sound Driver' for Windows.
  • Tip: Wotja does not allow dynamic change of audio output device - if you change the output you will need to restart Wotja for it to be used. See also this FAQ.

Window Menu^

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

Help Menu^

• About (Windows)^
  • Displays the Wotja version number.
  • Various weblinks
    • Useful links.

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 Cells15. 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 IME (Music Engine), ISE (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 ISE Sound & FX networks (used to generate sound and FX).

Once a Template is added to a Cell15 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 Saved Files9).

How are Templates used?

Automatic Mixing: Randomization Schemes allow interesting, fresh mixes to be created from random selections of Templates. In the Documents Screen they're used in the creation of automatic mixes and boxes13 and they underpin mixes created in the Flow Player.

Manual Mixing: Templates are selected, previewed15, and added to a Cell via the Template List. This is accessed via a Cell Selector Button15, Generator Menu Button6, pop-up menu from a Generator Button29 or any Settings Button14

AMenu Bar^

Menu Bar^

UI Elements: 1,6,7,8.

1Back Button^

Back Button^

Takes you back to the screen you came from.

2Paks List^

Paks List^

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

3Pak Toggle^

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

4Screen Title^

Screen Title^

Displays the name of the screen.

5Templates List^

Templates List^

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

6Action Button^

Action Button^

The Action button displays a pop-up menu a number of useful options to help with Template and Pak selection:

• 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

7Replace Button^

Replace Button^

The Replace button allows you to Replace content that is already in a Cell with the selected Template.

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

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

8Merge Button^

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

9Saved Files Pak^

Saved Files Pak^

The Saved Files Pak is always shown at the top for easy accesss. It contains all the generative templates (.noatikl files) that you have already created and saved (see Toolbox Button4 > Export to Template).

10Pak Selector^

Pak Selector^

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

These are what some of the Paks are:

• TTM 1 Players
  • Templates that use Text-to-Music techniques to generate melodies.
• BP20 Paks
  • New Paks for Wotja 20.
• BP1-4 Paks
  • These include templates optimised for Wotja 19.
• BP0 Paks
  • These include templates optimised for Wotja 4.
• IME Generator types
  • Simple templates that let you start a cell with just one Generator type.
• IME Others
  • Older sundry templates.
• BP00 Paks
  • 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
  • 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.

11Selected Pak^

Selected Pak^

A light blue background indicates the selected Pak.

12Generator Types Pak^

Generator Types Pak^

The IME Generator types Pak includes simple "starter" Templates for each of the Generator types. They are for those that want to build a mix from the most basic starting point.

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

133rd Party Pak^

3rd Party Pak^

3rd Party Paks are shown below the included Paks. If you have them installed, the Intermorphic MDB or the AL Collections Paks are shown in dark grey, italic. Other third party paks are shown in black, italic.

14Template Toggle^

Template Toggle^

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

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

15Preview Indicator^

Preview Indicator^

When a Template is being previewed it has a light green background - you can preview it without having to open it.

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

16Template Selector^

Template Selector^

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

Documents > Flow ScreenB > Flow Button8

The Flow Player (see Quick Start) shows a list of all the Randomization Schemes (RS) 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 Scheme.

AFlow Player Menu Bar^

Flow Player Menu Bar^

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

BFlow Player Status Bar^

Flow Player Status Bar^

UI Elements: Indicators2,5,11.

1Exit Button^

Exit Button^

Takes you back to the Documents screen.

2Flow/Play/Sleep Time Remaining^

Flow/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^

Sleep 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/Continuum Button^

Repeat/Continuum Button^

A toggle that, if set to repeat, will restart the current mix when it reaches its end rather than another being generated.

The Repeat icon is a loop symbol and the Continuum icon is a squiggly line (shown).

5Randomization Scheme Name^

Randomization Scheme Name^

Displays the name of the Randomization Scheme currently in use.

6Play/Stop Button^

Play/Stop Button^

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

7Next Button^

Next Button^

Forces another mix to be generated.

8Full Screen Top Panel^

Full 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^

Action Button^

Displays a pop-up menu with the following options:

• 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 & Restart/Stop [mobile] / Full Window & Restart/Stop (various sizes) [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.
• Save Flow to Wotja Box File
  • Creates a new mix file of the current Flow.
• Save Flow to Wotja Mix File
  • Creates a new Box file with this one flow mix file in it.
• Help and More
  • Visit our website for online help on the Flow player.

10Mix Time Remaining^

Mix 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 Scheme that is being used. Doing that lets you override what is in the Scheme. It's fun!

11Settings Button^

Settings Button^

Takes you to the Settings screen.

12Text Area^

Text 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 Scheme that is being used. Doing that lets you override what is in the Scheme. It's fun!

13Background/Screensaver^

Background/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 Scheme that is being used. Doing that lets you override what is in the Scheme. It's fun!

14Wotja Watermark^

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

Documents > User ScreenD > Box Button18 / Playlist Button19 or Albums ScreenC > Album Button10

The Playlist Player (see Quick Start) 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 the the User screenD > Add New button13 > "Play List."

APlaylist Player Menu Bar^

Playlist Player Menu Bar^

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

BPlaylist Player Toolbar^

Playlist Player Toolbar^

UI Elements: Toolbar buttons2,5,10.

CPlaylist Player Status Bar^

Playlist Player Status Bar^

UI Elements: Indicators12,7,20.

1Save/Exit Button^

Save/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^

Add 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^

Sleep 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

• Tap the Sleep Timer button3 which takes you to the Settings Screen.
• The Sleep Timer is found at the top of the General segment.

4Previous Mix Button^

Previous Mix Button^

Takes you to the previous playlist item.

5Playlist Icon Button^

Playlist Icon Button^

This sets the image used for the Box file18 or Playlist file19 in the Documents sceen.

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

• Show
  • Does nothing at present...
• Change - Browse
  • Browse for an image to use as the thumbnail for the Playlist/Box.
• Change - Random (Box file only)
  • Allows you to randomly generate a new icon according to the "Random > Albums > Icon Palette and Icon Graphic" settings.
• Change - Copy from Mix# 1
  • Select the icon from the first mix to use as the icon for the Playlist/Box.
• Clear
  • Clears any icon or background image being used as the thumbnail.

6Play/Stop Button^

Play/Stop Button^

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

7Playing Mix Name^

Playing Mix Name^

Displays the name of the playing mix.

8Next Mix Button^

Next Mix Button^

Takes you to the next playlist item.

9Action Button^

Action 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 & Restart/Stop [mobile] / Full Window & Restart/Stop (various sizes) [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 (Box/Playlist files only, not Albums)
  • This is for when you want to embed your Box in a webpage as a Wotja URL.
• Save Wotja Box to File (Box/Playlist files only, not Albums)
  • Allows you to export your Wotja playlist to a Box file that is then saved locally. You might choose to do this to if you wish to share your Box.
• Refresh ALL mixes (Box file only)
  • 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).
• Help & More
  • Visit the User Guide online.

10Sequential/Random Play Button^

Sequential/Random Play Button^

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

11Settings Button^

Settings Button^

Takes you to the Settings screen.

12Playlist Name/Sleep/Play Time Remaining^

Playlist 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^

Mix 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
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 & Always Show Fullscreen 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^

Selected Mix Indicator^

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

15Playing Mix Indicator^

Playing Mix Indicator^

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

16Mix Number/Name^

Mix Number/Name^

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

17Mix Duration/Range^

Mix 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 button19 (Box file only).

18Mix Selector^

Mix Selector^

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

19Mix Actions Button^

Mix Actions Button^

Tap for a pop-up menu where you are presented with the following options (Box/Playlist files only, not Albums):

• Mix Overrides (Box file only)
  

  Mix Overrides
  Click image for large

  • Opens a Mix Overrides screen in which you can choose to override the related setting that may be in the Mix File (these Playlist related settings are set in the Cell Rules panel in Music Mode).
    • 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).
    • 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)
  • Allows you to randomly generate a new icon according to the "Random > Albums > Icon Palette and Icon Graphic" settings.
• 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.

20Mix Time Remaining^

Mix 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 Overrides button19.

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

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 Scheme that has been selected. A number of these are included in the TV app and are non-editable.

Note: The paid-for Wotja Pro 20 iOS and Android apps include a TV player that has no auto-timeout; the free versions all have an auto-timeout of 10 minutes (i.e. 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 Scheme14 (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^

Menu Bar^

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

BSettings Panel^

Settings Panel^

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

1Settings Button^

Settings Button^

Displays the pop-up Settings PanelB.

2Sleep Timer Status^

Sleep 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^

Sleep/Play Time Remaining^

If a Sleep Timer has been set this will reflect that time. If not, then in the 'Pro 20' 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^

Mix Time Remaining^

Shows how long the current mix has left to play before either repeating or the next mix is generated (which depends on whether Repeat/Continuum is selected (12)).

5Repeat/Continuum Status^

Repeat/Continuum Status^

The icon shows whether the current mix is to repeat (Repeat - loop symbol) or a new mix is to be generated at the end of the mix play time (Continuum - squiggly line [shown]).

6Next Button^

Next Button^

Select this button to force another mix to be generated.

7Screen Text^

Screen Text^

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

8Background/Screensaver^

Background/Screensaver^

The background used depends on the Randomization Scheme14 being used.

9Wotja Watermark^

Wotja Watermark^

This is where the Watermark displays.

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

10About (Version and Live Use License)^

About (Version and Live Use License)^

Displays the version number and note that the TV app is only licensed for Personal Live Use.

See Live Use for further information.

11Text Display Selector^

Text Display Selector^

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

12Repeat/Continuum Selector^

Repeat/Continuum Selector^

Select this to choose a toggle value of 'Continuum' (default) or 'Repeat'. If set to Continuum then every few minutes (how long a mix will be is a setting that is defined in the selected Randomization Scheme14) a new mix will be generated. If set to 'Repeat' that the current mix will be restarted when it reaches its end rather than a new one being generated.

13Sleep Timer Selector^

Sleep Timer Selector^

Select this to display a list of available sleep times ranging from 'Off' to '8 hours'. Select the one you want to return to the Settings menu. When there the Sleep Timer is on the Sleep Timer icon looks more solid.

14Randomization Scheme Selector^

Randomization Scheme Selector^

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

Randomization Schemes are not editable in the TV Player.

15App Name^

App Name^

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

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 Scheme 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^

Play/Stop Button^

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

2Next Button^

Next 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^

Flow Mode^

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

4App Name^

App Name^

This will be either Wotja or Wotja Pro 20.

5File Type Playlist^

File Type Playlist^

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

6File Type Box^

File Type Box^

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

7File Type Mix^

File 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^

File Info^

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

• Flow
  • Name of the Flow Randomization Scheme 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^

Screen Text^

Where a mix or Randomization Scheme 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 Album^

File Type Album^

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

Documents > Mix File14 > Display Tab9

The Mix Player (see Quick Start) comprises a number of editing Modes but it can also be used toplay individual .wotja mix files.

To use Wotja as purely as a mix file player all you really need to know about are the Play/Stop button8 and Display tab9 in the Tab BarC, which is found in all the editing Modes (e.g. Music Mode, Text Mode and Display Mode).

Just to provide a general idea of the screen layout we show the Display Mode screen below and a few of the UI elements in it. For information on all of the controls in this screen, however, see Display Mode.

If you want to edit a mix then see the various editing Modes detailed in the next section of the User Guide.

AMenu Bar^

Menu Bar^

UI Elements: Menu Bar buttons1,3,4.

BToolbar^

Toolbar^

UI Elements: See Display Mode for details.

CTab Bar^

Tab Bar^

UI Elements: Tab Bar buttons8,9. See Display Mode for further details.

1Save/Exit Button^

Save/Exit Button^

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

2Screen Title^

Screen Title^

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

3Action Button ^

Action Button ^

Displays the Action Menu pop-up.

• 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 & Restart/Stop [mobile] / Full Window & Restart/Stop (various sizes) [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.

4Settings Button^

Settings Button^

Displays the Settings screen.

5Screen Text Area^

Screen Text Area^

The text area can display either Cut-up, TTM text or no text at all. Refer to Display Mode for further details.

6Screen Background^

Screen 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. Refer to Display Mode for further details.

7Wotja Watermark^

Wotja Watermark^

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

8Music Mode Tab^

Music Mode Tab^

Tap the tab to go to Music Mode.

9Play/Stop Button^

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

10Display Mode Tab^

Display Mode Tab^

Shows that you are in Display Mode.

Documents > Mix File14 > Music Tab23 (see Quick Start 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:

• Music Mode23
  • 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 (IME) and Intermorphic Synth Engine (ISE).
• Text Mode28
  • The editing mode where you can create and edit Cut-up and text.
• Play/Stop button32
  • Tap to stop or start your the generative mix (if any) in your wotja.
• Display Mode35
  • The editing mode where you decide how you want your wotja to look, this being important should you wish to share it.
• Record Mode36
  • The mode where you can make recordings of your mix.

AMenu Bar^

Menu Bar^

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

BToolbar^

Toolbar^

The Toolbar, below the Menu BarA, houses a number of buttons including the Editor Panel selectors 5,7,10,11,12.

CTab Bar^

Tab Bar^

The Tab Bar at the bottom of the screen provide access to the Editing Modes 23,28,35,36 and a Play/Stop button32.

DCells & Tracks Panel^

Cells & Tracks Panel^

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

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

EEditor Panel^

Editor Panel^

Select the Editor you wish to use here with the Editor Panel selectors: Network Editor Panel5, Cell Mixer Panel7, Track Mixer Panel10, Cell Rules Panel11 and Mix Rules Panel12.

FGenerator Editor Panel^

Generator Editor Panel^

The Generator Editor panel is a sub-panel view of the Full Screen Generator Editor5. It can make it easy to edit all the parameter values for each of the Generators in the Cell without having to go full screen. Simply select the Parameter Group on the left hand side, and then edit parameters on the right.

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

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

Full Screen Generator Editor

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^

Generator 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 IME Parameter List for info on all the available parameters.

HSynth & FX Button Area^

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 ISE Synth & FX Units for info on all the available synth & FX units.

1Save/Exit Button^

Save/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^

Randomize Button^

Displays the Randomize Menu pop-up:

• Randomize Mix
  • Replace your current mix with a new randomized mix created in accordance with the Randomization Settings.
• 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
  • Provides quick accecss to Randomization Settings.
• Cancel
  • Cancel out of the pop-up menu.

3Column Lock Button^

Column 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^

Grid Button^

Tap the Grid button to pop up a menu where you can select from a number of useful actions.

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 ogf 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 IME 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 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.
• Cell Actions...
  • Browse Templates...
    • Displays the Templates screen.
  • Copy
    • 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
    • Pastes a Cell that has been copied to the clipboard.
    • Only shown if a Cell have been copied to the clipboard.
  • Move from here
    • Tap to be able to move the selected Cell.
  • Move 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.
  • Import 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 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 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.
  • Lock Cell
    • Tap to force a Cell to Loop (i.e. lock/unlock).
    • See the "Loop" setting in Cell Rules.
  • Export 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 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
    • Tap any Cell to clear out the contents.
  • Clear ALL cells
    • Clears out the contents and arrangement settings for ALL Cells.

5Generator Network Editor Panel / Selector^

Generator Network Editor Panel / Selector^

Generator Network Editor
Click image for large

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

For the selected Cell15, and ONLY if it contains generative content, the Generator Network Editor panel is where you can marry IME Generator Objects (note "Generators") to MIDI channels, ISE synth sounds and FX. The buttons in the network and associated ISE 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. IME and ISE 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 button29 to show its Intermorphic Music Engine (IME) 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 button33 or FX button34 to access the Intermorphic Synth Engine (ISE) parameters and carry out any sound design you wish to do.
• Go to the Cell Rules panel11 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 IME will decide on a free MIDI channel to hook-up the Generator to when it starts playing.

6Generator Menu Button^

Generator Menu Button^

See also: IME Parameter List.

Tap on this button (and/or right click in the Desktop version) and it will display the pop-up 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...
  • Go to the Templates list where you can select a Template to add.
• Add Generator of Type...
  • Add a Generator of one of the IME 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.
• Show/Hide Generator Editor Panel
  • Default value - Visible: For in-screen editing of a Generator's IME 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 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.

See also the Intermorphic Music Engine (IME) Guide for details on what the parameters do.

7Cell Mixer Panel / Selector^

Cell Mixer Panel / Selector^

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

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

8Mix Name^

Mix Name^

The name of the open mix file.

9Cell FX Button^

Cell FX Button^

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

10Track Mixer Panel / Selector^

Track Mixer Panel / Selector^

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
  • Tap to change the volume for the related Track.
• Pan Slider
  • Tap to change the pan position for the related Track.

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

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

11Cell Properties Panel / Selector^

Cell Properties Panel / Selector^

Cell Properties Panel
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 Intermorphic Music Engine (IME) parameters refer to the IME User Guide.

Cell Properties Panel^

Track Cell Sequencing

• Track Rule

Script

• Script

Cell General

• Loop
• Root
• Meter
• Repeats
• Repeats Range

Cell Generative

• Scale Rule
• Harmony Rule
• Rhythm Rule
• Next Note Rule
• Generative Bars
• Generative Bars Range
• Harmonize With Me
• Harmonize With Others

Cell Info

• Template Title
• Template Author
• Template Notes
• File Name
• File Path
• Content Duration

• 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
  • Script^
    • Show the first line of any Cell level script. Tap on it for the Wotja Script Editor.
• 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^
    • 1-99 (Default value - 1): 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!
    • 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.
  • 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. For information on Template Title refer to IME Cell Info.
  • Template Author^
    • Displays the Author of theTemplate, if it is defined. For information on Template Author refer to IME Cell Info.
  • Template Notes^
    • Displays any Notes in the Notes field the Template, if defined. For information on Template Notes refer to IME Cell Info.
  • File Name^
    • Displays the name of the Template (or audio/MIDI file) used in the Cell.
  • 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.

12Mix Properties Panel / Selector^

Mix Properties Panel / Selector^

Mix Properties Panel
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 Intermorphic Music Engine (IME) parameters refer to the IME User Guide.

Mix Properties Panel^

Script

• Script

Mix FX

• Edit Mix FX...

Mix General

• Mix Volume
• Mix Root
• Mix Tempo
• Mix Scale Rule
• Mix Harmony Rule
• Mix Rhythm Rule
• Mix Next Note Rule

Mix Automatic Text Change

• At Mix Start
• Change After Seconds
• Seconds Between
• Seconds Between Range
• Use Saved Text

Mix Fades & Playlists

• Ramp Up: Seconds
• Duration: Seconds
• Duration Range: Seconds
• Ramp Down: Seconds

• Script
  • Script^
    • Show the first line of any Mix level script. Tap on it for the Wotja Script Editor.
• 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 IME 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 IME 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 IME 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 IME Rule Object.
• Mix Automatic Text Change
  • At Mix Start^
    • On/Off (Default value - Off): This powerful setting allows a new mix cut-up to be created automatically on mix start.
  • Change After Seconds^
    • On/Off (Default value - Off): This powerful setting allows a new mix cut-up to be created automatically on after a certain duration, specified in the parameters below.
  • Seconds Between^
    • 3-1000 (Default value - 60): If the Change After Seconds toggle is on, this determines the minimum time before a new cut-up is generated.
  • Seconds Between Range^
    • 3-1000 (Default value - 30): The range in value that can apply to the above time.
  • Use Saved Text^
    • On/Off (Default value - Off): When on, this powerful 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.
• 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.

13Action Button^

Action Button^

Displays the Action Menu pop-up:

• Export Mix to Clipboard (no image)
  • Creates the smallest Wotja URL from your mix.
• Export Mix with Image
  • Creates a Wotja URL 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
  • Opens the Intermorphic Wotja Script Sandbox window where you can try out scripts.
• Help & More
  • Link to this online Wotja User Guide.

14Settings Button^

Settings Button^

Takes you to the Wotja Settings screen.

15Cell / Selector^

Cell / Selector^

Cells are at the heart of Wotja.

Tap a Cell to select it.

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 a Template. Templates include 1 or more Generators.

Double-tap a populated Cell to display the Templates List where you can select a Template to replace the Cell contents or to merge into the existing Cell content.

Selected Cell: When a Cell is selected the border of the cell takes on an orange colour. A light blue background is shown at the top of the Cell when in Editor Panels5, 7,10 and at the bottom of the Cell when in Editor Panel11. There is no background shown when in Editor Panel12.

You can choose whether the panels shows either 1 Cell, a Column of Cells or 4 columns of Cells by using the Action Button13 and selecting the relevant "Display" option from the pop-up menu.

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

• Generative
  • Wotja Template18 icon.
• Audio
  • Audio Loop21 icon.
• MIDI
  • MIDI file22 icon.
• No content
  • Blank.

16Cell Content Name^

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

17Cell Playing Indicator^

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

18Cell Content - Generative^

Cell Content - Generative^

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

19Cell Rules Computed Values^

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

20Cell Loop Indicator^

Cell 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

21Cell Content - MIDI File^

Cell Content - MIDI File^

The Cell includes a MIDI file.

22Cell Content - Audio File^

Cell Content - Audio File^

The Cell includes an Audio file.

23Music Mode Tab^

Music Mode Tab^

The Tab that selects Music Mode.

24Track Cell Sequencing Button^

Track 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 (∞).

25Track FX Button^

Track FX Button^

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

26Track Mute Button^

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

27Track Solo Button^

Track Solo Button^

Tap to solo or unsolo the related Track.

• Gold
  • Soloed.
• Light grey
  • Not soloed.

28Text Mode Tab^

Text Mode Tab^

Takes you to Text Mode.

29Generator Button^

Generator Button^

See also: Parameter List.

Tap on a Generator button to select that Generator. 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).

30MIDI Channel Assignment^

MIDI Channel Assignment^

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

31MIDI Channel Box^

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

32Play/Stop Button^

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

33Generator Synth Button^

Generator 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 ISE Synth configuration. Tap on the Synth button for the Synth & FX editor.

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

34Generator FX Button^

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

35Display Mode Button^

Display Mode Button^

Takes you to Display Mode.

36Record Mode Button^

Record Mode Button^

Takes you to Record Mode.

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 Button29 and selecting "Edit" from the pop-up menu.

AMenu Bar^

Menu Bar^

UI Elements: 1,4,5,6.

1OK/Back button^

OK/Back button^

Tap to accept your changes and exit the Generator Editor

2Generator Selector button^

Generator Selector button^

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

3Generator Summary^

Generator Summary^

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

See also: IME Parameter List.

4Screen Title^

Screen Title^

Shows the name of the current screen.

5Undo Button^

Undo Button^

Undo the last parameter change you have made.

6Redo Button^

Redo Button^

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

7Parameter Groups List^

Parameter Groups List^

To make it easier to understand what each IME 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: IME Parameter List.

8Selected Parameter Group^

Selected Parameter Group^

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

See also: IME Parameter List.

9Parameter Group Selector Button^

Parameter Group Selector Button^

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

See also: IME Parameter List.

10Music Mode Tab^

Music Mode Tab^

The Generator Editor is only available in Music Mode.

11Parameter Edit Control^

Parameter Edit Control^

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

See also: IME Parameter List.

12Generator Type^

Generator Type^

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

See also: IME Parameter List.

13Generator Name^

Generator Name^

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

See also: IME Parameter List.

14Parameter List / Group Header^

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

15IME Generators & Parameters^

IME Generators & Parameters^

IME Objects & Parameters ^^

Wotja includes a powerful generative music engine - the Intermorphic Music Engine (IME) - and an associated Generator Editor. The table below includes quick links to all you will ever likely need to know about its Generator & Rule Objects and their parameters. For those that want it (or prefer it), we have created a separate standalone guide: IME User Guide.

Generator Objects

• Overview

Rule Objects

• Overview

Generators

•  Rhythmic
•  Ambient
•  Follower
•  Repeater
•  Patterns
•  Text to Music
•  Listener

Other Parameters

•  Chords
•  Rules
•  Scripting
•  Comments
•  Articulation
•  Controllers
•  Micro Controllers
•  Micro Note Delay
•  Micro Pitch
•  Note to MIDI CC
•  Envelopes

Note: For a better (visual) understanding of how all the Generator Objects in a Cell are associated with MIDI channels and how these Generators are linked to each other (e.g. Following Generators [below], where one Generator follows the output of another) then see the Wotja Generator Network Editor.

IME Generator Objects^

Generator Objects

See also the Generator Editor.

Every Wotja Mix Cell includes one or more "Generator" Objects. There are 7 "types" and each generates MIDI notes and events according to various parameter values:

•  Rhythmic: Note durations set by Rhythm Rules
•  Ambient: Note durations set by the Ambient parameters
•  Follower: Mirrors notes generated by another Generator
•  Repeater: Can repeat notes it has earlier generated
•  Patterns: Uses pre-defined note patterns to generate notes
•  Text to Music: Generates notes from text input
•  Listener: Detects incoming MIDI notes/events

Tip: The Generator button will flash when the Generator plays.

Note: For historical reasons these used to be called "Voices".

IME Rule Objects^

Rule Object - Scale Rules

See also the Rule Editor and Mix Rules and Cell Rules.

Every Generator composes notes according to the settings of 4 types of Rule Objects it has associated with it: Scale Rule, Harmony Rule, Next Note Rule, Rhythm Rule. Each Rule Object contains one or more "Rules", such as "Major" or "Minor".

Each Rule is an array of the values of the elements for that Rule Object (such as the values of 24 scale intervals). These values represent the relative probability (from 0% to 100%) (the "weighting") of that Rules' element being chosen by a Generator for a note to be composed. An element with a value of 0 will not be chosen for composition.

Important: When the Pitch Range for a Generator is wide enough, Scale Rules will "wrap around" to accomodate the extra range in notes available.

Changes to the values in these Rules, as with changes to any other IME parameter, allows an instant change in the music generated.

Tip: Where the interface displays the Rule elements, tap or click one one at the appropriate position to change the value of that element; the IME will attempt to make that element flash when it has been selected to play a note.

  Generator - Rhythmic ^

Overview

A "Rhythmic" Generator is the default Generator Type. It composes according to the parameters in the "Basics" Parameter Group. The group has this name because the parameters in it (e.g. MIDI Channel, Patch etc) are common to and used by all Generators.

Tip: To best allow note durations to fit within the bar structure of a Cell, a Rhythmic Generator calculates them according to the Rhythm Rule it uses.

Parameter Group - Basics

•  Name
•  Mute
•  MIDI Channel
•  Send MIDI Bank/Patch?
•  Patch
•  Pitch
•  Pitch Range

•  Phrase Length
•  Phrase Length Range
•  Phrase Gaps
•  Phrase Gaps Range
•  Note Rest %

 Name^

Every Generator in a Noatikl file has a unique name. You can use any name you want, provided it is not empty, and provided it is not a single question mark (which has a reserved meaning for use with Rules, which you will find out about later).

 Mute^

Toggle this setting (Yes/No) to mute or unmute the Generator. Certain Generator Types might take some time to respond, depending on how far in advance their notes are composed.

When the keyboard focus is on the Mute cell, you have various extra menu options available to you in the "Control" Menu. These are as follows:

• Solo Generator
• Unmute All Generators
• Mute All Generators

If you hold down the ctrl key when you click on the mute cell, you will toggle all other Generator's mute states, without changing the mute state of the Generator that you ctrl-click on. This can be very handy.

 MIDI Channel^

A Generator emits data on a MIDI Channel. MIDI channels are numbered from 1 to 16. The default MIDI channel for a Generator is actually MIDI channel 0 – which tells the IME to assign a free channel from 1 to 16 automatically, as best it can. MIDI channel 10 is always reserved for percussion sounds, such as drum sounds or other untuned sound.

 Send MIDI Bank/Patch?^

Not all software synthesizers for your favourite sequencer like having Patch data supplied to them via a Patch Change MIDI event. If this is the case, simply change the Send MIDI Bank/Patch? parameter to No (unchecked), and the IME won't send any MIDI patch change events.

 Patch^

Every Generator is assigned a given Patch. This specifies the sound that you will hear whenever the Generator plays a note. The exact sound you hear depends on the sound source you have associated with the Generator; this could be the ISE or you might be driving an external MIDI synth.

In general, the IME does not emit any MIDI bank select CC information for a Generator before it emits the Patch Change MIDI event. However, you can force the IME to emit such information, by typing-in a special format patch value; where you type-in the patch in the format: patch.msb.lsb, for example:

98.53.4

In this example, the IME will emit bank select CCs for both MSB and LSB according to the settings you supply (53 and 4 respectively, in this case). If you don't specify a value for the lsb, then the IME will only emit a Bank Select MSB CC (CC number 0). If you supply the lsb, then the IME will also emit a Bank Select MSB CC (CC number 32).

 Pitch^

Set the Pitch to be the minimum pitch for which you want your Generator to compose. The IME will ensure that it composes no notes less than this pitch value.

 Pitch Range^

Set the range of pitches in semitones above the Pitch which can be used for composition. The IME will ensure that it only composes notes with pitches between Pitch and Pitch + Pitch Range.

 Phrase Length^

Set this to define the shortest possible sequence of notes that your Generator will compose in sequence. The Generator composes a sequence of notes, followed by a sequence of rests. The length of each sequence of notes is governed by this and the Phrase Length Range parameter.

 Phrase Length Range^

This value defines the upper limit to the number of notes that your Generator will compose in sequence. For example, if the Phrase Length is 3, and the Phrase Length Range is 25, then the minimum phrase will be 3 notes, and the maximum phrase length will be (3+25) = 28 notes.

 Phrase Gaps^

Set this to define the shortest possible sequence of rests that your Generator will compose. Your Generator composes a sequence of notes, followed by a sequence of rests. The length of each sequence of rests is governed by this and the Phrase Gaps Range parameter.

 Phrase Gaps Range^

This value defines the upper limit to the number of rests that your Generator will compose in sequence. For example, if the Phrase Gaps is 3, and the Phrase Gaps Range is 25, then the minimum phrase will be 3 rests, and the maximum phrase length will be (3+25) = 30 rests.

 Note Rest %^

This value defaults to zero. If not zero, then the defined percentage of notes that would otherwise be played by your Generator will instead be treated as a rests of the same duration. This is very useful for making any Generator sound sparser. Give it a go: this parameter is very powerful, and applies to all Generator Types.

  Generator - Ambient ^

Overview

Tip: See also Rhythmic for the common "Basics" Generator parameters.

An "Ambient" Generator does not use the Rhythm rule for note durations but instead use durations defined by the specialist parameters in the Ambient parameter group. This is to allow them to generate notes without respect for tempo or bar timings. They are wonderful for creating drifting, floating sounds for either background or foreground use as drones or for musical texture.

Parameter Group - Ambient

•  Units
•  Duration
•  Duration Range

•  Gap Minimum
•  Gap Range

 Units^

You define the Unit of Measure for which the other Ambient Generator parameters are interpreted. This may be one of the following values:

• Seconds (thousandths of a)

  The parameters including Duration are all interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Duration value of 1000 means one second.

• Beats (60ths of a)

  The parameters including Duration are all interpreted as being in 60ths of a beat. In the IME a Beat is defined as being one crotchet; you get 4 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet.  A Duration value of 15 means a semi-quaver.  A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).

• Full seconds

  The parameters including Duration are all interpreted as being in seconds. So, a Duration value of 10 means ten seconds.

 Duration^

The Ambient Generator parameters govern how Ambient Generators work.

This defines the minimum duration for which the Ambient Generator will play when it composes a note. The actual value chosen for each note is a value between Duration, and Duration plus the Duration Range. Each and every note composed for this Ambient Generator will have a note whose duration is separately calculated.

 Duration Range^

This is combined with the Duration parameter, to determine the duration for which the Ambient Generator will play when it composes a note. The actual value chosen for each note is a value between Duration, and Duration plus the Duration Range. Each and every note composed for this Ambient Generator will have a note whose duration is separately calculated.

 Gap Minimum^

This defines the minimum duration for which the Ambient Generator will play when it composes a rest. The actual value chosen for each rest is a value between Gap Minimum, and Gap Minimum plus the Gap Range. Each and every rest composed for this Ambient Generator will have a rest whose duration is separately calculated.

Tip: This is the Duration used for the Phrase Gaps / Phrase Gaps Range parameters i.e. it allows the duration of gaps to be different to that of the notes.

 Gap Range^

This is combined with the Gap Minimum parameter, to determine the duration for which the Ambient Generator will play when it composes a rest. The actual value chosen for each rest is a value between Gap Minimum, and Gap Minimum plus the Gap Range. Each and every note composed for this Ambient Generator will have a note whose duration is separately calculated.

Tip: This is the Duration Range used for the Phrase Gaps / Phrase Gaps Range parameters i.e. it allows the duration of gaps to be different to that of the notes.

  Generator - Follower^

Overview

A "Follower" Generator is used in a call-response manner, allowing it to follow the behaviour of other Generators according to parameters in the "Following" Parameter Group.

In the Cell, select the Generator which you want your "Following" Generator to follow - you may follow any Generator of any type. You may even follow a Generator that follows another Generator that follows another Generator... provided that you don't try to define a cyclic dependency which loops back to the current Generator! If you don't specify a Generator to follow then it won't play.

Important: If you follow a Generator that is using the Chords parameter (i.e. to create more than one note), then only the first note in the chord is followed.

Parameter Group - Follower

•  Follow Generator?
•  Percent
•  Strategy
•  Units

•  Delay Generator?
•  Delay Range
•  Shift Interval
•  Shift Interval Range

 Follow Generator?^

This parameter simply allows you to select another Generator in the Cell for your "Following" Generator to follow.

 Percent^

This parameter sets the percentage of notes that the Followed Generator responds to so as to emit a note. Set to 100 if you want the Following Generator to emit a note for every note played by the Followed Generator. Set to a smaller value if you want to thin-out the notes played by the Following Generator. This is also useful for building networks of chords,  where if you have a number of Following Generators all following either each other or one main Generator, and if those Following Generators have the Percent Parameter to less than 100, then sometimes you will hear dense chords, and sometimes you will hear thinner chords.

 Strategy^

This parameter defines the pitch to use for a note generated by the Following Generator. The available values are:

• Chordal Harmony

  This causes the Following Generator to choose notes which respect the currently defined Scale, Harmony and Next Note Rules.

• Interval Within Scale Rule

  This causes the Following Generator to choose notes which are offset from the followed note, such they are at an interval within the Scale Rule, defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.

  For example, if these values are 1 and 2 respectively, then each time a note is chosen, it will be between 1 and (1+2)=3 Scale Rule intervals up from the Followed Generator's note. It is important to understand that this refers to the non-zeroed elements in the current Scale Rule, in other words only those notes that are available within the Scale Rule.

  So, in our example, if we were using a Major Scale Rule, and if the followed note were C4 (Middle C), and if Noatikl chose a value of 2 as its random value; then the played note would be E4 (Middle C), which is the second note up from Middle C within the Major Scale Rule.

• Semitone Shift

  This causes the Following Generator to choose notes which are offset up from the followed note, such they offset from the followed note by a number of semitones which is a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values. A note chosen in this way ignores the current Scale Rule.

  For example, if these values are 1 and 2 respectively, then each time a note is chosen, it will be between 1 and (1+2)=3 semitones up from the Followed Generator's note.

  So, in our example, if we were using a Major Scale Rule, and if the followed note were C4 (Middle C), and if Noatikl chose a value of 3 as its random value; then the played note would be D#4 (Middle D#), which is the third semitone note up from Middle C. This value is used even though it is not in the current scale rule.

 Units^

You define the Unit of Measure by which the Delay and Delay Range parameters are interpreted. This may be one of the following values:

• Seconds (thousandths of a)

  The parameters including Duration are all interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Duration value of 1000 means one second.

• Beats (60ths of a)

  The parameters including Duration are all interpreted as being in 60ths of a beat. In Noatikl a Beat is defined as being one crotchet; you get 3 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet. A Duration value of 15 means a semi-quaver. A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).

• Full seconds

  The parameters including Duration are all interpreted as being in seconds. So, a Duration value of 10 means ten seconds.

 Delay^

This defines the minimum delay after which the Following Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Following Generator will have a note whose delay is separately calculated.

 Delay Range^

This is combined with the Delay parameter, to determine the delay after which the Following Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Following Generator will have a note whose delay is separately calculated.

 Shift/Interval^

Used when the Strategy is either Interval Within Scale Rule or Semitone Shift.

This causes the Following Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift/Interval and Shift/Interval plus Shift/Interval Range values.

 Shift/Interval Range^

This represents the "Shift/Interval Range", and is used when the Strategy is either Interval Within Scale Rule or Semitone Shift.

This causes the Following Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift/Interval and Shift/Interval plus Shift/Interval Range values.

  Generator - Repeater^

Overview

"Repeater" Generators are like "Rhythmic" Generators, with the added feature that they can be defined to repeat notes that they have composed in previous bars, according to rules defined in the Repeat Parameter Group. When not repeating previous bars, Repeater Generators compose as if they were of Rhythmic Generator Type.

Parameter Group - Repeater

•  Repeat Generator?
•  Percent
•  Bars
•  Bars Range

•  History Generator?
•  History Range

 Repeat Generator?^

You define the name of the Generator from which you would like, from time-to-time, to repeat past bars of music. If you simply want to repeat bars played in the past for the current Generator, simply select the magic value of '?', which is also the default value.

 Percent^

When the Generator starts composing a new bar, it takes a look at this parameter value. This defines for what percent of the time the Generator should repeat previously-composed music. Set this parameter to 100 if you always want past composed music to be repeated (where available!); set to 0 if you never want past music repeated by this Generator. When the Generator doesn't choose to repeat past data it composes a new bar of music were it to be of Rhythmic Generator Type.

 Bars^

Defines the number of bars for which the Generator should repeat a past-composed chunk of music. The actual value chosen is somewhere between Bars and Bars + Bars Range.

 Bars Range^

Defines the upper limit of the number of bars for which the Generator should repeat a past-composed chunk of music. The actual value chosen is somewhere between Bars and Bars + Bars Range.

 History^

Defines the number of bars in the past, from which the Generator will choose the past-composed music to repeat. The actual value chosen is somewhere between History and History + History Range.

 History Range^

Defines the upper limit of the number of bars in the past, from which the Generator will choose the past-composed music to repeat. The actual value chosen is somewhere between History and History + History Range.

  Generator - Patterns^

Overview

"Patterns" Generators generate notes from various fixed MIDI-like patterns. These patterns have a specific syntax, are able to follow generative sequencing rules and can adapt automatically to changes in Scale Rules. They are great for bringing some structure to your composition. Patterns Generators are capable of mutating their patterns while playing, according to parameters defined in the Patterns Parameter Group. When mutating a pattern, Patterns Generators compose as would a Rhythmic Generator.

Parameter Group - Patterns

•  Pattern List
•  Use Percent
•  Mutation Factor
•  Bars Between
•  Bars Range

•  Mutate Rhythm?
•  Meter

 Pattern List^

The "Pattern" parameters govern how Pattern Generators work. Pattern Generators compose as if they were of Rhythmic Generator Type. Generators using TTM (Text to Music) Generators still use the Pattern Generator Type, as TTM is a subtype of that. The easiest way to use them is in the Wotja Pattern Editor.

For details on the Pattern Syntax see the IME Pattern Syntax section.

Pattern Syntax Overview

The pattern syntax is somewhat complicated and will require a bit of effort to get to grips with. Even if you do wish to use it, we still recommend that you first use the Wotja Pattern Editor to familiarise yourself with patterns and how they work.

A pattern is a text string in a specific format, surrounded by < and > symbols. Patterns can be grouped together as list of patterns. Because of this we refer to patterns as a "Pattern" when there is only one, or as "Sub-Patterns" when there are many in the list of patterns. We know it is a bit confusing, so we'll say it again in another way: each Pattern is made-up of a number of Sub-Patterns.

There are 4 types of Pattern:

• Note
  • R - Rhythm: Defines note durations to use, but leaves selection of the note pitches to use up to the Generator acting as a Rhythmic Generator. A negation duration represents a rest.
  • B - Both: i.e. "Melodic" pattern using scale rule intervals. Includes a series of both paired note durations and scale rule interval values. A scale rule interval value of 1 represents the 0ve scale interval used by the Generator and a value of 0 represents a rest.
  • F – Fixed: i.e. "Melodic" pattern using fixed MIDI pitches. Defines the root pitch (60 is Middle C) to use for the pattern and a series of both paired note durations and relative pitches. The pitch values are relative to the root pitch and are independent of scale rule. A pitch value of 0 represents the root pitch and a value of -1 means treat this note as a rest note. These patterns can be useful for drum riffs, e.g. with MIDI drums.
• Sequence
  • S – Sequence: Sequenced patterns allow the IME to use generative rules to select which sub patterns to use while playing a pattern as a generative sequence of sub-patterns.

The IME employs an underlying "time unit" that is 1/60th of a crotchet/quarter note. IME note Duration values map onto standard music notation in the following way (irrespective of meter) [# IME time units - Composed note length]:

• 240 - whole note (i.e. one bar of 4:4)
• 120 - minim/half note
• 60 - crotchet/quarter note
• 30 - quaver/eighth note
• 20 - triplet/twelfth note
• 15 - semi-quaver/sixteenth note

So by way of example:

• one bar of 4:4 is 4 * 60 = 240 IME time units.
• one bar of 3:4 is 3 * 60 = 180 IME time units.
• one bar of 2:4 is 2 * 60 = 120 IME time units.
• one bar of 1:4 is 1 * 60 = 60 IME time units.
• one bar of 6:8 is 6 * 30 = 180 IME time units.
• one bar of 9:8 is 9 * 30 = 270 IME time units.

You are of course free to experiment using other time unit values, which will mean different things. E.g. 10 time units is a 24th note etc.

Note Sub-Pattern Syntax:

Tip: To aid understanding and visual clarity, we use the following color coding: durations, velocity values and scale intervals.

<[prob][.M] pattype {[dur][.vff[-vffr]] [scaleint]}*>

Where:

• prob : the relative probability that this sub-pattern is selected; relevant only where there is more than one sub-pattern! The default value is 100%.
• M : Flag indicating that the sub-pattern is to be "muted", i.e. not allowed to be selected. This can be useful for testing of individual sub patterns; where you might want to "solo" a sub-pattern by muting out all the others.
• pattype : One of:
  • R: Rhythm
  • B: Both
  • F: Fixed, followed by the root note in MIDIpitch.  e.g. F60.
• dur : Note Duration / IME time units.

  • See above for note duration values.

    In R patterns a negative duration indicates a rest for that time; in F patterns a pitch of -1 indicates a rest for the note duration.

    If a note sub-pattern is not an exact even number of bars (e.g. 2 and and half bars at the current meter!) then the engine will pad to silence to the end of the nearest bar boundary.

  • vff: Velocity Force Factor (optional, any integer value)
  • vffr: Velocity Force Factor Range (optional, any integer value and used in conjunction with the above).
  • Note: Velocity Force Factor is an INTEGER % SCALE FACTOR applied to the velocity, where the velocity is first determined from the velocity envelopes. For example, in a pattern [dur][.vff[-vffr]] 60.50 means a note of length 60 Noatikl time units with 50% VFF scaling, 30.15 means a note of length 30 Noatikl time units with 15% VFF scaling, and 120.100-20 means a note of length 120 Noatikl time units and with 100% VFF scaling with a range of 20%.
    • The scaled pattern note velocity can never be any less than 1.
    • The scaled pattern note velocity can never be any greater than 127.
    • Note that a pattern note velocity scaling factor of 0 always returns minimum MIDI velocity, which is 1. You cannot use a factor of 0 to "completely mute" a note.
    • Example: A Generator's velocity (min) envelope has a value of 100, with a velocity range envelope vallue of 20 - the velocity for a given note is selected randomly in that range, to be (say) 104. Where defined, the pattern note's Velocity Force Factor is used to scale that velocity, to a final value from 1 to 127. e.g. if the Velocity Force Factor is 50 (%), in this example we'd chose a final velocity value of: 104 * 50 (%) = 52. The Velocity Force Factor Range value, if defined, applies a range to the scaling factor.
• scaleint: Scale interval (not present for Rhythm patterns).
  • B rule: interpreted as being the first valid note in current Generator's Scale Rule; i.e. the first element in the Generator's Current Scale Rule which does not have a zero value. "1" is therefore usually the root note (c.f. the Pitch parameter). "0" has the special meaning of indicating a "REST" for the note duration.
  • F rule: distance in semitones up from the root note (so "0" means the root note). E.g. if F60 (Middle C), then a pitch value of 5 means MIDI pitch 65. A pitch value of -1 is a rest.

Sequence Sub-Pattern Syntax

<S100 R 1.20 2.1 1-2.1-4 2.1>

Syntax

<[S][prob][.M] R {[seqnum[-seqnumrange].[repeattimes[-repeattimesrange]] [seqnum[-seqnumrange].[repeattimes[-repeattimesrange]]}* >

Where:

• S : identifies a sequence sub-pattern
• prob : relative probability of being chosen when there is more than one sequence sub-pattern.
• M: Mute the sub-pattern (i.e. prevent it being selected!). If none can be selected, then a non-sequence sub-pattern is chosen to play at random as usual each time.
• R: Rhythm pattern type (always required)
• seqnum: Sequence Number.
  • The index of the non-sequence sub-pattern to play. Default is 1. The sub-patterns are numbered from 1 up.
  • seqnumrange : Sequence Number Range. Default is 0.
• repeattimes: Repeat Times Minimum.
  • The number of times to repeat this sub-pattern, when selected. A value of "0", will cause the sub-pattern (when selected) to keep playing forever until the end of the Cell! Default is 1.
  • repeattimesrange : Repeat Times Range. Default is 0.

Which sub-pattern is chosen by the Generator depends on a few things:

If there is at least one sequenced sub pattern, then a sequence is used to drive the sub-pattern. Which sequence to use, is based on the Generator making a weighted random selection from the available sub-patterns. When (if!) the sequenced sub-pattern end is reached, the Generator will make another selection as to which sequenced sub-pattern to use.

Otherwise, a sub-pattern is chosen, based on the Generator making a weighted random selection from the available sub-patterns. This sub-pattern is played through to the end, at which point the Generator will make another selection as to which sub-pattern to play.

A Note Sub-Pattern that is less than a whole number of bars at the Generator's current Meter, will be padded automatically with silence to ensure that it remains bar synchronised.

Patterns: Examples

The IME has its own pattern format, which allows it to play specified notes and rests in different ways. Patterns are affected by the various Rules being used by the Generator.

Tip: To aid understanding and visual clarity in the examples, we use the following color coding: durations, velocity values and scale intervals.

Below are a number of example patterns. Copy and paste these into Noatikl to try them out.

Rhythm:   <100 R 60 60 60.127 60>

Both:     <100 B 60.15-30 1 60 2 60.127 3 15 7>

Forced Frequency:   <100 F60 60.127 1 60 4 30 5 15.70-120 7>

Sequence: <S100.M R 1.1 2-0.1-0 3-0.1-0 >

 

Two patterns. Select randomly from these two each time!

   <100 B 60 1 60 2 60 3 60 4>

  <100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>

 

Forced Frequency pattern. Plays note with pitch 58 (or MIDI patch 59 on Ch10): note on, note off, note on, note off etc.

  <100 F58 15 1 45 -1 15 1 45 -1 15 1 45 -1>

 

Forced Frequency pattern: Plays a series of notes for a whole bar (or patches in the drum kit on Ch10) starting at base pitch 40, each one a 16th note...

  <100 F40 15 1 15 7 15 6 15 13 15 2 15 8 15 4 15 11 15 13 15 2 15 8 15 2 15 2 15 8 15 4 15 14>

 

Two sequenced sub-patterns.  Play 1 once, then 2 once...

   <S100 R 1.1 2.1>

  <100 B 60 1 60 2 60 3 60 4>

  <100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>

 

Two sequenced sub-patterns. Play 1 twice, then 2 twice...

   <S100 R 1.2 2.2>

  <100 B 60 1 60 2 60 3 60 4>

  <100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>

 

Two sequenced sub-patterns. Play 1 or 2 twice, then 1 or 2 twice...

   <S100 R 1-1.2 1-1.2>

  <100 B 60 1 60 2 60 3 60 4>

  <100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>

 

Two sequenced sub-patterns. Play 1 once, then 2 twice, the one or 2 once, then 2 once...

   <S100 R 1.1 2.2 1-1.1 2.1>

  <100 B 60 1 60 2 60 3 60 4>

  <100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>

 

Two sequenced sub-patterns. Play 1 once, then 2 forever...

   <S100 R 1.1 2.0>

  <100 B 60 1 60 2 60 3 60 4>

  <100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>

 Use Percent^

When the Generator starts a new sub-pattern at the start of a bar, it consults the value you have defined for Use Percent. This parameter determines the probably of the Generator using the Pattern for the bar; or alternatively, compose a completely new bar (that you will hear only once!) were it to be of Rhythmic Generator Type.

If Use Percent is 100, then the Generator will always use the pattern. If Use Percent is 50, then teh Generator will instead compose a new bar every other bar or so. Note that the Generator will never interrupt a sub-pattern that it is playing; the Use Percent parameter is considered only on a sub-pattern boundary, at the start of a new bar.

 Mutation Factor^

The mutation factor is used when a bar is considered for mutation (which can happen only if Bars Between is not zero! The Mutation Factor determines the level of mutation to apply. If set to 10.0%, then when playing from a sub-pattern, this means that each note that would be played from the pattern, has a 10% chance of having a different one composed, with subsequence pattern playbacks keeping that mutation. Note that if Mutate Rhythm? is set to Yes, then if the composed note is longer than the composed-over pattern note, this might overlap and cancel-out some other notes in the sub-pattern.

 Bars Between^

This parameter defines the number of bars that the Generator waits between, before trying to mutate a bar in a pattern according to the Mutation Factor. If Bars Between is set to zero, the Generator can never mutate. Set to 1 if you want mutation every bar, 2 if you want mutation every other bar, etc. ...

The actual number of bars used is selected randomly each time, somewhere in the range from Bars Between, to Bars Between plus Bars Range.

 Bars Range^

This parameter is used to help define the number of bars between attempts by the Generator to mutate the current pattern. The actual number of bars used is selected randomly each time, somewhere in the range from Bars Between, to Bars Between plus Bars Range.

 Mutate Rhythm?^

If set to No, then the timing of the sub-pattern is preserved perfectly; only the frequency of the pattern notes will be changed when the pattern is mutated. Otherwise, the duration of each note is chosen from the rhythm rules and phrase/phrase gap rules for the Generator.

 Meter^

Defines the Meter to be used by the Generator, such 4:4 or 3:4 or 6:8. A value of ?, which is the default, means to use the Meter defined for the Cell. A different value allows the Generator to work with a completely different meter, which can be used for interesting polyphonic effects.

  Generator - Text to Music (TTM)^

Overview

"Text to Music" Generators are new Generator Type in V20. Text to Music Generators have their own special set of parameters and allow text in any language to generate a seed melody which, even though not visible, is in a Pattern syntax. Use English, Chinese, Japanese, Russian, German, French - whatever language takes your fancy, you will always get a melody!

Parameter Group - Text to Music (TTM)

•  Cut-up Rule
•  TTM Text
•  Display?
•  Repeats
•  Repeats Range
•  Tune Start at Index
•  Tune Length Override

•  Phrase Length
•  Phrase Length Range
•  Gaps
•  Gaps Range
•  Interval
•  Interval Range
•  Improvise after Tune
•  Variaton

 Cut-Up Rule^

The selection you make here determines what text is used for TTM. If you select one of the Cut-up options then text from your mix Cut-up will be displayed in the TTM Text field below and will overwrite any existing Custom text. Note that if there is no text available in a selected line of Cut-up then the TTM Generator will have no text to work with.

• Custom: Uses text that you enter in the TTM Text field.
  • See the TTM Editor for details on how to do this.
• Cut-Up: Line#=Track# (Default): This setting is very powerful when it comes to mixes that feature TTM. It means you can harness the power of the Cut-up Editor to quickly generate text that can be used to populate the TTM for multiple Generators - all at once! It is easiest to understand by example: if you have this setting and are using a TTM Generator in say Track 1 then it will use line 1 of text in your mix Cut-Up. If you had a TTM Generator in Track 3 it would use line 3 of your mix cut-up, and so on.
• Cut-up: All Lines: Uses the text in all lines in your Cut-up for the purposes of TTM
• Cut-Up: Line# 1-11: Uses the text from Line# 1 to Line# 11 (as selected) of your Cut-up for the purposes of TTM. You can set up TTM generators all to use the same line if you want!

 TTM Text^

This is the text in any language used to generate your TTM seed melody. In general it takes 2 characters to generate a note. Note that if your text is < 6 characters (e.g. Hello, which is 5 characters), we turn it into HelloHello ... which makes it sufficiently long to make at least 3 notes (that actually generates a few more). In Wotja, tap on this field to go to the TTM Text Editor screen.

 Display?^

The Display? toggle determines if your TTM text will display in Fullscreen mode.

If this is toggled ON, and IF in Display Mode you have selected Text > Show Text from TTM Generators then the TTM Text above will display on screen when in Full Screen or in Display Mode. If it is OFF, then it will not display.

 Repeats^

The total number of times the original melody or a variation of it is played. This also applies to improvised melodies (see Improvise toggle).

 Repeat Range^

Sets the range above the minimum. Also applies to improvised melodies (see Improvise toggle).

 Tune Start at Index^

From the notes composed, set the first note you want your tune to start playing at. Maximum value is Notes - 1.

 Tune Length Override^

From the notes composed, set how many notes will play. Maximum value is Notes - Tune Start at Index.

 Phrase Length^

Defines the minimum number of notes there are in a "phrase" (and you can see in the indicator above how many notes your text has generated - all of these notes get put into phrases to make the "tune").

 Phrase Length Range^

Sets the range above the minimum.

 Gaps^

Defines the minimum number of rests between each phrase (allows a tune to breathe). Rests are measured in terms of 16th notes.

 Gaps Range^

Sets the range above the minimum.

 Interval^

Defines the minimum number of rests between each play of the tune (allows a tune to breathe). Rests are measured in terms of 16th notes.

 Interval Range^

Sets the range above the minimum.

 Improvise after Tune^

Turn this on to let Wotja continuously generate tune variations after the FIRST complete play (and repeats) of the tune. When this is on, Wotja can "noodle" for ever (well, until you turn it off or the Sleep Timer kicks in, if set!).

Tip: If you have this set to ON and Variation (below) set to 0, then the TTM melody will continue to repeat for ever.

 Variation^

Selects how much variation is applied to the previous melody when improvising.

  Generator - Listener^

Overview

A "Listener" Generator detects a monophonic (not polyphonic) incoming MIDI note event on its MIDI channel and presents it as a virtual composed note. It will only detect a subsequent note if it first receives a note off for the previous note.

To generate sound via the ISE it needs to be followed by a Follower Generator. Used like this, Listener Generators allow you to create simple hyperinstruments where external input can influence the music that is generated. Such music is also referred to as Adaptive Generative Music [AGM].

Listener Generators do not have any special parameters, which is why there is no special Parameter Group, and nor do they require any use of scripting. However, they can be used with Intermorphic Wotja Script to create more advanced hyperinstruments.

When an incoming MIDI note is detected, e.g. C60, then:

1. If the Generator has a Chords Depth value of 1 and Chords Range value of 0 (both default values) it echoes a single virtual note that can be "heard" only by a Follower Generator - this is used to create an actual note.
2. If the combined Chords Depth or calculated Chords Depth/Chords Depth Range value is >1 then the first note is still silent (and echoed as above and so can be followed, too), but the composed chording notes will also play (e.g. through the ISE) and Generators can follow those notes, too.

The virtual note created by a Listener Generator is pitch shifted, if necessary, to fit within the band of pitch values set by its Pitch and Pitch Range parameters (see Rhythmic Generator).

Playing with a Listener Generator:

• Ensure Wotja has been setup, as below.
• Ensure your Listener Generator is on the MIDI channel you are expecting to detect MIDI notes.
• Either Follow that Listener Generator with a Follower Generator (1 above) and maybe use that Generator's Chording parameters to play chords, OR set its Chording parameters to >1 (as in 2 above).
• Press play in Wotja app to start your Cell and for the Listener Generator to detect the MIDI notes fed into it (and remember that the Listener Generator will only detect a subsequent note if it first receives a note off for the previous note!).

Wotja Setup:

MIDI emitting app or MIDI Device feeding MIDI notes into the Wotja app

• Load the MIDI app (e.g. for iOS MIDIKeys or e.g. for macOS MIDI Mock or Live Performer) and ensure you have it set up to send MIDI notes on the Virtual MIDI channel you want, e.g. MIDI Channel 1 or Omni etc. Tip: In MIDIKeys you must have CoreMIDI Port set to 'Virtual Port'.
• In Wotja > Settings, select the MIDI Input Devices button which takes you to the MIDI Input Devices screen:
  • Toggle on the relevant Channels for your desired MIDI Input Device(s), e.g. 'Network Session 1' on iOS, or e.g. 'MIDIKeys'.
• To hear sound in Wotja, ensure you have the "ISE for Sounds & FX" setting toggled on in Settings. Note that when playing through the ISE the latency you will experience is mostly affected by both the Audio Block Size. When that is 1024 samples the latency is about 1 second; when set to its minimum value of 256 samples then it is about 1/4 of a second. You may also wish to experiment with the MIDI Latency setting.

  Generator - Chords^

Overview

The Chord parameters let you configure any Generator Type to generate chords automatically.

In outline, use the Depth and Depth Range values to define the "Chord Depth"; which is the number of notes that will play at any one time for a given Generator. The first note in any chord is composed according to the normal mechanism for the Generator Type; additional notes that cause a chord to be built-up may be generated automatically according to the Chord parameters.

Parameter Group - Chords

•  Depth
•  Depth Range
•  Percent
•  Strategy
•  Units

•  Delay
•  Delay Range
•  Shift/Interval
•  Shift/Interval Range
•  Pitch Offset
•  Velocity Factor

 Depth^

Specify the minimum Depth of chord that you want your Generator to play with. A value of 1 will mean that the Generator will not chord (unless the Depth Range parameter is greater than zero).

The Depth defines the number of notes that are played by the Generator at any one time.

 Depth Range^

Specify the relative maximum Depth of chord that you want your Generator to play with. A value of 0 means that whenever the Generator is played, it will play a number of notes equal to the Depth. A value of one or more means that whenever the Generator is played, it will play a number of notes equal to a randomly selected value between the Depth and the Depth plus the Depth Range.

 Percent^

This parameter tells the Generator the percentage chance that it should actually emit any given note in the chord (after the first note, of course!). Set to 100 if you want the Chording Generator to always emit a note for every note played by the Generator. Set to a smaller value if you want to thin-out the notes played within the chord. This allows you to create chords of varying depth; sometimes dense, sometimes thin.

 Strategy^

This parameter tells the Generator what it should do when it decides the pitch to use for a note generated within a chord. The available values are:

• Chordal Harmony

  This causes the Generator's chord notes to be selected according to the currently defined Scale, Harmony and Next Note Rules.

• Interval Within Scale Rule

  This causes the Generator's chord note to be selected offset from the followed note, such they it is at an interval within the Scale Rule beyond the previous note in the chord, defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.

  For example, if these values are 1 and 2 respectively, then each time a note is chosen within the chord, it will be between 1 and (1+2)=3 Scale Rule intervals up from the previous note in the chord. It is important to understand that this refers to the non-zeroed elements in the current Scale Rule, in other words only those notes that are available within the Scale Rule.

  So, in our example, if we were using a Major Scale Rule, and if the first note in the chord were C4 (Middle C), and if the Generator chose a value of 2 as its random value; then the played note would be E4 (Middle C), which is the second note up from Middle C within the Major Scale Rule.

• Semitone Shift

  This causes the the Generator's chord note to be selected offset up from the previous note in the chord, such it is offset from the previous chord note by a number of semitones which is a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values. A note chosen in this way ignores the current Scale Rule.

  For example, if these values are 1 and 2 respectively, then each time a note is chosen, it will be between 1 and (1+2)=3 semitones up from the previous note in the chord.

  So, in our example, if we were using a Major Scale Rule, and if the previous note in the chord were C4 (Middle C), and if the Generator chose a value of 3 as its random value; then the played note would be D#4 (Middle D#), which is the third semitone note up from Middle C. This value is used even though it is not in the current Scale Rule.

 Units^

You define the Unit of Measure by which the Delay and Delay Range parameters are interpreted. This may be one of the following values:

• Seconds (thousandths of a)

  The parameters including Duration are all interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Duration value of 1000 means one second.

• Beats (60ths of a)

  The parameters including Duration are all interpreted as being in 60ths of a beat. In the IME a Beat is defined as being one crotchet; you get 3 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet.  A Duration value of 15 means a semi-quaver.  A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).

• Quantized Beats (60ths of a)

  This works the same way as Beats (60ths of a) except that where the Delay has a special value of 10, 15 or 20; the delay is interpreted in a special way that is very useful for some breakbeat-based music. Specifically, in this case, the calculated value for the delay is rounded to the nearest sub-multiple of the Delay value. So, for example, if the engine calculates a value of 43, and if Delay is 20, the used value for the delay is actually 40 (which is the nearest multiple of 20).

 Delay^

This defines the minimum delay after which the Chording Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Chording Generator will have a note whose delay is separately calculated.

 Delay Range^

This is combined with the Delay parameter, to determine the delay after which the Chording Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Chording Generator will have a note whose delay is separately calculated.

 Shift/Interval^

Used when the Strategy is either Interval Within Scale Rule or Semitone Shift.

This causes the Chording Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.

 Shift/Interval Range^

This represents the "Shift/Interval Range", and is used when the Strategy is either Interval Within Scale Rule or Semitone Shift.

This causes the Chording Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.

 Pitch Offset^

This parameter defines the amount that the pitch of each note in the chord should be offset, in semitones, from the previous note in the chord; the actual value selected might be overridden according to the various rules that apply to the Generator, but in general, this parameter allows you to "shape" a chord to have a given range of pitch values. In combination with the Delay-related parameters, this allows you to create some very interesting arpeggiation effects.

For example, a value of +12 would tend to space each note in the chord by a range of 12 semitones (which is one octave), with each subsequent value in the chord being higher in pitch that the previous.

For example, a value of -12 would tend to space each note in the chord by a range of 12 semitones (which is one octave), with each subsequent value in the chord being lower in pitch that the previous.

 Velocity Factor^

This parameter allows you to specify the range of relative velocities for the notes in a chord. Each subsequent note in the chord is the defined percentage louder (for a positive value) or quieter (for a negative value) than the previous note in the chord. A value of zero means that all notes in the chord are played with the same velocity.

The Generator velocity envelope values are ignored when this parameter is applied.

For example, a value of -30 would tell the Generator to generate its chords such that each auto-chorded note is 30% quieter than each preceding note in the chord; giving a noticeable tailing-off effect.

  Generator - Rules^

See also the Rule Editor.

The Generator Rule parameters let you select the various rules that govern how your Generator works. The Rules themselves are edited in the relevant Rule Object. See Rule Objects.

Parameter Group - Rules

•  Scale
•  Harmony
•  Rhythm
•  Next Note

•  Harmonize?
•  Generator Root

 Scale Rule^

See also: Rule Editor and See Rule Objects; Standard Rule Values

Each Generator composes according a Scale Rule. The Rule defines both the notes in the musical scale that are available for use and the note probability weightings.

Scale Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.

Scale Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.

• Scale Rule elements: 24
  • These elements represent the semitone distance from the Root note defined for this Cell, these being: P1 (root), m2, M2, m3, M3, P4 (perfect 4th), b5, P5 (perfect 5th), m6, M6, m7, M7, P8 Oct (octave), m9, M9, m10, M10, P11 (perfect 11th), m125, P15 (perfect 13th), m14, M14, m15, M15.
  • Element values: % probability weighting
• If opening an "old" rule that contains just one octave, we automatically extend it by duplicating into a higher octave, and;
• We wrap around the two octaves, matching Pitch Minimum as well as we can:
  • If Generator has pitch minimum of B, but Root is C; wrap around the rule starting from the C below.
  • If Generator has pitch minimum of D, but Root is C; wrap around the rule starting from the D below.

Included Scale Rules

The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):

Scale Rule Name	Element Values
Default	1 0 0.5 0 1 0.5 0 1 0 0.5 0 0.5
All Scale Major	1 0 1 0 1 1 0 1 0 1 0 1
All Scale Minor Natural	1 0 1 1 0 1 0 1 1 0 1 0
All Scale Minor Harmonic	1 0 1 1 0 1 0 1 0 0 0 1
Chord Major triad	1 0 0 0 1 0 0 1 0 0 0 0
Chord Major sixth	1 0 0 0 1 0 0 1 0 1 0 0
Chord Dominant seventh	1 0 0 0 1 0 0 1 0 0 1 0
Chord Major seventh	1 0 0 0 1 0 0 1 0 0 0 1
Chord Augmented triad	1 0 0 0 1 0 0 0 1 0 0 0
Chord Augmented seventh	1 0 0 0 1 0 0 0 1 0 1 0
Chord Minor triad	1 0 0 1 0 0 0 1 0 0 0 0
Chord Minor sixth	1 0 0 1 0 0 0 1 0 1 0 0
Chord Minor seventh	1 0 0 1 0 0 0 1 0 0 1 0
Chord Minor-major seventh	1 0 0 1 0 0 0 1 0 0 0 1
Chord Diminished triad	1 0 0 1 0 0 1 0 0 0 0 0
Chord Diminished seventh	1 0 0 1 0 0 1 0 0 1 0 0
Chord Half-diminished seventh	1 0 0 1 0 0 1 0 0 0 1 0
Chord Augmented major seventh	1 0 0 0 1 0 0 0 1 0 0 1
Chord Seven-six	1 0 0 0 1 0 0 1 0 0 1 0
Chord Mixed-third	1 0 0 1 1 0 0 1 0 0 0 0
Chord Suspended fourth	1 0 0 0 0 1 0 1 0 0 0 0
Chord Dominant ninth	1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 0 0 0 0 0 0 0 0
Chord Dominant eleventh	1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 0 0 0 0
Chord Dominant thirteenth	1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 1 0 0 0
Chord Seventh minor ninth	1 0 0 0 1 0 0 1 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0
Chord Seventh sharp ninth	1 0 0 0 1 0 0 1 0 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 0
Chord Seventh augmented eleventh	1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 0 1 0 0 0 0 0 0
Chord Seventh diminished thirteenth	1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 1 0 0 0 0
Chord Add nine	1 0 0 0 1 0 0 1 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0
Chord Add fourth	1 0 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0
Chord Add sixth	1 0 0 0 1 0 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Chord Six-nine	1 0 0 0 1 0 0 1 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0
Chord Suspended second	1 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Chord Jazz sus	1 0 0 0 0 1 0 1 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0
Mode Ionian (I)	1 0 1 0 1 1 0 1 0 1 0 1
Mode Dorian (II)	1 0 1 1 0 1 0 1 0 1 1 0
Mode Phrygian (III)	1 1 0 1 0 1 0 1 1 0 1 0
Mode Lydian (IV)	1 0 1 0 1 0 1 1 0 1 0 1
Mode Mixolydian (V)	1 0 1 0 1 1 0 1 0 1 1 0
Mode Aeolian (VI)	1 0 1 1 0 1 0 1 1 0 1 0
Mode Locrian (VII)	1 1 0 1 0 1 1 0 1 0 1 0
Special Root only	1 0 0 0 0 0 0 0 0 0 0 0
Special Scale Chromatic	1 1 1 1 1 1 1 1 1 1 1 1

 Harmony Rule^

See also: Rule Editor and See Rule Objects; Standard Rule Values.

Each Generator composes according a Harmony Rule. The Rule defines how likely it is that a note for that Generator will harmonize at a given musical interval in semitones with any note already composed (and in use by) by any *other* Generator.

Harmony Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.

Harmony Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.

• Harmony Rule elements: 24
  • These elements represent in semitones the possible harmonies available, these being: P1 (root), m2, M2, m3, M3, P4 (perfect 4th), b5, P5 (perfect 5th), m6, M6, m7, M7, P8 Oct (octave), m9, M9, m10, M10, P11 (perfect 11th), m125, P15 (perfect 13th), m14, M14, m15, M15.
  • Element values: % probability weighting
• Note: If opening a mix that uses an "old" 12 element rule we automatically extend it by duplicating into a higher octave.
• If harmonic distance is greater than 2 octaves, wrap around the rule.

• Example:

  • Imagine that you have three Generators, called X, Y and Z.
  • Imagine that at some time in the Cell, the IME has already chosen to play note C for Generator X, and note G for Generator Y. At that time, the IME thinks about composing a note for Generator Z. It looks at the notes available for it to compose, and adjusts the probabilities of choosing each of those notes, by applying the Harmony Rule element values for each of those two composed notes which are active at time (i.e. notes C and G).
  • Harmonies are always calculated based on a rising direction up from the Cell Root. So, if the Cell Root is B and the IME is considering if it can compose note D for Generator Z, and it looks at the note it needs to harmonize with which is note C for Generator X; then Noatikl figures-out the Harmony Rule values for Generator Z from the C of Generator X, up and through the Octave (i.e. E, F, F#, G, G# etc.).

Included Harmony Rules

The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):

Harmony Rule Name	Element Values
Default	.35 0 0 .65 .85 1 .65 .65 .65 .1 .1 0 .35
All (one octave)	1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0
All (two octaves)	1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
P1	1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
P1 and P8	1 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0

 Rhythm Rule^

See also: Rule Editor and See Rule Objects; Standard Rule Values.

Each Generator composes note durations according a Rhythm Rule. The Rule defines how likely it is that a note for that Generator has a certain duration. This rule is combined with other factors, including the remaining length of time a Generator has left in the current bar (the IME tries to avoid having notes from non-Ambient Generators drifting across bar boundaries).

Rhythm Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.

Rhythm Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.

• Rhythm Rule elements: 12
  • These elements represent the permitted note durations, these being: 1, 1/2., 1/2, 1/4., 1/4, 1/8., 1/8, Triplet, 1/16
  • Element values: % probability weighting

Included Rhythm Rules

The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):

Rhythm Rule Name	Element Values
Default	.1 .25 1 .5 .5 .25 .25 0 0
All But Dotted	1 1 1 0 1 0 1 1 1
Slow	1 1 1 0 1 0 0 0 0
Fast Syncopated	0 0 0 0 0 1 1 1 1
Fast Plain	0 0 0 0 0 0 1 0 1
Very Slow	1 0 .5 0 .25 0 0 0 0
Semiquavers Only	0 0 0 0 0 0 0 0 1
MIddle	0 1 0 1 1 1 0 1 0
All	1 1 1 1 1 1 1 1 1

 Next Note Rule^

See also: Rule Editor and See Rule Objects; Standard Rule Values.

For each Generator's composed notes the Next Note Rule defines the distances in semitones available to be used between each note.

Next Note Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.

Next Note Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.

• Next Note Rule elements: 24
  • These elements represent in semitones the distance a new note will be from the last composed note, these being: P1 (root), m2, M2, m3, M3, P4 (perfect 4th), b5, P5 (perfect 5th), m6, M6, m7, M7, P8 Oct (octave), m9, M9, m10, M10, P11 (perfect 11th), m125, P15 (perfect 13th), m14, M14, m15, M15
  • Element values: % probability weighting
• Note: If opening a mix that uses an "old" 12 element rule, we automatically extend it by setting the "upper range" items to zero.

Included Next Note Rules

The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):

Next Note Rule Name	Element Values
Default	0.25 1 1 .7 .3 .2 .1 .1 .1 .1 .05 .02 .05 0 0 0 0 0 0 0 0 0 0 0
All (one octave)	1 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0
All (two octaves)	1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1

 Harmonize?^

The default value for this parameter is "Yes", which means that the Generator will be considered for harmonisation with other Generators. Set to "No" if for some reason you do not want other Generators to harmonize with this Generator.

 Generator Root^

Normally, you want your Generator to use the Cell Root. This is represented by the value ? However, sometimes you really want to force your Generator to use a different Root note; in which case, set the Generator Root to be whatever value suits.

This allows you to work-around the following sort of problem:

Imagine that you have a sampler, wher you load-up a variety of loops against MIDI note C3 up to D3. To have your Cell drive this from a Rhythmic Generator such that the sounds you hear are not affected by changes to the Cell Root, you should set the Generator Root to e.g. C3 and your Generator will then be unaffected by changes to the Cell Root. Note that in this specific example, it would probably be a good idea to set the Harmonize? Flag to No.

  Generator - Scripting^

The Generator Scripting parameter allows your Generator to use Intermorphic Wotja Script. For full details please refer to the Intermorphic Wotja Script Guide.

  Generator - Comments^

Overview

This Generator Comments parameters allow you to store comments in your Generator, in the form of copyright information and any notes you might want to make for future reference.

Parameter Group - Comment

•  Copyright

•  Notes

 Copyright^

Enter the Copyright information you might want to record for the Generator. In the case of a Generator from a template pack, this might contain a copyright notice associated with that template.

 Notes^

Enter any detailed notes you might want to make about this Generator for future reference.

  Generator - Articulation^

Overview

Important: A Generator's Articulation parameters apply to any/all notes it composes, be that via e.g. generative parameters, patterns or text-to-music.

The Generator Articulation parameters define the percentage of the duration of composed note, i.e. they determine how long a composed note actually plays for. A long time ago the IME used to compose notes to be played "Legato" (no gap between one note and the next) - this parameter allows you to play them with a shorter duration, e.g. staccato.

Parameter Group - Articulation

•  Minimum
•  Range

•  Change
•  Change Range

 Minimum^

1 is very staccato and 100 is legato (the new default).

 Range^

Max articulation is the value of Articulation (min) + Articulation range, and is used in combination with the variation values (below).

 Change^

The minimum variation in staccato between notes, c.f. other parameters that adopt the min + range approach.

 Change Range^

The range in variation of stacatto between the notes (in addition to the min).

  Generator - Controllers^

Overview

The Generator Controllers parameters define some of the key MIDI controller values that are emitted by the Generator.

Parameter Group - Controllers

•  Damper/Hold
•  Harmonic Content (71)
•  Reverb (91)
•  Chorus (93)

•  Damper Release
•  Portamento (65)
•  MIDI Channel Sharing

 Damper/Hold (64)^

Set this value to other than the default of "-1", if you want to emit a Damper/Hold MIDI controller (MIDI CC 64) at the specified value on this Generator's MIDI line. This is a funny MIDI controller, with only two states; in that a value of 64 or greater activates Damper/Hold, and any value of 63 or less means to turn it off! Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.

 Harmonic Content (71)^

Set this value to other than the default of "-1", if you want to emit a Harmonic Content MIDI controller (MIDI CC 71) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.

 Reverb (91)^

Set this value to other than the default of "-1", if you want to emit a Reverb MIDI controller (MIDI CC 91) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.

 Chorus (93)^

Set this value to other than the default of "-1", if you want to emit a Chorus MIDI controller (MIDI CC 93) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.

 Damper Release^

If you are using Damper/Hold (64), then you will find that your notes can start building-up and never decay! In which case, set the Damper Release parameter to "Yes", which tells the Generator to momentarily release the damper just before the end of every bar. This prevents build-up of notes and generally sounds wonderful.

 Portamento (65)^

Set this value to other than the default of "-1", if you want to emit a Portamento MIDI controller (MIDI CC 65) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.

 MIDI Channel Sharing^

The default value of "Yes" means that this Generator can share its MIDI channel with other Generators. This is only considered if you have defined the MIDI Channel parameter for a Generator to be 0.

  Generator - Micro Controllers^

Overview

The Generator Microcontroller parameters (there are two - User C1 and User C2) allow you to define very powerful Microcontrollers to be associated with your Generator.

Microcontrollers are very powerful and you can think of them as built-in, highly configurable MIDI event generators. They can either synchronise to the tempo of your Cell, or you can let them run free-floating. Experiment with them – they can do a huge amount to make your music interesting and dynamic.

Tip: if you want to synchronise your Microcontroller to the time-base, so that your MIDI controller is synchronised to bar boundaries in your music, you'll need to use the Beat Cycle Length parameter.

Parameter Group - Micro Controllers

•  MIDI CC
•  Mode
•  Minimnum
•  Range
•  Change
•  Change Range

•  Update
•  Update Range
•  Update Units
•  Beat Cycle Length
•  Phase Shift %

 MIDI CC^

This tells your Generator which MIDI controller (also referred to as the MIDI CC) to emit for this microcontroller, e.g. 11. When the Microcontroller is active, the Generator will emit values for this MIDI controller that change at various times, with behaviour that you define using the various parameters in this Parameter.

 Mode^

The Mode defines the shape of the waveform that the Generator will use to shape this waveform.

The Mode may be one of the following values:

• -1 – Off

  The microcontroller is off. This is the default value.

• 0 - Random Drift

  The microcontroller will drift between the Minimum and Minimum plus Range, changing at times specified by the Update and Update Range parameters, by an amount between the Change and Change plus Change Range parameters.

• 1 - LFO (Min-Max-Min)

  A triangular waveform, that starts at the minimum value, works up to the maximum value, and works back to the minimum value.

• 2 - LFO (Max-Min-Max)

  A triangular waveform, that starts at the maximum value, works down to the minimum value, and works back to the maximum value.

• 3 - Sawtooth (Min-Max)

  A sawtooth waveform, that starts at the minimum value, works up to the maximum value, and then starts again from the minimum value.

• 4 - Sawtooth (Max-Min)

  A sawtooth waveform, that starts at the maximum value, works down to the minimum value, and then starts again from the maximum value.

 Minimum^

Defines the minimum value that may be emitted by the Microcontroller.

 Range^

The microcontroller will emit a value between the Minimum and Minimum plus Range values.

So for example, if you define Minimum to be 20, and Range to be 100, the value that is emitted will be in the range 20 to 120 inclusive.

 Change^

Defines the amount by which the microcontroller will change, every time it is allowed to change. Typically set to a value of 1. If this value is set to 0, the Microcontroller will change only if the Change Range is greater than or equal to 1.

 Change Range^

Defines the upper limit to the amount by which the microcontroller will change, every time it is allowed to change. Typically set to a value of 1. If this value is set to 0, the Microcontroller will change only if the Change Range is greater than or equal to 1.

For example, if you define Change to be 1, and Change Range to be 3, the value that is emitted will vary by a value between 1 and (3+1)=4 each time.

 Update^

Defines the minimum time in milliseconds between changes in the emitted Microcontroller value. The system might not be able to emit changes as quickly as you want, if you set a very small value! If you don't want changes to happen very often, then use a large value.

Ignored if Beat Cycle Length is non-zero.

 Update Range^

Defines the upper limit in the time in milliseconds between changes in the emitted Microcontroller value. Use this parameter to apply some uncertainty in when the changes will occur.

For example, if you define Update to be 1000, and Update Range to be 500, the value that is emitted will change every 1000 to 1500 milliseconds (or in other words, every 1 to 1.5 seconds).

Ignored if Beat Cycle Length is non-zero.

 Update Units^

You define the Unit of Measure by which the Update and Update Range parameters are interpreted. This may be one of the following values:

• Seconds (thousandths of a)

  The Update and Update Range are interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Update value of 1000 means one second.

• Full seconds

  The Update and Update Range are interpreted as being in seconds. So, a Update value of 10 means ten seconds.

 Beat Cycle Length^

This parameter is critical for generating effects which synchronise with the bar timing of your Generator. If you want to achieve an effect like a filter-sweep that synchronises to your bar boundary, then this is the parameter to use.

Here are some of the values you could use.

Note in the IME a Beat is defined as being one crotchet; you get 4 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet. A Duration value of 15 means a semi-quaver. A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).

 Phase Shift %^

Use this parameter if you want to start the microcontroller from a start-point other than at the very start of its cycle.

  Generator - Micro Delay^

Overview

The Generator Micro Note Delay parameters provide fine variation in the times of Note events generated by a Generator. This can be used to give a Generator more “human” feel.

Parameter Group - Micro Note Delay

•  Delay Range
•  Delay Change

•  Delay Offset

 Delay Range^

The maximum amount of delay generated by micro note delay changes, that may be applied to note events. Zero means off (which is the default).

 Delay Change^

The amount of change in the micro delay that is applied by Wotja between note on/off events. The value drifts between zero (off) and the Delay Range, changing by plus or minus the Delay Change value each time.

 Delay Offset^

Fixed amount of offset note delay to apply, used only when the Micro Note Delay controller is in use. The default value is zero.

  Generator - Micro Pitch^

Overview

The Generator Micro Pitch parameters provide fine variation through use of the MIDI Pitch Wheel controller.

Tip: This is not normally used on MIDI line 10, which is the drum/percussion line!

Parameter Group - Micro Pitch

•  Bend Sensitivity
•  Pitch Bend Offset
•  Pitch Range

•  Pitch Change
•  Pitch Update
•  Pitch Update Range

 Bend Sensitivity^

A value from 0 to 24, meaning how many semitones are controlled by the full available range of Micro Pitch parameters. The default value is 2, which represents two semitones.

 Pitch Bend Offset^

Fixed amount of pitch-bend to apply on this MIDI line, used to tune/de-tune an instrument.

The default value is zero, which means to apply no offset pitch bend.

From -8192 to +8191; which covers a range of pitch bend defined by the Bend Sensitivity parameter.

 Pitch Range^

The maximum amount of micro pitch change that can be applied. Zero means off (which is the default). The maximum value allowed is 8191. The value chosen is added to the pitch bend offset.

 Pitch Change^

The amount of change in Micro Pitch that is applied by Wotja between “update” periods. The value drifts between zero (off) and the Pitch Range, changing by plus or minus the Pitch Change value each time.

 Pitch Update^

The time in milliseconds between updates to the pitch controller. The actual value chosen is selected randomly each time, to be a value somewhere between Pitch Update and Update Range.

 Pitch Update Range^

The upper limit of time between updates to the pitch controller. The actual value chosen is betwen Pitch Update and Update Range.

  Generator - Note to MIDI CC^

Overview

Normally, Generators compose and emit MIDI note events. The Generator Note to MIDI CC Mapping parameters allow you to tell a Generator to emit MIDI controller data instead of MIDI note events.

Why would you want to do this? Well, it lets you use a Generator as a very powerful generative MIDI event generator with a huge range of potential applications.

Parameter Group - Note to MIDI CC

•  CC for Note On?
•  Note On CC
•  CC for Velocity?

•  Velocity CC
•  CC for Note Off?
•  Note Off CC

 CC for Note On?^

If you want this Generator to emit a MIDI CC instead of note on/off events, set this parameter to Yes.

 Note On CC^

If you have set CC for Note On? to Yes, then instead of emitting a note on event, the Generator will emit the specified MIDI CC, with a value equal to the composed pitch.

 CC For Velocity?^

If you want this Generator to emit a MIDI CC proportionate to the Velocity of the composed note (in addition to any controller defined for Note On CC), then set this parameter to Yes.

 Velocity CC^

If you have set CC for Velocity? to Yes, then the Generator will (in addition to the Note On CC value) emit the specified MIDI CC, with a value equal to the composed velocity.

 CC for Note Off?^

If you want this Generator to emit a MIDI CC when a note off occurs, set this parameter to Yes. This applies only if CC for Note On? Is set to Yes.

 Note On CC^

If you have set CC for Note Off? to Yes, then instead of emitting a note off event, the Generator will emit the specified MIDI CC, with a value equal to the composed pitch of the stopped note.

  Generator - Envelopes^

Overview

See also the Envelope Editor.

Generator Envelopes are supported for a number of parameters. Envelopes work in the same way for all of these, so they are all grouped here.

Each envelope is a collection of up to 100 data points. A Cell 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.

You can draw direct on to the envelope with your mouse.

Alternatively, you may use one of the various powerful envelope editing tools that we have made available to you.

To use the envelope editing tools:
- Right-click (win) or ctrl-click (mac) on the envelope tool
- Select the option you want. e.g. random, curve up etc.
- Select the range using the mouse...
- Then: either press space or enter, or select pop-up envelope tool to apply to the selected range.
- Select freehand mode to return to the normal click-to-paint mode.

Parameter Group - Envelopes

•  Velocity
•  Velocity Range
•  Velocity Change
•  Velocity Change Range

•  User Envelope 1 (Volume)
•  Micro User (Envelope 1)
•  User Envelope 2 (Pan)

 Velocity Envelope^

This allows you to define how the Velocity level is changed automatically for your Generator throughout playback of the Cell. The velocity defines relatively how loud each note is.

The actual Velocity value used at any point in the Cell is calculated as being a value somewhere in the range from Velocity, to Velocity plus the value of the Velocity Range envelope.

 Velocity Range Envelope^

The value in this envelope is added to the value in the Velocity Envelope.

 Velocity Change Envelope^

The velocity for any composed note can change by a value between Velocity Change Envelope value (VCE) and the VCE plus the Velocity Change Range Envelope value.

 Velocity Change Range Envelope^

The value in this envelope is added to the value in the Velocity Change Envelope.

 User Envelope 1 (Volume)^

This allows you to define an envelope that is used to emit a MIDI CC of your choice. The default value for this MIDI CC is 7, which is the Volume controller.

• MIDI CC

  Use this to define the MIDI CC that you want to be emitted by this envelope. The default value is 7, which is the Volume controller.

• Enabled?

  Use this to turn your envelope on or off.

• Envelope

 Micro User (Envelope 1)^

This provides fine variation in the values generated by the User Envelope 1. Any value generated by this micro controller is added to the Micro User Envelope 1 value, to give fine variation in any such envelope.

• Range

  The maximum amount of micro change in the User Envelope 1 that can be applied. Zero means off (which is the default).

• Change

  The amount of micro change in the User Envelope that is applied by Wotja between “update” periods. The value drifts between zero (off) and the Range, changing by plus or minus the Change value each time.

• Update

  The time in milliseconds between updates to the Micro User Envelope value. The actual value chosen is selected randomly each time, to be a value somewhere between Update and Update Range.

• Update Range

  The upper limit of time between updates to the Micro User Envelope value. The actual value chosen is betwen Update and Update Range.

 User Envelope 2 (Pan)^

This allows you to define an envelope that is used to emit a MIDI CC of your choice. The default value for this MIDI CC is 10, which is the Pan controller.

• MIDI CC

  Use this to define the MIDI CC that you want to be emitted by this envelope. The default value is 10, which is the Pan controller.

• Enabled?

  Use this to turn your envelope on or off.

• Envelope

Cell - Rules

The Cell Rules parameters allow you to define the default Rules used by the Generators in the selected Cell. Each Cell can have different Cell Rules.

Scale Rules

Set this to define the default Scale Rule to use when the Cell plays. Individual Generators are allowed to override this setting if they so wish.

Harmony Rules

Set this to define the default Harmony Rule to use when the Cell plays. Individual Generators are allowed to override this setting if they so wish.

Next Note Rules

Set this to define the default Next Note Rule to use when the Cell plays. Individual Generators are allowed to override this setting if they so wish.

Cell - Meter

The Cell Meter parameters define the Meter to be used by the Cell, such 4:4 or 3:4 or 6:8. A Generator will generally use this Meter, but the Meter value to be used for each Generator may actually override this setting. This approach allows Generators to be configured to work with a completely different Meter, which can be used for interesting polyphonic effects.

Cell - Scripts

The Cell Scripting parameter allows a Cell to use Intermorphic Wotja Script. For full details please refer to the Intermorphic Wotja Script Guide.

Cell Info

The Cell Info Object allows you to define some book-keeping parameters for your Cell. None of these parameters affect the way that your Cell sounds. However, they are useful if you you wish to later export the Cell as a new Template because when you load that new Template it will show the values set here.

Template Title (editable)

The title of the Template that was first added to the Cell. If you change the title the changed title is not shown in the Cell, only here.

Template Author (editable)

The author of your Template.

Template Notes (editable)

Any notes you want to include for your Template.

File Path (non-editable)

This shows file path to the Pak that the Template is in.

Content Duration (non-editable)

This is non-editable and shows the duration of a WAV file or MIDI file (if used, and which is why it is shown) or 8:53:20 for generative content.

Mix Settings

Mix Tempo

The Mix Tempo allows you to define the tempo for your mix.

Mix Root

The Mix Root parameter allows you to define the Root Pitch to use for the mix. For example, if you are using a Major Scale Rule, then set this value to be C for your Cell to play in the key of C Major.

Ramp Up

Sets how long it takes for the file volume to ramp up once the file has started to play.

Playlist Duration

Sets how long the mix file will play for in the Playlist.

Playlist Duration Range

Sets a range on how long the mix file will play for in the Playlist.

Playlist Ramp Down

Sets how long it takes for the mix file volume to ramp down before play moves to the next mix file in the Playlist.