Wotja V20 icon

V20.3.7 - 23 Mar

Introduction

V20.3.7 - 23 Mar  |

Wotja V20 for mobile, desktop, TV and Apple Watch


Overview

This User Guide is for all Wotja V20 versions, interfaces and Feature Sets.

See also these Companion Guides:

Unless otherwise noted we use 'Wotja' to refer to either the free Wotja app or the paid-for Wotja Pro 20 app.

Note 1: The 'Pro S' and 'Pro 20' Feature Sets are identical except in relation to the TV apps where the Pro 20 TV app is the only one without a timeout. That duly noted, this User Guide uses 'Pro' to refer to either 'Pro S' and 'Pro 20' Feature Set.

Note 2: Amongst a few other limitations, the 'Lite' Feature Set has an auto-timeout of 10 minutes; tap the Play button to restart it.

Wotja Generative Music System

Wotja ( "wot-jah") is an awesome 'generative music' creator, lab & player system with a rich history.

Use it to generate ambient & melodic soundscapes, lush drone mixes, reflective text-to-music, MIDI, ideas, cut-up & much more.

Whether you use it as a creativity app or as an aid to relaxation, Wotja can be enjoyed with or without musical knowledge.

Dip into it for just a few minutes or take a deep dive - it's up to you!

Users say: "Essential music app", "Nothing compares", "Masterpiece", "Simply the best ambient app ever made!"

Wotja Platforms, Devices & Languages

Platforms: iOS, macOS, Windows, Android/Android TV, tvOS/watchOS

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

Languages: English, Chinese, Japanese

What's New in V20

For a full list see the V20.0 release notes. We'll add more things during the V20 (2020) product cycle.

    Overall

    • Simplified App Range: There are now only 2 Wotja apps per platform:
      • Wotja Pro 20 - a 'paid-for' app with a 'Pro 20' Feature Set
      • Wotja - a FREE app with a 'Lite' Feature Set
        • A 'Pro S' Feature Set can be unlocked in the iOS/macOS versions via In-App Subscription
    • New iOS App Inclusions: The above apps for iOS now include the relevant Wotja app for Apple Watch (see below)
    • New TV App Inclusions: The above apps now include the relevant Wotja app for and Apple TV/Android TV
    • Better Value: Personal Live Use used to be a $3.99/month Subscription but is NOW FREE
    • Better Business Model: Commercial Live Use is now licensed via the C0 / C1 / C2 / C3 Subscription tiers; as before, these easy to cancel Subscriptions can also be used as a 'tip jar' mechanism (for those that wish to!)

    New Features / Capabilities

    • New Wotja 20 Feature (iOS): Support for Ableton Link
    • New Wotja 20 Feature: Under-the-hood support for application/vnd.koan MIME Type makes it easy to play & share Wotja mix files when the .wotja file extension is changed to .skd
    • New IME 20 Feature: The V20 Wotja 'Pro' Feature Sets ('Pro S' and 'Pro 20') have no auto-timeout, this being a MAJOR change from V19 with its 8 hour auto-timeout; it means that Wotja with a 'Pro' Feature Set will now play either until you stop it or until a sleep timer kicks in - making it ideal as a background music generator for Personal or Commercial Live Use (see Better Value & Better Business Model above)
    • New IME 20 Feature: A new Text-to-Music (TTM) 'Generator Type' makes it much easier to use TTM (it used to be a subset of the Patterns Type)
    • New IME 20 Feature: 'Cut-up Rule' parameter for TTM Generator with values of: Custom … (as current behaviour), Cut-Up: Line# = Track# (used in new automatic mixes), Cut-up: All lines, Cut-Up: Line# 1, Cut-Up: Line# 2 etc.
    • New IME 20 Feature: 'Cut-up Rule' parameter allows the text used for TTM to be linked to the (line numbered) cut-up in the Cup-Up screen, making TTM much easier to use - one tap of the Cut-up Create button can be used to auto-change the TTM text used for multiple TTM generators meaning that you can enjoy TTM without manual text editing (you can still do that!)
    • New IME 20 Feature: When an auto mix is created or when any Template is manually added to the mix from the Templates list then any B Patterns in such Templates used in the mix are now randomized with note pitches generated to fit the defined Pitch Range (see the 'Using Templates with Patterns' section in our website Recording Rights & Copyright FAQ)
    • New ISE 20 Feature: Changes to 'Random' in LFO and Osc units makes it possible to create much better drones
    • New ISE 20 Feature: ISE Network editor Dice button now uses a lucky dip selection from all the built-in presets
    • New ITE 20 Feature: New Mix Rule Group "Automatic New Cut-Up" containing new "At Mix Start" and "Change After Seconds" toggles and new slider parameter "Seconds Between" and "Seconds Between Range" making it fast/easy to create a new text cut-up in any screen, also allowing a mix to auto-generate new melodies as it plays
    • New ITE 20 Feature: Many new Cut-up rules added to help with the new TTM capability above
    • New ITE 20 Feature: Cut-up and Automatic New Cut-up settings are now included in Randomization Schemes
    • New Wotja 20 Feature: MIDI Setting toggles to enable/disable MIDI Start/Stop Events ('Send Start/Stop Events') and enable/disable MIDI Controller Events ('Send Controller Events')
    • New Wotja 20 Feature: Support for importing legacy SSEYO Koan SKD files
    • New Wotja 20 Feature: "Text Display Duration/Range" and "Display Fade In/Out" Settings to control fade in/out of text
    • New Wotja 20 Feature: Video recordings now include animation, text fading and auto-panning - great for sharing
    • New Wotja 20 Feature: "Use Section Text" checkbox in Mix Rules that allows Wotja to sequentially display text from a mix's Saved Text sections; perfect for mixes where you want to convey meaning to aid reflection e.g. poetry, micro-stories, messages etc.
    • New Wotja 20 Feature: "Auto Pan Background Image" checkbox in Settings to allow background images to auto-pan when a mix plays (Mix Display tab, Mix Boxes etc.)
    • New Wotja 20 Feature: "Full Screen/Full Window" options in Mix/Playlist/Flow players for the simplest lean-back experience but also great for video creators, too
    • New Templates: New 'BP20 Drones 1' pak featuring 21 gorgeous drones (some utilize change to Random in LFO units)
    • New Sound Presets: New gorgeous Drone Sounds Presets coming from the above pak
    • New Randomization Schemes: These take advantage of the new content and capabilities above
    • New and Improved: Updates to 'TTM1 Players' and 'TTM1 Players 2' plus new templates added to the latter
    • New Apple Watch Apps: We've created all-new Wotja and Wotja Pro 20 companion apps for Apple Watch
    • New Sharing Option: "Copy To…" support added in iOS version to allow opening of .wotja files attached to emails

Feature Sets

Tip for app link: Tap relevant icon in table below.

The features and capabilities of any Wotja app is known as its 'Feature Set' and there are 2 main types: 'Pro' and 'Lite'.

The 'Pro' set has two sub-variants: 'Pro 20' in a Paid-for app and 'Pro S' in the free (iOS/macOS) apps as an In-App Subscription.

We refer to either of the above as a 'Pro' Feature Set because, except for one very minor detail (see table below), they are identical.

Rather than going through all the features in Wotja (there are hundreds), the table below sets out instead just the main differences between the 'Pro' Feature Set and the Restrictions in the 'Lite' Feature Set.

Note 1: Wotja Pro 20 will only be available in 2020 and will get all relevant Wotja V20 updates during the course of that year. The free versions of Wotja will get rolling updates whatever the year, which is a benefit of being a 'Pro S' Subscriber.

Note 2: Commercial use of recordings is permitted provided they are made with a 'Pro' Feature Set (see the FAQ: Do I own the rights to Recordings I make of the output of Wotja and can I use them commercially?.

Note 3: Commercial Live Use (LU) Licenses are NOT part of ANY Feature Set. Subscriptions for those are entirely separate.

A good overview of some of the UI & capabilities so worth a watch by existing users, too

App Version $ Paid-for Free (Lite)
Download links (tap icon)
iOS/watchOS/tvOS Pro 20 Pro S
macOS Pro 20 Pro S
Windows Pro 20 Lite
Android/Android TV Pro 20 Lite
Feature Set (V20.3.7) Pro 20 / S Lite
Auto-Timeout None 5 mins
MIDI Out/In Multi-Channel Channel 1 only
Track Editing All tracks Track 1 only
Export or Merge Templates Yes No
In-Mix Randomization (Cell, ISE) Yes No
Mixdown Recording to Audio Yes 30s only
Mixdown Recording to Video (iOS/macOS only) Yes 30s only
Mixdown Recording to MIDI Yes No
Use of Recordings of output (see FAQ) Commercial Personal
Openable Files Number (Documents screen) All First 5 listed
Export Flow Mix Yes No
Box/Playlist - add to/Edit/Save/Export etc. Yes No
Box Max Mix Durations 4 hours 30 secs
Remove Wotja watermark (full/display screen) Yes No
Live Use (LU) License included Personal Personal
Built-in 'Albums' Yes Yes
Notes / Other Pro 20 Lite / Pro S
Auto-timeout in the TV app: None 5 mins

Live Use

Tip: A Commercial Live Use (LU) License Subscription can also be used as a form of Tip Jar!

Wotja is a Generative Music System and can be used to generate music, MIDI, melody and text ideas that you RECORD/SAVE for later use.

Wotja can also be used to generate LIVE music, e.g. background music for a home, art installation, home office, shop, reception area etc. We specifically refer to use in this manner as Live Use (LU).

All Feature Sets include a license for Personal Live Use (LU).

To cater for anything other than Personal Live Use (LU) we sell various Commercial Live Use (LU) License Subscriptions. These are available only in the free iOS and macOS versions (see the download links above) and can be purchased in their In-App Stores.

For further details refer to the Permitted Use section of our EULA, specifically the Clauses in 7.B.

NOTES:
  • If a Commercial Live Use (LU) License Subscription lapses then you are immediately licensed only for Personal Live Use (LU)).
  • Subscriptions can be cancelled at any time via the 'Manage Subscriptions' button in the In-App Store.
  • A Commercial Live Use (LU) License Subscription can also be used as a form of Tip Jar!

Quick Start

Documents Screen - Flow Segment

Documents Screen - 'Flow' Segment
Click image for large


Documents Screen - User Segment

Documents Screen - 'User' Segment
Click image for large


Documents Screen - Albums Segment

Documents Screen - 'Albums' Segment
Click image for large

Wotja TV app: Refer to the 'TV Player' section.

Wotja Watch app: Refer to the 'Watch Player' section.

Wotja can be very quick and easy to use. It does indeed allow you to 'go deep', but you don't have to do that - if you want to explore that side of it then that is entirely up to you!

This Quick Start section refers to the Documents Screen. See the Documents Screen section for further details on that and on the 'Feature Set' and 'Live Use' buttons at the top.

Player - Generate a succession of generative mixes

Using Wotja as a generative music player is as simple as it possibly can be. Lauch Wotja and in the Documents Screen select the left-hand 'Flow' segment and tap any one of Flow icons to start it playing. It's as easy as that!

Each icon loads the 'Flow Player' with a particular Randomization Scheme and Wotja will then start generating a succession of freshly mixed generative music mixes.

Tip: With a 'Pro' Feature Set you can customize Schemes and create/save your own; they will be listed here and have the (default) purple Flow icon.

Creator - Create mixes, playlists & boxes

In the 'User' segment, tap the 'Add New' button and from the pop-up menu select 'Mix (Automatic)'.

A mix is created randomly from the hundreds of included Templates according to the settings in the selected Randomization Scheme and it will then show up in the 'User' segment.

Open the mix and press the bottom play button to stop/start playback. You can edit anything in the mix in one of the Editing Modes.

Alternatively, in the 'User' segment, tap the 'Add New' button and select 'Box (Automatic)' from the pop-up menu. From settings in the currently selected Randomization Scheme, Wotja will then create a freshly generated box of mixes (including icons, names, text etc.) to play in the Playlist Player.

After box creation you can use Mix Overrides to change mix duration, mix ordering etc. and re-save your box.

'Album' Player - Play a built-in Box

'Albums' are just special Boxes that are included in Wotja. They are for your listening enjoyment and include non-exportable Intermorphic created and curated mixes.

Tap the thumbnail of the album you want to play and it will then start playing in the Playlist Player.

Wotja App name - File | Options | Window | Help

The Desktop Menu (macOS/Windows) is where you can:

  • Quit/exit the desktop app
  • Create a new .wotjabox file ('Box' mix file collection), .wotja file (automatic mix) or .wotjalist (playlist)
  • Open a file you have previously saved
  • Open any of the relevant supported filetypes (see table below)
  • Show the Wotja data folder
  • Select your Audio Output device
  • Display Wotja with a pre-set Window size

Tip: You can use both 'Documents Window' or Finder / Windows Explorer to carry out normal file related activities e.g. delete/duplicate/rename etc.

Tip: On Desktop use 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.

UI Item Description
Menu Bar
Desktop Menu
  • Wotja App name:
    • About (macOS)
    • Other usual entries (macOS)
    • Quit (macOS)
  • File:
    • New (files are saved to the Wotja data folder)
      • 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 the last opened Mix Edit 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 Mix Edit 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.
    • Open
    • Close: Close the currently open file.
    • Save / Save As:
    • 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.
  • Options:
    • 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.
  • Help:
    • Various useful weblinks
    • About (Windows)

Documents Screen

'Wotja Pro 20' Documents Screen Top

'Wotja Pro 20' Documents Screen Top
Click image for large


'Wotja' Documents Screen Top - 'Pro S'

'Wotja' Documents Screen Top - 'Pro S'
Click image for large


'Wotja' Documents Screen Top - 'Lite'

'Wotja' Documents Screen Top - 'Lite'
Click image for large


Documents Screen - Flow Segment

Documents Screen - 'Flow' Segment
Click image for large


Documents Screen - User Segment

Documents Screen - 'User' Segment
Click image for large


Documents Screen - Albums Segment

Documents Screen - 'Albums' Segment
Click image for large

The Documents screen is what you see after you have launched the app. It is where you can:

  • Select one of three different file views (segments): 'Flow', 'User' or 'Albums'
  • 'Flow' segment:
    • Start the 'Flow Player' and use it with the named Randomization Scheme
  • 'User' segment:
    • Create a new .wotja file (automatic mix), .wotjabox file ('Box') or .wotjalist file (playlist)
    • Open a file you have previously saved
    • Open any of the relevant supported filetypes
    • Delete/duplicate/rename files
    • If you install any 3rd party Boxes you will see and can play them from here.
  • 'Albums' segment:
    • Load a Built-In Box 'Album' (e.g. presently Calm or Relax)

What you see at the top of the Documents screen depends on the version you have and (as available) the active Subscription tier(s).

Feature Set Button

Positioned to the right of the centered App Name, this button will display the name of the active Feature Set.

  • App: Wotja Pro 20 (paid-for version)
    • Button shows Pro 20
  • App: Wotja (free/subscription version)
    • Button shows Pro S if you have an active 'Pro S' Feature Set Subscription (as available)
    • Button shows Lite if you don't have an active 'Pro S' Feature Set Subscription
Live Use (LU) Licence Button

Positioned to the right of the left-hand action button, this button will display the name of the active Live Use (LU) Licence.

  • App: Wotja Pro 20 (paid-for version)
    • Button always shows LU:Pe as there is no In-App Store to allow purchase of a Commercial Live Use (LU) Licence Subscription
  • App: Wotja (free/subscription version)
    • Button shows LU:Pe by default
    • Button shows LU:C0, LU:C1, LU:C2 or LU:C3 (as appropriate) if you have an active Commercial Live Use(LU) Licence Subscription (as available)
    • Note: Commercial Live Use(LU) Licence Subscription (as available) can also be used as a form of tip jar!
Desktop vs Mobile

The only difference in display of this screen in Desktop and Mobile versions (see also the Desktop Titlebar Menu section) is that in the 'User' segment in the Desktop version you can have multiple files (mixes, playlists, Boxes and Albums) open, and playing, each one shown in a different tab at the top of the screen.

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

Filetypes
UI Item Description
SettingsSettings

Go to Settings screen.

ActionAction
  • Refresh: Refreshes the display in the Documents screen and resyncs to iCloud (if in use).
  • Sort: Selected Option...: You can choose how the files in the User segment are sorted as follows:
    • Sort: New-Old
    • Sort: Old-New
    • Sort: A-Z
    • Sort: Z-A
  • Help & Documentation: Visits this User Guide online.
  • Cancel: Closes the popup menu.
File View controlFile View Control

Tap to select either the 'Flow', 'User' or 'Albums' File view:

  • 'Flow': Displays thumbnails of all the Randomization Schemes. Select one to start the 'Flow Player' and use it with that Randomization Scheme
  • 'User': Displays thumbnails of any files of filetypes supported by the app that are present in the Wotja iCloud folder or present in the Local Wotja data folder on the device (see iCloud/Local below)
  • 'Albums': Displays thumbnails of any Box 'Albums' that are included in the app (e.g. presently 'Calm' and 'Relax').
FlowFlow button

Tap a Flow button in the Flow segment to start the 'Flow Player' mode which will use the named Randomization Scheme.

Add NewAdd New
  • 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.
  • 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.
ThumbnailSaved File Thumbnail

Saved File: Tap on one of the Saved File document thumbnails to open a previously created file.

How the thumbnail displays depends on a number of factors:

  • When a Box was created, what Icon Text setting was used: Cut-up, TTM or none
  • What auto-generated icon is in use?
  • Is it a Box (.wotjabox file)? Boxes are indicated by a small box icon that overlays the bottom right of the thumbnail image (see below).
  • Is it a Wotja template (.noatikl file)? Templates are indicated by a small template icon that overlays the bottom right of the thumbnail image (see below).
  • Is it a Wotja Playlist (.wotjalist) file? Playlists are indicated by a small playlist icon that overlays the bottom right of the thumbnail image (see below).
  • - Is content in one or multiple cells?
  • - Is it an old format Wotja file?
  • - Is it a Mixtikl file?
ThumbnailFilename

Tap on the Filename below the thumbnail for the following popup menu:

  • Open
  • Delete
  • Rename
  • Duplicate
  • Cancel
Thumbnail.wotjalist Thumbnail

Wotja Playlist: Playlist files (.wotjalist) are played in the Playlist Player.

Wotja List files are indicated by a small list icon that overlays the bottom right of the thumbnail image.

If the Playlist includes a thumbnail then you will see that here, otherwise you will see a list of the included files.

Thumbnail.wotjabox Thumbnail

Wotja 'Box' file: Boxes (.wotjabox files) are played in and exported from the Playlist Player or created in one press via New > Box (Automatic).

Boxes are indicated by a small box icon that overlays the bottom right of the thumbnail image.

If the Box includes a thumbnail image then you will see that here.

Thumbnail.noatikl

Wotja Template: A Template file (.noatikl) is shown with a small icon overlay in the bottom right corner. These are presently .noatikl files, but we may later change the extension. You can save the generative content in a cell as a template from a mix using the Toolbox icon and selecting "Export to Template" where you then see a popup where you can name the file. Once saved, you can find these .noatikl template files in the Template list under "Saved Files".

ThumbnailAlbum Thumbnail

Tap to play an included Box 'Album', e.g. 'Calm' or 'Relax' in the Playlist Player.

Play: Flow Player

Flow Player Screen

Flow Player Screen
Click image for large

The Flow Player is opened from the Documents screen as follows:

  • 'Flow' segment: Tap a Flow button and the Flow Player will start generating according to the named Randomization Scheme.

It is used to:

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

Takes you back to the Documents screen.

Sleep TimerSleep Timer

Takes you to the Settings screen where (in the "General" segment) you can configure a Sleep Timer. 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).

Repeat/ContinuumRepeat/Continuum

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

Play/StopPlay/Stop

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

BackNext

Forces another mix to be generated.

Action buttonAction button

Displays a popup 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 [macOS]) [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.
BackSettings

Takes you to the Settings screen.

Flow indicator or time remaining before sleepFlow or Sleep Time remaining

Just below the top toolbar there is a short status bar. If you have an active Sleep Timer then to the left of this is an area that 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.

Tap the Sleep Timer button in the top toolbar to go to the Settings Screen where you can configure the Sleep Timer. Note that once you have changed the Sleep Timer you need to stop/start the mix for the new sleep timer settings to be used and shown here.

Flow NameFlow Scheme

Just below the top toolbar there is a short status bar. In the centre of this is displayed the name of the Randomization Scheme currently in use.

File Play IndicatorFlow Mix Play Time

Just below the top toolbar there is a short status bar. On the right of it is displayed 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 Settings to override what is in the Randomization Scheme (RS). It's fun!

Display Text Display Text

Whether any text is displayed here depends on 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 Settings. Doing that lets you override what is in the Preset. It's fun!

Full Screen Background

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

There are different Wotja watermarks for the Wotja and Wotja Pro 20 apps shown at the bottom of the screen.

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

Play: Playlist Player

Playlist Player (Mix File List)

Playlist Player (Mix File List)
Click image for large


Playlist Player (Full Screen)

Playlist Player (Full Screen)
Click image for large

The Playlist Player is used to play Box files, Playlists and Albums. It is opened from the Documents screen as follows:

  • 'User' segment:
    • Opening a Wotja 'Box' file (.wotjabox)
    • Opening a Wotja Playlist file (.wotjalist)
    • Creating a new Box (Automatic album)
      • Create New & Album (Automatic)
      • Desktop: Titlebar Menu > New & Album (Automatic)
    • Creating a new Playlist
      • Add New > Play List
  • 'Ablums' segment:
    • Tapping on a built-in 'Album'

It is used to:

  • 'User' segment:
    • Play Wotja 'Boxes' (.wotjabox files, 'Box')
    • Play Wotja Playlists (.wotjalist files, 'Playlist')
    • 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)
    • If you install any 3rd party Box you will see and can play them from here.
  • 'Albums' segment:
    • Play a built-in 'Album' (currently 'Calm' and 'Relax')

Playlist Player File Types

  • Wotja 'Album':
    • A special kind of built-in play-only Box that does not allow exporting of mixes or Mix Overrides.
  • Wotja 'Box' (.wotjabox):
    • Container files that can be created directly through creating an Automatic album or exported from a Playlist. They include all parameter settings, text and images in the included Wotja (.wotja) mix files - which makes them great for sharing your favourite creations.
    • Note: Any Box that includes mixes that feature templates from a 3rd party template 'Pak'(s) and which uses media such as loops or add-on content must have that 'Pak' installed on any device on which you play those Boxes. See: iCloud Folder or in the Wotja Folder.
  • Wotja Playlist (.wotjalist):
    • Playlists that contain references to Wotja files saved to your iCloud folder. If you change the file in Wotja, then the Playlist just references that changed file.
UI Item Description
BackBack

Takes you back to the Documents screen.

Sleep TimerSleep Timer

Takes you to the Settings screen where (in the "General" segment) you can configure a Sleep Timer. 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).

BackPrevious

Takes you to the previous playlist item.

Play/StopPlay/Stop

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

BackNext

Takes you to the next playlist item.

ActionAction
  • 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 [macOS]) [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 to Clipboard as Wotja Box Album (Box/Playlist file only): This is for when you want to embed your Box in a webpage as a Wotja URL.
  • Save Wotja Box to File (Box/Playlist file only): 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.
BackSettings

Takes you to the Settings screen.

Add Item Add Item

Tap to add a file to your Box or Playlist.

  • New Random Mix (Box file only): Tap to add a new Random mix to your album.
  • Browse Mixes: Browse the Wotja folder to add a Mix or Saved Mix to your Box.
Box Icon/Box Background Image Box Icon/Box Background Image

Tap for a menu with the following options:

  • Show: Show or hide the icon in the Box thumbnail.
  • Change - Browse: Browse for an image to use as the thumbnail for the 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 Box.
  • Clear: Clears any icon or background image being used as the thumbnail.
Sequential Play Sequential Play / Random Play

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

Box/Playlist/Album NameBox/Playlist/Album Name

Just below the top toolbar there is a short status bar. If you have an active Sleep Timer then to the left of this is an area that shows the time remaining before Wotja will stop playing. If there is no Sleep Timer active this area just show the name of the Box.

Tap the Sleep Timer button in the top toolbar to go to the Settings Screen where you can configure the Sleep Timer. Note that once you have changed the Sleep Timer you need to stop/start the mix for the new sleep timer settings to be used and shown here.

File NameFile Name

Just below the top toolbar there is a short status bar. The name of the currently selected File is shown in the middle of this status bar.

File Play IndicatorFile Play Time

Just below the top toolbar there is a short status bar. To the right of it is displayed the Play Time remaining for the current file.

This value can only be adjusted in Mix Overrides (Box file only).

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

Mix Thumbnail Mix Thumbnail

Tap the mix thumbnail to go to Play Screen display (see below).

List ItemList Item

The top line is the file name.

The center line displays "Playing" when the file is playing and the list item will be a light blue colour.

The bottom line displays the minimum and maximum values for Mix Duration. These values are set in the mix file but can be overridden in Mix Overrides (Box file only).

Tap the central area (not the thumbnail) to play or stop the file without going into full screen.

Mix Overrides buttonMix Overrides

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

  • Mix Overrides (Box file only): See the Mix Overrides screen below.
  • 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.
Mix Overrides ScreenMix Overrides Screen
(click image for large)

The Mix Override settings (Box file only) override any related settings that may be in the File in the Box (these File related Playlist settings are set in the Cell Rules panel in the Mix 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.
FullscreenPlay screenPlay Screen
(click image for large)

Play Screen display (as opposed to Full Screen which is different, see the Action menu) is for 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 Play Screen display a faint white toolbar appears at the top to help you see the controls.

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

Play: TV Player

Wotja TV Player

TV Player
Click image for large


Wotja TV Player Settings menu

TV Player Settings menu
Click image for large

The Wotja TV Player is a simple 'player' app that, once installed on your TV (Apple TV, Fire TV or Android TV), is launched from the relevant Wotja app icon on your TV.

It operates in 'Flow Mode' 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 Scheme (these are not editable in the TV Player).
UI Item Description
Play/Stop

Use the play/stop buttons on your TV remote control play/stop music being generated by the Wotja app.

SettingsSettings

Select this button to display the Settings menu.

NextNext

Select this button to force another mix to be generated.

Indicator PanelIndicator Panel

The Indicator panel shows 4 things (from left to right):

  • Sleep Timer Icon: The icon shows whether the sleep timer is on (it is a solid shape) or off (it is an outline shape).
  • Total Play time remaining: If a Sleep Timer has been set this will reflect that time, otherwise this will be an infinity symbol in the 'Pro 20' version or be a maximum of 10 mins in the free version.
  • Mix Play time remaining: Shows how long the current mix has left to play before either repeating ('Repeat') or a new mix being generated ('Continuum').
  • Repeat or Continuum: Icon shows whether the current mix is to repeat or a new mix is to be generated at the end of the mix play time.
Settings: Flow Randomization SchemeSettings: Flow Randomization Scheme

Settings: Select this button to display a list of available 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 menu.

Settings: Sleep TimerSettings: Sleep Timer

Settings: Select this button 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.

Settings: Continuum/RepeatSetting: Continuum/Repeat

Settings: Select this button 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 Scheme) 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.

Settings: Display TextSettings: Display Text

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

Version numberVersion number

The app version number is shown at the bottom of the Settings menu.

Display TextDisplay Text

Text may show here, according to the selected Randomization Scheme.

Background Background

The background shown depends on the selected Randomization Scheme.

NextWatermark

Shown at the bottom of the screen, there are different Wotja watermarks for the Wotja (free) and Wotja Pro 20 apps.

Play: Watch Player

Watch Player - Flow

Watch Player - Flow
Click image for large


Watch Player - Box/Album

Watch Player - Box/Album
Click image for large


Watch Player - Playlist

Watch Player - Playlist
Click image for large


Watch Player - Mix

Watch Player - Mix
Click image for large

The Watch Player is a Wotja companion app for Apple Watch. It controls playback of Wotja on an iPhone and requires that the revelant version of Wotja is installed on your iPhone.

To use it, first load Wotja on your iPhone. If you then press the Play button on the watch app it will by default start Flow mode playing in the Wotja app for iPhone. You can use the Next button 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).

It has a simple interface with the following on screen controls/display areas:

  • App Name and Time: This will be either Wotja or Wotja Pro 20 and the current time of day
  • Play/Stop button (left): Tap this to start or stop play of Wotja on your iPhone.
  • Next button (right): 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.
  • File Type Icon: The icon displayed (Flow, Box, Playlist or Mix) depends on whether Wotja for iPhone in in Flow mode, or has a box/album, playlist or mix file open. Depending on what that is the text next to this icon displays as follows:
    • Flow: Flow
    • Box/Album: Number of mixes in the box/album and the name of the box/album
    • Playlist: Number of mixes in the playlist and the name of the playlist
    • Mix: Name of the playing mix
  • Music Icon: 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
  • Text area: 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.

Play: Mix Player

Mix Player

MIx Player
Click image for large

The Mix Player is entered by opening a .wotja file from the Documents screen.

It can be used to play individual .wotja mix files, but it also contains all the Wotja editors as well, detailed in the Create section of the User Guide and that follows this.

If you just want to open and play a mix file, then all you need to know about is the bottom tab bar, and in particular just the Play/Stop and Display buttons.

Bottom Tab Bar

Tabs

Play/Stop button

Found in the center of the Bottom Tab Bar, this is used to play/stop a mix.

Play Time Indicator

This is displayed below the Play/Stop button and 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 10 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.

Display button

Tap the Display button for Display Mode where you can play the mix Full Screen (Action > Display Full Screen).

Editing Modes: Overview

Music Mode

Music Editing Mode
Click image for large

Text Mode

Text Editing Mode
Click image for large

Display Mode

Display Editing Mode
Click image for large

Mix Player > Editing Modes

Editable Wotja "mix" files (.wotja files) are at the heart of Wotja and they are created in the Documents screen from various options in the Add New button/menu.

What happens in the mix creation process is that editable Wotja 'Templates' are added to 'Cells'. The Templates (built-in or user created) contain various generative music parameters (IME), sound & fx network configurations (ISE) etc. The only things they do not contain related to the music aspect of a mix are any locally referenced items, e.g. .zip, .sf2, .wav, .ogg and .midi files or images.

The Mix Player (above) can be used to play them but for those who wish to edit the settings in them it also has 3 different 'Editing Modes'. Access to these, and a mix 'Recording Mode', is via the tabs in the Bottom Tab Bar.

Bottom Tab Bar

Tabs

Music

  • The editing mode where you "design" your wotja, meaning accessing parameters for the Intermorphic Music Engine (IME) and Intermorphic Synth Engine (ISE) to define how the music is generated and what sounds are used, selecting TTM (text), mixing Generators and templates, and setting cell rules for arrangement.

  • Note: Displayed via the top toolbar segment control, the Mix mode features 5 different right hand panel views of data (two of the panels are accessed by one of the segments). Each of these provides access to different controls that let you set up much of how your wotja works.

Text

  • The editing mode where you can edit text and you have access to a powerful cut-up text editor to stimulate ideas for creative writing.

Play/Stop button

  • Tap to stop or start your the generative mix (if any) in your wotja. There is an indicator beneath the button that shows how long your mix has been playing for.

Display

  • The editing mode where you decide how you want your wotja to look, this being important should you wish to share it.

Record

  • The mode where you can make recordings of your mix.

Music : Overview

Music Mode - Left Panel: One Cell

Left Panel: One Cell
Click image for large


Music Mode - Left Panel: One Column of Cells

Left Panel: One Column of Cells
Click image for large


Music Mode - Left Panel: 4 Columns of Cells

Left Panel: 4 Columns of Cells
Click image for large

Editing Modes > Music

The Music Editing Mode has the most involved UI in Wotja. It is where you can edit the raft of available parameters available to you and where you can mix your generative music creation.

Menu

At the top of the screen is displayed a Menu bar which is the same whatever the right panel is selected to show (see below for full details).

Top Toolbar

The Top Toolbar is shown just under the Menu bar. It is also the same whatever the right panel is selected to show (see below for full details).

Below the Top Toolbar the screen is divided into a left panel displaying Cells and Track Controls, and a right panel with 5 different parameter editing displays (see the sections that follow:

Left Panel - Cells

To the left of the screen are shown the mix Cells. See the Left panel section of the table below for detailed information on what is displayed in the Cells.

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

Right Panel - Parameter Editors

Toolbar Panel View

Use the top toolbar 5 way segment control to access editors for the following: Generator Network, Cell Mixer, Track Mixer, Cell Rules and Mix Rules.

UI Item Description
Menu
Save/Back to Documents

Save / Back to Documents

Displays the Save Changes popup (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.
Randomize buttonRandomize Mix
  • 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.
ActionAction
  • 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".
  • 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.
SettingsSettings

Takes you to the Wotja Settings screen.

Top Toolbar
TTMColumn Lock

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 single column view, the column number shown at the top is that of the selected Cell.

Toolbox
Toolbox

Tap the Toolbox button to pop up a menu where you can select from a number of useful actions. The button will take on a fuschia colour when you have selected a sticky action. Tap the button again to turn off sticky behaviour.

  • Copy/Paste (sticky): Copies the currently selected Cell and pastes into the Cell(s) you next tap. The Toolbox button shows as green (to show sticky behaviour). Tap the button again to turn off sticky behaviour.
  • Move: Moves the contents of the currently selected Cell to replace the contents of the next Cell you tap. Use with caution as there is no pop-up warning.
  • Clear (sticky): Tap any Cell to clear out the contents. The Toolbox button shows as a fuschia colour (to show sticky behaviour). Tap the button again to turn off sticky behaviour.
  • Import from Clipboard: Tap to import into an empty Cell what is on the clipboard (i.e. a [.noatikl] file/template) into the currently selected cell. NB: Wotja files cannot be imported to a cell.
  • Merge from Clipboard: Tap to merge what is on the clipboard (i.e. a [.noatikl] file/template) into the currently selected Cell. NB: Wotja files cannot be merged to a cell.
  • Replace from Clipboard: Tap to replace the contents of the Cell with what is on the clipboard (i.e. a [.noatikl] file/template) NB: Wotja files cannot be imported into a cell.
  • Export to Clipboard: Tap to export the contents of a generative cell (i.e. a [.noatikl] file/template) to the clipboard.
  • 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 (shown at the top of the left hand Pak list).
  • Clear ALL cells: Clears out the contents and arrangement settings for ALL Cells.
Generator NetworkGenerator Network

Generator Network: For a selected Cell that contains generative content this right hand panel shows the Cell's Generator Network. Tap on the buttons in the network to have quick access to the relevant Generator parameters for the Intermorphic Music Engine (IME), right through to accessing the Intermorphic Synth Engine (ISE) to carry out any sound design you wish to do.

Cell MixerCell Mixer

Cell Mixer: For a selected Cell that contains generative content, this right hand panel shows sliders for mixing its Generator volume and pan levels.

Track MixerTrack Mixer

Track Mixer: This right hand panel shows sliders for mixing the track volume and pan levels.

Cell RulesCell Rules Cell Rules: Right hand panel shows the paramater values for the selected Cell that determine things such as how long it will play for.
TTMMix Rules Mix Rules: Right hand panel shows a list of parameters that affect the the entire mix. See the Mix Rules Panel.
Left Panel - Cells
CellCell

Cells are at the heart of Wotja. You can use a Mix Mode Action Menu "Display" option to toggle the left hand Cell display to show either 1 Cell, a Column of Cells or 4 columns of Cells. There are 3 areas/parts of cell, see below.

Selected CellSelected

TTMGenerative

Selected CellAudio Loop

Selected CellMIDI File

Selected Cell: When a Cell is selected the border of the cell takes on an orange colour and the top or bottom of the cell takes on a light blue background colour that marries up to the right side panel that has been selected to display.

The top of a Cell also displays an icon depending on the kind of content in it:

  • Generative: Wotja Template icon
  • Audio Loop: Grey waveform icon
  • MIDI file: Black notes icon
  • No content: Blank
Cell Status:
TTMPlaying

TTMLooping

TTMPlay Empty

The middle of a Cell displays the Cell Status band and within that is the name of the file in the Cell. The 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
Cell Values:
PlayingPlaying

InfiniteInfinite

MissingMissing Content (Red Cell)

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 ).
Left Panel - Track Controls
Track FXTrack FX

Default - None:

Tap this button to go into the ISE Network Editor where you can add Track FX.

Track Rules:
Track Rule SequenceSequence

Track Rule One ShotFXOne Shot

Track FXLoop

Default - Sequence:

Sequence: 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 Loop toggle in this panel. Turn off looping the same way. Tip: When using the Toolbox menu "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 (∞).

SoloTrack Solo Button

Tap to solo the related Track. Gold tint means soloed, grey means not soloed.

This button is in the Track Control grouping to the left of the sliders.

Track MuteTrack Mute Button

Tap to mute the related Track. Dark grey means muted, light grey means not muted.

Note: When a track is soloed the M in non-soloed or non-muted buttons shows white to indicate they are temporarily muted.

This button is in the Track Control grouping to the left of the sliders.

Music : Generator Network

Music Mode - Network Panel with IME Edit Panel

Generator Network Panel with IME Edit panel
Click image for large

Editing Modes > Music > Right Panel > Generator Network

The "Generator Network" panel is where you can marry IME Generators (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 the top Generator button for quick access to the IME Generator parameter editors. Go to the Cell Rules panel 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.

For full information on the Intermorphic Music Engine (IME) Generator parameters refer to the IME User Guide.

For full information on the Intermorphic Sounds Engine (ISE) parameters refer to the ISE User Guide.

UI Item Description
Generator Network 'Menu' buttonMenu button

Tip: See last item in the pop-up menu (below) for IME Generator Edit panel show/hide option.

Generator Network 'Menu' button: - 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.
  • Mute: Mute the Generator.
  • Solo: Solo the Generator.
  • Delete: Delete the Generator.
  • Rename: Rename the Generator.
  • Show/Hide Generator Editor Panel:

      (Default: On) 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.

Cell FXCell FX

Cell FX: Tap set the cell level FX button in the ISE FX editor.

Note that this applies an FX Network to the WHOLE of the Content Cell.

GeneratorGenerator button

Generator (AKA "Voice" in terms of Scripting): Tap/hold on a Generator button (and/or right click in Desktop version) to get a Generator Action pop-up menu (see the Menu above).

Note: To Paste a Generator (once copied) you must tap an existing Generator and then select Paste.

MIDI ChannelMIDI channel

MIDI Channel: The Generator "IME Patch" parameter (see Generator Editor) defines which MIDI Patch command to send for each MIDI channel.

The MIDI channel box is an indicator and not a button. However, you can tap/hold a Generator button and drag it to a MIDI channel box.

In general, you should only hook-up multiple Generator to the same MIDI channel if they all share the same Patch parameter.

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

Synth buttonSynth button

Synth: 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 defined by the associated Synth button, which by default will use ISE's built-in MIDI Wavetable synth (using the Patch defined by the Generator's Patch parameter). If you want to use a custom sound, click the Synth button to invoke the ISE Synth editor.

Generator FX buttonGenerator FX button

Generator FX: 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 this FX button to invoke the ISE FX editor.

Music : Cell Mixer

Mix - Cell Mixer Panel

Cell Mixer Panel (Mix tab)
Click image for large

Editing Modes > Music > Right Panel > Cell Mixer

The "Cell Mixer" panel is where you can easily change the volume and pan balance of the Generators used within the cell.

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

Tap on a slider to change the volume or pan.

Tap the Mute or Solo button to mute or solo the Generator. These buttons do not at present change colour like those in the Track Mix panel.

UI Item Description
Cell Mix Panel
TTMGenerator button Tap to take you to the Generator in the Generator Edit screen so that you can edit its composition parameters.
TTMVolume Slider

Tap to change the volume for the related Generator.

Tip: This slider changes the volume value for the MIDI channel that this Generator is on. You may have multiple Generators all on one MIDI channel. In that instance, try changing the Generator's Velocity parameters instead.

TTMPan Slider

Tap to change the pan position for the related Generator.

Tip: This slider changes the pan value for the MIDI channel that this Generator is on. You may have multiple Generators all on one MIDI channel.

TTMGenerator Mute/Solo Buttons

Tap to mute or solo the related Generator.

Tip: The Generator button will turn light grey when it is muted. These buttons do not at present change colour like those in the Track Mix panel.

Music : Track Mixer

Mix - Track Mix Panel

Track Mixer Panel (Mix tab)
Click image for large

Editing Modes > Music > Right Panel > Track Mixer

The "Track Mixer" panel is where you can easily change the volume and pan balance of each of the tracks used in the mix.

Tip: To mix the internals of a cell use the Generator Mix panel.

Tap on a slider to change the volume or pan.

Tap the Mute or Solo button to mute or solo the Generator. These buttons change colour to indicate their status.

UI Item Description
Track Mix Panel
Volume SliderVolume Slider

Tap to change the volume for the related Track.

Pan SliderPan Slider

Tap to change the pan position for the related Track.

TTMTrack Mute/Solo Buttons

Tap to mute or solo the related Track.

Music : Cell Rules

Mix - Cell Rules Panel

Cell & Mix Rules Panel (Mix tab)
Click image for large

Editing Modes > Music > Right Panel > Cell Rules

The "Cell Rules" 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 Tempo, Root, Ramp Up/Down as well as Playlist Duration settings) see the Mix Rules panel.

Wotja Template Tip: When exporting a piece for use as a Template, it is best to use a maximum piece length (32,000 seconds).

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.

UI Item Description
Cell Rules
Cell Repeats

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

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

Loop (Toggle)

Default - 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 Offset: Mix Root + Semitones

Default - Template Root: Choose the Root you want to apply to the Cell. Its value is a Semitone offset from the Mix Root.

Meter

Default - 4:4: Choose the meter you want to apply to the Cell. Each cell can have a different meter.

Generative Cell
Gen Bars

Default: ∞ [0 - 1000] - The minimum number of bars for which a cell will play generative content. 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.

This value is the first of a pair of numbers shown in blue 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.

Gen Bars Range Default: 0 [0 - 1000] - 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

Default - ON: This determines if Wotja needs to take the notes played by this Cell into account when composing/playing other Cells.

Harmonize with Others

Default - ON: This determines if Wotja needs to take the notes played by other Cells into account when composing/playing notes for this Cell.

Generative Piece Rules
Scale Rules

Default - Default 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 Level 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. For information on Piece Level rules refer to IME Piece Rules.

Harmony Rules

Default - Default 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 Piece 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 refer to IME Rule Object. For information on Piece Level rules refer to IME Piece Rules.

Next Note Rules

Default - Default 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 Piece Level 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. For information on Piece Level rules refer to IME Piece Rules.

Track Rule
Sequence/One Shot/Loop

Default - Sequence:

Sequence: 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 LoopToolbox menu "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 (∞).

Piece Script
Script

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

Cell Info
Template Title

Displays the Title of the Template used in the Cell. For information on Template Title refer to IME File.

Template Author

Displays the Author of theTemplate, if it is defined. For information on Template Author refer to IME File.

Template Notes

Displays any Notes in the Notes field the Template, if defined. For information on Template Notes refer to IME File.

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.

Music : RHS - Mix Rules

Mix - Rules Panel

Cell & Mix Rules Panel (Mix tab)
Click image for large

Editing Modes > Music > Right Panel > Mix Rules

The "Mix Rules" panel is where you can easily set the parameters that define how a Mix will play (Mix FX, Root, Tempo and Mix Ramp Up/Down) 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.

UI Item Description
Mix FX
Mix FX:

Tap the FX button to go the the ISE 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 Root:

Select the root pitch you want to use for your mix (value shown on the Mix Rules button).

Note:: When creating an automatic mix or a mix from a template a random root is chosen.

Tempo:

Default - Template Tempo: Select the tempo you want to use for your mix (value shown on the Mix Rules button).

Ramp Up: Seconds

0-20: This applies when the mix starts to play (also in a Playlist).

Duration: Seconds

10-7200: 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

0-7200: 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: This applies when the mix stops playing in a Playlist.

Automatic Cut-up Change
At Mix Start

On/Off toggle (Default Off): This powerful setting allows a new mix cut-up to be created automatically on mix start.

Change After Seconds

On/Off toggle (Default Off): This powerful setting allows a new mix cut-up to be created automatically on after a certain duration, specified in the paramaters below.

Seconds Between

3-1000 (Default 60): If the Change After Seconds toggle is on, this determines the minimum time before a new cut-up is generated.

Seconds Between Range

0-1000 (Default 30): The range in value that can apply to the above time.

Use Saved Text

On/Off toggle (Default 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.

Music : Generator Editor

Generators Screen

Generator Editor Screen
Click image for large

Editing Modes > Music > Right Panel > Generator Network > Menu > Generator Editor

The Generator Editor screen is where you can fullscreen edit all the parameter values for each of the Generator in the Cell. You get to it from the Generator Network by tapping on a Generator button (or the Generator Network Menu button) and selecting Edit from the pop-up menu.

Simply select the Parameter Group on the left hand side, and then edit the parameters on the right.

For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.

Tip: If you prefer to edit Generator parameters whilst seeing the Generator Network on screen, you can display the Generator Editor in a panel below or to the right of the Generator Network (depending on display orientation) by selecting the "Show Generator Editor Panel" meny item from the Generator Network Menu.

UI Item Description
Undo/Redo

Undo or Redo your last parameter change.

Central area
Generator selectorGenerator Selector Bar

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.

Parameter ListParameter Group List

Tap the item you are interested in the left hand Parameter Group list for the right panel to scroll to that section.

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

For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.

Parameter ListSelected Parameter Group

The selected Parameter Group.

Parameter ListParameter Values Panel

The Parameter Values panel is where you change the values for parameters in the group. Swipe up / down in this panel to scroll up or down.

For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.

Music : TTM Text Editor

TTM Text Editor Panel

TTM Text Editor
Click image for large

Generator Editor > Text to Music > TTM Text

This is the screen where you can enter custom TTM text, rather than relying on a cut-up line number association.

Tip: Using the Randomise button in this screen is a quick and easy way to create some custom cut-up text!

You can use any text, and in can be in any language. In general it takes 2 characters to generate a note.

Tip: If you prefer to edit Generator parameters whilst seeing the Generator Network on screen, you can display the Generator Editor in a panel below or to the right of the Generator Network (depending on display orientation) by selecting the "Show Generator Editor Panel" meny item from the Generator Network Menu.

UI Item Description
Text Editor Text areaText Editor
(click image for large)

Where you enter your TTM text.

TTM ActionAction

    Popup Menu:

  • "Clear Text": Clears the text in the text area.
  • "Export to Clipboard": Allows you to export the TTM text e.g. randomizations you have made (there are some restrictions prior to an IAP tier being active).
  • "Import from Clipboard": Import text to be used for your TTM.
TTM Display ToggleDisplay Text? When this toggle is on and you use in a TTM Generator, your TTM text will show in full screen mode.
TTM Randomise OptionRandomise Option Tap the button for a Popup menu where you can set what happens when you press the Randomise button (dice icon to the right of this button).

    Popup Menu:

  • "Shuffle Words": Existing TTM words in this text area will be randomly shuffled.
  • "Shuffle Text": All characters in existing TTM words in this text area will be randomly shuffled.
  • "Random Words"(Default): Allows the creation of a simple cut-up derived from words in your word pool. How many words are used is governed by the TTM Min Words and TTM Max Words settings in Randomization Settings.
TTM Randomise ButtonRandomise Button

Carries out the action set in Randomise Option.

TTM NotesNotes Tells you the number of notes your text generates.

Music : Rule Editor

Rule Editor

Rule Editor
Click image for large

Generator Editor > Rules > Rule Editor

This view is where you select and (real-time) edit the Rules used in your Generator or piece - be they Scale, Harmony, Next Note or Rhythm rules.

Tip: If you prefer to edit Generator parameters whilst seeing the Generator Network on screen, you can display the Generator Editor in a panel below or to the right of the Generator Network (depending on display orientation) by selecting the "Show Generator Editor Panel" meny item from the Generator Network Menu.

UI Item Description
Top area
Parameter ListRule Element

This control lets you change the rule elements. Tap on a rule element to change its value. The composition engine accomodates all rule changes in real-time - which can be a lot of fun!

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

For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.

List area
Rules ListRules List
(click image for large)

Below the Rule Edit area is a scrollable list contains all of the defined rules. Tap a rule to select it so that you can edit it in the Rule Edit area above.

Toolbar
Rule Add Rule Edit Rule Cut Rule Copy Rule Paste Rule Delete

The toolbar contains the Add Rule button, as well as a the Edit Rule Name, Cut, Copy and Paste buttons and the Delete button.

When you select the Add Rule button you are presented with a set of included default rules. For Scale rules these may include Major, Minor, Dorian, Hypodorian, Hypolydian, Hypomixolydian, Hypophyrgian, Lydian, Mixolydian, Pentatonic, Phrygian.

Music : Pattern Editor

Pattern Editor

Pattern Editor
Click image for large

Generator Editor > Patterns > Pattern Editor

This view is where you edit all the Pattern parameters. Patterns are a little tricky to use because of limited string editing, so be aware. We suggest instead to use TTM Patterns.

Tip: If you prefer to edit Generator parameters whilst seeing the Generator Network on screen, you can display the Generator Editor in a panel below or to the right of the Generator Network (depending on display orientation) by selecting the "Show Generator Editor Panel" meny item from the Generator Network Menu.

UI Item Description
Top area
Parameter ListPattern Edit field

Tap in the field to enter a full screen editor where you can edit the IME Pattern or Sub-pattern. The IME Pattern Syntax can take a bit of getting used to and you will need to study it carefully if you want to use patterns.

Tip: In the full screen editor you can add new lines to make it easier to edit your patterns; new lines are removed automatically when you press "OK".

List area
Pattern ListPattern List

Below the Pattern Edit field is is a scrollable list contains all of the defined patterns or sub-patterns. Tap a pattern to select it so that you can edit it in the Pattern Edit field above.

Toolbar
Pattern Add Pattern Up Pattern Down Pattern Delete Pattern Preset

The toolbar contains the Add Pattern button, as well as a the Up and Down buttons to move patterns up and down, the Delete pattern button and the Presets button. Select the Presets button display a list of preset included patterns to choose from.

IMPORTANT: The pattern you select in the presets list OVERWRITES your current selected pattern.

Tip: Patterns are a way that can be used to create hidden structure in a piece. Set up a Generator to be of Generator Type Pattern, set its volume to be zero (e.g. in the Blend view), but do not mute it (or it will not count in terms of composition). Then, follow that Fixed Pattern Generator with another Generator. Set up the following Generator with Chords Strategy set to Chordal Harmony and you will never hear the pattern but it will be used as an invisible skeleton around which to compose! If you want to hear the pattern, set Follows Strategy to Semitone Shift.

Music : Envelope Editor

Envelope Editor

Envelope Editor
Click image for large

Generator Editor > Envelopes > Envelope Editor

Generator Envelopes are supported for the following parameters:

  • Volume
  • Pan
  • Velocity
  • Velocity Range
  • Velocity Change
  • Velocity Change Range

Envelopes work in the same way for all of these. This view is where you edit the Generator Envelopes.

Each envelope is a collection of up to 100 data points. A piece starts with the value at the left side of the envelope, and as it progresses, eventually ends up with the value from the far right of the envelope.

Tip: If you prefer to edit Generator parameters whilst seeing the Generator Network on screen, you can display the Generator Editor in a panel below or to the right of the Generator Network (depending on display orientation) by selecting the "Show Generator Editor Panel" meny item from the Generator Network Menu.

UI Item Description
Parameter ListEnvelope Mode

Draw: Select this if yoi want to draw direct on to the envelope with your finger to change the values.

Macro: Select this to use one of the various macro envelope editing tools.

Parameter ListEnvelope Editor
  • Draw Mode: Tap/drag to select the range using your finger...
  • Macro Mode: Select the option you want. e.g. random, curve up etc.
  • Select top Draw button to return to the normal click-to-paint mode.

Text : UI Overview

Text tab

UI Elements
(Edit & Cut-Up Screen)
Click image for large

Editing Modes > Text

The Text tab is where you generate/edit Cut-up Text or enter Text that you want to use in your mix, whether purely for display purposes or also for "Text-to-Music".

Manually entered/edited Text

See the "Edit Text" button.

Cut-up Text

See the "Create Cut-up" button.

The powerful "cut-up technique" is great for generating ideas for lyrics, poems, haiku etc as it allows you to quickly generate random word associations from a pool of words. This pool can include words from up to 5 user entered text fields ("Sources"), a user word library ("Word Library"), the customisable Wotja Word Bank ("Word Bank") and a non-editable Wotja Word Database ("Word Database").

You can lock down ("Lock") any words you want or, for just a selected word, choose one of the alternative cut-up words presented. You can use Rules ("Rules") to constrain your cut-up by lines, words and syllables.

Keep iterating until you find the interesting, inspiring or serendipitous combinations of words you are looking for. Save the the best Cut-ups ("Saved") and then use in real-world lyrics, poems, haikus, tweets etc.

For your cut-up you get to choose how many lines and how many words per line you want in it and whether you want Wotja to attempt End of Line (EOL) rhyming.

Tip: You can also also quickly generate cut-up in the TTM Text Editor.

There are 3 main segments in the display:

Text Segments
  • Sources (left): Where you input and store all the text you want to be used as a source for your cut-up. The sources are saved in the your Wotja file and you can have up to 5 of them.
  • Cut-Up & Edit (center): Where you create your cut-up Text and/or manually edit Text. All Text, word locks and associated Rules are saved in your Wotja file.
  • Saved (right): Where you can see all the cut-ups you have chosen to save. These cut-ups are saved in your Wotja file.

Important: We respect copyright and strongly encourage you to do the same. That means if you use Wotja to come up with a lyric you like, make sure that it does not infringe the copyright of any of your source material. Wotja is pretty good at creating random "cut-ups", but it is just a tool for you to use to generate ideas. It is ultimately your responsibility to make sure you are not infringing anyone elses copyright.

Text : Sources

Text Sources Screen

Sources Screen
Click image for large

Editing Modes > Text > Sources

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

It is where you input and store all the text you want to be used as a source for a cut-up. The sources are saved in the your Wotja file and you can have up to 5 of them.

Each source field is plain text only and you can type the data in directly, or paste-in some text from the clipboard.

macOS: There are also various other options you can use, which are on a pop-up menu that you can get at either by either right clicking or control clicking.

The Sources text boxes are all editable, which means you can move words around by cutting and pasting, or even edit or manually add in new words.

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

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

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

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

UI Item Description / Menu Items
ActionAction

Popup Action menu.

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

This text area displays your source. It supports standard iOS text copy/paste etc controls.

There is no formatting of text in a source.

Wotja for macOS:

In Wotja for macOS you can access a pop-up context sensitive menu by either right clicking (Windows) or right clicking/control clicking on one of the text fields in the Sources area, or a word in this area.

Right/Ctrl click on a word

NB: You can click on a word, or, specifically in respect of the search option, select (highlight) single or multiple words.

  • Thesaurus: Searches for the selected word via an online thesaurus engine.
  • Dictionary: Searches for the selected word via an online dictionary engine.
  • Search: Searches for the selected word via an online search engine.
  • Look Up: Loads the integral macOS dictionary your selected word.
  • Share: Displays the list of standard macOS options that are available for sharing.
  • Rhyme: Searches for words (via Rhymebox.com) that rhyme with the selected word. The menu options are:
    • Normal
    • Phonetic
    • Consonants
    • German
      • Normal
      • Phonetic
      • Consonants
  • Edit...: Displays the list of standard macOS options for copy/paste etc.
  • Services...: Displays the list of standard macOS options for copy/paste etc.

Click on the background

  • This presents a slightly different pop-up menu, similar to that from "Edit..." above.
BackgroundPage Control

Either tap a dot or swipe the screen left or right to move between sources.

Text : Cut-Up & Edit

Cut-Up & Edit

Cut-Up & Edit Screen
Click image for large

Editing Modes > Text > Cut-Up & Edit

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

It is where you can create a "Cut-up" Text via the "Create Cut-up" button on the bottom right as well as edit your Text (via the Edit Text button). The Text or created Cut-up, word locks and associated Rules are saved in your Wotja file.

Tapping a word will lock/unlock a word (a locked word is shown in blue and will not be changed when you press the "Create Cut-up" button).

UI Item Description / Menu Items
ActionsActions

Popup Action menu.

  • Lock All: Locks all words in the Text.
  • Unlock All: Unlocks all words in the Text.
  • Save Text / Save Text (x/y):
    • Save Text: Displayed if your Saved Text list is empty; Select this to save your Text to the Saved Text list.
    • Save Text (x/y): Displayed if you are editing Text (x) from the Saved Text list of (y) items; Select this to replace that Text with your amended Text. Example: Say you have 3 sections of Saved Text and you are editing the second one. The menu item will then display Save Text (2/3).
  • Append New / Append to Saved:
    • Append New: Displayed if there are no Saved Text sections; Select this to save your Text as the first Saved Text section.
    • Append to Saved: Shown when you have already some Saved Text sections; Select this to appended your Text as a new Text section at the end of the Saved Text list.
  • Export Text to Clipboard: Exports the Cut-up to the clipboard.
  • Import Text from Clipboard: Imports a Cut-up from the clipboard.
  • 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.
EditEdit Text

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

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

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

Rules Rules

This top left button shows you the rule being used to create your Cut-ups. If the rule has a title you will see it here, otherwise you will see the rule syntax.

Tap on the Rules button to go to the Rules List where you can select a rule.

EOL EOL (End of Line) toggle

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

EOL Character Count

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

TextText Area

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

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

Background Word Alternatives Bar

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

Library Button Library Button

Library ScreenLibrary Screen
(click image for large)

Wotja Word BankWotja Word Bank
(click image for large)

Located to the left of the Blend slider, tap this to view the User Word Library which where you can add your own favourite words ("spices") that you can mix with words from your sources. In the User Library click the Show button to view the Wotja Word Bank (containing over 650 selected words). Both are editable/customisable and operate as standard text fields.

The User Word Library and Wotja Word Bank are both stored outside of the Wotja file, so these words are available to use in cut-ups for any file.

Blend slider Blend Slider

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

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

Cut-Up Mode selector Cut-Up Mode Selector

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

Word Lock: In this classic mode, words can be locked, and the non-locked words are changed using the active rule (including syllables), and are sourced from Sources text, User Library and any Word Bank data you might have defined. This mode is very useful for fine-tuning a cut-up.

Sources Only: This new cut-up mode analyses the structure of the Sources text and lets you create cut-up with a more natural feel; in this mode the cut-up is created from Sources ONLY and it uses the active rule (ignoring syllables) but EOL rhyming and word locks are ignored.

BackgroundCreate Cut-up Button

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

Rules List
Rules ListRules List
(click image for large)

In the Rules List you will see the available Rules and can select the rule you want to have used for your cut-up.

If there isn't one there you want to use then you can easily create and use any rule you want - see the Rule Editor.

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

Edit:

  • Delete a rule: Tap the left had red icon to delete a saved cut-up.
  • Re-arrange Rule list: Select the right hand list icon and drag it up or down.

Actions:

  • Export to Clipboard: Select to export all rules to the clipboard.
  • Import from Clipboard: Select to import rules that are on the clipboard. Wotja ensures there are no duplicates.
  • Prune: Remove all rules from the list that are not actually used in this Wotja file.
  • Use Default Rules: Replace all the rules in your Wotja file with the default rules (use carefully!).

Rule List item:

  • Rule: Tap to use it for your cut-up.
  • Cogs icon: Tap to take you to the Rule Editor.
Rule Editor
Rules ListRule Editor
(click image for large)

The Rule Editor provides an easy, graphical way to create rules.

If there isn't a rule you want to use in the Rules List, or you want to edit it, then you can do that easily. There are 3 ways to edit or create Rules. Either:

  • A) Use the Rules Editor, or;
  • B) Create a rule in a text editor and copy it (e.g. 3 5 6 6) and then paste it into the Rules field (or, from the top right Rules Action button in the in the Rules List select "Import All from Clipboard" to import it) or;
  • C) In the Create screen, tap the top right Edit button and type into the textarea any old text for the kind of rule you want (where any single letter counts as a word, you do not have to type full words), e.g.:
      A A A A A 
    A A
    A A A
    			  
    would be a "5 2 3" rule.

Editor Controls:

  • Edit button (top right):
    • Delete rule: - Tap the left hand red icon to delete the rule.
    • Re-arrange rules: - Select the right hand list icon and drag it up or down.
  • Rules Field: This is editable.
  • Title Field: This is editable.
  • Line Summary: This displays the word and syllable count for the line. Tap the line to expand it so you can use the sliders to change the rule values.
  • Slider controls:
    • Words Minimum: The minimum number of words in the line of cut-up.
    • Words Maximum: The maximum number of words in the line of cut-up.
    • Syllables Minimum: The minimum number of syllables in the line of cut-up.
    • Syllables Maximum: The maximum number of words in the line of cut-up.
Rule Syntax

The most basic Rule consists of a series of numbers. Each number stands for the number of words to put in a particular line of the cut-up. For example, the numbers "3 4 5 6" would represent four lines of cut-up as there are four numbers. The first line would have three words, the second would have four words, the third would have five words, and the fourth would have six words.

There is a lot more you can do if you want to, and it then helps to understand the Rule syntax.

Line Rule Syntax

Tip: Items in [ ] are optional.

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

Composite Syntax
LineRule1 LineRule2 LineRule1 [title:"Name"]

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

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

Text : Saved

Saved Text Screen

Saved Screen
Click image for large

Editing Modes > Text > Saved

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

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

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

UI Item Description / Menu Items
ActionAction

Popup Action menu.

  • Edit: Copy the selected Saved Text Section to the "Cut-Up & Edit" screen for editing.
  • Up/Down: Use these buttons to change the order of Saved Text Sections.
  • Delete: Delete the selected Saved Text Section.
  • Cut-ups to Clipboard: Copy all Saved Text Sections to the Clipboard.
Edit menuEdit

Edit: Copy the selected Saved Text Section to the main Edit & Cut-up screen for editing.

Display

Display Tab

Display Tab
Click image for large

Editing Modes > Display

The Display Tab (also referred to as Display Screen) is where you access the screens that let you set up how your wotja looks, i.e. for Fullscreen display when someone loads it in a box.

UI Item Description / Menu Items
FilesDocuments

Back to Documents screen.

ActionAction

Popup Action menu.

  • Full Screen [mobile] / Full Window [desktop]: Displays Wotja full screen on your device and the mix (if playing) continues to play. At any time tap the screen to leave full screen display and return to Display mode.
  • Full Screen & Restart/Stop [mobile] / Full Window & Restart/Stop (various sizes [macOS]) [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.
TextText

Displays a pop-up menu where you can select:

  • Show Text from Cut-Up [Default]: The icon thumbnail in Files screen and that exported for a tweet shows this text overlaying the image.
  • Show Text from TTM Generators: The icon thumbnail in Files screen and that exported for a tweet shows this text overlaying the image. Tip: To prevent TTM text displaying, in the TTM Text Edit screen set the "Display?" toggle to off.
  • Text Hide: When selected then no text is shown in the Thumbnail - this can be quite nice!
  • Change Text Colour: Goes to a screen where you can set the text colour via RGB sliders or a HSB colour wheel.
BackgroundBackground

Go to a screen where you can set the background colour via RGB sliders or a HSB colour wheel.

BackgroundPicture
  • Browse: Mobile: Goes to the Photos app on your device where you can select a picture to use as a background image to your wotja. Desktop: Select an image using Finder/Explorer.
  • Random: Creates a random icon/thumbnail to use for the mix as according to the "Random > Albums > Icon Palette and Icon Graphic" settings.
  • Clear: Removes any icon or picture icon associated with the mix so you can use the Background colour setting.

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

Recording Mode

Mix Recordings Screen

Recordings Screen (Mix tab)
Click image for large

Editing Modes > Record

This screen is where you can create and preview recordings: WAV (as per Wotja Audio Output System Setting [hardware dependent]), MIDI and Video (iOS, macOS only).

These recordings are all saved to the "Wotja Folder", the location of which depends on the OS and/or whether iCloud is enabled for Wotja.

MIDI Recording Note: MIDI file recordings are saved as Type 1 files. The "MIDI File Track Grouping" option in Settings determines how MIDI is saved. Basically, it allows you to group MIDI File recordings into Tracks by Wotja Track or by MIDI Channel ( default) and where each MIDI File Track is labelled by Wotja Track Number or MIDI Channel Number as appropriate.

Video Recording Note: When making a Video recording Wotja creates an audio recording (that you will find in the Audio segment when you next look there) and creates a video based on that recording, using the current "Display Mode" settings to provide a still image for use in the video.

Tip: For audio/video recordings you can set the music Ramp in and Ramp down times (from 0 - 20 seconds) in the Mix section of the Cell & Mix Rules panel.

Tip: Use the following apps to locate and then export/share a mixdown recording:

  • iOS: iCloud enabled - Use the Apple Files app (See also this FAQ)
  • iOS: iCloud not enabled - From the Wotja Mixdown & Recordings screen > Actions button > Open With... and try sharing via the options presented there; alternatively use App File Sharing (See also this FAQ)
  • macOS: Finder
  • Windows: Explorer
  • Android: Files app (or other File Manager app); Once you have selected the file(s) you want to export/share (e.g. recordings), use the Share Menu in the Files app to do what you want (alternatively use USB to copy files off your device)

Usage:

  • Set recording length: Using the top Record Bars slider control you can set the number of bars you want to record (up to 100 bars maximum by default, but extendable via the Max Bars slider control in the mix segment of Settings).
  • Start the mixdown: Tap the left "Record" bottom in the bottom toolbar.
  • Recording progress: The title bar will show the recording progress (e.g. 34% - 1.75 Mb) and you will see a % Recording progress popup in the middle of the screen (e.g 35%).
  • Recording complete: The popup will disappear and you will see your recording show up in the list below (if you are using iCloud it might take some time depending on how long your recording is).
  • Preview recording: Audio/MIDI recording: Tap it to start and stop it playing (but there is no visual indication), or use the right side tools button and select Open With; Video recording: Tap it or tap the right side Action button (tools icon) and select Open With.
Notes:

Recordings you make are saved to the Wotja iCloud folder or Wotja folder depending on the "Use iCloud" setting (iOS > Settings > Wotja > Use iCloud).

Mixdown recordings are not live recordings and they are made as fast as your device allows. To be made they require sufficient device memory to be available.

When a recording is made it is held in memory before iOS flushes it to the file system.

Bytes per second = 48000 x 2 x 2 =192,000. 100 bars of 4:4 at 60 bpm is 400 seconds of recording (just over 6 minutes). In terms of bytes this is 192000 * 400 = 77 MB. At 30 bpm, that is 154 MB.

For every 100 MB recording, you need to have space in the file system. 10 recordings will be 1 GB.

If you're using iCloud, e.g. 10 files totalling 1 GB, remember that those files are synced with the cloud.

UI Item Description
FilesDocuments

Back to Documents screen.

Recording status indicatorScreen Title

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

Audio/MIDI selectorAudio/MIDI/Video selector (Video is iOS, macOS only)

Tap to select which file type you want to record do. The supported mixdown recording formats are:

  • 48Khz/44Khz (hardware dependent) Stereo WAV file, or;
  • Type 1 MIDI file; or
  • .mv4 (newer devices) or .mov (older devices) file
Bars selectorBars selector

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

You can increase the default value in Settings > Mix.

Item selectorRecording

Audio iconAudio file

MIDI iconMIDI file
Video iconVideo file

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

Tap an audio or MIDI recording to preview it. When it is playing the item selector will have a light green tint.

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

Tapping a video recording shows the Actions popup (or use the right side Action button "Tools" icon for it) and select Open With.

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

ActionActions

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

  • Show in Finder/Explorer (Desktop):
    Opens a window with the file selected.
  • Open With... (iOS only):
    Opens an action sheet where you can choose how to export/share your recording to e.g. to iCloud Drive, Facebook, Dropbox etc. depending on what you have installed. See also this FAQ.
  • Delete (Wotja iOS only):
    In Wotja this is how you delete your recording.
  • Preview (iOS/macOS Video segment only):
    This allows you to preview your video.
  • Create Video (iOS/macOS Audio segment only):
    Wotja will create a video from your selected recording, using the current "Display Mode" settings to provide a still image for use in the video, and present it in the Video segment. This approach allows you to take a "finessed" recording of your generative mix, and create videos from it at your leisure.
  • Recording buttonRecord button

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

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

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

    Recording ProgressRecording Progress

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

    Templates

    Templates Screen

    Templates Screen
    Click image for large

    Mix Player > Music > Cell >Templates (tap)

    Alt: Settings > Randomization > Templates

    All mixes comprise a number of Content Cells, and for a Content Cell to play it must have in it either a Template, Audio file or MIDI file.

    Templates are therefore right at the heart of Wotja.

    Basically, a Template is a self contained "generative music and sound preset". It can vary from including a single Generator to very complex complex network of Generators, each with their own ISE Sound & FX networks.

    Once a Template is added to a Content Cell you can edit/customize any of its settings, but you do not have to - they sound great as they are!

    Wotja includes hundreds of Templates, but you can also create and use your own (see "Saved Files" below, and Edit Mix Toolbox > Export to Template).

    Using randomisation techniques Wotja lets you mix Templates together to very quickly create interesting music mixes.

    Note: The Templates screen is also where you preview and select templates that you want to use in a Randomization Scheme.

    On the left of the top panel is a button that takes you back to the screen you came from. Depending on how you accessed this screen, the top right menu items will vary (see below).

    Tip: If you tap on a template or file in the left hand panel you can preview it without having to open it.

    UI Item Description / Menu Items
    Back to Settings Back to the Settings screen.
    PaksPaks
    (left list)

    The list of Paks you can select a Template from.

    Saved Files: Always shown at the top for easy accesss, this is list of generative templates that you have already created and saved (see Edit Mix Toolbox > Export to Template).

    TTM 1 Players: Templates that use Text-to-Music techniques to generate melodies.

    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?" toggle is on). The Paks that were available for Noatikl 3 and Mixtikl 7

    BP000 Paks: (Shown in dark grey, and only if "Older?" toggle is on). These include generative templates that came with Noatikl 1 and Mixtikl 1-5.

    3rd Party Paks: If you have them installed, older IM Paks (e.g. MDB or the AL Collections) are shown in dark grey, italic. Other third party paks are shown in black, italic.

    TemplatesTemplates
    (right list)

    The list of Templates in the selected Pak. Tap to preview a Template; tap again to stop the preview.

    ActionAction 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

    Settings: General

    Settings Screen

    Settings Screen - General
    Click image for large

    Documents > Settings > General

    Mix Player > Settings > General

    Playlist Player > Settings > General

    Mix Player > Settings > General

    There are 3 top segments in Settings:

    • General (this section): Where you set the Sleep timer if required, the User Interface mode (Light or Dark) and UI related settings such as text fade in/out
    • Audio MIDI+: How you want Wotja to play its sounds, how it is used with Audiobus / Inter-app Audio / Ableton Live [all iOS only], MIDI Out/In and video recording sizes etc.
    • Randomization: Where you select and configure Randomization Schemes.
    Item Description
    StoreStore

    This button is only shown in the free version. In the Subscription version it takes you to the In-App Store screen.

    InfoInfo

    This button displays a popup menu with the following information/options:

    • Version number info: The version number for this Wotja app
    • Help & Documentation: Web link to this User Guide
    • Video Tutorials: Web link to our video tutorials on Youtube
    • Give us Feedback: Web link to our contact form
    • Privacy Policy: Web link to our Privacy Policy
    • Website Terms of Service: Web link to our Terms of Service
    • End User License Agreement: Web link to our EULA
    • Display Language: A setting saved across sessions that lets you select the language used in Wotja UI:
      • System (what your device is set to)
      • English
      • Chinese (simplified)
      • Japanese
    Sleep Timer
    Sleep Timer

    (Default: Infinite) The sleep timer can take values from 1m to 8 hours mins. Use it to set how long you want to Wotja to play before fading out over the last few seconds of play time.

    Wotja will stop playing and restart whenever you change the value of the Sleep Timer, with the new Sleep Timer setting then being operational.

    When the Sleep Timer is operational the Play button in the Mix Player will shown the time counting down to show how long the mix has left to play.

    If you are running in 'Lite Mode' then Wotja will always stop playing after 10 minutes whatever the value of the timer.

    If the Sleep Timer is off then it means there is no sleep timer active. The only timer that might then be in operation is the auto-timeout in Lite Mode.

    User Interface
    Colour Scheme: Light/Dark

    (Default: Light) This where you choose whether you want the app to use a Light or Dark scheme to suit your preference. This User Guide uses the Light scheme.

    Select the Light or Dark option to change theme - it is that simple!

    Auto Play on Document Open

    (Default: Enabled) This setting simply means that when you open any file it will start to play.

    Interaction Colour for Videos: None, Red, Green, Blue

    (Default: None) This setting enables/disables a Red, Green or Blue "blob" overlay on many UI events and it is for those wanting to create videos of Wotja operation. When it is on it is easier to see what is going on, but the UI will also be a little slower to update.

    Always Show Fullscreen Top Panel

    (Default: Enabled) This setting means that when in Play Screen mode in the Flow/Box/Album Player the top toolbar panel is always visible. If the toggle is off, then the panel will autohide after a few seconds.

    Note: If you are in Full Screen display (see the Action menu in each mode) then whatever the setting of this toggle the toolbar is hidden.

    Templates: Auto-Change Patterns

    (Default: Enabled) This is a very important setting and unless you have a specific requirement we strongly recommend that you leave it enabled. When enabled it means that when creating an auto-mix or adding a Template to a mix all B/F (melodic) patterns in use by a Generator Type "Patterns" are randomized, AND, all other patterns that might be in the Template are set to <100 B 240 1>. This is a default pattern and it is a way of clearing out any "junk DNA" patterns that might be in the Template and that you might end up using inadvertently. If you disable this toggle then no melodic patterns are randomized and no other patterns are overwritten when creating an auto-mix or adding a Template to a mix - it is for a very specialist use case where you are using your own patterns.

    Auto-Pan Background Image

    (Default: Disabled) This allows auto-panning of any background image (in Mix Display tab, Mix Boxes etc.), if one has been added to the mix.

    Show Watermark

    (Default: Enabled) When enabled the stylish Wotja watermark will be overlaid at the bottom of the Display mode screen or an Full Screen mode. Disable it to prevent the watermark from displaying.

    Note: This is a Pro tier feature (see Feature Sets).

    Text Display
    Duration

    (Default: 4000ms) Sets how long (milliseconds) text will display for in the Display screen and in fullscreen in the Playlist player.

    Duration Range

    (Default: 0ms) Sets the range (milliseconds) that can be applied to Duration.

    Fade In

    (Default: 4000ms) Sets how long (milliseconds) it takes for text to fade in.

    Fade Out

    (Default: 0ms) Sets how long (milliseconds) it takes for text to fade out.

    Settings: Audio MIDI+

    Settings Screen

    Settings Screen - Audio MIDI+
    Click image for large

    Documents > Settings > Audio MIDI+

    Mix Player > Settings > Audio MIDI+

    Playlist Player > Settings > Audio MIDI+

    Mix Player > Settings > Audio MIDI+

    This segment is where you set various Audio, MIDI and Video settings.

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

    Item Description
    Audio Output
    ISE for Sounds & FX

    (Default: On) Enables ISE sounds, which all Generators use as this is the sound generator for Wotaj. Turn this to off when you want to play through an external synth(s) and you do not want to hear the ISE sounds as well. NOTE: When this is set to OFF you will not hear anything from Wotja unless you have a MIDI device connected (and you will hear sounds through that instead).

    Note: Inter-App Audio and Audiobus are on by default. To use either of these you need to route Wotja via an Inter-App Audio or Audiobus enabled app (e.g. AUM).

    IMPORTANT: For Wotja for iOS to work correctly with AUM, Audiobus etc. the Wotja Audio Sample Rate MUST have the same value as the Sample Rate in those apps.

    IMPORTANT: For Wotja for iOS to work correctly with AUM, Audiobus etc. the Audio Block Size MUST have the same value as the Buffer Size (samples) / Latency Control (frames) in those apps [different apps refer to the same thing in different ways]. We recommend that this value is 1024.

    Tip: If you getting noise in AUM, Audiobus etc. see this video.

    Audio Sample Rate

    (Default: 48 kHz or 44 kHz auto selected depending on device capabilities [iOS, macOS, Windows]; 22Khz [Android]). iOS: If you experience noise with Wotja in AudioBus, consider changing the sample rate between 48000 and 44100 Hz. If, after changing sample rate, you get occasional audio break-up, consider experimenting with the Audio Latency value, below.

    Audio Block Size (iOS, Android)

    (Default: 1024 samples [iOS]; 2048 [Android]). This setting is of particular use if you are using Wotja on an older device or are using it routed via Audiobus or Inter-App Audio - higher values minimise audio artifacts which also depend on device power and mix/sound/fx complexity. Used in conjuction with Audio Block Count.

    If you are using Wotja to drive external MIDI synths you may need to tweak the values both here and for MIDI Latency. Example: You're driving an external synth via MIDI and want to sync the audio output of that with audio output from Wotja (i.e. via the ISE sounds). Try setting the Audio Block Size and Audio Block Count to be as low as you are happy with. Then, change the MIDI Latency until the output from 3rd party synth is in sync. Many dependencies are outside control of Wotja, however.

    Audio Block Count (iOS, Android)

    (Default: 10 [iOS]; 5 [Android]). This setting is of particular use if you are using Wotja on an older device or are using it routed via Audiobus or Inter-App Audio - higher values minimise audio artifacts which also depend on device power and mix/sound/fx complexity. Is the number of Audio Blocks of size determined in Audio Block Size setting.

    If you are using Wotja to drive external MIDI synths you may need to tweak the values both here and for MIDI Latency. Example: You're driving an external synth via MIDI and want to sync the audio output of that with audio output from Wotja (i.e. via the ISE sounds). Try setting the Audio Block Size and Audio Block Count to be as low as you are happy with. Then, change the MIDI Latency until the output from 3rd party synth is in sync. Many dependencies are outside control of Wotja, however.

    MIDI Output
    Output Devices

    Wotja will send-out MIDI events to whichever device you have selected in the MIDI Output Device List of detected outputs.

    Note that 'Lite Mode' will send/receive MIDI only on Channel 1; if you want to send/receive on multiple MIDI channels then you will need to get the Pro version of Wotja (see Wotja Downloads).

    • MIDI routing on Android device
    • On Android devices we refer to Wotja MIDI Out as an experimental feature because we require it to be supported in the OS AND by the device manufacturer, but this is not always the case. We expect that most devices running Android 8+ should support MIDI Out in the OS, but some devices using Android 6+ may also support MIDI Out (e.g. some Samsung / Google devices). There seems to be no public list of such MIDI enabled Android devices but you can at least check that it works on your device in the free version of Wotja.
    • When it is supported it will let you control external MIDI devices via a suitable USB MIDI Interface (e.g. Roland UM-One mk2). If you just want to make MIDI file recordings on Android, see this FAQ.
    • Getting it working:
      • BEFORE loading Wotja, plug into your Android device your USB MIDI Interface (e.g. Roland UM-One mk2; we know this works as we have tried it); you will likely also need a Micro USB Male to USB Female OTG Adapter cable to be able do that.
      • Load the Wotja app, go into Wotja Settings, find the MIDI Output section and tap the "Output Devices" selector.
      • In the MIDI Output Devices screen that then displays, you should see your MIDI Interface in the MIDI Output Device List (e.g. Roland UM-ONE).
      • Tap the checkbox to the left to select it (you will see the checkbox show a green dot).
      • Create or load a Wotja mix and start it playing; you should see your MIDI Interface show that it is receiving MIDI notes.
      • You should then be all set!
    Virtual MIDI (iOS/macOS)

    Default: Off

    Note: Available for iOS/macOS only.

    When enabled, causes Wotja to present a number of Virtual MIDI ports - one Omni (all channels) and 16 per-channel virtual MIDI ports - and Wotja sends MIDI events as Virtual MIDI ports over Core MIDI.

    MIDI Clock

    (Default: Off) When enabled, tells Wotja to send-out MIDI Clock events over Core MIDI / Omni channel.

    • Important Note: The iOS version can emit MIDI clock but it doesn’t support MIDI transport controls.
    Send Patch Change Events

    (Default: On) When enabled, tells Wotja to send-out MIDI Patch Change Events. Turn this off if you want ONLY MIDI Note Event information to be sent.

    Send Start/Stop Events

    (Default: On) When enabled, tells Wotja to send-out Start/Stopr Events. Turn this off if you do not want them sent.

    Send Controller Events

    (Default: On) When enabled, tells Wotja to send-out MIDI Controller Events. Turn this off if you do not want them sent.

    Latency

    (Default: 100ms) Sets Latency (milliseconds) to apply to MIDI events sent-out to Core MIDI / Virtual MIDI by Wotja. Use to help remove jitter if using e.g. Network MIDI.

    Tuning Mode

    (Default: Off) Useful option for tuning external analog synths - causes all notes sent-out by Wotja to be "forced" to the specified pitch.

    Important: This setting is ALWAYS turned off when you restart Wotja.

    MIDI Input
    MIDI Input Devices button

    Notes: MIDI Input is only used by Listening Generators.

    Tap the MIDI Input Devices button to go to the MIDI Input Devices screen where you will see toggles for all MIDI Input Devices detected by Wotja.

    • Network Session (iOS/macOS):
      • Used for detecting MIDI sent via a network (e.g. from a Mac or iOS device over WiFi).
    • IAC Driver Bus (macOS) / loopMIDI port (Windows):
      • Used for detecting MIDI routed via OS system level capabilities.
    • Wotja + Tracks/Channels (iOS/macOS):
      • These allow Wotja to detect MIDI it sends out over Virtual MIDI (see below). As it is a kind of MIDI feedback it is for specialist use and unlikely you will need to use it.
    • App / MIDI Device + Channels:
      • All 3rd party MIDI emitting Apps or MIDI devices that Wotja detects (e.g. Thumbjam, MIDIKeys apps, Roland UM-ONE MIDI Interface etc.) will be shown here; toggle on the ones you want Wotja to recieve MIDI input from.
      • Note: Each of the apps have created virtual MIDI ports named after themselves (e.g. Thumbjam, MIDIKeys etc.). You'll only get their output (sent on those ports) into Wotja, if you enable those input ports. For Wotja to see these ports, however, you need to first load the app you want to generate MIDI, e.g. MIDIKeys or Thumbjam and then load Wotja.
      • Tip: When MIDI input triggers notes in Wotja then, as the audio will be playing in Wotja via the ISE, in Settings make sure "ISE for Sounds & FX" is toggled on, and you set the Audio Latency to be some low value. If that is set to 850ms (the default) then your notes will take about 1 second to play!
    MIDI Transport Control
    External Clock Sync

    Wotja's MIDI Input Transport Control / External Clock Sync features allow it to be able to sync to e.g. a DAW.

    How to use MIDI Transport Control / External Clock Sync:

    • Sequencer:
      • Configure your sequencer (e.g. Reaper/Logic, or whatever) to send Transport commands (MMC) and/or MIDI clock to a specific MIDI port
        • Note for iOS: You can route via Network MIDI
      • Make sure your piece in the sequencer is long enough; sequencers will stop sending clock events when they reach the end of their content, and they’ll also automatically emit a stop event.
    • Wotja:
      • Activate the MIDI input port/device that you have configured your sequencer to send Transport (MMC)/Clock to (in the previous step)
      • Set tick for MIDI Transport Control
      • Set tick for External Clock Sync
      • Open a Wotja mix, press Play
      • Wotja will say "MIDI: Wait" under the play/stop button rather than elapsed time, and won’t (immediately) show tempo
      • Start your sequencer playing (e.g. Reaper/Logic):
        • Wotja will now start playing
        • The Elapsed time will now display/update
        • The calculated tempo (from the sequencer’s MIDI clock) will display (rather than the internal Wotja tempo)

    NOTE: There is an oustanding issue that can be revealed if you sync to the incoming MIDI clock using a different tempo.

    Set up Ableton Link

    Support for Ableton Link is currently experimental but it should work in Wotja just like it does in other iOS app. If you find any issues then please get in touch via our Contact Form and send us detailed instructions on how to reproduce them.

    Note 1: Ableton link tempo does NOT work with Wotja boxes, albums or playlists.

    Note 2: Wotja works accurately with Integer tempos, but does not support fractional tempos.

    • Ableton Link: Toggle on to turn it on
    • In-app notifications: Toggle on to be notified when apps join or leave
    • Sync Start/Stop: Toggle on to send and listen to Start/Stop commands
    • Connected Apps: Shows how many apps are connected
    Recording
    Max Recording Seconds

    (Default: 3000) This setting lets you increase how long you can record for in Recordings screen.

    IMPORTANT: Use with care as recordings are large and your device must have sufficient free memory available. If you try to change this value take note of the pop up message warning before you change it. Also be aware that these the recordings are stored in iCloud (if you are using that), so that could hit your bandwidth.

    Max Recording Bars

    (Default: 100 bars) This setting lets you increase the number of bars you can use to make mixdown recordings in the Mixdown Recording screen.

    IMPORTANT: Use with care as recordings are large and your device must have sufficient free memory available. If you try to change this value take note of the pop up message warning before you change it. Also be aware that these the recordings are stored in iCloud (if you are using that), so that could hit your bandwidth.

    MIDI File Track Grouping

    (Default: "by MIDI Channel") This option determines how MIDI is saved in a MIDI file recording and allows you to have Wotja's MIDI output summed either by Wotja MIDI Channel (default) or by Wotja Track.

    Each MIDI track in the MIDI file recording is labelled either by MIDI Channel Number or by Wotja Track Number, as appropriate.

    Example: Wotja can have multiple Cells playing at the same time and all generating MIDI. Cell 1 could have say 9 generators each sending MIDI to a different MIDI channel (e.g. 1 to 9) and the same might be the case for Cell 2.

    • Use setting "by Wotja Track" if you want the MIDI sent from all generators in Cell 1 summed to MIDI track 1 in the MIDI file and the MIDI sent from all generators in Cell 2 summed to MIDI track 2 in the MIDI file.
    • Use setting "by MIDI Channel" if instead you want the MIDI sent on MIDI channel 1 in Cell 1 and the MIDI sent on MIDI channel 1 in Cell 2 to be summed to MIDI track 1 in the MIDI file.
    Video Recording Size (iOS/macOS)

    Options: 640x480, 960x540, 1280x720, 1920x1080 (Default: 640x480) This setting lets you set the size of the video you wish to record. The larger the size, the longer the recording will take to make.

    Tip Recordings featuring a background image do take a *long time* to create.

    Settings: Randomization

    Settings Randomization

    Settings Screen - Randomization
    Click image for large

    Documents > Settings > Audio MIDI+

    Mix Player > Settings > Audio MIDI+

    Playlist Player > Settings > Audio MIDI+

    Mix Player > Settings > Audio MIDI+

    This segment is where you select the Randomization Scheme used for Randomization as well as being able to override the values of Randomization parameters.

    Randomization parameters determine both how the mixes in Flow and Automatic albums ('Boxes') are created and whether text is displayed on screen in Flow mode and/or the Playlist Player Fullscreen mode. Randomization is also used to determine how mix Cells are populated with templates when using the Random function in Wotja, including how TTM Generator text randomisation is applied to mixes and how Cut-up is generated in the TTM Text Editor screen to mention a few.

    In Mix Editing mode the Random / Randomize function is manually available as follows:

    • Mix Mode > Menu bar Randomize button (dice icon)
    Parameter Description
    Schemes
    OpenOpen

    Opens the Scheme list.

    Selected SchemeSelected Scheme

    Shows the selected Randomization Scheme.

    SaveSave

    Displays a pop-up menu for you to save changes to the current scheme or to save as another one (create your own!).

    Templates
    Templates for Randomization Templates screen: This easy access to the templates screen means you can always easily change the pool of templates you want to randomize from.
    ISE Network/Presets
    Synth Presets

    This takes you to a screen that lets you select the pool of ISE Network presets that are available for selection and use as sounds:

    • For TTM players (only) when randomizing a mix or creating a new Random mix, Flow or Box
    • When in the ISE Network Editor and you use the randomize button

    If no presets are selected then no random selection occurs.

    FX Presets

    the pool of ISE Network presets that are available for selection and use:

    • As (top level) Mix FX when randomizing a mix
    • When in the ISE Network Editor and you use the randomize button

    If no presets are selected then no random selection occurs.

    Cut-up
    EOL Rhyme?

    Default - Off: Allows you to decide if you want to enforce End Of Line rhyming of your cut-up.

    Cut-up Rules

    Default - 2 2 2: The cut-up rule you select has a bearing on what is displayed on screen, as well as what cut-up is available for use for TTM.

    Automatic Cut-up Change
    At Mix Start

    Default - Off: Refer to Mix Rules.

    After Seconds

    Default - Off: Refer to Mix Rules.

    Seconds Between

    Default - 60: Refer to Mix Rules.

    Seconds Between Range

    Default - 30: Refer to Mix Rules.

    Automatic album (Box)/Flow
    Screensaver Palette

    Default - Random: Select from one of 35 includes palettes for the screensaver shown in the Flow Player. Where a screensaver is used in a mix file it will show in the Mix Player Display tab as well as "Fullscreen" in the Playlist Player and the its values will be used for the mix file's auto-generated thumbnail.

    Screensaver Graphic

    Default - Blobs: Select from 2 different kinds of icon graphic styles for the screensaver. The choices are: Blobs or Geometric.

    Screensaver Text

    Default - TTM: Select what text, if any, you want to display in your screensaver (and also on your mix file thumbnail). The choices are: TTM, Cut-Up or none.

    Mixes in Box

    Default - 8: The minimum number of mixes in an automatically generated Box.

    Max (Mixes in Box)

    Default - 8: The maximum number of mixes in an automatically generated Box.

    Duration

    Default - 2.5 m (150 s): The minimum time a mix is configured to play for in an automatically generated Box.

    Max (Duration)

    Default - 5 m (300 s): The maximum time a mix is configured to play for in an automatically generated Box.

    Duration Range

    Default - 0 s: The minimum duration that is added to a mix's Duration above when the Box is created.

    Max (Duration Range)

    Default - 0 s: The maximum duration that is added to a mix's Duration above when the Box is created.

    Tempo

    Default - 25 BPM: The minimum tempo of a mix.

    Max (Tempo)

    Default - 36 BPM: The maximum tempo of a mix.

    Ramp Up

    Default - 5 s: How long a mix takes to ramp up to its full volume.

    Ramp Down

    Default - 15 s: How long a mix takes to ramp down to zero volume.

    General / Mix
    TTM Cells/Column (min)

    Default - 0: The minimum number of TTM Players that will be in a column, assuming you have a TTM Pak available for selection when randomizing.

    TTM Cells/Column (max)

    Default - 1: The maximum number of TTM Players that will be in a column, assuming you have a TTM Pak available for selection when randomizing.

    TTM Words (min)

    Default - 2: The minimum number of words that will be added to a TTM Text field on creating a new random mix or in the TTM Text Editor when using the Randomize button with Randomise option selected.

    TTM Words (max)

    Default - 2: The maximum number of words that will be added to a TTM Text field on creating a new random mix or in the TTM Text Editor when using the Randomize button with Randomise option selected.

    Tracks

    Default - 3: The number of Tracks that will have their cell contents (below) randomized (starting with Track 1).

    Cells

    Default - 1: The number of Cells in the Tracks above that will have their contents repopulated from the list of available templates.

    Generative %

    Default - 100%: - The chance that a randomized will be repopulated with a generative template.

    Blank Cell %

    Default - 35%: - The chance that a randomized will be empty.

    Tempo Min

    Default - 30 bpm: - The minimum tempo of a new, random mix.

    Tempo Max

    Default - 60 bpm: - The maximum tempo of a new, random mix.

    Volume Min

    Default - 90: - The minimum volume of a track in a new, random mix.

    Volume Max

    Default - 120: - The maximum volume of a track in a new, random mix.

    Pan +/-

    Default - 30: - How far away from center that pan can be for a Track in a new, random mix.

    Cells
    Generative Bar Min

    Default: Infinite - The minimum base value for the number of bars a generative template will play for and to which the range value (below) is added. Special Value: If this value is set far left to ∞ then once play in a Track reaches such a cell the generative content in that cell will continue to play either for as long as the mix plays or until you manually select another cell in that Track to play.

    Generative Bar Max

    Default - 0: The maximum base value for the above.

    Generative Bar Range

    Default - 0: Sets the range that applies to the above base value.

    Cell Repeat Min

    Default - 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!

    Cell Repeat Max

    Default - 1: The maximum base value for the above

    Cell Repeat Range

    Default - 1: Sets the range that applies to the above base value.

    Reset
    Reset All Random Settings

    Resets all values back to their Defaults.

    Settings: iCloud

    iCloud Drive Settings Screen

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


    iCloud Settings Screen

    Wotja Use iCloud (iOS)
    Click image for large


    iCloud Settings Screen

    iCloud Drive (macOS)
    Click image for large


    iCloud Drive Settings Screen

    iCloud Drive App (Windows)
    Click image for large

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

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

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

    iOS - Set up/Use iCloud Drive:

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

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

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

    iOS - Wotja "Use iCloud" toggle:

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

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

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

    See also Apple's iCloud Help resource.

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

    Wotja iCloud Drive App screen (Windows):

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

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

    In-App Store

    Store Screen

    In-App Store Screen
    Click image for large

    The Subscription versions of Wotja (iOS/macOS only) contain an In-App Store where you can purchase an In-App Subscription. The image shows the current In-App Subscription tiers.

    Tip: When a 'Pro S' Subscription expires then the limitations in 'Lite Mode' are re-instated.

    For Apple information on managing subscriptions please refer to : https://support.apple.com/en-us/HT202039

    Note: There is no In-App Store in the paid-for Wotja Pro 20 because it does not include any auto-renewing In-App Subscriptions.

    Item Description
    BackSettings Returns you to the Settings Screen.
    RestoreRestore

    Tap this button and you will be asked if you want to check for and restore any previous purchases.

    IAP ItemIAP Item
    IAP ItemPrice
    Subscribed

    If you have purchased an In-App Subscription, and it is active, then "Subscribed" will show instead of the price.

    MiscellaneousManage Subscriptions

    The "Manage Subscriptions" button in the Miscellaneous" section takes you straight to the Wotja subscription page in the relevant Apple App Store where you can manage your subscription. See also the FAQ entry on in-app subscriptions.

    Credits

    Intermorphic is Tim Cole & Pete Cole - yes, just two brothers - and we have now been working together in generative music since 1990. However, without the incredible support and interest from so many over the years then we would not be where we are today with our current Apps, Engines and Content. Our thankyou list below is an ever expanding one, in no particular order, and does not include everyone (sorry to those we have missed!). We offer our heartfelt thanks and gratitude to:

    • All our old friends and colleagues from SSEYO days including from the early days Jon Pettigrew, John Wilkinson, Steve Crawshaw & Chandra Modi and including from later days (1996 onwards) Jerry Leach, Paul Blampied, Jerry Swan, Nick Barefoot, Simon Robertson, Kerry-Anna Saia, Natalie Da Gama Rose, John Tenkoni and also including Jesper Bennedbaek, Wenwu Wang etc. from our Tao Group audio days (we are focusing primarily on audio and so there are way too many to list here, but they include all those who went on to work at Antix Labs!)
    • Timothy Didymus and Mark Harrop, longstanding friends, colleagues and artists with incredible talent whose sublime generative music creations have, on the many occasions when times were hard, given us the much needed inspiration to press onwards.
    • All customers, and most especially those who wish to continue with us as we move forward - we love you, thank you!
    • Everyone who made contributions to our forums, has helped others and given feedback or who has blogged, tweeted, facebooked or otherwise written nicely about or shared content they have made with our apps and in so doing helped others to find us - we love you, thank you!
    • Our outstanding beta testers for their testing efforts and everyone who has given feedback, found bugs and helped with suggestions.
    • Early content creators such as David Muddyman, Andrew Garton, Paul Weir and Igor Dvorkin.
    • Finally, a big thanks to Brian Eno for his support and kindness to us in the SSEYO Koan years, out of which arose his pioneering release '"Generative Music 1" with SSEYO Koan Software'.

    © 2004-2020 Intermorphic Ltd. All Rights Reserved. Subject to Change. E & OE.
    x