Menu Bar

Save / Back to Documents

See: 'Free Mode' & Limitations

Displays the Save Changes popup (see below) before exiting to the Documents Screen.

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

• Randomize Mix - Automatic: Replace your current mix with a new randomized mix created in accordance with the Randomization Settings.
• Randomize Mix - Manual: Takes you to the Templates screen where, prior to randomizing, you can manually decide which Templates are to be used as well as changing the Randomization Settings.
• Randomize Cell (sticky):Tap any cell (including looping cells) to replace its contents with another randomly selected template. This template is chosen from paks/templates in the Template List that are tagged as available for selection and also uses relevant settings in Randomization Settings (see Edit Randomization Settings). The Randomize button shows as a fuschia colour (to show sticky behaviour). Tap the button again to turn off sticky behaviour.
• Randomize Column: Tap any cell in a column to randomly replace the contents of all currently populated cells in the column EXCEPT those that are set to be looping (i.e. locked). Tip: By setting a cell to loop (tap/hold = orange bar) you can ensure that the contents of that cell are not changed when randomizing.
• Randomize Column (ALL): Tap any cell in a column to randomly populate / replace the content of potentially ALL cells in the column (including looping cells). The number of cells randomised is determined by the "Tracks" setting in Randomization Settings. Tip: Use carefully.
• Randomize Track: Tap any cell in a track to randomly replace the contents of all currently populated cells in the track EXCEPT those that are set to be looping (i.e. locked). Tip: By setting a cell to loop (tap/hold = orange bar) you can ensure that the contents of that cell are not changed when randomizing.
• Randomize Track (ALL): Tap any cell in a track to randomly populate / replace the content of ALL cells in the track (including looping cells). The number of cells randomised is determined by the "Cells" setting in Randomization Settings.Tip: Use carefully.
• Randomization Settings: Provides quick accecss to Randomization Settings.
• Cancel: Cancel out of the pop-up menu.

See: 'Free Mode' & Limitations

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

• Copy/Paste (sticky): Copies the currently selected Cell and pastes into the Cell(s) you next tap. The Toolbox button shows as green (to show sticky behaviour). Tap the button again to turn off sticky behaviour.
• Move: Moves the contents of the currently selected Cell to replace the contents of the next Cell you tap. Use with caution as there is no pop-up warning.
• Clear (sticky): Tap any Cell to clear out the contents. The Toolbox button shows as a fuschia colour (to show sticky behaviour). Tap the button again to turn off sticky behaviour.
• Import from Clipboard: Tap to import into an empty Cell what is on the clipboard (i.e. a [.noatikl] file/template) into the currently selected cell. NB: Wotja files cannot be imported to a cell.
• Merge from Clipboard: Tap to merge what is on the clipboard (i.e. a [.noatikl] file/template) into the currently selected Cell. NB: Wotja files cannot be merged to a cell.
• Replace from Clipboard: Tap to replace the contents of the Cell with what is on the clipboard (i.e. a [.noatikl] file/template) NB: Wotja files cannot be imported into a cell.
• Export to Clipboard: Tap to export the contents of a generative cell (i.e. a [.noatikl] file/template) to the clipboard.
• Export to File: Tap to export the contents of a generative Cell (i.e. a [.noatikl] file/template) to a file. This file will then show up in Templates List > Saved Files (shown at the top of the left hand Pak list).
• Export Mix (legacy format): Tap to export your mix to an old style Mixtikl format so you can open it in Mixtikl. Wotja does not utilise or resave in .wotja files or exported .mixtikl files the following Mixtikl parameters:
• Any settings, including text, related to the Mixtikl visualiser
• Store/Recall settings
• Any Advanced cell settings, i.e. Skip, Silent, Stream, Audio Sample

• Clear ALL cells: Clears out the contents and arrangement settings for ALL Cells.

See: 'Free Mode' & Limitations

• Mixdown & Recordings: [Mix Mode only] Takes you to a screen where you can make mixdown recordings and preview them.
• Help & More:
  • "Mix - Quick Help": Quick Help on this screen.
  • "Online Wotja User Guide": Link to this online Guide.
  • "Online IME Guide": Link to the online Intermorphic Music Engine (IME) Guide. This is also incorporated into the Wotja User Guide.
  • "Online ISE Guide": Link to the online Intermorphic Sound Engine (ISE) Guide. This is also incorporated into the Wotja User Guide.
• Import Wotja from Clipboard: Only shown if you have a Wotja on the clipboard and you will see a message about having to Import a Wotja via the Documents screen (Documents > Add New > Mix (from Clipoard).
• Export Mix to Clipboard (no image): Creates the smallest Wotja URL from your mix.
• Export Mix with Image: Creates a Wotja URL from your mix that includes your a background image (if you have selected one).
• Script Sandbox: Opens the Intermorphic Wotja Script Sandbox window where you can try out scripts.

Status Bar

Top Toolbar

Mixer Panel: Once in this panel, tap the button again for a pop-up menu where you can choose between seeing the Voice Mixer and Track Mixer panels.

• Track Mixer Panel: Right hand panel shows sliders for mixing Track volume and pan levels.
• Voice Mixer Panel: For a selected Cell that contains generative content, the right hand panel shows sliders for mixing its "Voice" volume and pan levels.

A mix always includes a "grid" of 12 tracks of 4 cells. You can populate or leave empty any cells you wish. This button, shown to the right of the panel selectors, has a pop-up menu allowing you to select one of three display modes for the grid:

• Multi Column: This "Grid" mode shows the whole grid of Cells (i.e. all columns). It is an overview mode that gives you access to the Track Mixer to set the levels/pans for each track as well as seeing how "Cell Sequencing" is working when the Track Rule is set to Sequence. Cell Sequencing can used used to apply a level of arrangement to your mix, allowing spaces for example via empty Cells. It is particularly useful when using loops and if you want to loop different cells that use the same track FX. This mode is also great for "live performance" mixing, too, where you tap/hold a cell to force it to "loop".
• Single Column: Shows just one column of Cells which always includes the active (selected) Cell. This mode still gives access to the Track Mixer to set the levels/pans for each track and is particularly useful if you want to mix together just one column of Cells without Cell sequencing (i.e. pure generative mix).
• Single Cell: Shows just the current active (selected) Cell. This is perfect if you just want to focus on editing the contents of just one cell, or even to create a complete piece in one Cell (c.f. Noatikl).

Central Area - Content Cells

Content Cells are at the heart of Wotja. You can use the bottom toolbar right side "grid" icon to toggle the left hand Content Cell display to show either 1 column of Cells or 4 columns of Cells. There are 3 areas/parts of cell, see below.

Selected Cell: When a Content Cell is selected the border of the cell takes on a fuschia colour and the top or bottom of the cell takes on a lime green background colour that marries up to the right side panel that has been selected to display.

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

• Generative: Blue IME icon
• Audio Loop: Grey waveform icon
• MIDI file: Black notes icon
• No content: Blank

The middle of a Content Cell displays the Cell Status band and within that is the name of the file in the Cell. The colour of this band indicates the following:

• Green: Playing but not looping
• Orange: Playing and continuously looping
• Grey: Playing an empty cell (no sound)
• White: Not playing

The bottom of a Content Cell shows the cell "Arrange" values, and these are presented differently depending on whether the mix is playing or stopped.

The topmost values shown in blue are the Cell's Generative Bar values and the values below those in black or dark grey are the Cell's Cell Repeat values.

• Mix Playing: The values are shown with syntax #X/Y where X is the calculated minimum and Y is the calculated range value.
• Mix Stopped: The values are shown with syntax #X+Y where X is the set minimum value and Y is the set range.
• Infinite: The one exception to the above is that if a cell is playing and the Generative Bars value is infinite, a blue infinite symbol takes up the space of both.
• Missing: If the content referenced in the cell cannot be found then the bottom area displays red. This can happen, for example, if your mix references a loop on your device which you later delete or you load someone's piece and you have not installed a Pak that it might reference.

Central Area - Track Controls

Default - None:

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

Default - Sequence:

Sequence: When the content in the Track's current cell has finished playing, the next Cell in the track will play (unless it has been forced to loop).

One Shot: No Track Cell will play UNTIL it has been triggered (it will display the green "play marker" in the middle of the cell). Once triggered, any content will play through ONCE (like a sting) and then the cell will stop playing.

Loop: No Track Cell will play UNLESS it is forced to loop - either by tap/hold on the cell or by setting the Loop toggle in this panel. Turn off looping the same way. Tip: When using the Toolbox menu "Randomize" menu functions only the item "Randomize Cell (sticky)" will randomize the Cell. Advanced Tip: Cells in Loop tracks containing Audio/MIDI content will play ONCE when the Column lock is first applied to a Column (if a cell is not already looping); cells containing generative content will be set to play for the length of the mix (∞).

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

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

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

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

Central Area - Right Side Panel

What shows in this area depends on which panel you are in:

See in order:

• Network Panel
• TTM Panel
• Mixer Panels
  • Voice Mixer
  • Track Mixer
• Rules Panel

TTM Panel

Turn this on to enable the TTM voice, meaning your text will be used to generate a pattern. If the voice type is not already Fixed Pattern turning on this toggle on will change it to one.

The pattern generated by your text will then overide any pattern that may already be in the Fixed Pattern voice.

Where you enter your TTM text .

Popup Menu:

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

Popup Menu:

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

Carries out the action set in Randomise Option.

Voice Mix Panel

Tap to change the volume for the related Voice.

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

Tap to change the pan position for the related Voice.

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

Tap to mute or solo the related Voice.

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

Track Mix Panel

Tap to change the volume for the related Track.

Tap to change the pan position for the related Track.

Generative Cell

Default: ∞ [0 - 1000] - The minimum number of bars for which a cell will play generative content. Special Value: If this value is set far left to ∞ [0] then once play in a Track reaches such a cell the generative content in that cell will continue to play either for as long as the mix plays or until you manually select another cell in that Track to play.

This value is the first of a pair of numbers shown in blue in the top line of text at the bottom of the cell.

The value in brackets next to the Gen Bars value shows what this represents in terms of h:m:s and takes into account the mix tempo.

This value is the second of a pair of numbers shown in blue in the top line of text at the bottom of the cell. If the first value (above) is ∞ then this value is not shown.

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

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

Generative Piece Rules

Default - Default Rule: When the cell is playing any active rule element will flash; the colour is that of the Voicetype of the playing voice. To edit or change the Piece Level Scale Rule (which can be overridden at Voice level), tap on it to go to the Rule Editor screen. For information on Scale Rules refer to IME Rule Object. For information on Piece Level rules refer to IME Piece Rules.

Default - Default Rule: When the cell is playing any active rule element will flash; the colour is that of the Voicetype of the playing voice. To edit or change the Piece Level Harmony Rule (which can be overridden at Voice level), tap on it to go to the Rule Editor screen. For information on Harmony Rules refer to IME Rule Object. For information on Piece Level rules refer to IME Piece Rules.

Default - Default Rule: When the cell is playing any active rule element will flash; the colour is that of the Voicetype of the playing voice. To edit or change the Piece Level Next Note Rule (which can be overridden at Voice level), tap on it to go to the Rule Editor screen. For information on Next Note Rules refer to IME Rule Object. For information on Piece Level rules refer to IME Piece Rules.

Scripting

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

Generative Piece Info

Displays the Title of the Piece/Template, if it is defined. For information on Piece Title refer to IME File.

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

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

Cell Rules

Default - 1: The minimum base value for the number of times a cell will repeat after it has played through once and to which the range value (below) is added. For a generative template each bar counts as one repeat; for audio or MIDI content this is the length of the content rounded up to the end of a bar). Note: If the cell contains generative content and the Generative Bar Min is value is set to ∞ then this setting takes no effect as the cell never repeats!

This value is the first of a pair of numbers shown in black in the bottom line of text at the bottom of the cell.

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

This value is the second of a pair of numbers shown in black in the bottom line of text at the bottom of the cell.

Default - Off: Turn this on to force the Cell to loop continuously. Only once Cell per Track can be looped. Turning on Looping for another Cell will turn off Looping for this Cell.

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

Track Rule

Default - Sequence:

Sequence: When the content in the Track's current cell has finished playing, the next Cell in the track will play (unless it has been forced to loop).

One Shot: No Track Cell will play UNTIL it has been triggered (it will display the green "play marker" in the middle of the cell). Once triggered, any content will play through ONCE (like a sting) and then the cell will stop playing.

Loop: No Track Cell will play UNLESS it is forced to loop - either by tap/hold on the cell or by setting the LoopToolbox menu "Randomize" menu functions only the item "Randomize Cell (sticky)" will randomize the Cell. Advanced Tip: Cells in Loop tracks containing Audio/MIDI content will play ONCE when the Column lock is first applied to a Column (if a cell is not already looping); cells containing generative content will be set to play for the length of the mix (∞).

File Info

File name: This displays the name of the audio/MIDI file or original template used in the Cell.

Pak Name: This displays the name of the zip file that includes the template.

Content length (secs): This displays the play length of the content in the cell.

Mix

Random root is chosen for an automatic mix or from the template if created manually: Choose the Root you want to apply to the whole Mix.

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

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

10-7200: This is how long the mix will play for in a Playlist (overridden by Music Play Time). Double tap for a pop-up menu where you can edit the value via on-screen keyboard.

0-7200: A range value added to the Playlist Duration value (overridden by Music Play Time). Double tap for a pop-up menu where you can edit the value via on-screen keyboard.

0-20: This applies when the mix stops playing in a Playlist.

Select to be able to edit the text in the cut-up area as plain text e.g. perhaps to change a word or even add new words (in which case a suitable new matching Rule will be generated).

When in Edit mode, click in a word to place the cursor and press the Esc key to see a drop list of words; or double click a word to select it (once selected if you wait a second and click/hold the word again you can drag it).

Press "Done" when finished to revert back to standard cut-up screen behaviour where tapping a word will lock/unlock it.

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

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

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.

Lines are alternatedly coloured with black and dark grey 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 red when locked). When you select a word (locked or unlocked) it also underlines it to show that it is the selected word (e.g. "inspiring" 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.

This is displayed just above the bottom toolbar. If you tap on one of the four alternative words (e.g. "creative" in the screenshot above) then that word will replace the selected word (e.g. "inspiring" 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.

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

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

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

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

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: 'Free Mode' & Limitations

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

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

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

    A A A A A 
  A A
  A A A
  			  

  would be a "5 2 3" rule.

Rule Syntax

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

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

Line Rule Syntax

Tip: Items in [ ] are optional.

Composite Syntax

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

Back to Files screen.

For details on the Save Changes popup displayed when you press this button see the description of this button in the UI Elements section.

Displays a pop-up menu where you can select:

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

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

iOS: The toggle is only shown ONCE a picture has been selected. Tap on the text otherwise displays a popup menu with the following items:

• Browse: Goes to the Photos app screen where you can select a picture to use as a background image to your wotja. Turn off the toggle to remove the image from the wotja when you next save it. macOS: Select an image using Finder.
• Random: Creates a random icon/thumbnail to use for the mix as according to the "Random > Albums > Icon Palette and Icon Graphic" settings.
• Clear: Removes any icon or picture icon associated with the mix so you can use the Background colour setting.

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

Wotja A iOS Only: Tap anywhere in the center area to go Full Screen mode; when in Full Screen mode, tap anywhere to return to the Display screen.

In Full Screen mode the background picture, if attached, will slowly auto-pan around the screen.