.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
.TH SILAN "1" "June 2013" "silan version 0.3.1" "User Commands"
.SH NAME
silan \- Soundfile Silence Analyzer
.SH SYNOPSIS
.B silan
[ \fIOPTIONS \fR] \fI<file-name>\fR
.SH DESCRIPTION
silan \- Audiofile Silence Analyzer.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-b\fR, \fB\-\-bounds\fR
skip silence mid file.
print start/end boundaries only.
.TP
\fB\-B\fR, \fB\-\-fastbounds\fR
same as \fB\-b\fR, except the sound\-off is detected by
decoding backwards from the end.
This is much faster but also inacurate.
.TP
\fB\-f\fR, \fB\-\-format\fR <format>
specify output format (default: 'txt')
.TP
\fB\-F\fR, \fB\-\-filter\fR <float>
high\-pass filter coefficient (default:0.98)
disable: 1.0; range 0 < val <= 1.0
.TP
\fB\-o\fR, \fB\-\-output\fR <filename>
write data to file instead of stdout
.TP
\fB\-p\fR, \fB\-\-progress\fR
show progress info on stderr
.TP
\fB\-q\fR, \fB\-\-quiet\fR
inhibit error messages
.TP
\fB\-s\fR, \fB\-\-threshold\fR <float>
RMS signal threshold (default 0.001 ^= \fB\-60dB\fR)
postfix with 'd' to specify decibels
.TP
\fB\-t\fR, \fB\-\-holdoff\fR <float>
holdoff time in seconds (default 0.5)
.TP
\fB\-u\fR, \fB\-\-unit\fR <unit>
specify output unit (default: 'seconds')
.TP
\fB\-v\fR, \fB\-\-verbose\fR
increase debug\-level (can be used multiple times)
.TP
\fB\-V\fR, \fB\-\-version\fR
print version information and exit
.PP
This application reads a single audio file and analyzes it for
silent periods. Timestamps/ranges of silence are printed to standard output.
.PP
Valid output formats are: txt, JSON, audacity (label file)
.PP
Valid output units are: samples, seconds (audacity format uses seconds regardless).
.PP
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.
.PP
The fast boundary scan can decrease the time it takes to analyze a file
at the cost of accuracy.
Use \fB\-\-fastbounds\fR 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.
The fast boundary scan mode requires a seekable file and does not work with
streams.
.SH "REPORTING BUGS"
Report bugs to Robin Gareus <robin@gareus.org>
.br
Website and manual: <https://github.com/x42/silan>
.SH COPYRIGHT
Copyright \(co GPL 2012 Robin Gareus <robin@gareus.org>