Differences

This shows you the differences between two versions of the page.

--- apps:all:saugns [2020/10/22 17:54] – [Documentation] joelkp
+++ apps:all:saugns [2026/08/22 17:36] (current) – [Documentation] v0.5.8b joelkp
@@ Line 2: / Line 2: @@
 {{metacard>}}
-saugns implements the SAU (Scriptable AUdio) language, and is a command-line parser, player, and WAV file writer for SAU scripts.
+saugns implements the SAU (Scriptable AUdio) language, and is a command-line parser, player, and WAV file writer for SAU scripts. It makes it easy to write script files which play sounds when ran. It's also possible to pipe audio data from it over stdout.
-Currently most useful as a command-line generator for tones and PM/FM/AM sounds. Future goals include a language more suitable for music composition.
+Currently most useful for generating tones, sounds, soundscapes, and simple timed sequences. Can be used tersely and simply for that, and for shorter musical pieces.
+Audio generation can use the following types of audio generators and ways of configuring them:
+  * ''A'' – Amplitude generator, produces amplitude offsets i.e. DC offsets
+  * ''N'' – Noise generator, various noise colors and distributions (no pitch control)
+  * ''R'' – Rumble a.k.a. random line segments oscillator, various modes and line types (for pitched, smooth noise, and modulation both of and by noisy signals)
+  * ''W'' – Wave oscillator, various wave types
+  * Parameter sweeps, ADSR envelopes, and modulation by connecting objects – for AM/RM, FM/PM, and more
+  * Options for variations on phase distortion synthesis, and pulsar synthesis
+  * An arbitrary number of generators can be used, and changes to their parameters laid out in time
 ===== Documentation =====
-* {{https://saugns.github.io/usage.html|Command-line usage examples}}
+  * {{https://sau.frama.io/usage.html|Command-line usage}}
+  * {{https://sau.frama.io/language.html|SAU language overview web page}}
-* {{https://saugns.github.io/syntax.html|Guide to the SAU syntax}}
+  * {{https://codeberg.org/sau/saugns/src/stable/sau/doc/README.SAU|SAU language reference (README.SAU)}}
+  * {{https://sau.frama.io/examples.html|Example SAU scripts with audio online}}
-* {{https://github.com/saugns/saugns/blob/master/doc/README.SAU|SAU language reference (README.SAU)}}
 {{tag>synthesis_and_composition_packages signal_generators oss alsa sndio}}
 ~~META:title=saugns~~
-~~META:desc=Scriptable AUdio (SAU) Generation System. Command-line parser, player, and format converter for SAU scripts. Supports ALSA, OSS, and sndio (on OpenBSD).~~
+~~META:desc=Scriptable AUdio (SAU) Generation System. Command-line parser, player, and format converter for SAU scripts. Supports ALSA, OSS, and (on OpenBSD) sndio.~~
-~~META:logo=~~
+~~META:logo=https://saugns.github.io/images/sau-logo88x50.png~~
-~~META:link=https://saugns.github.io~~
+~~META:link=https://sau.frama.io~~
 ~~META:screenshot=~~
 ~~META:banner=~~
@@ Line 23: / Line 31: @@
 ~~META:download=~~
 ~~META:manual=~~
-~~META:version=v0.3.7~~
+~~META:version=v0.5.8b~~
-~~META:releasedate=2020-10-22~~
+~~META:releasedate=2026-08-22~~