SMWAVSET(1)

📦 version 0.6.1, in arch rolling, nixos 26.05, nixpkgs unstable

💖 NAME 💖

okay so this is SMWAVSET(1), straight from the smwavset Manual Page, and the name says it all, bestie: smwavset is the program to manage spectmorph multiwave files. 💅

🌈 SYNOPSIS 🌈

smwavset <command> [OPTIONS] [ <command specific args>... ]

That's literally the shape of every call, no cap. ✨

✨ DESCRIPTION ✨

smwavset is a command line tool to manage multi-wave files for SpectMorph. The usual vibe is: first you initialize a multi-wave file with the init command, then you add different wave files using the add command. After that, encoding all waves can be done with one single command, like decoding all waves. 🎀

🎀 OPTIONS 🎀

smwavset follows the usual GNU command line syntax, with long options starting with two dashes. periodt.

  • -h, --help — shows a brief help message. 🫶
  • -v, --version — prints out smwavset version. 💖
  • --args <arguments> — specify additional arguments to be passed to smenc/smplay. This could be --args "-O1" for encoding, or --args "--no-sines" for decoding. iykyk. ✨
  • -d, --data-dir — for encoding/decoding, this sets a data directory where the .wav files or a list of .wav files (or .sm files) live. It is important that different wavsets store their files in different directories (otherwise they will overwrite wav files that belong to a different wavset). So specifying a proper data directory which is different for each wavset is usually necessary. The default value is /tmp, which is only appropriate for testing; you should ensure that scripts setup a different value. this part matters, bestie 😭
  • --format <field1>,<field2>,<field3>,...,<fieldN> — set the output format for the list command. 🦋
  • -j <jobs> — use <jobs> parallel jobs for encoding (for systems with more than one processor). 🔥

👑 COMMANDS 👑

  • init [ <options> ] <wavset>... — initializes a new wavset; can also initialize more than one wavset specified on the commandline. 🌱
  • add [ <options> ] <wavset> <midi_note> <path> — adds a wave file to the wavset, where midi_note is the midi note the wave file has been recorded for. 🎵
  • list [ <options> ] <wavset> — lists the wave files that are contained within the wavset. The output format for the list command can be specified using the format option (comma seperated fields). See the FIELDS section for a list of valid fields. 📋
  • encode [ <options> ] <wset_filename> <smset_filename> — encodes a wavset using smenc. 🧚
  • decode [ <options> ] <smset_filename> <wset_filename> — decodes a wavset using smplay. 🌸
  • delta [ <options> ] <wset_filename1>...<wset_filenameN> — computes the difference between many wavsets. The difference between the first and second wavset is the reference which is 100%. The other wavsets are measured against that reference. 📊
  • link <smset> — this command includes all .sm files that are referred to by the smset in one big file. This is useful as final step when building instruments. 🔗

🦋 FIELDS 🦋

For the list command, valid fields are:

  • midi-note — midi note of the audio entry (0-127). 🎹
  • channel — channel for the audio entry (0 is the first channel). 🎚️
  • filename — filename of the audio entry. 📁
  • min-velocity — minimum velocity of the audio entry (0-127). 🍓
  • max-velocity — maximum velocity of the audio entry (0-127). ⭐

💜 SEE ALSO 💜

💖 okay bestie, that's the whole page: Revision 591, dated 2011-07-20, from SMWAVSET(1) and the smwavset Manual Page. slay. 🎀

📦 where this page comes from