'\" t
.\"     Title: butt
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.10
.\"      Date: 2022-04-20
.\"    Manual: BUTT
.\"    Source: BUTT
.\"  Language: English
.\"
.TH "BUTT" "1" "2022-04-20" "BUTT" "BUTT"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
butt \- Easy to use, multi OS streaming tool
.SH "SYNOPSIS"
.sp
\fBbutt\fP [\-h | \-v | \-s [name] | \-u <song name> | \-M <streaming signal threshold> | \-m <streaming silence threshold> | \-O <recording signal threshold> | \-o <recording silence threshold> | \-Sdrtqn | \-c <config_path>] [\-A | \-U | \-x] [\-a <addr>] [\-p <port>]
.SH "DESCRIPTION"
.sp
\fBbutt\fP (broadcast using this tool) is an easy to use, multi OS streaming tool.
It supports ShoutCast and IceCast and runs on Linux, MacOS and Windows.
The main purpose of \fBbutt\fP is to stream live audio data from your computers Mic or Line input
to an Shoutcast or Icecast server. Recording is also possible.
It is NOT intended to be a server by itself or automatically stream a set of audio files.
.SH "OPTIONS"
.sp
Options:
.sp
\fB\-h\fP
.RS 4
Print help
.RE
.sp
\fB\-v\fP
.RS 4
Print version information
.RE
.sp
Options for operating mode:
.sp
\fB\-c <path>\fP
.RS 4
Path to configuration file
.RE
.sp
\fB\-A\fP
.RS 4
Command server will be accessible from your network/internet (default: localhost only)
.RE
.sp
\fB\-U\fP
.RS 4
Command server will use UDP instead of TCP
.RE
.sp
\fB\-x\fP
.RS 4
Do not start a command server for receiving commands
.RE
.sp
\fB\-p <port>\fP
.RS 4
Port where the command server shall listen to (default: 1256)
.RE
.sp
Options for control mode:
.sp
\fB\-s [name]\fP
.RS 4
Connect to streaming server
.RE
.sp
\fB\-d\fP
.RS 4
Disconnect from streaming server
.RE
.sp
\fB\-r\fP
.RS 4
Start recording
.RE
.sp
\fB\-t\fP
.RS 4
Stop recording
.RE
.sp
\fB\-n\fP
.RS 4
Split recording
.RE
.sp
\fB\-q\fP
.RS 4
Quit butt
.RE
.sp
\fB\-u <song name>\fP
.RS 4
update song name
.RE
.sp
\fB\-S\fP
.RS 4
Request status
.RE
.sp
\fB\-M <seconds>\fP
.RS 4
Set streaming signal threshold
.RE
.sp
\fB\-m <seconds>\fP
.RS 4
Set streaming silence threshold
.RE
.sp
\fB\-O <seconds>\fP
.RS 4
Set recording signal threshold
.RE
.sp
\fB\-o <seconds>\fP
.RS 4
Set recording silence threshold
.RE
.sp
\fB\-U\fP
.RS 4
Connect via UDP instead of TCP
.RE
.sp
\fB\-a <address>\fP
.RS 4
Address of the \fBbutt\fP instance to be controlled (default: 127.0.0.1)
.RE
.sp
\fB\-p <port>\fP
.RS 4
Port of the \fBbutt\fP instance to be controlled (default: 1256)
.RE
.SH "RESSOURCES"
.sp
Project web site: \c
.URL "https://danielnoethen.de/butt" "" ""
.SH "SEE ALSO"
.sp
A more detailed description can be found in the manual at
.URL "http://danielnoethen.de/butt/manual.html" "" ""
.SH "FILES"
.sp
~/.buttrc
.RS 4
\fBbutt\fP configuration file.
.RE
.SH "BUGS"
.sp
Please contact me at \c
.MTO "butt\(atdanielnoethen.de" "" " "
if you find any bugs.
.SH "AUTHORS"
.sp
\fBbutt\fP was written by Daniel Nöthen and other contributors.