gsequencer - Man Page

Advanced Gtk+ Sequencer is an audio sequencer and composition editor

Synopsis

/usr/bin/gsequencer [--help] [--version] [--no-builtin-theme] [--non-unique] [--menu-bar] [--filename file] [--no-config]

Description

Advanced GTK+ Sequencer is intended to use for music composition​. It features a piano roll, as well a synth, matrix editor, drum machine, soundfont2 player, mixer and an output panel​. It’s designed to be highly configurable​. You may add effects to its effect chain; and add or remove audio channels/pads​. You may set up a fully functional network of engines, thus there is a link editor for linking audio lines​.

As version 1​.0​.0 it supports LADSPA, DSSI and Lv2 plugin format​. And provides the ability to export to WAV, FLAC and OGG audio files​. It can run on various soundcard backends including ALSA, OSS4, JACK Audio Connection Kit, Pulseaudio Core-Audio, Audio-Unit and WASAPI​.

The binary looks for a configuration file in $HOME/​.gsequencer/ags​.conf​.

​...

Options

The program follows the usual GNU command line syntax, with long options starting with two dashes (`-')​. A summary of options is included below​. For a complete description, see the info(1) files​.

--no-builtin-theme

Disable built-in theme in order to display default theme​.

--non-unique

Don't attach to any existing application ID, i​.e​. fork a new process​.

--menu-bar

Ignore gtk-shell-shows-menubar from GtkSettings and force showing a traditional GtkMenuBar​.

--filename file

Open file from command line​.

--no-config

Don't read config from file​.

--help

Show summary of options​.

--version

Show version of program​.

Environment Variables

The program interprets following environment variables if set​.

OSS_MIXERDEV

the OSSv4 mixer device

LADSPA_PATH

LADSPA plugin search path

DSSI_PATH

DSSI plugin search path

LV2_PATH

LV2 plugin search path

AGS_ANIMATION_FILENAME

The splash screen's background picture

AGS_ANIMATION_TEXT_BOX_X0

The splash screen's text box x-position

AGS_ANIMATION_TEXT_BOX_Y0

The splash screen's text box y-position

AGS_ANIMATION_TEXT_COLOR

The splash screen's text color

AGS_CSS_FILENAME

The application's style sheet

AGS_CONFIG

The config to read from environment instead of $HOME/​.gsequencer/ags​.conf

Alsa Example Configuration File

This example configuration file is using ALSA backend to play to "hw:CARD=PCH,DEV=0" and capture from "hw:CARD=CODEC,DEV=0" device​.

[generic]
disable-feature=experimental
autosave-thread=false
segmentation=4/4
engine-mode=deterministic
rt-safe=false
gui-scale=1​.0

[soundcard-0]
backend=alsa
capability=playback
buffer-size=512
pcm-channels=2
format=16
samplerate=44100
device=hw:CARD=PCH,DEV=0

[soundcard-1]
backend=alsa
capability=capture
buffer-size=512
pcm-channels=2
format=16
samplerate=44100
device=hw:CARD=CODEC,DEV=0

[recall]
auto-sense=false

[thread]
model=super-threaded
super-threaded-scope=audio
lock-global=ags-thread
lock-parent=ags-recycling-thread
thread-pool-max-unused-threads=4
max-precision=250

Ossv4 Example Configuration File

This example configuration file is using ALSA backend to play to "/dev/dsp" device​.

[generic]
disable-feature=experimental
autosave-thread=false
segmentation=4/4
engine-mode=deterministic
rt-safe=false
gui-scale=1​.0

[soundcard-0]
backend=oss
capability=playback
buffer-size=512
pcm-channels=2
format=16
samplerate=44100
device=/dev/dsp

[recall]
auto-sense=false

[thread]
model=super-threaded
super-threaded-scope=audio
lock-global=ags-thread
lock-parent=ags-recycling-thread
thread-pool-max-unused-threads=4
max-precision=250

Bugs

None​. So far I know​.

Author

Joël Krähemann

Info

2022-01-20 gsequencer v3.0.0