System Overview | Mix Editing | Settings & Other |
---|---|---|
Wotja ( "watch-ah" [Siri "Woa-chah"]) is an awesome 'generative music' creator/composer, mixer, lab & player system.
It is regularly updated and has got a rich history, being the evolution of SSEYO Koan, Noatikl, Mixtikl, Liptikl & Tiklbox.
Use it to generate royalty-free background music, ambient & melodic soundscapes, lush drone mixes, reflective text-to-music, MIDI & ideas e.g. for personal enjoyment or for use in videos, podcasts & presentations, on CDs & DVDs etc. as well as in live installations.
Wotja Users say: "Essential music app", "Nothing compares", "Masterpiece", "A gem", "Incredible, fantastic, wonderful, inspiring", "Simply the best ambient app ever made!"
Platforms: iOS, macOS, Windows, Android/Android TV, tvOS/watchOS | See Wotja V20 Requirements
Devices: iPhone, iPad, iPod touch, Mac, PC, Laptop, Tablet, Mobile, Watch | Apple TV, Fire TV, Android TV
Languages: English, Chinese, Japanese
This User Guide is for all Wotja V20 versions and Feature Sets. It is complemented by these standlaone companion Guides:
This User Guide provides schematics for each key screen, making it easy to get to grips with Wotja. Each schematic is surrounded by colour-coded buttons.
Tap a button around the outside of a schematic for further info on that UI element. Tap it again (or use your browser back button) to return to the schematic.
In a desktop browser hover over the button for a pop-up description of the item; on an iOS device tap/hold the button for a quick preview. Easy!
Colour-coded buttons and examples from the Music Mode Schematic:
#: Panel area e.g. Menu BarA
#: Button/selector e.g. Cell Selector15
#: Display item e.g. MIDI Channel31
#: IME (Generators) e.g. Generator Button29
#: ISE (Sounds, FX) e.g. Generator FX Button34
It's very easy to use Wotja, especially as a generative music player; see the Flow Player and Playlist Player Quick Starts below.
Wotja is also rewarding to use as a powerful creativity system for generating ideas, melodies, music and even cut-up text. If you want to try using it for that then check out the Create & Play Quick Start below. See also our video tutorials.
Let's start off by playing some things - you could also check out the Wotja TV Player & companion Wotja Watch Player apps, too!
Note: In Lite Mode all files have a bottom left badge which shows the auto-timeout time, that being either minutes (60) or minutes (2). This badge is not shown in Play or Pro Feature Sets.
The Flow segment shows a list of all the Randomization Schemes (RS) included in Wotja (as well as any that are in the Wotja Folder i.e. any you have created yourself). These are used by the Flow Player to auto-generate a succession of generative music mixes. 2 taps is all you need - what could be easier!
It auto-generates mixes until stopped or a sleep timer (or Lite Mode timeout) kicks in.
Tip: To save a Flow to a mix file (Pro Mode) or Box file (Play or Pro Mode) use the relevant Flow Player > Action button menu item.
It really is as easy as that!
The easiest way to check out the Playlist Player is with an "Included" Album. An Album is just a 'Box' playlist that is specially packaged for inclusion in Wotja.
Alternatively, create (see below) and play your own playlist/box of mix files:
The Mix Player can be used to create, play and edit 'mix' files (.wotja
).
Alternatively, make and play an auto-generated 'box' (.wotjabox
) of mix files:
See also this Youtube video: Wotja: 'Lite' vs 'Pro' - Which is right for you? (10 mins)
The Wotja V20 app range includes two creator player variants - a paid-for version and a free version (see below).
The features and capabilities that each operates with is called its Feature Set (abbreviation FS) or Feature Mode (AKA 'Mode'). There are 3 distinct Feature Sets, these being Pro, Play and Lite - see the Feature Set Table below.
A paid-for app with a Pro Feature Set (AKA 'Pro Mode'), meaning all Feature Set Restrictions are unlocked. These versions have no In-App Store, are only available in 2020 and will get all relevant Wotja V20 updates during the course of that year.
A free app with a default Lite Feature Set (FS) (AKA 'Lite Mode'). These versions get rolling updates whatever the year.
The iOS & macOS versions include an In-App Store that allows purchase of monthly "Dual" In-App Subscriptions that work in both. Subscriptions are easy to cancel should you no longer wish to Subscribe.
The table below shows the main differences between the Pro, Play and Lite Feature Sets (AKA 'Modes') for Wotja V20.12.7. Feature Set Restrictions shown in red.
Feature Set (AKA 'Mode') | Pro | Play | Lite |
---|---|---|---|
License (Businesses - see Special Options) |
|||
Commercial Use of Recordings of output | Personal | No | No |
Live Use (LU) | Personal | Personal | Personal |
Features & Capabilities |
|||
Create mixes, boxes, playlists | Yes | Yes | Yes |
Access to all Editors | Yes | Yes | Yes |
Full Save | Yes | Yes | Yes |
iCloud for Wotja Folder (iOS/macOS only) | Yes | Yes | Yes |
Inter-App Audio/Audiobus/Link (iOS only) | Yes | Yes | Yes |
Auto-Timeouts | None | None | Flow "Go" - 60 min "Calm" Included Album - 60 min All other files - 2 min |
Export Flow to Box file | Yes | Yes | No |
Flow Repeat/Continuum button | Enabled | Enabled | Disabled |
MIDI Out/In | 16 Channels | Ch 1 only | Ch 1 only |
Mix Track Editing/Scripting | All tracks | Track 1 only | Track 1 only |
Mix Recording to Audio | Yes | 30s only | 30s only |
Mix Recording to Video (iOS/macOS only) | Yes | 30s only | 30s only |
Select/Edit/Save Randomization Schemes | Yes | No | No |
In-Mix Randomization (Cell, ISE) | Yes | No | No |
Mix Template Export/Merge | Yes | No | No |
Export Flow to Mix file | Yes | No | No |
Export Mix from Box | Yes | No | No |
Mix Recording to MIDI | Yes | No | No |
Remove Wotja watermark (full/display screen) | Yes | No | No |
Tip: How do I get files into Wotja? See this FAQ.
.wotja
[Mix file]: Contains all parameters, text and image needed to play and display a mix (IME, ISE, ITE) .wotjabox
[Box file]: A playlist container including up to 20 .wotja
files.wotjalist
[Playlist file]: References .wotja
files located in the Wotja folder.noatikl
[Template (Noatikl) file]: Added to a Cell via the Template List; auto-converted to .wotja
file when opened via Documents.mixtikl
[Mixtikl file]: Auto-converted to .wotja
file when opened via Documents.liptikl
[Liptikl file]: Auto-converted to .wotja
file when opened via Documents.skd
[SSEYO Koan file]: Auto-converted to .wotja
file when opened via Documents.zip
, .sf2
, .midi
, .wav
, .ogg
(or image) files
.sf2
[and in Paks] can be referenced in templates via an ISE Wavetable Unit..wav, .ogg, .midi
[in Paks] can be added to a Cell via the Template List..jpg/.png
image files can be added as a background to a mix file via the picture setting.noatikl
[Template (Noatikl) file]: Via Music Mode > Grid > Cell Actions > Export to Template.wotjarp
[Randomization Scheme file]: AKA "Scheme" or "RS".tg
[ISE Synth Network file]: AKA "Synth Preset".fxm
[ISE FX Network file]: AKA "FX Preset".wotja, .wotjabox, .wotjalist
: any/all referenced .zip
, .sf2
, .midi
, .wav
, .ogg
files are not included.wav
, .midi
, .mv4 / .mov
Wotja URL
: a mix file webpage embedded as a URL (see Export Mix to Clipboard and Sharing)Plain text
: words/characters, cut-up, cut-up rules, patterns etc..tg, .fxm
: as aboveThe Documents screen is what you see after you have launched the app. In it you can use the Screen Selector7 to select one of three different file views or screens: FlowB, AlbumsC or MixesD. What you see on the Live Use2 and Feature Set4 buttons depends on the version you have and (as available) the active Subscription tier(s).
Note: In Lite Mode all files have a bottom left badge which shows the auto-timeout time, that being either minutes (60) or minutes (2). This badge is not shown in Play or Pro Feature Sets.
In the User segment the Desktop version allows multiple files (mixes, playlists, Boxes and Albums) to be open at the same time. Each file is shown in a different tab at the top of the screen. See also the Desktop Titlebar Menu section.
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.
UI Elements: Menu Bar buttons12456 and a Screen title3 that is always "Wotja".
The Flow screen is selected with the Screen Selector7.
UI Elements: Flow button8 and Randomization Scheme Name9.
The Albums screen is selected with the Screen Selector7. It includes 2 sub-segments, "User" and "Included".
Note: For an album to be shown it must be in the (relevant) Wotja folder.
The Mixes screen is selected with the Screen Selector7.
Note: For a mix file or template to be shown it must be in the (relevant) Wotja folder.
The Action button presents a pop-up menu with the following options:
The Special Options (SO) button will display the name of the active Special Options Subscription Tier. These are Subscriptions are for Commercial Use Licensing and for 'Super-fans'. Tap on it for a screen with further information.
The Screen title in Documents is always Wotja.
The Feature Set button displays the name of the active Feature Set.
NB: The Store button is not shown in the Wotja Pro 20 version.
The Settings button takes you to the Settings screen.
Tap a "segment control" to select a screen, these being the FlowB, AlbumsC (with two sub-screens) or MixesD screens.
This shows the name of the Randomization Scheme that is used by the Flow button above it.
The name of a built-in Randomization Scheme is not editable but you can edit the name of your own saved Scheme as follows:
.wotjarp
file in the Wotja folder and rename to what you want.Tap the Add New button13 for the following pop-up menu:
The Album badge is used to indicate this is an Album (Box file .wotjabox
, see Filetypes). Included albums have an IM icon as a badge.
Tap the Album button to load it the Playlist Player.
If the Box includes a background image then you will see that image on the Album button.
.wotjabox
)Tap the button for a Playlist File19 to load the playlist in the Playlist Player.
A Playlist file button (.wotjalist
, see Filetypes) has a playlist badge. If the Playlist includes a background image then you will see that image on the Playlist File button otherwise it will display a list of the included files.
.wotjalist
)The name of a Album (i.e. Box file). Tap the button to edit the name (see File Name button17).
Note: the names of Included Albums cannot be changed.
Tap the Add New button15 for the following pop-up menu:
Tap a Mix File button14 to open the mix in the Mix Player.
A Mix File button (.wotja
, see Filetypes) has no badge. Its appearance depends on a number of factors:
.wotja
)Tap on the File Name button17 (below a Mix File button16) for the following popup menu:
This is the Mix File button for a mix file created with Add New > Mix Empty.
See also: Mix File button14
This is the Mix File button of a mix file to which you have added a background image (see: Display Mode > Picture button5).
See also: Mix File button14
Tap the button for a Template File20 to auto-convert it to a .wotja mix file before being opened in the Mix Player.
A Template file button (.noatikl
, see Filetypes) has a template badge.
.noatikl
)Wotja | File | Options | Window | Help |
---|---|---|---|---|
About | New | Show Folder | Show Window | About |
Open | Output Devices | Resize | ||
Close | ||||
Save | ||||
Recent | ||||
Exit |
The Desktop versions of Wotja allow you to have open multiple mixes/boxes/playlists/albums ('files'). Each file will be shown in a separate tab at the top. If your computer is powerful enough then you play all of the files at the same time!
Being able to have multiple files open can be really handy when you wish to copy between mixes, and it is a key feature advantage the desktop versions have over the mobile versions.
To carry out normal file related activities in the Desktop versions e.g. delete/duplicate/rename files etc. you can use either the 'Documents Screen' or Finder / Windows Explorer.
Keyboard shortcuts: The Desktop menu items show the keyboard shortcuts that can be used to select them, e.g. Cmd+W (macOS) or Ctrl+W (Windows) to close a tab.
Tip: If you change the Audio Output device selection you will need to restart Wotja. See this FAQ.
Note: If you have the macOS and iOS versions of Wotja and have iCloud, then, instead of using the local Wotja Folder for your Wotja Files (the Wotja Data Folder menu item will show you the location of this) you may instead prefer to use the Wotja iCloud Drive folder (recommended). A key benefit of using the Wotja iCloud Drive folder is that you you will then be able to access your Wotja files on any iOS or macOS device that shares the same iCloud account. See the iCloud FAQ.
WOTJA BACKUPS: Make these by: A) Using iCloud to store your files, or by B) backing up your device with Time Machine or equivalent; or C) emailing yourself a backup copy of each wotja. Using iCloud is the easiest way to manage your files.
Editable "Templates" are at the core of Wotja and Wotja includes 100s of them. Every mix file uses them, whether auto-created e.g. in the Flow Player, or created by you.
The reason is quite simple actually. Mix files are comprised of Cells15. For a Cell to play it must have in it either a Template, be that in an included one or one one you or a 3rd party has created - or an Audio or MIDI file (the latter 2 must be in Paks, see Filetypes).
If so then it definitely helps to know a bit about Templates, which is why this section comes before the other "Edit Mode" sections.
In our terminology a Template is basically a self contained "generative music and sound preset". This simply means it contains all the parameter settings for the IME (Music Engine), ISE (Sound & FX Engine) and anything else Wotja needs to generate music. It can include just a single Generator (these generate MIDI notes) to very complex complex network of Generators, each with their own ISE Sound & FX networks (used to generate sound and FX).
Once a Template is added to a Cell15 you can edit/customize any of its settings, but you do not have to - they sound great as they are! There are hundreds of editable Templates included in Wotja that you modify and save to use as your own (see Saved Files9).
Automatic Mixing: Randomization Schemes allow interesting, fresh mixes to be created from random selections of Templates. In the Documents Screen they're used in the creation of automatic mixes and boxes13 and they underpin mixes created in the Flow Player.
Manual Mixing: Templates are selected, previewed15, and added to a Cell via the Template List. This is accessed via a Cell Selector Button15, Generator Menu Button6, pop-up menu from a Generator Button29 or any Settings Button14
UI Elements: 1,6,7,8.
Takes you back to the screen you came from.
Displays a list of installed Paks that you can select a Template (or other supported FileType) from.
Note: The Pak toggle is only shown when you are accessing the Template List via Settings > Randomization > Templates.
For the purposes of randomization the Pak toggle allows you to specify which Paks you want Templates to be selected from for the current Randomization Scheme.
Displays the name of the screen.
The list of Templates (or other supported FileType) in the selected Pak.
The Action button displays a pop-up menu a number of useful options to help with Template and Pak selection:
The Replace button allows you to Replace content that is already in a Cell with the selected Template.
If the Cell is empty then you will instead see a Load button which when tapped simply adds the Template to the Cell.
Note: This button is only shown if accessing the Template List from a non-empty Cell.
The Merge button allows you to merge the selected Template with the generative content that is already in a Cell. An example would be if you had a Cell with say a TTM Generator in it and you wanted to add another TTM Template to that.
Note: You are not allowed to Merge in a Template if there are insufficient free MIDI channels to accomodate the Template.
Note: The Merge button is only shown if accessing the Template List from a non-empty Cell.
The Saved Files Pak is always shown at the top for easy accesss. It contains all the generative templates (.noatikl files) that you have already created and saved (see Toolbox Button4 > Export to Template).
Tap a Pak to select it and displays its templates in the right hand Templates list.
These are what some of the Paks are:
A light blue background indicates the selected Pak.
The IME Generator types Pak includes simple "starter" Templates for each of the Generator types. They are for those that want to build a mix from the most basic starting point.
Note: These are also the Templates that are added when you select "Add Generator of Type" from a Generator's pop-up menu.
3rd Party Paks are shown below the included Paks. If you have them installed, the Intermorphic MDB or the AL Collections Paks are shown in dark grey, italic. Other third party paks are shown in black, italic.
Note: The Template toggle is only shown when you are accessing the Template List via Settings > Randomization > Templates.
For the purposes of randomization the Template toggle allows you to specify which Templates you want to be selected for the current Randomization Scheme.
When a Template is being previewed it has a light green background - you can preview it without having to open it.
Tap to select or preview a Template; tap again to stop the preview.
Tap to select or preview a Template; tap again to stop the preview.
Documents > Flow ScreenB > Flow Button8
The Flow Player (see Quick Start) shows a list of all the Randomization Schemes (RS) included in Wotja (as well as any that are in the Wotja Folder i.e. any you have created yourself) and is used to:
UI Elements: Menu Bar buttons1,3,4,6,7,9,11.
UI Elements: Indicators2,5,11.
Takes you back to the Documents screen.
If you have an active Sleep Timer button3 then this indicator shows the time remaining before Wotja will stop playing.
If there is no Sleep Timer active this area just show the word "Flow" to let you know you are in Flow mode.
When the timer is not active it is a line outline; when it is active the icon takes on a more solid form (as shown).
When the Sleep Timer value is changed Wotja will auto-restart whatever is playing.
A toggle that, if set to repeat, will restart the current mix when it reaches its end rather than another being generated.
The Repeat icon is a loop symbol and the Continuum icon is a squiggly line (shown).
Displays the name of the Randomization Scheme currently in use.
A Play/Stop toggle that will start or stop the mix.
Forces another mix to be generated.
When displayed, this panel can help to see the various Menu buttons at the top of the screen. You can have it auto hide after 2 seconds by toggling off the "Always Show Full Screen Top Panel" in Settings > General.
Displays a pop-up menu with the following options:
Displays the Play Time remaining for the current Flow mix.
Tip: To change how long mix will play for try changing the Duration/Max and Duration Max/Range values in the Randomization Scheme that is being used. Doing that lets you override what is in the Scheme. It's fun!
Takes you to the Settings screen.
Whether any text is displayed here depends on the Icon Text value used by the Randomization Preset (Settings > Randomization). The text is present in the underlying mix file and can be Cut-up or TTM text.
Tip: To change what is displayed try changing the 'Icon Text' value in the Randomization Scheme that is being used. Doing that lets you override what is in the Scheme. It's fun!
The background used in Flow Mode depends on the Icon Pallete and Icon Graphic values used by the Randomization Preset (Settings > Randomization).
Tip: To change what is displayed try changing the Icon Pallete and Icon Graphic values in the Randomization Scheme that is being used. Doing that lets you override what is in the Scheme. It's fun!
This is where the Watermark displays if the Settings > General > Show Watermark toggle is on.
There are different Wotja watermarks for the Wotja and Wotja Pro 20 apps.
Documents > User ScreenD > Box Button18 / Playlist Button19 or Albums ScreenC > Album Button10
The Playlist Player (see Quick Start) is used to play the following file types:
.wotjalist
):
.wotjabox
):
The Playlist Player is also used to:
.wotja
) to a BoxTip: To create a playlist, see the the User screenD > Add New button13 > "Play List."
UI Elements: Menu Bar buttons1,3,4,6,8,9,11.
UI Elements: Toolbar buttons2,5,10.
UI Elements: Indicators12,7,20.
Note: This Button is shown only in the mobile versions; the Deskstop versions use the File Menu.
Displays the Save Changes Menu pop-up (see below) before exiting to the Documents Screen.
Tap this button for the following pop-up menu:
When the timer is not active it is a line outline; when it is active the icon takes on a more solid form (as shown).
Note: When the Sleep Timer value is changed Wotja will auto-restart whatever is playing.
Takes you to the previous playlist item.
This sets the image used for the Box file18 or Playlist file19 in the Documents sceen.
Tap for a pop-up menu with the following options:
A Play/Stop toggle that will start or stop the mix.
Displays the name of the playing mix.
Takes you to the next playlist item.
Tap to toggle between sequential play (shown) and random play.
Takes you to the Settings screen.
If you have an active Sleep Timer then this shows the time remaining before Wotja will stop playing. If there is no Sleep Timer active this area just show the name of the playlist.
Tap the Sleep Timer button in the top toolbar to go to the Settings Screen where you can configure the Sleep Timer.
Tap the mix thumbnail to go to "Play Screen" display mode below (see also the "Full Screen" option in the Action Button).
The Play Screen is a full screen mode of operation but it still has a toolbar. It is great when you want to sit back, look at any included image/message and reflect on the music, but also to have access to the top toolbar. When you first go into it a Fullscreen Top Panel background appears behind the Menu Bar to help you see the controls. To have it always on see: Settings & General & Always Show Fullscreen Top Panel.
The Play Screen layout is similar to that of the Flow Player except that it has the Playlist Player Menu Bar instead of the Flow Player Menu Bar. Although very similar, the Status Bar is also slightly different as the left hand area shows the Mix Name (instead of Flow) and the right hand area shows the Mix Remaining Play Time.
Tap in the center of the Play Screen to return to the Playlist Player screen.
A faint blue highlight indicates the currently selected mix, this may be different from the playing mix.
The center line displays "Playing" when the mix file is playing.
Show the number of the mix in the list and its name.
Displays the minimum and maximum values for Mix Duration, i.e. the range of values for how long the mix can play for each time. These values are set in the mix file but can be overridden via the Mix Actions button19 (Box file only).
Tap the central area (not the thumbnail) to play or stop the mix without going into the Play Screen (see Mix Thumbnail button13).
Tap for a pop-up menu where you are presented with the following options (Box/Playlist files only, not Albums):
This displays the Play Time remaining for the current file.
This value can only be adjusted in Mix Overrides (Box file only) - see Mix Overrides button19.
Note: The maximum duration for a mix is 4 hours.
The Wotja TV Player is a simple 'player' app that, once installed on your TV (Apple TV, Fire TV or Android TV), is launched from the relevant Wotja app icon on your TV.
It operates as a 'Flow Player' meaning that it generates a succession of freshly created mixes, but it also lets you repeat the current mix if you so wish.
The music generated, screen background and any text displayed all depend on the Randomization Scheme that has been selected. A number of these are included in the TV app and are non-editable.
Note: The paid-for Wotja Pro 20 iOS and Android apps include a TV player that has no auto-timeout; the free versions all have an auto-timeout of 10 minutes (i.e. the Lite Feature Set auto-timeout).
Wotja TV Player capability summary:
Tip: Use the play/stop buttons on your TV remote control play/stop music being generated by the Wotja app.
The top part of the screen that includes 2 buttons - Settings button1 and Next button6.
A pop-up panel that displays when you select the Settings button1.
Displays the pop-up Settings PanelB.
The icon shows whether the Sleep Timer is on, where it has is a solid shape, or off [as shown], where it is an outline shape.
If a Sleep Timer has been set this will reflect that time. If not, then in the 'Pro 20' version it will show an infinity symbol and in the free version it will a countdown timer with a maximum value of 5 mins.
Shows how long the current mix has left to play before either repeating or the next mix is generated (which depends on whether Repeat/Continuum is selected (12)).
The icon shows whether the current mix is to repeat (Repeat - loop symbol) or a new mix is to be generated at the end of the mix play time (Continuum - squiggly line [shown]).
Select this button to force another mix to be generated.
Whether any text is displayed here depends on the Randomization Scheme14 being used.
The background used depends on the Randomization Scheme14 being used.
This is where the Watermark displays.
There are different Wotja watermarks for the Wotja and Wotja Pro 20 apps.
Displays the version number and note that the TV app is only licensed for Personal Live Use.
See Live Use for further information.
Select this to choose whether any text is displayed on screen or not (which also depends on the selected Randomization Scheme14, as some simply do not show text). The text can be Cut-up or TTM text, depending on the Randomization Scheme14.
Select this to choose a toggle value of 'Continuum' (default) or 'Repeat'. If set to Continuum then every few minutes (how long a mix will be is a setting that is defined in the selected Randomization Scheme14) a new mix will be generated. If set to 'Repeat' that the current mix will be restarted when it reaches its end rather than a new one being generated.
Select this to display a list of available sleep times ranging from 'Off' to '8 hours'. Select the one you want to return to the Settings menu. When there the Sleep Timer is on the Sleep Timer icon looks more solid.
Select this to display a list of built-in Randomization Schemes. Amongst other things, these determine how long each generated mix will be. Select the Randomization Scheme you want to return to the Settings Panel.
Randomization Schemes are not editable in the TV Player.
Displays the App Name, being either "Wotja" for the free version or "Wotja Pro 20" for the paid-for version.
The Watch Player is a Wotja companion app for Apple Watch. It controls playback of Wotja on an iPhone and requires that the revelant version of Wotja is installed on your iPhone.
To use it, first load Wotja on your iPhone. If you then press the Play button (1) on the watch app it will by default start Flow mode (3) playing in the Wotja app for iPhone. You can use the Next button (2) to force a new mix to be created.
Alternatively, if in Wotja for iPhone you first select a Flow Scheme or a Box, a Playlist or Mix file (and then open it) the watch app can control play of that, including moving to the next mix (as relevant). The icon displayed in the File Type area (3,5,6,7,10) will depend on whether Wotja for iPhone in in Flow mode, or has a box/album, playlist or mix file open.
Tap this to start or stop play of Wotja on your iPhone.
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.
Indicates that your Wotja for iOS app is playing in Flow mode.
This will be either Wotja or Wotja Pro 20.
Displays the number of mixes in the playlist and the name of the playlist.
Displays the number of mixes in the box/album and the name of the box/album.
Displays the relevant icon and the name of the playing mix.
Icons can be as follows: 3, 5, 6, 7, 10Depending on what is playing the text next to this icon displays as follows:
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.
Displays the number of mixes in the album and the name of the box/album.
Documents > Mix File14 > Display Tab9
The Mix Player (see Quick Start) comprises a number of editing Modes but it can also be used toplay individual .wotja mix files.
To use Wotja as purely as a mix file player all you really need to know about are the Play/Stop button8 and Display tab9 in the Tab BarC, which is found in all the editing Modes (e.g. Music Mode, Text Mode and Display Mode).
Just to provide a general idea of the screen layout we show the Display Mode screen below and a few of the UI elements in it. For information on all of the controls in this screen, however, see Display Mode.
If you want to edit a mix then see the various editing Modes detailed in the next section of the User Guide.
UI Elements: Menu Bar buttons1,3,4.
UI Elements: See Display Mode for details.
UI Elements: Tab Bar buttons8,9. See Display Mode for further details.
Displays the Save Changes Menu pop-up (see below) before exiting to the Documents Screen.
Displays the name of the screen. This is "Display" as there is only one screen in Display Mode.
Displays the Action Menu pop-up.
Displays the Settings screen.
The text area can display either Cut-up, TTM text or no text at all. Refer to Display Mode for further details.
This displays either a solid colour, a screensaver or a background image depending on what has been selected in the Display Mode Background and Picture buttons. Refer to Display Mode for further details.
This is where the Watermark displays if the Settings > General > Show Watermark toggle is on.
Tap the tab to go to Music Mode.
This button is used to play/stop a mix and it is common to all Mix Player Modes (i.e. Music, Text, Display and Record).
Below the button is display the "Play Time Indicator". It shows time in two different ways:
Shows that you are in Display Mode.
Documents > Mix File14 > Music Tab23 (see Quick Start for how to create a Mix file)
Of the four Mix Player "Edit Modes" (Music, Text, Display, Record), the Music Mode is likely to be the most important for you. It is where you add/delete Templates to/from your mix Cells and edit all their Music (IME) parameters, Sounds & FX (ISE) parameters and Cell Rule related settings. You can also access the Cell Mixer and Track Mixer, edit Mix Rules & Mix FX - and so more....
The following Mode selectors, common to all the Edit Modes, are accessed via the Tab BarC:
The Menu Bar at the top of the screen has a number of buttons, 1,2,13,14.
The Toolbar, below the Menu BarA, houses a number of buttons including the Editor Panel selectors 5,7,10,11,12.
The Tab Bar at the bottom of the screen provide access to the Editing Modes 23,28,35,36 and a Play/Stop button32.
Shown to the left of the screen the Cells & Tracks panel is is where you access the Cells15 and Track Controls 24,25,26,27.
Tip: To select between a left panel display of One Cell, One Column or 4 Columns tap the Action Menu button and select one of the "Display" settings in the pop-up (see below).
Select the Editor you wish to use here with the Editor Panel selectors: Network Editor Panel5, Cell Mixer Panel7, Track Mixer Panel10, Cell Rules Panel11 and Mix Rules Panel12.
The Generator Editor panel is a sub-panel view of the Full Screen Generator Editor5. It can make it easy to edit all the parameter values for each of the Generators in the Cell without having to go full screen. Simply select the Parameter Group on the left hand side, and then edit parameters on the right.
See the IME Parameter List for info on all the available parameters.
Hide/Display the Panel: Generator Menu Button6 and selecting "Show/Hide Generator Editor Panel". Alternatively, tap on a Generator Button29 and select "Show/Hide Generator Editor Panel" from the pop-up menu.
Note: The two items below are only shown in the Full Screen Generator Editor.
The Generator Editor button area is where all the Generators buttons are shown. These can be used to access the Generator Editor.
See the IME Parameter List for info on all the available parameters.
The Synth & FX button area is where all the Synth & FX Buttons are shown. These launch the Synth & FX Editor.
See the ISE Synth & FX Units for info on all the available synth & FX units.
Displays the Save Changes Menu pop-up before exiting to the Documents Screen:
Displays the Randomize Menu pop-up:
Tap on this button to lock a column to force the play of all cells in that column; tap again to unlock it. Locking of a column only has effect on cells for a Track with Track Rule of type "Sequence" and where cells are not looped (i.e. no orange band).
In "One column" view (see Action Button13 > "Display: One Column", the column number shown at the top is that of the selected Cell15.
Tap the Grid button to pop up a menu where you can select from a number of useful actions.
Tip: you can also double tap a Cell for this pop-up menu.
See also: Generator Editor (shown as a sub-panel to right of this image).
For the selected Cell15, and ONLY if it contains generative content, the Generator Network Editor panel is where you can marry IME Generator Objects (note "Generators") to MIDI channels, ISE synth sounds and FX. The buttons in the network and associated ISE network all provide quick links to the underlying paramaters and editors.
Important: In any mix Cell from Wotja V20.1.5 onwards, all Template parameter settings (e.g. IME and ISE etc.) and user edits made to them are saved to the Cell. This is so that the mix will work as intended whether or not the underlying Template is accessible in the file system. For more info see this FAQ.
See also: IME Parameter List.
Tap on this button (and/or right click in the Desktop version) and it will display the pop-up menu below:
See also the Intermorphic Music Engine (IME) Guide for details on what the parameters do.
This is where you can easily change the volume and pan levels within the Cell and solo/mute each Generator.
Tip: To mix tracks against each other use the Track Mixer Panel10.
Tip: Double tap a slider for a pop-up menu where you can manually enter a value.
The name of the open mix file.
Tap the button for the Synth & FX editor where you can add/edit FX Networks for the WHOLE Cell.
This 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 Cell Mixer Panel7.
Tip: Double tap a slider for a pop-up menu where you can manually enter a value.
The "Cell Properties" panel is where, amongst other things, you can easily set the parameters that define how a Cell will play, as well as the rules used for the content in that Cell.
Tip: For general rules that apply to the whole Mix (such as Mix Rules, Tempo, Root, Ramp Up/Down as well as Playlist Duration settings) see the Mix Rules panel.
Tip: If you are going to be making your mix or piece available for others to use, you may well wish to include your own copyright statement for each Cell in the mix. Each Generator within a Cell can also have its own copyright statement.
For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.
0-99 (Default value - 0): Sets the range that applies to the above base value.
Various (Default value - Mix: Default): When the cell is playing any active rule element will flash; the colour is that of the Generator type of the playing Generator. To edit or change the Cell Scale Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.
For information on Scale Rules and included "Standard Rule Values" refer to Scale Rule Object.
Various (Default value - Mix: Default): When the cell is playing any active rule element will flash; the colour is that of the Generator type of the playing Generator. To edit or change the Cell Level Harmony Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.
For information on Harmony Rules and included "Standard Rule Values" refer to Harmony Rule Object.
Various (Default value - ? [Use Random Cell Rule]): When the cell is playing any active rule element will flash; the colour is that of the Generator type of the playing Generator. To edit or change the Cell Rhythm Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.
For information on Rhythm Rules and included "Standard Rule Values" refer to Rhythm Rule Object.
Various (Default value - Mix: Default): When the cell is playing any active rule element will flash; the colour is that of the Generator type of the playing Generator. To edit or change the Cell Next Note Rule (which can be overridden at Generator level), tap on it to go to the Rule Editor screen.
For information on Next Note Rules and included "Standard Rule Values" refer to Next Note Rule Object.
The "Mix Properties" panel is where you can easily set the parameters that define how a Mix will play (Mix FX, Root, Tempo, Mix Rules [if used] and also how you can get text to automatically change (Automatic Text Change group).
The Mix Tempo, Mix Root and Ramp Up/Down settings apply to both a mix and/or that mix in a Playlist.
The Duration/Duration Range are specific to that mix only in Playlists.
Tip: If you are going to be making your mix or Template available for others to use, you may well wish also to include your own copyright statement for each Generator in the mix as it can also have its own copyright statement.
For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.
Displays the Action Menu pop-up:
Takes you to the Wotja Settings screen.
Cells are at the heart of Wotja.
Tap a Cell to select it.
Tap an empty Cell or its empty Network Panel5 (which will display "Tap here to browse Templates) to display the Templates List from which you can select and add a Template. Templates include 1 or more Generators.
Double-tap a populated Cell to display the Templates List where you can select a Template to replace the Cell contents or to merge into the existing Cell content.
Selected Cell: When a Cell is selected the border of the cell takes on an orange colour. A light blue background is shown at the top of the Cell when in Editor Panels5, 7,10 and at the bottom of the Cell when in Editor Panel11. There is no background shown when in Editor Panel12.
You can choose whether the panels shows either 1 Cell, a Column of Cells or 4 columns of Cells by using the Action Button13 and selecting the relevant "Display" option from the pop-up menu.
The icon at the top of a Cell shows the content that is in it:
This is always the name of the Template that was first added to the Cell. The name is not editable
Tip: If you wish the Cell to show a different name then you could export that Cell as a Template, giving it the name you wish, and then re-load that new Template.
The middle of a Cell displays the Cell Status band and its green colour indicates the following:
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.
X+Y
where X is the set minimum value and Y is the set range.X/Y
where X is the calculated minimum and Y is the calculated range value.The middle of a Cell displays the Cell Status band and within that is the name of the file in the Cell. The orange colour of this band indicates the following:
The Cell includes a MIDI file.
The Cell includes an Audio file.
The Tab that selects Music Mode.
Note: There are two ways to trigger a Cell or to start/stop it looping.
Tap this button to go into the Synth & FX editor where you can add Track FX.
Tap to mute or unmute the related Track.
Tap to solo or unsolo the related Track.
Takes you to Text Mode.
See also: Parameter List.
Tap on a Generator button to select that Generator. If the Generator Editor panelF is displaying then you will see the parameters for that Generator and can edit them straight away in that panel.
Tip: Double tap the button to display a pop-up menu (for details see the Generator Menu button6).
To assign a MIDI channel to a Generator, tap/hold the Generator button and drag it to a MIDI channel box.
The MIDI channel box is an indicator (it shows the MIDI channel number); it is not a button. However, you can tap/hold a Generator button and drag it to a MIDI channel box.
Note: The Generator "IME Patch" parameter (see Generator Editor) defines which MIDI Patch command to send for each MIDI channel. If you are using Wotja to drive any 3rd party MIDI synth/gear it is therefore recommended that all Generators on the same MIDI channel should use the same Patch parameter.
Note: MIDI Channel 10 is reserved for the Drum instrument. Every Generator with a Drum Patch, should generally be attached to MIDI Channel 10.
This button is used to play/stop a mix and it is common to all Mix Player Modes (i.e. Music, Text, Display and Record).
Below the button is display the "Play Time Indicator". It shows time in two different ways:
If the "ISE for Sounds & FX" toggle is checked in the Settings screen, then MIDI events are routed for each channel through an ISE Synth configuration. Tap on the Synth button for the Synth & FX editor.
Note: If there is no Synth network defined then the ISE will use its built-in MIDI Wavetable synth (using the Patch defined by the Generator's Patch parameter).
The output from every Synth box can be passed through a custom FX Network. If you want to use an FX on a Generator, click the FX button to invoke the Synth & FX editor.
Takes you to Display Mode.
Takes you to Record Mode.
The Generator Editor is where you can edit all the parameter values for each of the Generators in the Cell. It can be used full screen (as shown above) or as a sub-panelF in the Network Editor panel5.
Full Screen Editor: In the Network Editor panel5 tap the Generator Menu button6 or double tap on a Generator Button29 and selecting "Edit" from the pop-up menu.
UI Elements: 1,4,5,6.
Tap to accept your changes and exit the Generator Editor
Tap for a pop-up list of the Generators in the Cell. Select the Generator you want to edit.
Shows the Template Name, MIDI Channel, Track Number and Cell Column being used by a Generator.
See also: IME Parameter List.
Shows the name of the current screen.
Undo the last parameter change you have made.
Redo the last parameter change you have made (i.e. perhaps after an Undo).
To make it easier to understand what each IME Parameter is for, related Parameters are grouped together into "Groups".
Tap on the Parameter Group in the Parameter Groups List to have the Parameter List scroll to show it at the top.
Tip: Tap "Basics" to scroll the Parameter Values panel to the top so you can see the Generator name.
See also: IME Parameter List.
The selected Parameter Group shows with a light blue background colour.
See also: IME Parameter List.
Tap the Parameter Group selector to select your desired Parameter Group.
See also: IME Parameter List.
The Generator Editor is only available in Music Mode.
There are a number of different Parameter Edit Controls and these include: sliders, toggles, disclosure buttons.
See also: IME Parameter List.
Shows the Generator Type. Tap for a pop-up list where you can change it if you want to.
See also: IME Parameter List.
Shows the name of the Generator. Tap to edit it.
See also: IME Parameter List.
When you select a parameter group in the left column then the Parameter List will scroll so that the Parameter Group Header is at the top. Swipe up / down in this panel to scroll up or down.
Note: For a better (visual) understanding of how all the Generator Objects in a Cell are associated with MIDI channels and how these Generators are linked to each other (e.g. Following Generators [below], where one Generator follows the output of another) then see the Wotja Generator Network Editor.
See also the Generator Editor.
Every Wotja Mix Cell includes one or more "Generator" Objects. There are 7 "types" and each generates MIDI notes and events according to various parameter values:
Tip: The Generator button will flash when the Generator plays.
Note: For historical reasons these used to be called "Voices".
See also the Rule Editor and Mix Rules and Cell Rules.
Every Generator composes notes according to the settings of 4 types of Rule Objects it has associated with it: Scale Rule, Harmony Rule, Next Note Rule, Rhythm Rule. Each Rule Object contains one or more "Rules", such as "Major" or "Minor".
Each Rule is an array of the values of the elements for that Rule Object (such as the values of 24 scale intervals). These values represent the relative probability (from 0% to 100%) (the "weighting") of that Rules' element being chosen by a Generator for a note to be composed. An element with a value of 0 will not be chosen for composition.
Important: When the Pitch Range for a Generator is wide enough, Scale Rules will "wrap around" to accomodate the extra range in notes available.
Changes to the values in these Rules, as with changes to any other IME parameter, allows an instant change in the music generated.
Tip: Where the interface displays the Rule elements, tap or click one one at the appropriate position to change the value of that element; the IME will attempt to make that element flash when it has been selected to play a note.
A "Rhythmic" Generator is the default Generator Type. It composes according to the parameters in the "Basics" Parameter Group. The group has this name because the parameters in it (e.g. MIDI Channel, Patch etc) are common to and used by all Generators.
Tip: To best allow note durations to fit within the bar structure of a Cell, a Rhythmic Generator calculates them according to the Rhythm Rule it uses.
Every Generator in a Noatikl file has a unique name. You can use any name you want, provided it is not empty, and provided it is not a single question mark (which has a reserved meaning for use with Rules, which you will find out about later).
Toggle this setting (Yes/No) to mute or unmute the Generator. Certain Generator Types might take some time to respond, depending on how far in advance their notes are composed.
When the keyboard focus is on the Mute cell, you have various extra menu options available to you in the "Control" Menu. These are as follows:
If you hold down the ctrl key when you click on the mute cell, you will toggle all other Generator's mute states, without changing the mute state of the Generator that you ctrl-click on. This can be very handy.
A Generator emits data on a MIDI Channel. MIDI channels are numbered from 1 to 16. The default MIDI channel for a Generator is actually MIDI channel 0 – which tells the IME to assign a free channel from 1 to 16 automatically, as best it can. MIDI channel 10 is always reserved for percussion sounds, such as drum sounds or other untuned sound.
Not all software synthesizers for your favourite sequencer like having Patch data supplied to them via a Patch Change MIDI event. If this is the case, simply change the Send MIDI Bank/Patch? parameter to No (unchecked), and the IME won't send any MIDI patch change events.
Every Generator is assigned a given Patch. This specifies the sound that you will hear whenever the Generator plays a note. The exact sound you hear depends on the sound source you have associated with the Generator; this could be the ISE or you might be driving an external MIDI synth.
In general, the IME does not emit any MIDI bank select CC information for a Generator before it emits the Patch Change MIDI event. However, you can force the IME to emit such information, by typing-in a special format patch value; where you type-in the patch in the format: patch.msb.lsb, for example:
98.53.4
In this example, the IME will emit bank select CCs for both MSB and LSB according to the settings you supply (53 and 4 respectively, in this case). If you don't specify a value for the lsb, then the IME will only emit a Bank Select MSB CC (CC number 0). If you supply the lsb, then the IME will also emit a Bank Select MSB CC (CC number 32).
Set the Pitch to be the minimum pitch for which you want your Generator to compose. The IME will ensure that it composes no notes less than this pitch value.
Set the range of pitches in semitones above the Pitch which can be used for composition. The IME will ensure that it only composes notes with pitches between Pitch and Pitch + Pitch Range.
Set this to define the shortest possible sequence of notes that your Generator will compose in sequence. The Generator composes a sequence of notes, followed by a sequence of rests. The length of each sequence of notes is governed by this and the Phrase Length Range parameter.
This value defines the upper limit to the number of notes that your Generator will compose in sequence. For example, if the Phrase Length is 3, and the Phrase Length Range is 25, then the minimum phrase will be 3 notes, and the maximum phrase length will be (3+25) = 28 notes.
Set this to define the shortest possible sequence of rests that your Generator will compose. Your Generator composes a sequence of notes, followed by a sequence of rests. The length of each sequence of rests is governed by this and the Phrase Gaps Range parameter.
This value defines the upper limit to the number of rests that your Generator will compose in sequence. For example, if the Phrase Gaps is 3, and the Phrase Gaps Range is 25, then the minimum phrase will be 3 rests, and the maximum phrase length will be (3+25) = 30 rests.
This value defaults to zero. If not zero, then the defined percentage of notes that would otherwise be played by your Generator will instead be treated as a rests of the same duration. This is very useful for making any Generator sound sparser. Give it a go: this parameter is very powerful, and applies to all Generator Types.
Tip: See also Rhythmic for the common "Basics" Generator parameters.
An "Ambient" Generator does not use the Rhythm rule for note durations but instead use durations defined by the specialist parameters in the Ambient parameter group. This is to allow them to generate notes without respect for tempo or bar timings. They are wonderful for creating drifting, floating sounds for either background or foreground use as drones or for musical texture.
You define the Unit of Measure for which the other Ambient Generator parameters are interpreted. This may be one of the following values:
The parameters including Duration are all interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Duration value of 1000 means one second.
The parameters including Duration are all interpreted as being in 60ths of a beat. In the IME a Beat is defined as being one crotchet; you get 4 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet. A Duration value of 15 means a semi-quaver. A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).
The parameters including Duration are all interpreted as being in seconds. So, a Duration value of 10 means ten seconds.
The Ambient Generator parameters govern how Ambient Generators work.
This defines the minimum duration for which the Ambient Generator will play when it composes a note. The actual value chosen for each note is a value between Duration, and Duration plus the Duration Range. Each and every note composed for this Ambient Generator will have a note whose duration is separately calculated.
This is combined with the Duration parameter, to determine the duration for which the Ambient Generator will play when it composes a note. The actual value chosen for each note is a value between Duration, and Duration plus the Duration Range. Each and every note composed for this Ambient Generator will have a note whose duration is separately calculated.
This defines the minimum duration for which the Ambient Generator will play when it composes a rest. The actual value chosen for each rest is a value between Gap Minimum, and Gap Minimum plus the Gap Range. Each and every rest composed for this Ambient Generator will have a rest whose duration is separately calculated.
Tip: This is the Duration used for the Phrase Gaps / Phrase Gaps Range parameters i.e. it allows the duration of gaps to be different to that of the notes.
This is combined with the Gap Minimum parameter, to determine the duration for which the Ambient Generator will play when it composes a rest. The actual value chosen for each rest is a value between Gap Minimum, and Gap Minimum plus the Gap Range. Each and every note composed for this Ambient Generator will have a note whose duration is separately calculated.
Tip: This is the Duration Range used for the Phrase Gaps / Phrase Gaps Range parameters i.e. it allows the duration of gaps to be different to that of the notes.
A "Follower" Generator is used in a call-response manner, allowing it to follow the behaviour of other Generators according to parameters in the "Following" Parameter Group.
In the Cell, select the Generator which you want your "Following" Generator to follow - you may follow any Generator of any type. You may even follow a Generator that follows another Generator that follows another Generator... provided that you don't try to define a cyclic dependency which loops back to the current Generator! If you don't specify a Generator to follow then it won't play.
Important: If you follow a Generator that is using the Chords parameter (i.e. to create more than one note), then only the first note in the chord is followed.
This parameter simply allows you to select another Generator in the Cell for your "Following" Generator to follow.
This parameter sets the percentage of notes that the Followed Generator responds to so as to emit a note. Set to 100 if you want the Following Generator to emit a note for every note played by the Followed Generator. Set to a smaller value if you want to thin-out the notes played by the Following Generator. This is also useful for building networks of chords, where if you have a number of Following Generators all following either each other or one main Generator, and if those Following Generators have the Percent Parameter to less than 100, then sometimes you will hear dense chords, and sometimes you will hear thinner chords.
This parameter defines the pitch to use for a note generated by the Following Generator. The available values are:
This causes the Following Generator to choose notes which respect the currently defined Scale, Harmony and Next Note Rules.
This causes the Following Generator to choose notes which are offset from the followed note, such they are at an interval within the Scale Rule, defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.
For example, if these values are 1 and 2 respectively, then each time a note is chosen, it will be between 1 and (1+2)=3 Scale Rule intervals up from the Followed Generator's note. It is important to understand that this refers to the non-zeroed elements in the current Scale Rule, in other words only those notes that are available within the Scale Rule.
So, in our example, if we were using a Major Scale Rule, and if the followed note were C4 (Middle C), and if Noatikl chose a value of 2 as its random value; then the played note would be E4 (Middle C), which is the second note up from Middle C within the Major Scale Rule.
This causes the Following Generator to choose notes which are offset up from the followed note, such they offset from the followed note by a number of semitones which is a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values. A note chosen in this way ignores the current Scale Rule.
For example, if these values are 1 and 2 respectively, then each time a note is chosen, it will be between 1 and (1+2)=3 semitones up from the Followed Generator's note.
So, in our example, if we were using a Major Scale Rule, and if the followed note were C4 (Middle C), and if Noatikl chose a value of 3 as its random value; then the played note would be D#4 (Middle D#), which is the third semitone note up from Middle C. This value is used even though it is not in the current scale rule.
You define the Unit of Measure by which the Delay and Delay Range parameters are interpreted. This may be one of the following values:
The parameters including Duration are all interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Duration value of 1000 means one second.
The parameters including Duration are all interpreted as being in 60ths of a beat. In Noatikl a Beat is defined as being one crotchet; you get 3 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet. A Duration value of 15 means a semi-quaver. A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).
The parameters including Duration are all interpreted as being in seconds. So, a Duration value of 10 means ten seconds.
This defines the minimum delay after which the Following Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Following Generator will have a note whose delay is separately calculated.
This is combined with the Delay parameter, to determine the delay after which the Following Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Following Generator will have a note whose delay is separately calculated.
Used when the Strategy is either Interval Within Scale Rule or Semitone Shift.
This causes the Following Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift/Interval and Shift/Interval plus Shift/Interval Range values.
This represents the "Shift/Interval Range", and is used when the Strategy is either Interval Within Scale Rule or Semitone Shift.
This causes the Following Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift/Interval and Shift/Interval plus Shift/Interval Range values.
"Repeater" Generators are like "Rhythmic" Generators, with the added feature that they can be defined to repeat notes that they have composed in previous bars, according to rules defined in the Repeat Parameter Group. When not repeating previous bars, Repeater Generators compose as if they were of Rhythmic Generator Type.
You define the name of the Generator from which you would like, from time-to-time, to repeat past bars of music. If you simply want to repeat bars played in the past for the current Generator, simply select the magic value of '?', which is also the default value.
When the Generator starts composing a new bar, it takes a look at this parameter value. This defines for what percent of the time the Generator should repeat previously-composed music. Set this parameter to 100 if you always want past composed music to be repeated (where available!); set to 0 if you never want past music repeated by this Generator. When the Generator doesn't choose to repeat past data it composes a new bar of music were it to be of Rhythmic Generator Type.
Defines the number of bars for which the Generator should repeat a past-composed chunk of music. The actual value chosen is somewhere between Bars and Bars + Bars Range.
Defines the upper limit of the number of bars for which the Generator should repeat a past-composed chunk of music. The actual value chosen is somewhere between Bars and Bars + Bars Range.
Defines the number of bars in the past, from which the Generator will choose the past-composed music to repeat. The actual value chosen is somewhere between History and History + History Range.
Defines the upper limit of the number of bars in the past, from which the Generator will choose the past-composed music to repeat. The actual value chosen is somewhere between History and History + History Range.
"Patterns" Generators generate notes from various fixed MIDI-like patterns. These patterns have a specific syntax, are able to follow generative sequencing rules and can adapt automatically to changes in Scale Rules. They are great for bringing some structure to your composition. Patterns Generators are capable of mutating their patterns while playing, according to parameters defined in the Patterns Parameter Group. When mutating a pattern, Patterns Generators compose as would a Rhythmic Generator.
The "Pattern" parameters govern how Pattern Generators work. Pattern Generators compose as if they were of Rhythmic Generator Type. Generators using TTM (Text to Music) Generators still use the Pattern Generator Type, as TTM is a subtype of that. The easiest way to use them is in the Wotja Pattern Editor.
For details on the Pattern Syntax see the IME Pattern Syntax section.
The pattern syntax is somewhat complicated and will require a bit of effort to get to grips with. Even if you do wish to use it, we still recommend that you first use the Wotja Pattern Editor to familiarise yourself with patterns and how they work.
A pattern is a text string in a specific format, surrounded by < and > symbols. Patterns can be grouped together as list of patterns. Because of this we refer to patterns as a "Pattern" when there is only one, or as "Sub-Patterns" when there are many in the list of patterns. We know it is a bit confusing, so we'll say it again in another way: each Pattern is made-up of a number of Sub-Patterns.
There are 4 types of Pattern:
The IME employs an underlying "time unit" that is 1/60th of a crotchet/quarter note. IME note Duration values map onto standard music notation in the following way (irrespective of meter) [# IME time units - Composed note length]:
So by way of example:
You are of course free to experiment using other time unit values, which will mean different things. E.g. 10 time units is a 24th note etc.
Tip: To aid understanding and visual clarity, we use the following color coding: durations, velocity values and scale intervals.
Where:
See above for note duration values.
In R patterns a negative duration indicates a rest for that time; in F patterns a pitch of -1 indicates a rest for the note duration.
If a note sub-pattern is not an exact even number of bars (e.g. 2 and and half bars at the current meter!) then the engine will pad to silence to the end of the nearest bar boundary.
Syntax
<[S][prob][.M] R {[seqnum[-seqnumrange].[repeattimes[-repeattimesrange]] [seqnum[-seqnumrange].[repeattimes[-repeattimesrange]]}* >
Where:
Which sub-pattern is chosen by the Generator depends on a few things:
If there is at least one sequenced sub pattern, then a sequence is used to drive the sub-pattern. Which sequence to use, is based on the Generator making a weighted random selection from the available sub-patterns. When (if!) the sequenced sub-pattern end is reached, the Generator will make another selection as to which sequenced sub-pattern to use.
Otherwise, a sub-pattern is chosen, based on the Generator making a weighted random selection from the available sub-patterns. This sub-pattern is played through to the end, at which point the Generator will make another selection as to which sub-pattern to play.
A Note Sub-Pattern that is less than a whole number of bars at the Generator's current Meter, will be padded automatically with silence to ensure that it remains bar synchronised.
The IME has its own pattern format, which allows it to play specified notes and rests in different ways. Patterns are affected by the various Rules being used by the Generator.
Tip: To aid understanding and visual clarity in the examples, we use the following color coding: durations, velocity values and scale intervals.
Below are a number of example patterns. Copy and paste these into Noatikl to try them out.
Rhythm: <100 R 60 60 60.127 60>
Both: <100 B 60.15-30 1 60 2 60.127 3 15 7>
Forced Frequency: <100 F60 60.127 1 60 4 30 5 15.70-120 7>
Sequence: <S100.M R 1.1 2-0.1-0 3-0.1-0 >
Two patterns. Select randomly from these two each time!
<100 B 60 1 60 2 60 3 60 4>
<100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>
Forced Frequency pattern. Plays note with pitch 58 (or MIDI patch 59 on Ch10): note on, note off, note on, note off etc.
<100 F58 15 1 45 -1 15 1 45 -1 15 1 45 -1>
Forced Frequency pattern: Plays a series of notes for a whole bar (or patches in the drum kit on Ch10) starting at base pitch 40, each one a 16th note...
<100 F40 15 1 15 7 15 6 15 13 15 2 15 8 15 4 15 11 15 13 15 2 15 8 15 2 15 2 15 8 15 4 15 14>
Two sequenced sub-patterns. Play 1 once, then 2 once...
<S100 R 1.1 2.1>
<100 B 60 1 60 2 60 3 60 4>
<100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>
Two sequenced sub-patterns. Play 1 twice, then 2 twice...
<S100 R 1.2 2.2>
<100 B 60 1 60 2 60 3 60 4>
<100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>
Two sequenced sub-patterns. Play 1 or 2 twice, then 1 or 2 twice...
<S100 R 1-1.2 1-1.2>
<100 B 60 1 60 2 60 3 60 4>
<100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>
Two sequenced sub-patterns. Play 1 once, then 2 twice, the one or 2 once, then 2 once...
<S100 R 1.1 2.2 1-1.1 2.1>
<100 B 60 1 60 2 60 3 60 4>
<100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>
Two sequenced sub-patterns. Play 1 once, then 2 forever...
<S100 R 1.1 2.0>
<100 B 60 1 60 2 60 3 60 4>
<100 B 30 9 30 8 30 7 30 6 30 5 30 4 30 3 30 2>
When the Generator starts a new sub-pattern at the start of a bar, it consults the value you have defined for Use Percent. This parameter determines the probably of the Generator using the Pattern for the bar; or alternatively, compose a completely new bar (that you will hear only once!) were it to be of Rhythmic Generator Type.
If Use Percent is 100, then the Generator will always use the pattern. If Use Percent is 50, then teh Generator will instead compose a new bar every other bar or so. Note that the Generator will never interrupt a sub-pattern that it is playing; the Use Percent parameter is considered only on a sub-pattern boundary, at the start of a new bar.
The mutation factor is used when a bar is considered for mutation (which can happen only if Bars Between is not zero! The Mutation Factor determines the level of mutation to apply. If set to 10.0%, then when playing from a sub-pattern, this means that each note that would be played from the pattern, has a 10% chance of having a different one composed, with subsequence pattern playbacks keeping that mutation. Note that if Mutate Rhythm? is set to Yes, then if the composed note is longer than the composed-over pattern note, this might overlap and cancel-out some other notes in the sub-pattern.
This parameter defines the number of bars that the Generator waits between, before trying to mutate a bar in a pattern according to the Mutation Factor. If Bars Between is set to zero, the Generator can never mutate. Set to 1 if you want mutation every bar, 2 if you want mutation every other bar, etc. ...
The actual number of bars used is selected randomly each time, somewhere in the range from Bars Between, to Bars Between plus Bars Range.
This parameter is used to help define the number of bars between attempts by the Generator to mutate the current pattern. The actual number of bars used is selected randomly each time, somewhere in the range from Bars Between, to Bars Between plus Bars Range.
If set to No, then the timing of the sub-pattern is preserved perfectly; only the frequency of the pattern notes will be changed when the pattern is mutated. Otherwise, the duration of each note is chosen from the rhythm rules and phrase/phrase gap rules for the Generator.
Defines the Meter to be used by the Generator, such 4:4 or 3:4 or 6:8. A value of ?, which is the default, means to use the Meter defined for the Cell. A different value allows the Generator to work with a completely different meter, which can be used for interesting polyphonic effects.
"Text to Music" Generators are new Generator Type in V20. Text to Music Generators have their own special set of parameters and allow text in any language to generate a seed melody which, even though not visible, is in a Pattern syntax. Use English, Chinese, Japanese, Russian, German, French - whatever language takes your fancy, you will always get a melody!
The selection you make here determines what text is used for TTM. If you select one of the Cut-up options then text from your mix Cut-up will be displayed in the TTM Text field below and will overwrite any existing Custom text. Note that if there is no text available in a selected line of Cut-up then the TTM Generator will have no text to work with.
This is the text in any language used to generate your TTM seed melody. In general it takes 2 characters to generate a note. Note that if your text is < 6 characters (e.g. Hello, which is 5 characters), we turn it into HelloHello ... which makes it sufficiently long to make at least 3 notes (that actually generates a few more). In Wotja, tap on this field to go to the TTM Text Editor screen.
The Display? toggle determines if your TTM text will display in Fullscreen mode.
If this is toggled ON, and IF in Display Mode you have selected Text > Show Text from TTM Generators then the TTM Text above will display on screen when in Full Screen or in Display Mode. If it is OFF, then it will not display.
The total number of times the original melody or a variation of it is played. This also applies to improvised melodies (see Improvise toggle).
Sets the range above the minimum. Also applies to improvised melodies (see Improvise toggle).
From the notes composed, set the first note you want your tune to start playing at. Maximum value is Notes - 1.
From the notes composed, set how many notes will play. Maximum value is Notes - Tune Start at Index.
Defines the minimum number of notes there are in a "phrase" (and you can see in the indicator above how many notes your text has generated - all of these notes get put into phrases to make the "tune").
Sets the range above the minimum.
Defines the minimum number of rests between each phrase (allows a tune to breathe). Rests are measured in terms of 16th notes.
Sets the range above the minimum.
Defines the minimum number of rests between each play of the tune (allows a tune to breathe). Rests are measured in terms of 16th notes.
Sets the range above the minimum.
Turn this on to let Wotja continuously generate tune variations after the FIRST complete play (and repeats) of the tune. When this is on, Wotja can "noodle" for ever (well, until you turn it off or the Sleep Timer kicks in, if set!).
Tip: If you have this set to ON and Variation (below) set to 0, then the TTM melody will continue to repeat for ever.
Selects how much variation is applied to the previous melody when improvising.
A "Listener" Generator detects a monophonic (not polyphonic) incoming MIDI note event on its MIDI channel and presents it as a virtual composed note. It will only detect a subsequent note if it first receives a note off for the previous note.
To generate sound via the ISE it needs to be followed by a Follower Generator. Used like this, Listener Generators allow you to create simple hyperinstruments where external input can influence the music that is generated. Such music is also referred to as Adaptive Generative Music [AGM].
Listener Generators do not have any special parameters, which is why there is no special Parameter Group, and nor do they require any use of scripting. However, they can be used with Intermorphic Wotja Script to create more advanced hyperinstruments.
When an incoming MIDI note is detected, e.g. C60, then:
The virtual note created by a Listener Generator is pitch shifted, if necessary, to fit within the band of pitch values set by its Pitch and Pitch Range parameters (see Rhythmic Generator).
The Chord parameters let you configure any Generator Type to generate chords automatically.
In outline, use the Depth and Depth Range values to define the "Chord Depth"; which is the number of notes that will play at any one time for a given Generator. The first note in any chord is composed according to the normal mechanism for the Generator Type; additional notes that cause a chord to be built-up may be generated automatically according to the Chord parameters.
Specify the minimum Depth of chord that you want your Generator to play with. A value of 1 will mean that the Generator will not chord (unless the Depth Range parameter is greater than zero).
The Depth defines the number of notes that are played by the Generator at any one time.
Specify the relative maximum Depth of chord that you want your Generator to play with. A value of 0 means that whenever the Generator is played, it will play a number of notes equal to the Depth. A value of one or more means that whenever the Generator is played, it will play a number of notes equal to a randomly selected value between the Depth and the Depth plus the Depth Range.
This parameter tells the Generator the percentage chance that it should actually emit any given note in the chord (after the first note, of course!). Set to 100 if you want the Chording Generator to always emit a note for every note played by the Generator. Set to a smaller value if you want to thin-out the notes played within the chord. This allows you to create chords of varying depth; sometimes dense, sometimes thin.
This parameter tells the Generator what it should do when it decides the pitch to use for a note generated within a chord. The available values are:
This causes the Generator's chord notes to be selected according to the currently defined Scale, Harmony and Next Note Rules.
This causes the Generator's chord note to be selected offset from the followed note, such they it is at an interval within the Scale Rule beyond the previous note in the chord, defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.
For example, if these values are 1 and 2 respectively, then each time a note is chosen within the chord, it will be between 1 and (1+2)=3 Scale Rule intervals up from the previous note in the chord. It is important to understand that this refers to the non-zeroed elements in the current Scale Rule, in other words only those notes that are available within the Scale Rule.
So, in our example, if we were using a Major Scale Rule, and if the first note in the chord were C4 (Middle C), and if the Generator chose a value of 2 as its random value; then the played note would be E4 (Middle C), which is the second note up from Middle C within the Major Scale Rule.
This causes the the Generator's chord note to be selected offset up from the previous note in the chord, such it is offset from the previous chord note by a number of semitones which is a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values. A note chosen in this way ignores the current Scale Rule.
For example, if these values are 1 and 2 respectively, then each time a note is chosen, it will be between 1 and (1+2)=3 semitones up from the previous note in the chord.
So, in our example, if we were using a Major Scale Rule, and if the previous note in the chord were C4 (Middle C), and if the Generator chose a value of 3 as its random value; then the played note would be D#4 (Middle D#), which is the third semitone note up from Middle C. This value is used even though it is not in the current Scale Rule.
You define the Unit of Measure by which the Delay and Delay Range parameters are interpreted. This may be one of the following values:
The parameters including Duration are all interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Duration value of 1000 means one second.
The parameters including Duration are all interpreted as being in 60ths of a beat. In the IME a Beat is defined as being one crotchet; you get 3 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet. A Duration value of 15 means a semi-quaver. A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).
This works the same way as Beats (60ths of a) except that where the Delay has a special value of 10, 15 or 20; the delay is interpreted in a special way that is very useful for some breakbeat-based music. Specifically, in this case, the calculated value for the delay is rounded to the nearest sub-multiple of the Delay value. So, for example, if the engine calculates a value of 43, and if Delay is 20, the used value for the delay is actually 40 (which is the nearest multiple of 20).
This defines the minimum delay after which the Chording Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Chording Generator will have a note whose delay is separately calculated.
This is combined with the Delay parameter, to determine the delay after which the Chording Generator will play a followed note. The actual value chosen for each note is a value between Delay, and Delay plus the Delay Range. Each and every note composed for this Chording Generator will have a note whose delay is separately calculated.
Used when the Strategy is either Interval Within Scale Rule or Semitone Shift.
This causes the Chording Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.
This represents the "Shift/Interval Range", and is used when the Strategy is either Interval Within Scale Rule or Semitone Shift.
This causes the Chording Generator to choose notes which are offset in some way from the followed note, according to the Strategy; where the offset is defined as a value randomly selected between the Shift / Interval and Shift / Interval plus Shift / Interval Range values.
This parameter defines the amount that the pitch of each note in the chord should be offset, in semitones, from the previous note in the chord; the actual value selected might be overridden according to the various rules that apply to the Generator, but in general, this parameter allows you to "shape" a chord to have a given range of pitch values. In combination with the Delay-related parameters, this allows you to create some very interesting arpeggiation effects.
For example, a value of +12 would tend to space each note in the chord by a range of 12 semitones (which is one octave), with each subsequent value in the chord being higher in pitch that the previous.
For example, a value of -12 would tend to space each note in the chord by a range of 12 semitones (which is one octave), with each subsequent value in the chord being lower in pitch that the previous.
This parameter allows you to specify the range of relative velocities for the notes in a chord. Each subsequent note in the chord is the defined percentage louder (for a positive value) or quieter (for a negative value) than the previous note in the chord. A value of zero means that all notes in the chord are played with the same velocity.
The Generator velocity envelope values are ignored when this parameter is applied.
For example, a value of -30 would tell the Generator to generate its chords such that each auto-chorded note is 30% quieter than each preceding note in the chord; giving a noticeable tailing-off effect.
See also the Rule Editor.
The Generator Rule parameters let you select the various rules that govern how your Generator works. The Rules themselves are edited in the relevant Rule Object. See Rule Objects.
See also: Rule Editor and See Rule Objects; Standard Rule Values
Each Generator composes according a Scale Rule. The Rule defines both the notes in the musical scale that are available for use and the note probability weightings.
Scale Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.
Scale Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.
The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):
Scale Rule Name | Element Values |
---|---|
Default | 1 0 0.5 0 1 0.5 0 1 0 0.5 0 0.5 |
All Scale Major | 1 0 1 0 1 1 0 1 0 1 0 1 |
All Scale Minor Natural | 1 0 1 1 0 1 0 1 1 0 1 0 |
All Scale Minor Harmonic | 1 0 1 1 0 1 0 1 0 0 0 1 |
Chord Major triad | 1 0 0 0 1 0 0 1 0 0 0 0 |
Chord Major sixth | 1 0 0 0 1 0 0 1 0 1 0 0 |
Chord Dominant seventh | 1 0 0 0 1 0 0 1 0 0 1 0 |
Chord Major seventh | 1 0 0 0 1 0 0 1 0 0 0 1 |
Chord Augmented triad | 1 0 0 0 1 0 0 0 1 0 0 0 |
Chord Augmented seventh | 1 0 0 0 1 0 0 0 1 0 1 0 |
Chord Minor triad | 1 0 0 1 0 0 0 1 0 0 0 0 |
Chord Minor sixth | 1 0 0 1 0 0 0 1 0 1 0 0 |
Chord Minor seventh | 1 0 0 1 0 0 0 1 0 0 1 0 |
Chord Minor-major seventh | 1 0 0 1 0 0 0 1 0 0 0 1 |
Chord Diminished triad | 1 0 0 1 0 0 1 0 0 0 0 0 |
Chord Diminished seventh | 1 0 0 1 0 0 1 0 0 1 0 0 |
Chord Half-diminished seventh | 1 0 0 1 0 0 1 0 0 0 1 0 |
Chord Augmented major seventh | 1 0 0 0 1 0 0 0 1 0 0 1 |
Chord Seven-six | 1 0 0 0 1 0 0 1 0 0 1 0 |
Chord Mixed-third | 1 0 0 1 1 0 0 1 0 0 0 0 |
Chord Suspended fourth | 1 0 0 0 0 1 0 1 0 0 0 0 |
Chord Dominant ninth | 1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 0 0 0 0 0 0 0 0 |
Chord Dominant eleventh | 1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 0 0 0 0 |
Chord Dominant thirteenth | 1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 1 0 0 0 |
Chord Seventh minor ninth | 1 0 0 0 1 0 0 1 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 |
Chord Seventh sharp ninth | 1 0 0 0 1 0 0 1 0 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 0 |
Chord Seventh augmented eleventh | 1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 0 1 0 0 0 0 0 0 |
Chord Seventh diminished thirteenth | 1 0 0 0 1 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 1 0 0 0 0 |
Chord Add nine | 1 0 0 0 1 0 0 1 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 |
Chord Add fourth | 1 0 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 |
Chord Add sixth | 1 0 0 0 1 0 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 |
Chord Six-nine | 1 0 0 0 1 0 0 1 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 |
Chord Suspended second | 1 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 |
Chord Jazz sus | 1 0 0 0 0 1 0 1 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 |
Mode Ionian (I) | 1 0 1 0 1 1 0 1 0 1 0 1 |
Mode Dorian (II) | 1 0 1 1 0 1 0 1 0 1 1 0 |
Mode Phrygian (III) | 1 1 0 1 0 1 0 1 1 0 1 0 |
Mode Lydian (IV) | 1 0 1 0 1 0 1 1 0 1 0 1 |
Mode Mixolydian (V) | 1 0 1 0 1 1 0 1 0 1 1 0 |
Mode Aeolian (VI) | 1 0 1 1 0 1 0 1 1 0 1 0 |
Mode Locrian (VII) | 1 1 0 1 0 1 1 0 1 0 1 0 |
Special Root only | 1 0 0 0 0 0 0 0 0 0 0 0 |
Special Scale Chromatic | 1 1 1 1 1 1 1 1 1 1 1 1 |
See also: Rule Editor and See Rule Objects; Standard Rule Values.
Each Generator composes according a Harmony Rule. The Rule defines how likely it is that a note for that Generator will harmonize at a given musical interval in semitones with any note already composed (and in use by) by any *other* Generator.
Harmony Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.
Harmony Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.
Example:
The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):
Harmony Rule Name | Element Values |
---|---|
Default | .35 0 0 .65 .85 1 .65 .65 .65 .1 .1 0 .35 |
All (one octave) | 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 |
All (two octaves) | 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 |
P1 | 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 |
P1 and P8 | 1 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 |
See also: Rule Editor and See Rule Objects; Standard Rule Values.
Each Generator composes note durations according a Rhythm Rule. The Rule defines how likely it is that a note for that Generator has a certain duration. This rule is combined with other factors, including the remaining length of time a Generator has left in the current bar (the IME tries to avoid having notes from non-Ambient Generators drifting across bar boundaries).
Rhythm Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.
Rhythm Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.
The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):
Rhythm Rule Name | Element Values |
---|---|
Default | .1 .25 1 .5 .5 .25 .25 0 0 |
All But Dotted | 1 1 1 0 1 0 1 1 1 |
Slow | 1 1 1 0 1 0 0 0 0 |
Fast Syncopated | 0 0 0 0 0 1 1 1 1 |
Fast Plain | 0 0 0 0 0 0 1 0 1 |
Very Slow | 1 0 .5 0 .25 0 0 0 0 |
Semiquavers Only | 0 0 0 0 0 0 0 0 1 |
MIddle | 0 1 0 1 1 1 0 1 0 |
All | 1 1 1 1 1 1 1 1 1 |
See also: Rule Editor and See Rule Objects; Standard Rule Values.
For each Generator's composed notes the Next Note Rule defines the distances in semitones available to be used between each note.
Next Note Rules can selected from the Standard Rule Values list (below) or can be a custom Rule you have created and named as you want.
Next Note Rules can be set at a Generator, Cell or Mix level - see the Rule Editor for details.
The following "Standard Rule" items are included (Note: Rule objects can be referenced in Wotja Script):
Next Note Rule Name | Element Values |
---|---|
Default | 0.25 1 1 .7 .3 .2 .1 .1 .1 .1 .05 .02 .05 0 0 0 0 0 0 0 0 0 0 0 |
All (one octave) | 1 1 1 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 |
All (two octaves) | 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 |
The default value for this parameter is "Yes", which means that the Generator will be considered for harmonisation with other Generators. Set to "No" if for some reason you do not want other Generators to harmonize with this Generator.
Normally, you want your Generator to use the Cell Root. This is represented by the value ? However, sometimes you really want to force your Generator to use a different Root note; in which case, set the Generator Root to be whatever value suits.
This allows you to work-around the following sort of problem:
Imagine that you have a sampler, wher you load-up a variety of loops against MIDI note C3 up to D3. To have your Cell drive this from a Rhythmic Generator such that the sounds you hear are not affected by changes to the Cell Root, you should set the Generator Root to e.g. C3 and your Generator will then be unaffected by changes to the Cell Root. Note that in this specific example, it would probably be a good idea to set the Harmonize? Flag to No.
The Generator Scripting parameter allows your Generator to use Intermorphic Wotja Script. For full details please refer to the Intermorphic Wotja Script Guide.
This Generator Comments parameters allow you to store comments in your Generator, in the form of copyright information and any notes you might want to make for future reference.
Enter the Copyright information you might want to record for the Generator. In the case of a Generator from a template pack, this might contain a copyright notice associated with that template.
Enter any detailed notes you might want to make about this Generator for future reference.
Important: A Generator's Articulation parameters apply to any/all notes it composes, be that via e.g. generative parameters, patterns or text-to-music.
The Generator Articulation parameters define the percentage of the duration of composed note, i.e. they determine how long a composed note actually plays for. A long time ago the IME used to compose notes to be played "Legato" (no gap between one note and the next) - this parameter allows you to play them with a shorter duration, e.g. staccato.
1 is very staccato and 100 is legato (the new default).
Max articulation is the value of Articulation (min) + Articulation range, and is used in combination with the variation values (below).
The minimum variation in staccato between notes, c.f. other parameters that adopt the min + range approach.
The range in variation of stacatto between the notes (in addition to the min).
The Generator Controllers parameters define some of the key MIDI controller values that are emitted by the Generator.
Set this value to other than the default of "-1", if you want to emit a Damper/Hold MIDI controller (MIDI CC 64) at the specified value on this Generator's MIDI line. This is a funny MIDI controller, with only two states; in that a value of 64 or greater activates Damper/Hold, and any value of 63 or less means to turn it off! Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.
Set this value to other than the default of "-1", if you want to emit a Harmonic Content MIDI controller (MIDI CC 71) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.
Set this value to other than the default of "-1", if you want to emit a Reverb MIDI controller (MIDI CC 91) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.
Set this value to other than the default of "-1", if you want to emit a Chorus MIDI controller (MIDI CC 93) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.
If you are using Damper/Hold (64), then you will find that your notes can start building-up and never decay! In which case, set the Damper Release parameter to "Yes", which tells the Generator to momentarily release the damper just before the end of every bar. This prevents build-up of notes and generally sounds wonderful.
Set this value to other than the default of "-1", if you want to emit a Portamento MIDI controller (MIDI CC 65) at the specified value on this Generator's MIDI line. Leave this value at the default of "-1" if you don't want the Generator to emit any information for this MIDI controller.
The default value of "Yes" means that this Generator can share its MIDI channel with other Generators. This is only considered if you have defined the MIDI Channel parameter for a Generator to be 0.
The Generator Microcontroller parameters (there are two - User C1 and User C2) allow you to define very powerful Microcontrollers to be associated with your Generator.
Microcontrollers are very powerful and you can think of them as built-in, highly configurable MIDI event generators. They can either synchronise to the tempo of your Cell, or you can let them run free-floating. Experiment with them – they can do a huge amount to make your music interesting and dynamic.
Tip: if you want to synchronise your Microcontroller to the time-base, so that your MIDI controller is synchronised to bar boundaries in your music, you'll need to use the Beat Cycle Length parameter.
This tells your Generator which MIDI controller (also referred to as the MIDI CC) to emit for this microcontroller, e.g. 11. When the Microcontroller is active, the Generator will emit values for this MIDI controller that change at various times, with behaviour that you define using the various parameters in this Parameter.
The Mode defines the shape of the waveform that the Generator will use to shape this waveform.
The Mode may be one of the following values:
The microcontroller is off. This is the default value.
The microcontroller will drift between the Minimum and Minimum plus Range, changing at times specified by the Update and Update Range parameters, by an amount between the Change and Change plus Change Range parameters.
A triangular waveform, that starts at the minimum value, works up to the maximum value, and works back to the minimum value.
A triangular waveform, that starts at the maximum value, works down to the minimum value, and works back to the maximum value.
A sawtooth waveform, that starts at the minimum value, works up to the maximum value, and then starts again from the minimum value.
A sawtooth waveform, that starts at the maximum value, works down to the minimum value, and then starts again from the maximum value.
Defines the minimum value that may be emitted by the Microcontroller.
The microcontroller will emit a value between the Minimum and Minimum plus Range values.
So for example, if you define Minimum to be 20, and Range to be 100, the value that is emitted will be in the range 20 to 120 inclusive.
Defines the amount by which the microcontroller will change, every time it is allowed to change. Typically set to a value of 1. If this value is set to 0, the Microcontroller will change only if the Change Range is greater than or equal to 1.
Defines the upper limit to the amount by which the microcontroller will change, every time it is allowed to change. Typically set to a value of 1. If this value is set to 0, the Microcontroller will change only if the Change Range is greater than or equal to 1.
For example, if you define Change to be 1, and Change Range to be 3, the value that is emitted will vary by a value between 1 and (3+1)=4 each time.
Defines the minimum time in milliseconds between changes in the emitted Microcontroller value. The system might not be able to emit changes as quickly as you want, if you set a very small value! If you don't want changes to happen very often, then use a large value.
Ignored if Beat Cycle Length is non-zero.
Defines the upper limit in the time in milliseconds between changes in the emitted Microcontroller value. Use this parameter to apply some uncertainty in when the changes will occur.
For example, if you define Update to be 1000, and Update Range to be 500, the value that is emitted will change every 1000 to 1500 milliseconds (or in other words, every 1 to 1.5 seconds).
Ignored if Beat Cycle Length is non-zero.
You define the Unit of Measure by which the Update and Update Range parameters are interpreted. This may be one of the following values:
The Update and Update Range are interpreted as being in thousandths of a second (i.e. Milliseconds). So, a Update value of 1000 means one second.
The Update and Update Range are interpreted as being in seconds. So, a Update value of 10 means ten seconds.
This parameter is critical for generating effects which synchronise with the bar timing of your Generator. If you want to achieve an effect like a filter-sweep that synchronises to your bar boundary, then this is the parameter to use.
Here are some of the values you could use.
Note in the IME a Beat is defined as being one crotchet; you get 4 beats in a bar of 4:4 music. So, a Duration value of 60 means one beat. A Duration value of 30 means a quaver. A Duration value of 20 means a triplet. A Duration value of 15 means a semi-quaver. A Duration value of 240 means 4 beats (which is a full bar if the Cell Meter is 4:4).
Use this parameter if you want to start the microcontroller from a start-point other than at the very start of its cycle.
The Generator Micro Note Delay parameters provide fine variation in the times of Note events generated by a Generator. This can be used to give a Generator more “human” feel.
The maximum amount of delay generated by micro note delay changes, that may be applied to note events. Zero means off (which is the default).
The amount of change in the micro delay that is applied by Wotja between note on/off events. The value drifts between zero (off) and the Delay Range, changing by plus or minus the Delay Change value each time.
Fixed amount of offset note delay to apply, used only when the Micro Note Delay controller is in use. The default value is zero.
The Generator Micro Pitch parameters provide fine variation through use of the MIDI Pitch Wheel controller.
Tip: This is not normally used on MIDI line 10, which is the drum/percussion line!
A value from 0 to 24, meaning how many semitones are controlled by the full available range of Micro Pitch parameters. The default value is 2, which represents two semitones.
Fixed amount of pitch-bend to apply on this MIDI line, used to tune/de-tune an instrument.
The default value is zero, which means to apply no offset pitch bend.
From -8192 to +8191; which covers a range of pitch bend defined by the Bend Sensitivity parameter.
The maximum amount of micro pitch change that can be applied. Zero means off (which is the default). The maximum value allowed is 8191. The value chosen is added to the pitch bend offset.
The amount of change in Micro Pitch that is applied by Wotja between “update” periods. The value drifts between zero (off) and the Pitch Range, changing by plus or minus the Pitch Change value each time.
The time in milliseconds between updates to the pitch controller. The actual value chosen is selected randomly each time, to be a value somewhere between Pitch Update and Update Range.
The upper limit of time between updates to the pitch controller. The actual value chosen is betwen Pitch Update and Update Range.
Normally, Generators compose and emit MIDI note events. The Generator Note to MIDI CC Mapping parameters allow you to tell a Generator to emit MIDI controller data instead of MIDI note events.
Why would you want to do this? Well, it lets you use a Generator as a very powerful generative MIDI event generator with a huge range of potential applications.
If you want this Generator to emit a MIDI CC instead of note on/off events, set this parameter to Yes.
If you have set CC for Note On? to Yes, then instead of emitting a note on event, the Generator will emit the specified MIDI CC, with a value equal to the composed pitch.
If you want this Generator to emit a MIDI CC proportionate to the Velocity of the composed note (in addition to any controller defined for Note On CC), then set this parameter to Yes.
If you have set CC for Velocity? to Yes, then the Generator will (in addition to the Note On CC value) emit the specified MIDI CC, with a value equal to the composed velocity.
If you want this Generator to emit a MIDI CC when a note off occurs, set this parameter to Yes. This applies only if CC for Note On? Is set to Yes.
If you have set CC for Note Off? to Yes, then instead of emitting a note off event, the Generator will emit the specified MIDI CC, with a value equal to the composed pitch of the stopped note.
See also the Envelope Editor.
Generator Envelopes are supported for a number of parameters. Envelopes work in the same way for all of these, so they are all grouped here.
Each envelope is a collection of up to 100 data points. A Cell starts with the value at the left side of the envelope, and as it progresses, eventually ends up with the value from the far right of the envelope.
You can draw direct on to the envelope with your mouse.
Alternatively, you may use one of the various powerful envelope editing tools that we have made available to you.
To use the envelope editing tools:
- Right-click (win) or ctrl-click (mac) on the envelope tool
- Select the option you want. e.g. random, curve up etc.
- Select the range using the mouse...
- Then: either press space or enter, or select pop-up envelope tool to apply to the selected range.
- Select freehand mode to return to the normal click-to-paint mode.
This allows you to define how the Velocity level is changed automatically for your Generator throughout playback of the Cell. The velocity defines relatively how loud each note is.
The actual Velocity value used at any point in the Cell is calculated as being a value somewhere in the range from Velocity, to Velocity plus the value of the Velocity Range envelope.
The value in this envelope is added to the value in the Velocity Envelope.
The velocity for any composed note can change by a value between Velocity Change Envelope value (VCE) and the VCE plus the Velocity Change Range Envelope value.
The value in this envelope is added to the value in the Velocity Change Envelope.
This allows you to define an envelope that is used to emit a MIDI CC of your choice. The default value for this MIDI CC is 7, which is the Volume controller.
MIDI CC
Use this to define the MIDI CC that you want to be emitted by this envelope. The default value is 7, which is the Volume controller.
Enabled?
Use this to turn your envelope on or off.
Envelope
This provides fine variation in the values generated by the User Envelope 1. Any value generated by this micro controller is added to the Micro User Envelope 1 value, to give fine variation in any such envelope.
Range
The maximum amount of micro change in the User Envelope 1 that can be applied. Zero means off (which is the default).
Change
The amount of micro change in the User Envelope that is applied by Wotja between “update” periods. The value drifts between zero (off) and the Range, changing by plus or minus the Change value each time.
Update
The time in milliseconds between updates to the Micro User Envelope value. The actual value chosen is selected randomly each time, to be a value somewhere between Update and Update Range.
Update Range
The upper limit of time between updates to the Micro User Envelope value. The actual value chosen is betwen Update and Update Range.
This allows you to define an envelope that is used to emit a MIDI CC of your choice. The default value for this MIDI CC is 10, which is the Pan controller.
MIDI CC
Use this to define the MIDI CC that you want to be emitted by this envelope. The default value is 10, which is the Pan controller.
Enabled?
Use this to turn your envelope on or off.
Envelope
The Cell Rules parameters allow you to define the default Rules used by the Generators in the selected Cell. Each Cell can have different Cell Rules.
Set this to define the default Scale Rule to use when the Cell plays. Individual Generators are allowed to override this setting if they so wish.
Set this to define the default Harmony Rule to use when the Cell plays. Individual Generators are allowed to override this setting if they so wish.
Set this to define the default Next Note Rule to use when the Cell plays. Individual Generators are allowed to override this setting if they so wish.
The Cell Meter parameters define the Meter to be used by the Cell, such 4:4 or 3:4 or 6:8. A Generator will generally use this Meter, but the Meter value to be used for each Generator may actually override this setting. This approach allows Generators to be configured to work with a completely different Meter, which can be used for interesting polyphonic effects.
The Cell Scripting parameter allows a Cell to use Intermorphic Wotja Script. For full details please refer to the Intermorphic Wotja Script Guide.
The Cell Info Object allows you to define some book-keeping parameters for your Cell. None of these parameters affect the way that your Cell sounds. However, they are useful if you you wish to later export the Cell as a new Template because when you load that new Template it will show the values set here.
The title of the Template that was first added to the Cell. If you change the title the changed title is not shown in the Cell, only here.
The author of your Template.
Any notes you want to include for your Template.
This shows file path to the Pak that the Template is in.
This is non-editable and shows the duration of a WAV file or MIDI file (if used, and which is why it is shown) or 8:53:20 for generative content.
The Mix Tempo allows you to define the tempo for your mix.
The Mix Root parameter allows you to define the Root Pitch to use for the mix. For example, if you are using a Major Scale Rule, then set this value to be C for your Cell to play in the key of C Major.
Sets how long it takes for the file volume to ramp up once the file has started to play.
Sets how long the mix file will play for in the Playlist.
Sets a range on how long the mix file will play for in the Playlist.
Sets how long it takes for the mix file volume to ramp down before play moves to the next mix file in the Playlist.
The Wotja Synth & FX Editor is used to design / view and edit both Synth Networks or FX Networks.
Whether you are viewing/editing a Synth or FX Network in Music Mode depends on which button in the Network Editor5 that you tap on to access it. You can tell which Sound or FX network you are editing as the Screen Title5 of the Mix Editor tells you - it refers either to "Synth" or "FX".
The Editor is quite easy to use one you understand how it works and how everything fits together.
Top Tip: Use the top "Presets" button to open the Presets List where you can select from a range of included Sounds (.tg) or FX (.fxm) presets (you can even load ones you have saved). What is shown depends on whether you are in sound or fx network.
Top Tip: Synth Units are also called Sound Units or Tone Generators (TG); the terms are used interchangably.
Top Tip: Use the top "Dice" button quickly change your Sound or FX Network. Every time you tap the Dice button a Preset is chosen at random ("lucky dip") from ALL available presets (i.e. the built-in ones or ones you have saved). This allows quick experimentation with sounds and FX and is a lot of fun, too!
Top Tip: To build a stereo synth network, use a Synth Unit's pan parameter (or even a following Amp unit) to spatially position its sound. You can have as many Synth and FX Units, Controllers and Junctions in your network as you want (device capability permitting).
Buttons: 1, 8, 9.
Buttons: 2, 3, 6, 7, 10.
This very powerful and complex modular synth unit is a port of the popular open-source "Braids" sound generator from Mutable Instruments (the github is here).
For information on its capabilities see the Mutable Instruments Documentation and/or PDF quickstart. You may also wish to look at the excellent http://www.vo1t.com/Euro/BraidsIllustrated1.8.pdf.
The best way to experiment with it is to load one of the many "MO1-Lead" patches that can be found from the Presets button.
As with any other ISE TG Unit it is a sound source for notes generated by the IME. This means it can be used polyphonically (you can set the polyphony required via the top Poly button in the Synth & FX Editor).
It can also be modulated via other control-rate units (LFO and Envelope modulators are shown in the screenshot) and can be used in a ISE Sound Network in combination with other TG and Control units.
Macro Oscillator 1 - Tone Generator (Audio-rate)^
Tuning
Edit Envelope
The MO1 has its own integral envelope unit with the same capabilities as the Ctrl Envelope Unit.
The "DSynth" tone generator unit can be used either as a melodic tone generator or as a Drum/Percussion Synthesizer for a range of drum/percussion related sounds. You can shift the pitch of the generated sound away from the notes that would otherwise be played, using the Tuning controls.
The unit works by combining two Oscillators which cross-modulate each other's oscillation frequency. Each oscillator has its own ADSR envelope which is used primarily to modulate the volume of the oscillator, but which can also be used to modulate the frequency of the oscillator!
The output of the two oscillators is merged with the output from a filtered noise generator (the bottom block of parameters) which also has its own ADSR envelope. The net effect is a unit which can create a wide array of percussive and melodic sounds. You can use the Export and Import buttons at the top of the unit to export and import DSynth settings to/ from the clipboard.
Tip: Use an audio junction unit to add together sounds from multiple tone generators to make even richer sounds!
DSynth - Tone Generator (Audio-rate)^
Oscillator 1 and Oscillator 2 Parameters
Filter/Q Parameters
Tuning
This unit lets you create a range of waveforms, which are driven by MIDI pitch (via the "Pitch" checkbox); in which case, they are flexible, efficient MIDI tone generators.
Tip: You can use an audio junction unit to add together sounds from multiple tone generators to make even richer sounds!
Tip: The bottom linked Envelope Unit is there to help you shape your sound.
Osc - Tone Generator (Audio-rate)^
Type
DEPRECATED
This effect unit is an example of Granular Synthesis, which although is often used to do time-stretching of samples, is used for a completely different purpose here - that of creating rich layered sounds ranging from ambient forms to plopping sounds and twinkling chimes. The particle system incorporates octave, semitone and micro tonal offsets. It also has a checkbox that allows it to use the default volume envelope for amplitude shaping.
The Particle System synthesizes tones from a number of sine waves. This is really granular "additive synthesis". The unit works by streaming-out grains up to a maximum of 20 at any one time. These are randomly offset from each other to blend well. When the effect decides to generate a new grain, it takes its information from the dialog values. If the grains are reasonably large then the harmonics come in and out giving a full sound.
Tip: You can use an audio junction unit to add together sounds from multiple tone generators to make even richer sounds!
Particle - Tone Generator (Audio-rate)^
Envelope
Note: The Wavetable Unit is the unit that uses Soundfonts/SF2. It is also what you use if you want to use your own SF2, too.
When added to a Synth Network, a Wavetable Unit defaults to use the integral "General MIDI" (GM) SF2 Wavetable and plays Patch "001-Acoustic Grand Piano". To change the Patch select another one in the Patch list.
It is easy to use the other IM-included SF2 wavetables (IM Drums, IM E-Perc, IM Guitar, IM E-Piano, IM Piano, IM Synths).
Simply use the left list control to select the Wavetable from the list of those shown and then use the right hand list control to select the Patch (all patches available in the Wavetable are listed; they are listed in standard patch bank/patch order).
To use your own or 3rd party SF2, they just first need to be put in the right place (see: File Management - Where should I put or look for App Files, Zips, SF2, WAVs etc.?).
Note: If a Wavetable Unit is used in a Synth Network for a MIDI line, its Wavetable and selected patch will override the underlying piece's IME General MIDI Patch parameter (which always uses that patch in the GM Wavetable). If you DO want to use the piece's IME General MIDI Patch parameter setting, you must DELETE all units in the Synth Network and select the OK button to accept that. If you then re-enter the Synth Network you see a Wavetable Unit looks to have been added. It is a placeholder but it is not used - unless you enter the Wavetable unit in which case the sound will default to a GM Piano sound until you change it.
Top Tip: There are 4 parameters in the Wavetable unit that can be modulated: Frequency, Portamento, Amp and Pan. Try using a LFO Unit to modulate the Wavetable Unit's frequency paramater to apply a vibrato effect. To change how that vibrato is applied over time, try shaping the output of the LFO with an Envelope Unit before feeding into the Wavetable Unit.
Tip: You can use an audio junction unit to add together sounds from multiple tone generators to make even richer sounds.
Wavetable - Tone Generator (Audio-rate)^
Selector List
Bottom Toolbar
If you have a weak signal, e.g. coming out from a Filter Unit or an Wavetable Unit, then pump it into an amplifier. The Amplifier can multiply the input by a factor of up to 10. If you want more than this, feed it into another amplifier!
Amp - FX (Audio-rate)^
Sums the input and duplicates it at varying delay rates with the effect of "thickening" the audio. The delay time and frequency should be tweaked to give the right feel.
Chorus - FX (Audio-rate)^
Used to help compress the signal in the DSP chain.
If you view the compressor behaviour as a function of Output (measured in decibels [dB]) against Input (measured in decibels [dB]), the compressor displays three distinct regions of behaviour:
Compressor - FX (Audio-rate)^
Mode
Delay - FX (Audio-rate)^
Distorts the sum of your incoming signals. Take cutoff X right down to about 0.02 to get a really distorted sound - it sounds great on a particle system! Cutoff Y acts like an amp and Cutoff Max determines the position of the output wave when the input is at 1.0 or -1.0.
The combination of Cutoff X, Y and Cutoff Max contribute to reshaping the input signal.
Graph of the Distortion Cutoff parameters
Distortion - FX (Audio-rate)^
Use the Equaliser Unit to modify the frequency response of your audio signal. Depending on how you configure the unit, it can operate as either a 5-band or a 10-band equaliser. Note that the 5-band equaliser takes less CPU power.
Equaliser - FX (Audio-rate)^
Toolbar
The Filter Unit can work in a variety of different ways depending on how you configure it:
Filter - FX (Audio-rate)^
Overdrive - FX (Audio-rate)^
This unit adds reverberation to the sound. This gives depth to the sound and makes it seem as though the piece is being performed in a room. You can control the 'size' and sound of this room with the parameters below.
Reverb - FX (Audio-rate)^
The Envelope Unit is used to edit the "Ctrl-Envelope" control-rate plugin. It is only of use in Modular Synth networks, where it is triggered in response to MIDI note on events for the current MIDI line, and generates no sound of its own. Used in context of the TG Osc it is also triggered in response to MIDI note off events.
Note: An Envelope Unit can be added to an FX Network, but it cannot be used to modulate an FX and can even mute the sound - so we do not recommend doing it!
There are a number of values which you can adjust to modify the shape of your envelope. The shape used is shown in this diagram below.
Envelope - Controller (Control-rate)^
Toolbar
This unit lets you create a range of control-rate waveforms. The waveforms oscillate at a pitch that you dictate yourself. They are used for modulating the parameters of other effect units; they should only be run below (say) 50Hz or you'll get some odd effects.
LFO - Controller (Control-rate)^
Type
STS
If you have a weak control rate signal, coming from a LFO for example, then pump it into an amplifier. The Amplifier can multiply the input by a factor of up to 10. If you want more than this, feed it into another amplifier!
Amp - Controller (Control-rate)^
This unit simply generates a random value from -1 to +1 at the control rate (it is not an audio unit). There is no Unit interface, but you control the scale factor with the slider at the bottom of the Network Screen.
Random - Controller (Control-rate)^
Audio-rate / Control-rate
Junction units are what you use whenever you need to add or combine together the output from two or more units in the system. They are added from the Units drop list below the Chain display. They are shown in grey in the network and have no interface of their own.
There are two types:
When a junction unit is selected in the top "Chain" display area, a "Connector + Unit" section displayes at the bottom of the Network Editor screen and which lets you change junction inputs.
Junction - Audio-rate / Control-rate^
Connector + Unit & Scale: These only show if your currently selected unit is a audio-rate [audio] junction ("Junction") or a control-rate junction ("Ctrl-Junction").
Tap the OK button to accept the preset and return to the Synth & FX Editor.
The ISE Presets List is launched from the "Presets" button at the top of the Network Editor. Using presets is a very easy way to quickly change the sounds and fx used in a mix.
Whether you see sound presets (.tg) or fx presets (.fxm) depends on whether you are in a sound or fx network (i.e. accessed via the Synth or FX buttons in the Wotja Music Mode Network Editor5).
To preview a preset first make sure you have your mix playing and then just tap on it. If you want to use it tap the top left < OK button to exit the list; if you want to discard it then press the top right Cancel button to exit the list.
Any custom presets you have saved can be found in the Saved Files grouping at the top on the left.
You can easily zip up your custom presets into a zip with the following paths being used for sounds and fx for your own folders:
/sounds/tg-preset-group-name/xxx.tg
/fx/fx-preset-group-name/xxx.fxm
Tip: The zip file just needs to be placed in the Wotja Folder.
Tip 2: The zip file can be called anything except wj_tgfxm.zip
.
Tapping this button chooses a Synth or FX preset at random ("lucky dip") from ALL available presets (i.e. the built-in ones or ones you have saved). This allows quick experimentation with sounds and FX and is a lot of fun, too!
The synth/fx network area shows a visual representation of the network design, but is also active as you can tap it to add a new unit.
The currently selected unit is highlighted with a black surround (see: 13).
Audio-rate units are shown in the top row of the network and control-rate units are shown in the bottom row. Units are always numbered from left to right and from 1 upwards; they are automatically renumbered if you ever delete a unit.
If there are no units shown then it means there is no Network defined.
Adding Units:
Note if you are designing a Synth Network, then at least one of your units should be a Tone Generator Unit! In the pop-up menu these all have a "Tone:" prefix.
Tap on an empty/blank part in the top half of this network design area to display the "Unit Add" menu below where audio-rate (Tone) units are listed first, then FX and then Control Rate units (Ctrl-):
Selecting/ Editing Units:
Deleting Units:
The Title will display the MIDI Channel number (for Generator Sounds or FX), Cell, Track or Mix depending on the context, appended by either Synth or FX depending on whether it is a Synth or FX network.
Displayed in Synth networks only. Tap this button to display a pop up list where you select the polyphony level used by the Generator(s) playing through this network. The default value is 4; set this too high, and your computer/device might slow down; set it too low, and you likely won't hear as many notes playing in chords or when notes have long decays (due to note stealing).
Goes to the relevant webpage in the online user guide (internet connection required).
Tap this button to go to the Settings screen.
Tap to discard any changes you have made since entering the Synth & FX Editor.
Displays the following pop-up menu:
Audio-rate units are units that operate at the audio output frequency (e.g. 44kHz) - that means Synth units (i.e. "Tone Generators") and FX units.
Double tap a unit for the following "Unit Action" pop-up menu (all pretty self explanatory):
All units on this line will be audio-rate units.
The currently selected unit has a more solid outline than the others.
The connector line shows which Synth or FX units are connected to and being modulated by Control-rate units.
The controller unit selected in the Controllers Panel17 has
Deletes the selected controller unit in the Controllers Panel17.
Control-rate units are units that operate at a much lower frequency that audio-rate units and are used for modulation of parameters, e.g. the LFO and Envelope units.
Double tap a unit for the following "Unit Action" pop-up menu (all pretty self explanatory):
IMPORTANT: The Synth & FX Editor does not support dragging to add Controllers; these have to be added via the Controller panel "+" button. This button is greyed until you select an Audio Rate Unit (e.g. Tone Generator or FX unit) that has a Contoller Unit somewhere to the left of it otherwise no Controller can be added! Also, Controllers can not be added to some units, e.g. Compressor, as they have have no modulateable parameters.
All Units (i.e. both audio-rate and control-rate), except Junction Units (below), have some parameters that can be controlled (modulated) by control-rate Units (LFO, Envelope, Amp). Each Unit you want to control can have as many Connectors (lines) as you like, and these are separately numbered for each Unit. This allows all kinds of fun and clever sound design stuff to be done in the ISE. The Connectors and Controllers are displayed / selected at the bottom of the screen and/or on the bottom left.
You can tell if a Unit (audio-rate or control-rate) has been set up to be modulated by a Controller as you will see a blue or red line attached that is connnected to control-rate unit to the left of it.
Junctions (audio-rate or control-rate): These units are coloured grey, have no interfaces, and are used only to sum together the outputs of a number of Units of the same audio-rate or control-rate type, meaning the units they sum are always on the same line.
Controller Editing:
See: Add Connector19This button allows you to add a new Controller to pre-existing Audio-rate or Control-rate unit. This is how you do it:
Displays a pop-up that allows you to choose the Controller unit (from those added/present in the network) that will do the modulation (e.g. Envelope Unit).
Displays a drop list of parameters (if any) that can be modulated in the Unit that the controller is connected to.
This sets the Scale Value applied to the modulation (+/-2) before it is passed to the parameter in the Unit that the controller is connected to. Setting this to 0 means no modulation is applied.
For Junctions the Scale Value is a way to balance how much of the output of each Unit is blended together. Note: If more than one control-rate unit feeds a specific parameter on a target unit, they will get added together automatically (including the appropriate scaling factor).
This editor is only available in Music Mode.
There are four different Rule Types (Scale, Harmony, Rhythm and Next Note) and they are fundamental to how Wotja works as Generators use them when composing.
The Rule Editor is where you select and (real-time) edit these Rules, e.g. their names, elements and element weightings.
To Add Rules or Copy/Paste/Rename etc. see ToolbarB.
You can access the Rule Editor from:
Tip: If you prefer to edit Generator parameters whilst seeing the Generator Network on screen then see Generator Editor PanelF.
Rules can be saved in 2 different places - at a top level in the Mix itself ("Mix Rules") or in each Cell ("Cell Rules").
The distinction is important because Wotja allows every Generator in every Cell in a Mix to use the same "Mix Rule" or to allow Generators in a particular Cell (e.g. Cell 1) to be configured to use any of the Rules saved in that Cell ("Cell Rules" e.g. saved in Cell 1).
UI Elements: OK button1.
The Toolbar contains two buttons - Add and Action.
Tap the OK button to accept your changes and exit the Editor.
A note is playing with this rule element (see above for example of one with no note playing).
The Rule Element Selector lets you change the rule elements. Tap on a rule element to change its value from 0 to 100 (relative probability weighting). The composition engine accomodates all rule changes in real-time - which can be a lot of fun!
So that you can tell when a Generator using the currently selected rule composes using it, it flashes the colour of the Generator type used by that Generator (as in this case). This is primarily to remind you that other Generators rely on that rule, so if you are going to change it then the way other Generators compose may change, too. It can be useful to have the same rule used by all Generators, but if you want to, then each Generator can have its own rule!
For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.
There is no note playing that uses this rule element (see above for example of one playing).
The Rule Element Selector lets you change the rule elements. Tap on a rule element to change its value from 0 to 100 (relative probability weighting). The composition engine accomodates all rule changes in real-time - which can be a lot of fun!
For full information on the Intermorphic Music Engine (IME) parameters refer to the IME User Guide.
The screen title which shows whether you have accessed the Rule Editor from:
Lets you choose a Mix Rule list item.
Lets you choose a Cell Rule list item.
The selected (and active) rule has shows with a light blue background.
The scrollable Rule List (in either Mix Rules or Cell Rules) contains all of the Rules available to select from.
To add/edit/rename/delete rules see the ToolbarB.This editor is only available in Music Mode.
Access is via the Music Mode Generator Editor PanelF > Parameter Groups > Pattern Parameter.
Tip: Patterns can be used to create hidden structure in a mix. Set up a Generator to be of Type Pattern and set its volume envelope to be zero), but do not mute it (or it will not count in terms of composition). Then, follow that Generator with a Generator of type Follow and which has Chords Strategy set to Chordal Harmony. You will never hear the original pattern but it will be used as an invisible skeleton around which to compose! If you do want to hear the pattern, set Follows Strategy to Semitone Shift in the Follow Generator.
Menu Buttons: 2,6,7.
The Toolbar has buttons that allow you to add and delete patterns, and change their order.
Tap for a pop-up menu (the Pattern type is shown at the end in brackets, e.g. B,R or F). See also Pattern Syntax.
Tap the item you want and it is added to the bottom of the Pattern List:
Tap the OK button to accept changes you have made.
Tap a Pattern item to select it and display the following pop-up menu:
Moves the selected pattern up the Pattern List.
Displays the name of the screen.
Moves the selected pattern down the Pattern List.
Tap for a pop-up menu with a list of Sequence presets. See also Pattern Syntax.
Tap the item you want and it will replace everything in the Pattern List.
Discard any changes you have made.
Deletes the selected pattern.
Display the list item number and the Pattern type, e.g. #1 Both.
The text string for a Pattern of type "Both". See also Pattern Syntax.
The text string for a Pattern of type "Rhythm". See also Pattern Syntax.
The text string for a Pattern of type "Fixed". See also Pattern Syntax.
The text string for a Pattern of type "Sequence". See also Pattern Syntax.
Displays the appropriate Pattern Editor for the Pattern type, these being Both, Rhythm. Fixed or Sequence. See also Pattern Syntax.
The selected pattern has a light blue background.
Access is via: Pattern Selector3 > "Edit - Graphical" menu option or the Pattern Editor Button15
Most of the interface is common, but what is shown in the grid area varies depending on the Pattern type - see Grid X-axis11 and Grid Y-axis12.
See the Pattern List. See also Pattern Syntax.
UI Elements: 1,8,9.
UI Elements: 2,3,4, 6, 7, 10.
Tap the OK button to accept changes you have made and return to Pattern List.
There are 3 Edit Modes:
Tap for a pop-up dialog that lets you set how many bars your pattern has from 1 to 50 (Default 1).
Tap for a pop-up dialog that lets you select the note length you wish new notes to have when you add them (Default 60 / 1/4 note - see also Pattern Syntax):
Displays the name of the screen.
Tap for a pop-up dialog that lets you select the "snap to grid" resolution you have when you add a new note (Default 60 / 1/4 note - see also Pattern Syntax):
Tap to undo the last change you made (only 1 level of undo/redo is supported)
Tap the button for the following pop-up:
Discards changes made since entering the Editor.
Tap to redo the last change you made (only 1 level of undo/redo is supported)
For Patterns of type Both, Rhythm and Fixed the grid has an X-axis of Bars. Beneath that, each bar is split into Beats (each bar has 240 Beats).
For Patterns of type Sequence the Grid has a different layout and is instead a "Sequence Element" list, see Y-axis below.
Pattern Type:
Each note in the pattern is shown as a Note Button. Tap on the button to select it. What you can then do depends on the Edit Mode Button2
This is a special editor for entering custom TTM text, rather than relying on cut-up being generated in the Text Mode and then associated via a line number association (see IME TTM Cut-up Rule parameter).
As with all TTM text, it can be in can be in any language and, in general, it takes 2 characters to generate a note.
Tip: Use the Randomize button for a quick and easy way to create some custom cut-up text!
UI Elements: Menu Bar buttons1,6,7.
UI Elements: Menu Bar buttons2,5,8.
Tap the OK button to accept changes you have made.
When this toggle is on and you use in a TTM Generator, your TTM text will show in full screen mode.
Shows you the number of notes your text generates.
Displays the name of this Editor.
Tap the button for a Popup menu where you can set what happens when you press the Randomise Button8.
Popup Menu:
Popup Menu:
Tap the Cancel button to discard any changes you have made.
Carries out the action set in Shuffle Option Button5.
Tap the screen to enter your TTM text.
This editor is only available in Music Mode.
Generator Envelopes are supported for the following parameters:
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.
UI Elements: OK button1.
UI Elements: Draw/Macro Selector3.
Tap the OK button to accept your changes and exit the Editor.
The envelope area is active meaning you can draw on it (Draw Mode) or select and area (Macro Mode).
Draw Mode: Select this if you want to draw direct on to the envelope with your finger/mouse to change the values.
Macro Mode: Select this to use one of the various macro envelope editing tools on a selected area (e.g. random, curve up etc.).
The screen title.
Shows an area that has been selected in Macro Mode.
The following Macros can be selected:
The selected Macro is shown with a light blue background.
This editor is only available in Music Mode.
Documents > Mix File14 > Text Tab28
Cool Tip: Your text in Text Mode can be used for "Text-to-Music" (TTM). See the TTM Cut-up Rule.
Text Mode is where you create/edit text used in your mix, whether purely for display purposes or also for "Text-to-Music". Use the Sources Screen to input any source text used for creating cut-up, the Cut-up & Edit Screen to create/edit Cut-up, select cut-up rules, lock words etc. and the Saved Screen to access saved text sections (saved in a mix file).
The powerful "cut-up technique" is great for generating ideas for lyrics, poems, haiku etc as it allows you to quickly generate random word associations from a pool of words. This pool can include words from up to 5 user entered text fields ("Sources"), a user word library ("Word Library"), the customisable Wotja Word Bank ("Word Bank") and a non-editable Wotja Word Database ("Word Database").
You can lock down ("Lock") any words you want or, for just a selected word, choose one of the alternative cut-up words presented. You can use Rules ("Rules") to constrain your cut-up by lines, words and syllables.
Keep iterating until you find the interesting, inspiring or serendipitous combinations of words you are looking for. Save the the best Cut-ups ("Saved") and then use in real-world lyrics, poems, haikus, tweets etc.
For your cut-up you get to choose how many lines and how many words per line you want in it and whether you want Wotja to attempt End of Line (EOL) rhyming.
Important: We respect copyright and strongly encourage you to do the same. That means if you use Wotja to come up with a lyric you like, make sure that it does not infringe the copyright of any of your source material. Wotja is pretty good at creating random "cut-ups", but it is just a tool for you to use to generate ideas. It is ultimately your responsibility to make sure you are not infringing anyone elses copyright.
UI Elements: 1,4,5.
There are 3 different screens in Text Mode, the screen being selected with the Screen Selector Button3.
Same as the Music Mode Save/Exit1.
Displays the name of the Text Mode Screen you are in.
Tap to select one of the 3 different screens in Text Mode.
Displays the Action menu for the Text Screen you are in.
Takes you to the Settings screen.
Documents > Mix File14 > Text Tab8 (above)
The Sources screen is the first of the three Text related screens.
It is where, for each mix, you input and store all the custom (i.e. non-Library) text you want to be used as a source in that mix for a Cut-up. The sources are saved in the your Wotja file and you can have up to 5 of them.
The Source text area is editable and supports plain text only. You can move words around by cutting and pasting, or even edit or manually add in new words.
Tip 1: The more interesting the source material you use, the more interesting the cut-up suggestions generated. You can think of your favourite source materials like spices or ingredients, and then build up a collection of your favourites to add when you want. You can then add as little or as much as you like!
Tip 2: Why not try using text from some current news item as a Source - that way you can make sure you use words that are current, and some interesting themes can seemingly come out of nothing!
Tip 3: The more words there are in your Sources the more options for cut-ups.
Tip 4: To use the "Sources Only" cut-up mode requires that you have at least one source defined.
UI Elements: 1,6,7.
The three Text Mode screens are selected with Screen Selector2. The Sources screen is shown as having been selected.
Shows the Source Toolbar which contains only the Source Selector Button3.
Same as the Music Mode Save/Exit1.
Tap to select one of the 3 different screens in Text Mode. The Sources screen is shown as being selected.
The button shows the selected Source. Tap it to show the Select Source pop-up menu.
Displays the name of the Text Mode Screen you are in.
Tap to clear the text from the currently selected Source.
Popup Action menu.
This editable text area displays your source and supports plain text only, i.e. no emoji and no formatting.
The Tab that selects Text Mode.
Select from the menu the Source you want to view/edit.
Documents > Mix File14 > Text Tab15 (above)
The Text "Cut-Up & Edit" screen is the second of the three Text related screens.
It is where you can create a "Cut-up" Text via the Create Cut-up Button16 as well as edit your Text via the Edit Text Button5. The Text or created Cut-up12, Word Locks11, associated Text Rules8 and Saved Text are saved in your Wotja file.
Tapping a word will Lock11 / Unlock10 it (a locked word will not be changed when you press the Create Cut-up Button16).
UI Elements: 1,6,7.
The three Text Mode screens are selected with the Screen Selector3.
UI Elements: 13,14,16,17.
Same as the Music Mode Save/Exit1.
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.
Tap to select one of the 3 different screens in Text Mode. The Cut-up & Edit screen is shown as being selected.
Displays the name of the Text Mode Screen you are in.
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).
Popup Action menu:
Takes you to the Settings screen.
The Rules Button button displays the Cut-up Rule ("Rule") currently being used to create cut-ups. If it has a name then that will also be shown, otherwise you will see the Rule Syntax (below).
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.
See also the Rule Syntax.
4 4 4 4
rule to the bottom of the Rules List (see also "How to Add/Edit Rules" below.See also the Rule Syntax.
4 4 4 4
): Rules List > Action Button > Add Rule.A A A A A A A A A Awould be a "5 2 3" rule. On leaving the screen select Yes in the "Change the rule?" pop-up.
A basic Cut-up Rule is very simple - it is just a text string that consists of a series of numbers. Each number stands for the number of words to put in a particular line of the cut-up. For example, the four spaced numbers 3 4 5 6
would represent four lines of cut-up. The first line would have three words, the second would have four words, the third would have five words, and the fourth would have six words.
Tip: Items in [ ] are optional.
LineWordsMin [- LineWordsMax[:SyllablesMin [-SyllablesMax]]]
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"
Show the line number of the Cut-up (see also Rule Syntax).
An unlocked word (shown) can be replaced whenever a new cut-up is created (e.g. tap the Create Cut-up Button). Tap a word to lock or unlock it.
An locked word (shown) will not be replaced when a new cut-up is created (e.g. tap the Create Cut-up Button). Tap a word to lock or unlock it.
The text area is where your cut-up (text) is shown.
Lines are alternatedly coloured so that if your Text wraps you can easily see which line the words are in.
Tap a word to lock or unlock it (it shows in blue when locked). When you select a word (locked or unlocked) it also underlines it to show that it is the selected word (e.g. "Text-to-Music" in the screenshot above). To select a word without changing its lock state tap on it and then drag away from it and release. Even though the word does not display an underline, it is now selected.
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!
Tap the Text Library Button to select/view/edit what text, in addition to Sources (if any), you want to be available in the "wordpool" available for selection when creating Cut-ups.
At the bottom of the screen is a toolbar with three segments - None, Wotja Word Bank and Wotja Database. These segments allow you to use text "Libraries" that are stored outside of the Wotja file (as opposed to Source which are stored in the Mix file), meaning the text in those libraries is available for use in any cut-ups YOU MAKE for ANY mix:
The Text screens are only available in Text Mode.
Provided you have first added some words to at least one of the Sources text boxes above (or you have some words in your User Library or the Wotja Word Bank toggle is on AND the Library slider is not hard over to the right) then when you click this you'll see a Cut-up appear in the text area. Each time you click this button all non-locked words will be replaced by words selected at random from your word pool and/or Library/Word Bank.
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.
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.
The selected word is indicated by an underscore.
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.
Documents > Mix File14 > Text Tab8 (above)
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 Items") you have chosen to save. These are saved in your Wotja file.
Tip: The Mix Rule > Automatic Text Change > Use Saved Text toggle allows Saved Text Items to be used in a very creative manner in a mix. When the above toggle is on, your mix can sequentially display Saved Text Items according to the various Change settings, instead of randomly generating a cut-up. Any words in your Saved Text Items that are not locked will be randomized just as it if was a cut-up.
Menu Buttons: 1,4,5.
The three Text Mode screens are selected with the Screen Selector3.
Same as the Music Mode Save/Exit1.
Displays the name of the Text Mode Screen you are in.
Tap to select one of the 3 different screens in Text Mode. The Saved Screen is shown as being selected.
Copies the selected Saved Text Item to the Cut-up & Edit screen, replacing what is there.
Popup Action menu.
A grey background indicates the currently selected item in the list.
Tap a Saved Text Item to select it.
Each Saved Text Item includes the text and all text locks that were used. At the top right of the item is displayed the Rule used for the text and a character count showing the total characters and the line characters in brackets after that.
The Tab that selects Text Mode.
Documents > Mix File14 > Display Tab11
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.
Menu Buttons: 1,6,7.
Toolbar Buttons: 2,3,5.
Same as the Music Mode Save/Exit1.
Displays a pop-up menu where you can select:
Go to a screen where you can set the background colour via RGB sliders or a HSB colour wheel.
Displays the name of the screen. This is "Display" as there is only one screen in Display Mode.
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".
Popup Action menu:
Takes you to the Wotja Settings screen.
The text area can display either Cut-up, TTM text or no text at all. See the settings in the Text Button2.
This displays either a solid colour, a screensaver or a background image depending on what has been selected in the Display Mode Background and Picture buttons. See the Picture Button5 and the settings in the Background Button3.
This is where the Watermark displays if the Settings > General > Show Watermark toggle is on.
The Display Mode is accessed via this Tab Bar button.
Documents > Mix File14 > Record Tab10
Although not strictly an "Editing Mode" as there is no actual editing that goes on in it, this screen is where you can create and preview WAV, MIDI (Pro Feature Set) and Video (iOS, macOS only) "mixdown" recordings (selected via the Recording Format Selector2).
Tip: Recordings are all saved to the "Wotja Folder", the location of which depends on the OS and/or whether iCloud is enabled for Wotja.
Usage:
Menu Buttons: 1,4,5.
Toolbar Buttons: 2.
Bottom Toolbar Items: 9,11.
Same as the Music Mode Save/Exit1.
Select the mixdown recording format: WAV, MIDI (Pro Feature Set) and Video (iOS, macOS only).
The supported mixdown recording formats are:
When a recording is being made the screen title (normally "Record") will change to indicate the progress of the mixdown.
When you are using iCloud it can take time for a recording to sync with it. Press this button to update the recordings list.
Takes you to the Settings screen.
Dependent on the setting of the Record Units Toggle11, you use this slider control to set the number of bars or seconds you want to record (up to 100 bars or 600 seconds maximum by default, but extendable via the Max Bars/Max Settings slider control in the mix segment of Settings).
Tip: To change the bars value either tap the "-" or "+" buttons, drag your finger along the slider or double tap it for a pop up to manually enter a value.
The recording item uses an icon to indicate the file type and the description shows the name, bars, tempo and date/time.
Tap an audio (grey icon) or MIDI (black icon) recording to preview it/stop it being previewed. When it is playing the item selector will have a light green tint.
When previewing MIDI recordings these play only with a default GM MIDI Wavetable; MIDI is also sent out at the same time.
Tapping a video recording (green icon) 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.
Shows the % progress of the mixdown recording, e.g. 34% done.
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.
The Record Mode is accessed via this Tab Bar button.
Choose between Seconds (toggle is on) or Bars (toggle is off).
Displays the list of mixdown recordings you have made.
Tap this button shown to the right of the recording to present a pop-up action sheet with the following options:
Access is via the Settings button found in many screens: Settings Button14.
Menu Buttons: 1,8,9.
Settings are grouped and shown on 3 different screens, the screen being selected with the Screen Selector7.
This toolbar is only shown in the Randomization Screen. It contains the following Toolbar Buttons: 2,4,7.
Tap to return to the Mode you came from.
Does the same as the Scheme Name Button4, namely it lets you select Scheme from the Scheme List screen (which also lets you delete a Scheme).
Displays the name of the screen.
Shows the name of the current Scheme but otherwise does the same as the Scheme Select Button6, namely it lets you select Scheme from the Scheme List screen (which also lets you delete a Scheme).
Related Settings are grouped together. The Group Header shows the name of the group.
Lets you select one of the 3 Settings screens: General | Audio MIDI+ | Randomization.
Use this button to save changes to your Scheme or to save as a new scheme (Pro Feature Set only).
The Version Number button shows the version number of the software. Tap it to go to the Releases webpage where you can see the details of each release.
Note: The Store button is only shown in the free versions of Wotja. Tap the button in the iOS/macOS versions to go to the In-App Store screen. Tap the button in the non-Subscription versions (Windows/Android) to launch a web redirection page that takes you to the paid-for Wotja Pro 20 app in either the Microsoft Store or Amazon Appstore (as relevant).
This is where you set the Sleep timer (if required), the User Interface mode (Light or Dark) and UI related settings such as text fade in/out, display language and see the version number.
See the list below.
This where you set how you want Wotja to play its sounds, how it is used with Audiobus / Inter-app Audio / Ableton Live [all iOS only], MIDI Out/In and video recording sizes etc.
Wotja has both powerful and customisable randomization capabilities. It is something that one day you may wish to explore and at such time you will be glad that there are so many possibilities!
This screen is where you can select the Randomization Scheme you wish to use as well as being able to edit any of the settings in it.
You can save your own or customized Schemes with a Pro Feature Set.
A Randomization Scheme is a collection of settings that can be used for Randomization. There are over 40 different settings described below included in each one. These range from Template selections (including ones you have made), Sound & FX preset selections (again including ones you have made) right through to Cut-up rules and the number of cells/tracks in an auto mix. Each Scheme can have completely different settings, too, meaning they can be configured exactly as you want - whether you want to change just one setting or all of them is up to you.
Randomization can be used in a number of places in Wotja and the randomization parameters in a Scheme determine how it is used. Examples of this are how the mixes in Flow and Automatic albums ('Boxes') are created and whether e.g. text is displayed on screen in Flow mode and/or the Playlist Player Fullscreen mode. They are also used to determine how mix Cells are populated with templates when using the Random function in Wotja, how TTM Generator text randomisation is applied to mixes and how Cut-up is generated in the TTM Text Editor screen - plus a lot more, too.
Awesome listen | lighttext | - | - | - | - | - | - | - | |||||||
Been painting | lighttext | - | - | - | - | - | - | - | |||||||
Black gold | lighttext | - | - | - | - | - | - | - | |||||||
Bold space | lighttext | - | - | - | - | - | - | - | |||||||
Breathe slow | lighttext | - | - | - | - | - | - | - | |||||||
Citrus zest | darktext | - | - | - | - | - | - | - | |||||||
Comforting cotton | darktext | - | - | - | - | - | - | - | |||||||
Deck chair | lighttext | - | - | - | - | - | - | - | |||||||
Deep thought | lighttext | - | - | - | - | - | - | - | |||||||
Drifting upbeat | lighttext | - | - | - | - | - | - | - | |||||||
Flow Go | lighttext | - | - | - | - | - | - | - | |||||||
Flutter words | lighttext | - | - | - | - | - | - | - | |||||||
From imagination | lighttext | - | - | - | - | - | - | - | |||||||
Hedge row | lighttext | - | - | - | - | - | - | - | |||||||
Ideal discover | lighttext | - | - | - | - | - | - | - | |||||||
Incredible relation | lighttext | - | - | - | - | - | - | - | |||||||
Inventing decision | lighttext | - | - | - | - | - | - | - | |||||||
Lilt dimension | darktext | - | - | - | - | - | - | - | |||||||
Look light | darktext | - | - | - | - | - | - | - | |||||||
Love heart | lighttext | - | - | - | - | - | - | ||||||||
Mono chrome | lighttext | - | - | - | - | - | - | - | - | - | - | ||||
Noodle safe | lighttext | - | - | - | - | - | - | - | |||||||
Ocean travel | lighttext | - | - | - | - | - | - | - | |||||||
Pastel healing | lighttext | - | - | - | - | - | - | - | |||||||
Pebble vision | lighttext | - | - | - | - | - | - | - | |||||||
Random hand | lighttext | - | - | - | - | - | - | - | |||||||
Reflecting time | lighttext | - | - | - | - | - | - | - | |||||||
Sun flower | lighttext | - | - | - | - | - | - | - | |||||||
Teal leaves | lighttext | - | - | - | - | - | - | - | |||||||
That filter | lighttext | - | - | - | - | - | - | - | - | - | |||||
Value union | lighttext | - | - | - | - | - | - | - | |||||||
Vibrant feeling | lighttext | - | - | - | - | - | - | - | |||||||
Wander happiness | lighttext | - | - | - | - | - | - | - | |||||||
Why incredible | lighttext | - | - | - | - | - | - | - | |||||||
Winter scene | lighttext | - | - | - | - | - | - | - | |||||||
Wood finish | lighttext | - | - | - | - | - | - | - |
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)
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.
macOS - "iCloud Drive" / Wotja "Use iCloud":
See also Apple's iCloud Help resource.
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.
"Dual" Subscriptions: Subscriptions are common to both iOS AND macOS versions meaning you can purchase e.g. a 'Pro' or 'Play' Feature Set (FS) Subcription on one and it will unlock it on both!
The free versions for iOS/macOS contain an In-App Store that allows purchase of In-App Subscriptions in two 'Groups': 'Feature Set (FS)' and 'Special Options (SO)'.
In these versions The In-App Store can be accessed from the Documents Screen > Store button or the Settings Screen > Store button (shown only in iOS/macOS versions).
Wotja Pro 20: There is no In-App Store in the paid-for Wotja Pro 20 because it does not include any auto-renewing In-App Subscriptions. If you need or want them, simply get one of the free iOS/macOS versions.
Note: When a Subscription is active "Subscribed" is shown in blue instead of the price. To restore a Subscription tap the top right Restore button.
It is easy to manage your Wotja Subscriptions, as follows: