.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "ABX 1"
.TH ABX 1 2024-03-09 "abx 0.0~b1" "User Commands"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
abx \- audio ABX testing software
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.IP "abx \fI[OPTIONS...]\fR \fI<SAMPLE\-A\fR> \fI<SAMPLE\-B\fR>" 4
.IX Item "abx [OPTIONS...] <SAMPLE-A> <SAMPLE-B>"
.SH DESCRIPTION
.IX Header "DESCRIPTION"
abx is a program for performing software-based audio ABX testing on GNU/Linux
systems. ABX test (Wikipedia, Hydrogenaudio) is a statistical test for assessing
whether you are able to tell for audible differences between two samples. For
example, one sample can be a compressed audio file such as OGG Vorbis file and
another one its uncompressed variant (WAV, AU, ...). You can then use abx to
infer whether you are able to separate the two samples due to compression
artifacts.
.SH OPTIONS
.IX Header "OPTIONS"
.SS "Application Options"
.IX Subsection "Application Options"
.IP "\fB\-i\fR \fIN\fR, \fB\-\-num\-trials\fR=\fIN\fR" 4
.IX Item "-i N, --num-trials=N"
Do \fIN\fR trials.
.IP "\fB\-d\fR \fIID\fR, \fB\-\-audio\-device\fR=\fIID\fR" 4
.IX Item "-d ID, --audio-device=ID"
Use PortAudio audio device \fIID\fR
.IP \fB\-\-display\fR==\fIDISPLAY\fR 4
.IX Item "--display==DISPLAY"
X display to use
.SS "Help Options"
.IX Subsection "Help Options"
.IP "\fB\-\-help\fR, \fB\-h\fR" 4
.IX Item "--help, -h"
Show help options
.IP \fB\-\-help\-all\fR 4
.IX Item "--help-all"
Show all help options
.IP \fB\-\-help\-gtk\fR 4
.IX Item "--help-gtk"
Show GTK+ options
.SS "GTK+ Options"
.IX Subsection "GTK+ Options"
.IP \fB\-\-class\fR=\fICLASS\fR 4
.IX Item "--class=CLASS"
Program class as used by the window manager
.IP \fB\-\-name\fR=\fINAME\fR 4
.IX Item "--name=NAME"
Program name as used by the window manager
.IP \fB\-\-screen\fR=\fISCREEN\fR 4
.IX Item "--screen=SCREEN"
X screen to use
.IP \fB\-\-sync\fR 4
.IX Item "--sync"
Make X calls synchronous
.IP \fB\-\-gtk\-module\fR=\fIMODULES\fR 4
.IX Item "--gtk-module=MODULES"
Load additional GTK+ modules
.IP \fB\-\-g\-fatal\-warnings\fR 4
.IX Item "--g-fatal-warnings"
Make all warnings fatal
.SH AUTHOR
.IX Header "AUTHOR"
abx is written by Petteri Hintsanen <petterih@iki.fi> and is licensed under the
GNU General Publication License, version 3 or above.
.PP
This manual page was written by Chow Loong Jin <hyperair@debian.org> for the
Debian system (but may be used by others). Permissions is granted to copy,
distribute, and/or modify this document under the terms of the GNU General
Public License, Version 3 or any later version published by the Free Software
Foundation.
.PP
On Debian systems, the full text of the GNU General Public License, Version 3
can be found in /usr/share/common\-licenses/GPL\-3.