Ongenet
On this page

Scripting

Quick steps

  1. Open the Scripting centre tab (after Video), or use Pop out for a separate window.
  2. Pick a factory script or load/save a .cs file from Documents/Ongenet/Scripts/.
  3. Edit in the built-in IDE (syntax highlighting, diagnostics, IntelliSense); click Run for batch automation or Start live for event handlers.
  4. Read api.Log() output in the console.

Portable export

  • Export project — generates a portable C# script that rebuilds the open project via api.* calls (no audio PCM; re-link sample paths).
  • Export preset — exports the selected track's instrument slot or FX chain as a pasteable script snippet.
  • Save exported scripts with Save as… into Documents/Ongenet/Scripts/ to reuse on any machine.

Details

Ongenet embeds a Roslyn C# scripting host with a curated IScriptingApi:

  • Project — tempo, time signature, key, playback mode, clear/rebuild
  • Transport — play, stop, seek, loop region, playhead
  • Tracks — all track kinds, mute/solo/arm, routing, sends
  • Devices — instruments, effects, presets, parameters
  • Clips — MIDI notes/CC, audio metadata, automation, patterns, session clips
  • Timeline meta — markers, chord track, drum maps, video layers/items, overlays, triggers
  • Video — GetVideoEnabled / SetVideoEnabled, GetVideoLayers / AddVideoLayer, GetVideoLayerItems / AddVideoLayerItem, GetVideoTriggers / AddVideoTrigger
  • MIDI bulk — quantize, transpose, velocity scale, humanize, chance
  • Live handlers — transport state, beat grid, clip changes (Start live)

Scripts have no general filesystem or process API. Desktop scripts may write only the explicit paths passed to ExportAudio / MatchAlbumLoudness — see Dev: Scripting for the full API and security limits.

Batch example

api.SetTempo(128.0);
foreach (var track in api.GetTracks())
    api.Log($"{track.Name}: {track.Volume:P0}");

Live example

api.OnTransportStateChanged(state =>
    api.Log(state == ScriptTransportState.Playing ? "Playing" : "Stopped"));

Video example

api.SetVideoEnabled(true);
foreach (var layer in api.GetVideoLayers())
    api.Log($"Layer: {layer.Name} (z={layer.ZOrder})");

Mastering and export

Desktop scripts can drive delivery targets, meter taps, factory master chains, and offline bounces:

using System.Linq;

var master = api.GetTracks().First(t => t.Kind == ScriptTrackKind.Master);
api.ApplyMasteringChain(master.Id, "reference");
api.SetDeliveryTarget("Spotify");
api.SetMasterMeterTap(ScriptMasterMeterTap.PreLimiter);

api.ExportAudio("/tmp/master.wav",
    normalizeLoudness: true,
    bitDepth: 16,
    applyDither: true,
    ditherMode: ScriptDitherMode.NoiseShaped,
    targetSampleRate: 44100,
    exportComparisonPair: true);

api.MatchAlbumLoudness(new[] { "/tmp/01.wav", "/tmp/02.wav" }, -14, -1);

Use ApplyMasteringChain for whole-recipe replacement; use AddEffect when building a custom chain insert-by-insert. Web Demo and Android do not expose these APIs — see Mastering.