Wotja Go 19

Wotja Go 19 Guide  19.0.9 - 10th Jan 2019

Wotja Go 19 User Guide

Guide  19.0.9 - 10th Jan 2019 |
Wotja Go 19 for mobile and desktop devices

Generative Music Player

For: macOS, Windows, iOS, Android;
Languages: English, Chinese, Japanese

Love listening to ambient & relaxing music? Use the Wotja Go 19 player to generate fresh music that’s beautiful, personal & unique to you. Made live on your device, the music is not an internet stream, recording or loop. So be in the 'now', be Zen!

Wotja's success stems from many years of continuous development.

For All

Start the all-new 'Flow Player' mode for mix-after-mix of live relaxing music. Use Randomization Presets to change what is generated. Or, select the included album you want and press play. There are two, 'Calm' and 'Relax', and there are 6 mixes in each.

Wotja User Reviews

"Masterpiece", "the best generative software that I have ever used", "Brilliant", "Extremely musical", "Love Wotja!"

This App

This paid-for version of Wotja V19 includes two high quality non-editable Albums of specially constructed generative music mixes as well as a 'Flow Player' mode of operation. It’s for those without a need to save and who simply wish to relax with high quality pre-created albums of generative music or who instead prefer the simple freewheeling freedom of the Flow Player mode’s succession of freshly generated mixes.

It will play for up to 1 hour or you can set the Sleep Timer to have it stop earlier. In Flow Player mode you can change what is created by selecting a different Randomization Preset, several of which are included. You can override some of the preset’s settings e.g. whether words are shown or not, style of icon used, mix duration, tempo etc. Wotja Go 19 will also play any 3rd party .wotjabox album you have installed.

'Wotja Go 19' is a player app and not a creativity app, meaning it has no support for any of Wotja V19’s more advanced creativity or interoperability features. If you have a need for a music play time that is more than 1 hour and/or want to explore the music creativity side of the Wotja system then depending on your needs consider getting the paid-for 'Wotja Box 19' or 'Wotja Pro 19'.

Alternatively, if available, consider a Subscription version and take out a Subscription to a 'Box' or ’Pro' Feature Set tier. The Subscription version also includes optional 'Long Play' Subscriptions for those that need to play their own mixes in e.g. a long play music installation.

Quick Start

Documents Screen

Documents Screen
Click image for large

On starting the app you will see the Documents screen.

'Flow Player' Mode

Tap the left hand purple 'Flow' button to start Flow Player Mode.

When the Flow screen has loaded it will start to play a succession of freshly mixed generative music mixes.

Playing an Included Album

Tap the top view selector control so that 'Built-In' is selected and tap the thumbnail of the album you want. It will then start playing in the Album Player.

Create an Automatic Album

In the 'User' view, tap the 'Add New' button and select 'Album (Automatic)' from the pop-up menu. From settings in the currently selected Randomization Preset, Wotja will then create a freshly generated album of mixes to play in the Album Player.

Each mix in the album (including its icon, text etc.) is created randomly from the hundreds of included Templates according to various Randomization Settings.

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

If you want to customize a mix firstly export it as .wotja (mix) file and then open it in the Documents screen where you will enter one of the Editing Modes.

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

  • Quit/exit the app
  • Create a new .wotjabox file (automatic album), .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 (useful for later)
  • Select your Audio Output device

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.

Note: You may want to use iCloud (if you have it) rather than local storage (if you use local storage the Wotja Data Folder will show you where that is and it will be the Intermorphic Folder). If you use iCloud your files will also appear in the Wotja iCloud Drive folder for all your devices, meaning you can easily sync your Wotja related files between devices that share 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 (macOS):
    • About
    • Other usual entries
    • Quit
  • File:
    • New (files are saved to the Wotja data folder)
      • Album (automatic): Creates a new automatic album of mixes and opens in the Album Player.
      • 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 Mix Mode.
      • Mix - Manual: Takes you to the Templates List to let you manually create a new mix file before opening it in Mix Mode.
      • Cut-Up Text: Creates a new mix file without music (you can create a mix later if you want) and then opens it in Cut-Up Mode.
      • Play List (Desktop version only at present): Creates a new playlist file (.wotjalist) and then opens it in the Album Player where you can add to it the Wotja files you want to be in it.
    • 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 Wotja albums and Randomization presets 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.
  • Window:
    • Show Window: Brings the Wotja app window to the front.
  • Help:
    • Various useful weblinks
    • About (Windows)

Documents Screen

Documents Screen

Documents Screen
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 two file views: 'User' or 'Built-In'
  • Start the 'Flow Player', a button for which is included in both 'User' and 'Built-In' views
  • Load an Built-In album (e.g. Calm or Relax or any included demo albums)
  • Create a new "automatic album" .wotjabox file
  • Create a new .wotjabox file, .wotja file or .wotjalist file
  • Open a file you have previously saved
  • Open any of the relevant supported filetypes
  • Delete/duplicate/rename files

The only difference in display of this screen in Desktop and Mobile versions is that in the 'User' files view in the Desktop version you can have multiple files open, 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.

Filetypes:

UI Item Description
SettingsSettings

Go to Settings screen.

ActionAction
  • Refresh: Refreshes the display in the Documents screen and resynchs to iCloud (if in use).
  • Help & Documentation: Visits this User Guide online.
  • Cancel: Closes the popup menu.
File View controlFile View Control

Tap to select either the 'User' or 'Built-In' File view:

  • '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 ; in Wotja Go 19 these will be any 3rd party .wotjabox albums you have installed)
  • 'Built-In': Displays thumbnails of any .wotjabox albums that are included in the app (e.g. 'Calm' and 'Relax')
FlowFlow

Tap to start the 'Flow Player' mode.

ThumbnailIncluded Album Thumbnail

Tap to play an 'included' Album, e.g. 'Calm' or 'Relax' in the Album Player. Both albums include relaxing, ambient generative music pieces.

Add NewAdd New
  • Album (automatic): Creates a new random .wotjabox "album" file based on various Randomisation Settings (meaning you can create a lot of mixes with nice icons in just one button press).
  • Music Mix (automatic): Creates a new random mix file based on the Randomisation Settings (meaning you do not have to make one via the Templates List) and then open it in Mix Mode.
  • Music Mix (manual): Takes you to the Templates List to let you manually create a new mix file before opening it in Mix Mode.
  • Cut-Up Text: Creates a new mix file without music then opens it in Cut-Up Mode.
  • Play List: Creates a new playlist file (.wotjalist) and then opens it in the Album 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 the auto album was created, what Icon Text setting was used: Cut-up, TTM or none
  • What auto-generated icon is in use?
  • Is it a .wotjabox file? Wotjabox files are indicated by a small golden box icon that overlays the bottom right of the thumbnail image.
  • - Is content in one or multiple cells?
  • - Is it an old format Wotja file?
  • - Is it a Noatikl file (template)?
  • - Is it a Mixtikl file?
  • - Is it a Wotja Playlist file (see below)?
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 Album Player.

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

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

Thumbnail.wotjabox Thumbnail

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

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

If the Wotjabox file includes an Album thumbnail image then you will see that here.

Thumbnail.noatikl

Wotja Template: A Template file (.noatikl) is shown with a small IME 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 the top toolbar Toolbox icon and selecting "Export to File" 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".

Flow Player

Flow Player Screen

Flow Player Screen
Click image for large

See: 'Free Mode' & Limitations

The Flow Player is opened by:

  • Tapping the Flow button in the Documents screen

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 the Music Play Time Timeout (MPTT) is reached.
  • How each mix is generated depends on the various settings in the currently selected Randomization Preset.

The maximum Play Time is governed by the value of the Music Play Time Timeout (MPTT). Once it has been reached music playback will stop. Press the relevent Wotja play button to restart play.

The MPTT ranges from 10 minutes to 8 hours and is Feature Set dependent.

The MPTT in Wotja Go 19 is 1 hour. See Feature Sets.

The MPTT in Wotja Box 19 is 2 hours. See Feature Sets.

The MPTT in Wotja Pro 19 is 8 hours. See Feature Sets.

UI Item Description
BackBack

Takes you back to the Documents screen.

BackSettings

Takes you to the Settings screen.

Sleep Timer & Play Time RemainingPlay Time Remaining

Shows the total Play Time remaining before Wotja will stop playing. The maximum this can be is governed by the value of the Music Play Time Timeout (MPTT).

The MPTT ranges from 10 minutes to 8 hours and is Feature Set dependent.

The MPTT in Wotja Go 19 is 1 hour. See Feature Sets.

The MPTT in Wotja Box 19 is 2 hours. See Feature Sets.

The MPTT in Wotja Pro 19 is 8 hours. See Feature Sets.

Tap the Sleep Timer button just to the left of the Play Time Remaining indicator to go to the Settings Screen where you can set the Sleep Timer. When there the Sleep Timer is on the button looks more solid.

LockLock

Locks the mix so that it is restarted when it reaches its end rather than another being generated.

BackNext

Forces another mix to be generated.

Album NameFlow

Shows that you are in Flow mode.

Action buttonAction button

Lets you export the Flow mix as a Wotjabox Album and/or as a Wotja file. Feature Set dependent.

Lets you export the Flow mix as a Wotjabox Album.

Lets you export the Flow mix as a Wotjabox Album and/or as a Wotja file.

Visit the User Guide online with the Help & More item.

File Play IndicatorFlow Mix Play Time

Shows the Play Time remaining for the current Flow mix.

The Flow mix Music Play Time Timeout is Feature Setdependent.

The Flow mix Music Play Time Timeout is 1 hour in Wotja Go 19. See Feature Setdependent.

The Flow mix Music Play Time Timeout is 2 hours in Wotja Box 19. See Feature Setdependent.

The Flow mix Music Play Time Timeout is 8 hours in Wotja Pro 19. See Feature Setdependent.

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 Preset. Doing that lets you override what is in the Preset. 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).

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!

Album Player

Album Player Screen

Album Player Screen
Click image for large

Album Player Screen

Album Player Screen
Click image for large

See: 'Free Mode' & Limitations

The Album Player is opened from the Documents screen by:

  • Tapping on one of the Included Albums
  • Opening a Wotja Box file (.wotjabox)
  • Opening a Wotja List file (.wotjalist)
  • Creating a new Automatic Album (.wotjabox)
    • Documents screen > Create New & Album (automatic)
    • Titlebar Menu > New & Album (automatic)
  • Creating a new Wotja List file (.wotjalist)

It is used to:

  • Play the included Albums (.wotjabox files 'Calm' and 'Relax')
  • Play Wotjabox (.wotjabox) files
  • Play Wotja List (.wotjalist) files
  • Export user created Wotjabox (.wotjabox) files from Wotja List files
  • Add Wotja, Noatikl and Mixtikl files to a Wotjabox album
  • Re-order the files in a playlist
  • Edit Mix Override settings for .wotjalist and .wotjabox files (these values are saved back to that file)

The maximum Play Time is governed by the value of the Music Play Time Timeout (MPTT). Once it has been reached music playback will stop. Press the relevent Wotja play button to restart play.

The MPTT ranges from 10 minutes to 8 hours and is Feature Set dependent.

The MPTT in Wotja Go 19 is 1 hour. See Feature Sets.

The MPTT in Wotja Box 19 is 2 hours. See Feature Sets.

The MPTT in Wotja Pro 19 (or an app with Pro feature set) is 8 hours. See Feature Sets.

Album Player File Types

  • Wotjabox (.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 for the included mixes/files - which makes them great for sharing your favourite creations.
    • Note: Any album 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 albums. See: iCloud Folder or in the Intermorphic Folder.
  • Wotja List (.wotjalist):
    • Playlists that contain references to Wotja / Noatikl / Mixtikl files saved to your iCloud folder. If you change the file in Wotja, then the playlist just references that changed file.
  • Wotja (.wotja), Noatikl (.noatikl); Mixtikl (.mixtikl):
    • Wotja (.wotja) files include all parameter settings, text and images necessary to play the mix. They do not include, however, any additional referenced media such as loops.
    • Files created with Noatikl and Mixtikl can also be included in albums/playlists.
    • Note: Any mix 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 mixes. See: iCloud Folder or in the Intermorphic Folder.
UI Item Description
BackBack

Takes you back to the Documents screen.

BackSettings

Takes you to the Settings screen.

Sleep Timer & Play Time RemainingPlay Time Remaining

Shows the total Play Time remaining before Wotja will stop playing. The maximum this can be is governed by the value of the Music Play Time Timeout (MPTT).

The MPTT ranges from 10 minutes to 8 hours and is Feature Set dependent.

The MPTT in Wotja Go 19 is 1 hour. See Feature Sets.

The MPTT in Wotja Box 19 is 2 hours. See Feature Sets.

The MPTT in Wotja Pro 19 is 8 hours. See Feature Sets.

Tap the Sleep Timer button just to the left of the Play Time Remaining indicator to go to the Settings Screen where you can set the Sleep Timer. When there the Sleep Timer is on the button looks more solid.

BackPrevious

Takes you to the previous item in the Album.

BackNext

Takes you to the next item in the Album.

Add Item Add Item

Tap to add a file to your album.

  • New Random Mix: Tap to add a new Random mix to your album. Feature Set dependent.
  • Browse Mixes: Browse the Wotja folder to add a Mix, Saved Mix, Template or Saved Template to your album. Feature Set dependent.
Sequential Play Sequential Play
Random Play Random Play

Tap to toggle between sequential and random play.

ActionAction
  • Export to Clipboard as Wotja Box Album: This is for when you want to embed your Album in a webpage as a Wotja URL.
  • Save Wotja Box Album to File: Allows you to export your Wotja List to a Wotja Box file that is then saved locally. You might choose to do this to if you wish to share your album.
  • Refresh ALL items (.wotjabox only): This will refresh all items in the Wotja Box file with the latest versions that you have saved locally (this is for Wotja Box authors who have the local original files).
  • Refresh playlist item (.wotjabox only): This will refresh the selected item in the Wotja Box file with the latest versions that you have saved locally (this is for Wotja Box authors who have the local original files).
  • Export playlist item to File (.wotjabox only): Allows you to export a file to be saved locally. You might choose to do this to if you wish to edit or re-edit this file.
  • Help & More: Visit the User Guide online.
Album NameAlbum Name

The name of the Album (left of status bar).

File NameFile Name

The name of the currently selected File (middle of status bar).

File Play IndicatorFile Play Time

Shows the Play Time left for the current file (right of status bar).

This value can be adjust in List Overrides.

The maximum effective value of a mix in Wotja is 4 hours but it is limited by the MPTT and so is Feature Set Dependent. See Feature Set dependent.

The maximum duration of a mix in Wotja Go 19 is effectively 1 hour, as that is the MPTT in Wotja Go 19. See Feature Sets.

The maximum duration of a mix in Wotja Box 19 is effectively 2 hours, as that is the MPTT in Wotja Box 19. See Feature Sets.

The maximum duration of a mix in Wotja Pro 19 is 4 hours. See Feature Sets.

Album ThumbnailAlbum Thumbnail Album Thumbnail

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

List Item

The top line is the file name.

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

The bottom line displays the minimum and maximum piece time (these values are set in Item Overrides).

Tap the central area to play or stop the file. When the file is playing the item will be a light blue colour.

List Item Overrides button

Tap for a pop-up menu where you are presented with the following options:

  • Mix Overrides: See the item below.
  • Random Icon: Allows you to randomly generate a new icon according to the "Random > Albums > Icon Palette and Icon Graphic" settings.
  • Export Item to File: Where availble, this item lets you export your mix so that you can further edit it,
  • Refresh Item from File (only shown if you have exported that mix file): If you have exported a mix, changed it and saved it, this allows you to refresh the file in the album.
  • Move Up: Only shown if you have a subscription enabled or are using the Annual version.
  • Move Down: Only shown if you have a subscription enabled or are using the Annual version.
  • 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)

These settings override any related settings that may be in the File in the Album (these File related Playlist settings are set in the Cell Rules panel in the Mix Tab).

  • 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 (Piece time).
  • Range: Sets a range on how long the file can play for.
  • Ramp Down: Sets how long it takes for the file volume to ramp down before play moves to the next file.
FullscreenFullscreenFullscreen
(click image for large)

Fullscreen display is for when you want to sit back, look at any included image/message and reflect on the music.

When you first go into Fullscreen 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 Album player screen.

Settings: General

Settings ScreenSettings Screen

Settings Screen - General
Click image for large

The General "segment" in Settings is where you set the Sleep timer if required, the User Interface mode (Light or Dark) and various Audio settings.

It is also where you determine how you want Wotja to play its sounds and, amongst other things, how it is used with Audiobus / Inter-app Audio [both iOS only] and MIDI Out/In.

This screen is accessible from the Cog item which is shown in the Documents screen and others.

Item Description
StoreStore

Go to the In-App Store screen.

InfoInfo

Select for a popup with links to further information, such as version number, links to this user guide, website, EULA, Privacy Policy etc.

Sleep Timer
Timer Slider

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

The timer is off when the slider is in the near left position. You will then see the value shown as ∞.

If you are running in 'Free Mode' then Wotja will always stop playing after 10 minutes in Flow/Album modes or 1 minute in Mix Editing mode, whatever the value of the slider.

If the setting is ∞ then it means there is no sleep timer active and the only timer in operation is the Music Play Time Timeout.

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!

Audio Output
ISE for Sounds & FX

(Default: On) Enables ISE sounds, which all voices 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 with such apps it requires that the Wotja Audio Block Size MUST have the same value as the Buffer Size (samples) or Latency Control (frames) in those apps [different apps refer to the same thing in different ways]. We recommend that this value is 1024.

Audio Sample Rate

(Default: 48 kHz or 44 kHz; auto selected depending on device capabilities). 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

(Default: 1024 samples). 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 (ISE). 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

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

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.

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.

MIDI Input
Devices button

Notes: MIDI Input is only used by Listening Voices and MIDI Input Devices is now called simply "Devices".

Tap the 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:
    • This is used for detecting MIDI sent via a network (e.g. from a Mac over WiFi).
  • Wotja + Channels:
    • 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 Wotja detects (e.g. Thumbjam, MIDIKeys etc.) will be shown here; toggle on the ones you want Wotja to recieve MIDI input from.
    • Note: Each of those 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
      • Note that for WJ macOS (native), this text is displayed in the “Time” area in the top panel, rather than under the play/stop button
    • 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.

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

Settings: Randomization

Settings RandomizationSettings RandomizationSettings Randomization

Settings Screen - Randomization
Click image for large

The Randomization "segment" in the Settings screen is a very powerful screen.

It is where you select the Randomization Preset 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 are created and whether text is displayed on screen in Flow mode and/or the Album 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 voice text randomisation is applied to mixes and how Cut-up is generated in the 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
Presets
OpenOpen

Opens the Preset list.

Selected PresetSelected Preset

Shows the selected Randomization Preset.

OpenSave

Displays a pop-up menu for you to save changes to the current preset 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.
Albums
Icon Palette

Default - Random: Select from one of 35 includes palettes for auto-icon generation in Albums or Mixes.

Icon Graphic

Default - Blobs: Select from 2 different kinds of icon graphic styles for auto-icon generation in Albums or Mixes. The choices are: Blobs or Geometric.

Icon Text

Default - TTM: Select what text, if any, you want to display in your icon. The choices are: TTM, Cut-Up or none.

Mixes in Album

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

Max (Mixes in Album)

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

Duration

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

Max (Duration)

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

Duration Range

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

Max (Duration Range)

Default - 0 s: The maximum duration that is added to a mix's Duration above when the album 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: Templates

Templates Screen

Templates Screen
Click image for large

See: 'Free Mode' & Limitations

Templates are at the heart of Wotja. They are self contained "generative music and sound presets" - they can vary from being simple to very complex complex generators of notes and sounds. Their use is fundamental to how Wotja works.

Using randomisation techniques Wotja lets you mix templates together to very quickly create interesting music mixes. Once added to a mix you can edit/customize any of their settings, but you do not have to - they sound great as they are!

The Templates screen is where you preview and select templates that you want to have in your Randomization Preset.

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
Action Back to the Settings screen.
NewRandom
(Top right menu)

Wotja A iOS ONLY

When adding a template to a Content Cell (Mix mode):
  • "Load": Shown when content cell is empty.
  • "Merge": Shown when generative content is already in a cell. Lets you merge the selected file with what is already in the cell.
  • "Replace": Shown when content is already in a cell. Lets you replace it with the selected content.
When accessing the list via Randomization Settings:
  • No top right menu item is shown at all because in this use case you are only setting the content to be available for randomization when you do randomize.
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 wotjas or generative templates that you have already created and saved.

WJ18/WJ5 Paks: These include templates optimised for Wotja 5.

WJ4 Paks: These include templates optimised for Wotja 4.

IME VoiceTypes: Simple templates that let you start a cell with just one VoiceType.

IME Others: Older sundry templates.

IM3 Paks: The Paks that were available for Noatikl 3 and Mixtikl 7

IM2 Paks: (Shown in dark grey, and only if "Show Old?" toggle is on). These include generative templates that came with Noatikl 2 and Mixtikl 6.

IM1 Paks: (Shown in dark grey, and only if "Show Old?" 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.

ActionShow Older?
(Left)
Toggle this on to see generative templates that were included in precursors to Wotja X, e.g. Noatikl and Mixtikl.

Settings: iCloud

iCloud Settings Screen

iCloud Settings Screen (iOS)
Click image for large


iCloud Drive Settings Screen

iCloud Drive Settings Screen (iOS)
Click image for large


iCloud Settings Screen

iCloud Drive Settings Screen (macOS)
Click image for large


iCloud Drive Settings Screen

iCloud Drive App Screen (Windows)
Click image for large

See also Apple's iCloud Help resource.

Using Wotja with iCloud / iCloud Drive 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!

Tip: Wotja for iOS needs the iCloud/iCloud Drive settings to be both on or both off otherwise it can get confused and may not save files to where you are expecting.

Wotja iCloud Settings screen (iOS):

This screen is where you set whether Wotja can use Mobile Data and whether or not it uses iCloud for file saving.

This screen is accessed from the iOS Settings Screen. Scroll down that screen to find the version of Wotja that you have installed and then turn the toggle on.

Wotja iCloud Drive Settings screen (iOS):

This screen is where you set whether Wotja can use iCloud Drive for file saving.

This screen is accessed as follows: From the iOS Settings Screen > Accounts & Passwords > iCloud > iCloud Drive > ensure iCloud Drive is toggled on and scroll down the screen to find the version of Wotja that you have installed and then turn the toggle on.

Wotja iCloud Drive Settings screen (macOS):

This screen is where you set whether Wotja for macOS can use iCloud Drive for file saving. From the macOS System Preferences screen > iCloud Drive (ensure iCloud Drive is toggled on) > Options button > scroll down the screen to find the version of Wotja that you have installed and then turn the toggle on.

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.

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-2019 Intermorphic Ltd. All Rights Reserved. Subject to Change. E & OE.