'\" t
.\"     Title: mp3fs
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: June 2012
.\"    Manual: User Commands
.\"    Source: mp3fs 0.31
.\"  Language: English
.\"
.TH "MP3FS" "1" "June 2012" "mp3fs 0\&.31" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mp3fs \- mounts and transcodes FLACs to MP3s on the fly
.SH "SYNOPSIS"
.sp
\fBmp3fs\fR [\fIOPTION\fR]\&... \fIFLACDIR\fR \fIMP3DIR\fR
.SH "DESCRIPTION"
.sp
The mp3fs(1) command will mount the directory \fIFLACDIR\fR on \fIMP3DIR\fR\&. Thereafter, accessing \fIMP3DIR\fR will show the contents of \fIFLACDIR\fR, with all FLAC files transparently renamed and transcoded to MP3 format upon access\&.
.SH "OPTIONS"
.PP
\fB\-b, \-obitrate\fR=\fIRATE\fR
.RS 4
Set the bitrate to use for encoding\&. Acceptable values for
\fIRATE\fR
are any which are allowed by the MP3 format\&. According to the manual for LAME, this means:
.sp
For sampling frequencies of 32, 44\&.1, and 48 kHz,
\fIRATE\fR
can be among 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, and 320\&.
.sp
For sampling frequencies of 16, 22\&.05, and 24 kHz,
\fIRATE\fR
can be among 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, and 160\&.
.sp
When in doubt, it is recommended to choose a bitrate among 96, 112, 128, 160, 192, 224, 256, and 320\&. If not specified,
\fIRATE\fR
defaults to 128\&.
.RE
.PP
\fB\-d, \-odebug\fR
.RS 4
Enable debug output\&. This will result in a large quantity of diagnostic information being printed to stderr as the program runs\&. This option will normally not be used\&. It implies
\fB\-f\fR\&.
.RE
.PP
\fB\-\-gainmode, \-ogainmode\fR=\fIMODE\fR
.RS 4
Set mode to use for interpreting ReplayGain tags\&. The allowed values for
\fIMODE\fR
are:

0 \- Ignore all ReplayGain tags\&.

1 \- Prefer album gain tag, but fall back to track gain if album gain is not present\&.

2 \- Use track gain if present\&.
.RE
.PP
\fB\-\-gainref, \-ogainref\fR=\fIREF\fR
.RS 4
Set the reference loudness in decibels to adjust ReplayGain tags\&. ReplayGain software usually defaults to a loudness of 89 dB, but if this is too quiet, a higher value can be set here, causing adjustment of ReplayGain values in tags\&.
.RE
.PP
\fB\-f\fR
.RS 4
Run in foreground instead of detaching from the terminal\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
Print usage information\&.
.RE
.PP
\fB\-\-quality, \-oquality\fR=\fIQUALITY\fR
.RS 4
Set quality for encoding, as understood by LAME\&. The slowest and best quality is 0, while 9 is the fastest and worst quality\&. The default value is 5, although according to the LAME manual, 2 is recommended\&.
.RE
.PP
\fB\-s\fR
.RS 4
Force single\-threaded operation\&.
.RE
.PP
\fB\-V, \-\-version\fR
.RS 4
Output version information\&.
.RE
.SH "COPYRIGHT"
.sp
Copyright (C) 2006\-2008 David Collett and 2008\-2011 Kristofer Henriksson\&. This is free software: you are free to change and redistribute it under the terms of the GNU General Public License (GPL) version 3 or later\&.
.sp
This manual is copyright (C) 2010\-2011 Kristofer Henriksson and may be distributed under the same terms\&.