'\" t
.\" Title:
gsequencer
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 2022-01-20
.\" Manual: gsequencer v3.0.0
.\" Source: gsequencer v3.0.0
.\" Language: English
.\"
.TH "GSEQUENCER" "1" "2022\-01\-20" "gsequencer v3.0.0" "gsequencer v3.0.0"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gsequencer \- Advanced Gtk+ Sequencer is an audio sequencer and composition editor
.SH "SYNOPSIS"
.HP \w'\fB/usr/bin/gsequencer\fR\ 'u
\fB/usr/bin/gsequencer\fR [\-\-help] [\-\-version] [\-\-no\-builtin\-theme] [\-\-non\-unique] [\-\-menu\-bar] [\-\-filename\ \fIfile\fR] [\-\-no\-config]
.SH "DESCRIPTION"
.PP
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\(cqs 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\&.
.PP
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\&.
.PP
The binary looks for a configuration file in $HOME/\&.gsequencer/ags\&.conf\&.
.PP
\&...
.SH "OPTIONS"
.PP
The program follows the usual GNU command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&. For a complete description, see the
\fBinfo\fR(1)
files\&.
.PP
\fB\-\-no\-builtin\-theme\fR
.RS 4
Disable built\-in theme in order to display default theme\&.
.RE
.PP
\fB\-\-non\-unique\fR
.RS 4
Don\*(Aqt attach to any existing application ID, i\&.e\&. fork a new process\&.
.RE
.PP
\fB\-\-menu\-bar\fR
.RS 4
Ignore gtk\-shell\-shows\-menubar from GtkSettings and force showing a traditional GtkMenuBar\&.
.RE
.PP
\fB\-\-filename file\fR
.RS 4
Open file from command line\&.
.RE
.PP
\fB\-\-no\-config\fR
.RS 4
Don\*(Aqt read config from file\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Show summary of options\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Show version of program\&.
.RE
.SH "ENVIRONMENT VARIABLES"
.PP
The program interprets following environment variables if set\&.
.PP
OSS_MIXERDEV
.RS 4
the OSSv4 mixer device
.RE
.PP
LADSPA_PATH
.RS 4
LADSPA plugin search path
.RE
.PP
DSSI_PATH
.RS 4
DSSI plugin search path
.RE
.PP
LV2_PATH
.RS 4
LV2 plugin search path
.RE
.PP
AGS_ANIMATION_FILENAME
.RS 4
The splash screen\*(Aqs background picture
.RE
.PP
AGS_ANIMATION_TEXT_BOX_X0
.RS 4
The splash screen\*(Aqs text box x\-position
.RE
.PP
AGS_ANIMATION_TEXT_BOX_Y0
.RS 4
The splash screen\*(Aqs text box y\-position
.RE
.PP
AGS_ANIMATION_TEXT_COLOR
.RS 4
The splash screen\*(Aqs text color
.RE
.PP
AGS_CSS_FILENAME
.RS 4
The application\*(Aqs style sheet
.RE
.PP
AGS_CONFIG
.RS 4
The config to read from environment instead of $HOME/\&.gsequencer/ags\&.conf
.RE
.SH "ALSA EXAMPLE CONFIGURATION FILE"
.PP
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\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[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
.fi
.if n \{\
.RE
.\}
.SH "OSSV4 EXAMPLE CONFIGURATION FILE"
.PP
This example configuration file is using ALSA backend to play to "/dev/dsp" device\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[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
.fi
.if n \{\
.RE
.\}
.SH "BUGS"
.PP
None\&. So far I know\&.
.SH "AUTHOR"
.PP
Jo\(:el Kr\(:ahemann
.SH "COPYRIGHT"
.br
Copyright \(co 2022 Jo\(:el Kr\(:ahemann
.br
.PP
This manual page is part of GSequencer\&. License GPLv3+: GNU GPL version 3 or (at your option) any later \&.
.PP
This is free software: you are free to change and redistribute it\&. There is NO WARRANTY, to the extent permitted by law\&.
.sp