Apollo User Guide (0.9.4b1)

General Interface

Apollo interface is divided into two sections: the Browse tab and the Generate tab.

Page Navigation for login/logout is located on the top left part of the window [1] as shown in the annotated screenshot below

Browse

Browse Interface
  • [1] Page Navigation Menu: Login, Logout
  • [2] Application Tabs: Browse, Generate
  • [3] Context Menu:
    • New: Create a new empty corpus with a name
    • Delete: Delete the selected corpus [4]
  • [4] Select a corpus to work with
  • [5] Add new MIDI files to an existing corpus
  • [6] Table that displays all tracks from the selected corpus [4]
  • [6] Download all MIDI files from the corpus by clicking on “All” (as a .zip file)
  • [7] MIDI Viewer bar: to visualize selected MIDI file
  • [8] MIDI Player:
    • Player controls:
      • Song title,
      • Repeat when done,
      • Previous track in the table of MIDI files,
      • Play/stop,
      • Next track in the table of MIDI files,
      • Individual dowload button
    • MIDI Streaming port: Stream to a MIDI port. Apollo discovers and displays all available MIDI ports on your machine. By default, Apollo enables a port called “Apollo MIDI Port” for use. This will stop and restart the track
    • Soundfont: select the MIDI sound source for playback
    • Tempo adjustment
    • Volume slider
  • [8] MIDI Player Keyboard Shortcuts:
    • Spacebar: Play/Stop
    • “V”: previous track
    • “B”: next track




MIDI Viewer

MIDI Viewer
  • [7.1] MIDI channel block: one per MIDI channel, enables MIDI manipulation and settings
  • [7.2] MIDI channel properties:
    • Instrument: the MIDI GM Standard instrument assigned to this channel
    • MIDI Channel number for this channel
  • [7.3] MIDI controls: delete, mute, solo. Mute and Solo requires stopping and restarting playback to take effect.
  • [7.4] MIDI Channel Piano Roll:
    • Display timeline/grid
    • Display existing MIDI notes
    • Notes are color-coded
  • [7.5] Add a new MIDI channel to the MIDI file: a new MIDI channel block [7.1] is added at the end of the viewer (scroll down if necessary)

Generate

Generate Interface
  • [9] Model name: this is where a session model is created for a MIDI file send to generation using the “take_off” icon in the Browse tab.
  • [10] Seed MIDI path: the MIDI file originally selected for generation from the Browse tab
  • [10] Select “Edit bar selections for generation” to configure your generation work.
  • [11] General generative parameters: Use to constraint the model’s generative work
  • [12] Generate Options:
    • Batch size: This is the number of MIDI files you want to generate at once
    • Generate Button: This will effectively run the generation of MIDI files given the configured settings and controls
  • [13] Table of generated MIDI files for the selected session model. Generated MIDI files are displayed here
  • [13] Naming convention for generated files: “numberfrombatch_random.batch.id_generalparamsfirstletter_generalparamvalues_ 

MIDI View: Generative Mode

  • [14] Indicates that the MIDI Viewer is in “Generative Mode”
  • [16] Bar selection: This is achieved by a drag-selection action using your mouse. Selecting Bars for MIDI Generation.
  • [17] Channel-specific controls for generation
  • [15] MIDI channel properties
    • Instrument: the MIDI GM Standard instrument assigned to this channel
    • MIDI Channel number for this channel