SILAN(1)

📦 version 0.4.0, in opensuse-leap 16.0

🎀 SILAN(1) — the Soundfile Silence Analyzer bestie 💅

okay so real talk, this is the manual page for silan, a User Command and your new bestie for finding the quiet parts of audio files. she's literally a Soundfile Silence Analyzer and she's iconic for it. ✨

💖 NAME 💖

silan — Soundfile Silence Analyzer. that's it, that's the whole vibe. 🦋

✨ SYNOPSIS ✨

silan [ OPTIONS ] <file-name>

yes bestie, options first, file name last. give her a file to chew on and she'll tell you where it's quiet. 🍓

🌸 DESCRIPTION 🌸

silan — Audiofile Silence Analyzer. no cap, that's the description. she analyzes audiofiles for silence. main character energy fr. 👑

🌈 OPTIONS 🌈

  • -h, --help — displays the help text and dips out. classic. 💅
  • -b, --bounds — skip the silence mid-file, bestie. just prints the start/end boundaries only. 🎀
  • -B, --fastbounds — same as -b, except the sound-off gets detected by decoding backwards from the end. it's much faster but also inacurate. yes i said it, that's the manpage's spelling, we keep it 💀
  • -f, --format <format> — pick your output format (default: 'txt')
  • -F, --filter <float> — high-pass filter coefficient (default: 0.98). disable it with 1.0; the range is 0 < val <= 1.0. respect the range bestie 🙈
  • -i, --include-initial — display the initial state (don't assume initial silence at the start). let her cook 🔥
  • -o, --output <filename> — write the data to a file instead of stdout. fancy. ✨
  • -p, --progress — show progress info on stderr. so you know she's working and not ghosting you 🫶
  • -q, --quiet — inhibit error messages. shhh. 🤫
  • -s, --threshold <float> — RMS signal threshold (default: 0.001 ^= -60dB). postfix it with 'd' to specify decibels 💜
  • -t, --holdoff <float> — holdoff time in seconds (default: 0.5) ⭐
  • -u, --unit <unit> — specify output unit (default: 'seconds')
  • -v, --verbose — increase the debug-level (can be used multiple times). stack 'em, go feral 🌸
  • -V, --version — print version information and exit. bye bestie 👋

🦋 THE DEETS 🦋

this application reads a single audio file and analyzes it for silent periods. timestamps/ranges of silence get printed to standard output. literally her whole job. 💖

valid output formats are: txt, JSON, audacity (label file)

valid output units are: samples, seconds or bytes (audacity format uses seconds regardless. no you don't get a choice, that's just how she is 💅)

🧚 how sound detection works, iykyk

sound is detected if the signal level exceeds a given threshold for a duration of at least <holdoff> time. note that the returned timestamps are corrected for the holdoff-time. important detail, don't forget it 🔥

🌟 the fastbounds tea 🌟

the fast boundary scan can decrease the time it takes to analyze a file at the cost of accuracy. use --fastbounds with care.

due to low-pass filtering and RMS calculation the results will be different (+- .1 sec). furthermore, some codecs are not suitable for backwards decoding or sample-accurate seeking and may skew the timestamp by one second or more. also the fast boundary scan mode requires a seekable file and does not work with streams. periodt. 💀

😭 REPORTING BUGS 😭

report bugs to Robin Gareus <robin@gareus.org>

website and manual: <https://github.com/x42/silan>

Copyright © GPL 2012-2018 Robin Gareus <robin@gareus.org>

and that's the whole page bestie 🫶 — brought to you by silan version 0.4.0, dated May 2018, filed under SILAN(1). slay, go analyze some silence 💜✨🎀

📦 where this page comes from