GSEQUENCER(1)

📦 version 9.0.20, in debian bookworm, debian trixie, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

GSEQUENCER 💖 (that's the gsequencer page from the GSEQUENCER(1) manual, bestie)

okay so. sit down. hydrate. because this one? this one is a whole moment.

✨ NAME ✨

gsequencer — Advanced Gtk+ Sequencer is an audio sequencer and composition editor

like. it's a sequencer. it sequences. it edits compositions. iconic behaviour, no notes 💅

🎀 SYNOPSIS 🎀

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

that's it. that's the whole vibe. run the binary, sprinkle flags on top like glitter ✨

🌸 DESCRIPTION 🌸

Advanced GTK+ Sequencer is made for music composition, and it is not doing a little thing. it's doing a LOT of thing. we're talking:

  • a piano roll
  • a synth
  • a matrix editor
  • a drum machine
  • a soundfont2 player
  • a mixer
  • an output panel

and it's designed to be highly configurable, which is the dev way of saying "you have options, bestie, so many options". you can add effects to its effect chain, and you can add or remove audio channels/pads whenever the mood strikes. you can also set up a fully functional network of engines, and because of that there's a link editor for linking audio lines. networking but for audio. periodt 🔥

as of version 1.0.0 it supports LADSPA, DSSI and Lv2 plugin formats. and it gives you 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. so many backends. so many little guys.

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

...

(yeah that ... is literally in the original. i'm not touching it. it's part of the lore 🫶)

👑 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 — turn off the built-in theme so the default theme shows up instead. it's giving "let me see the real you" 💜
  • --non-unique — don't attach to any existing application ID, i.e. fork a new process. go be your own separate little guy 🦋
  • --menu-bar — ignore gtk-shell-shows-menubar from GtkSettings and force showing a traditional GtkMenuBar. retro menu bar rights 🌈
  • --filename file — open file from command line. hand it a file, it opens the file. simple as 🍓
  • --no-config — don't read config from file. no config, no rules, no problem 😭
  • --help — show summary of options. the classic "what do i even do here" button ✨
  • --version — show version of program. for when you gotta know exactly which girl you're running 💅

🧚 ENVIRONMENT VARIABLES 🧚

the program interprets following environment variables if set. (key phrase: if set. it's not gonna go looking for your drama.)

  • 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. look at it go.

[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. (yes, it says ALSA in the original text while the section is OSSv4 and the backend is oss. i am reporting, not judging. i keep the facts, i don't fix them 💀)

[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.

(not me being obsessed with this energy. the confidence. the serenity. the audacity. we stan a bug-free queen 🙈)

🌟 AUTHOR 🌟

Joël Krähemann

Copyright © 2022 Joël Krähemann

This manual page is part of GSequencer. License GPLv3+: GNU GPL version 3 or (at your option) any later <http://gnu.org/licenses/gpl.html>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

fr fr on the NO WARRANTY part, bestie — it's literally in all caps in the original, so you know they mean it 😭

okay that's the whole page, and it came from gsequencer v3.0.0, dated 2022-01-20, from the GSEQUENCER(1) manual. go make some music, you absolute main character 💅✨🎀

📦 where this page comes from