0.1 Clip-List

The Clip-List allows to start playback of individual clips.

0.2 Piano-Roll

The piano-roll editor displays notes in a grid where the vertical axis denotes the pitch and the horizontal axis the time line. It is modeled after a classic piano-roll. Several tools can be selected via a drop down menu or hotkeys which aid with creation, selection and modification of musical events. The cursor keys can be used to move selected notes, in combination with modifier keys the keys can also change note duration or note focus. A context menu is available with mouse button 3, which provides extended functionality.

0.2.1 Select Tool

Crosshair The Select Tool allows selection of single notes or groups of notes. Modifier keys can be used to modify the selection behavior.

0.2.2 Horizontal Select

0.2.3 Paint Tool

Pen With the note Paint Tool, notes can be placed everywhere in the grid by clicking mouse button 1 and possibly keeping it held during drags.

0.2.4 Move Tool

Pen With the note Move Tool, selected notes can be moved clicking mouse button 1 and keeping it held during drags. A copy will be made instead of moving the selected notes if the ctrl key is pressed during drag.

0.2.4.1 Resizing Notes

H-Resize When the Paint Tool is selected, the right edge of a note can be draged to make notes shorter or longer in duration.

0.2.5 Erase Tool

Eraser The Erase Tool allows deletion of all notes selected during a mouse button 1 drag. The deletion can be aborted by the Escape key.

1 Manual Pages

1.1 ANKLANG(1)

NAME

anklang - Music composition and modular synthesis application

SYNOPSIS

anklang [OPTIONS] [FILES...]

DESCRIPTION

Anklang is a digital audio synthesis application for live creation and composition of music and other audio material. It is released as free software under the MPL-2.0.

Anklang comes with synthesis devices which can be arranged in tracks and controlled via MIDI input devices or pre-programmed clips which contain MIDI notes.

The Anklang sound engine is a dedicated process which is controlled by a user interface based on web technologies that can be run in a special process (like electron) or modern browsers like firefox(1) or google-chrome(1).

OPTIONS

Anklang supports short and long options which start with two dashes ('-').

--
Stop argument processing, treat remaining arguments as files.
-h, --help
Show a help message about command line usage.
--fatal-warnings
Abort on warnings and failing assertions, useful for test modes.
--check
Execute internal tests and benchmarks.
--disable-randomization
Enable deterministic random numbers for test modes.
-v, --version
Print information about the program version.

SEE ALSO

Anklang Website

2 Anklang Scripting

The functionality of Anklang can be extended by user provided scripts. The scripts are written in Javascript and run as part of the User Interface threads.

Scripts can extend editing functionality or implement new controllers. The exact functions provided by a script are registered at script startup time.

2.1 Reference for ui/host.js

2.2 WorkerClip

Ase::Clip proxy

2.3 WorkerHost

Global host instance for scripts.

2.3.1 WorkerHost class

class WorkerHost

piano_roll_clip ()
Create handle for the currently selected clip.
script_name ()
Retrieve the file name of the current user script.
script_uuid ()
Retrieve the UUID set via use_api().
api_level ()
Retrieve numeric API level supported by this runtime.
use_api (api_level, script_uuid)
Request use of API level api_level and provide UUID for controllers.
register (category, label, fun, blurb, params)
Register a script function.