.\"
.\" Copyright (c) 2005-2007 Alon Bar-Lev <alon.barlev@gmail.com>
.\" Copyright (c) 2007 Andrey Dubovik <andu@inbox.ru>
.\" All rights reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License version 2
.\" as published by the Free Software Foundation.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program (see the file COPYING.GPL included with this
.\" distribution); if not, write to the Free Software Foundation, Inc.,
.\" 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.\"
.Dd Jul 28, 2007
.Os POSIX-compatible
.Dt mp3unicode 1
.Sh NAME
.Nm mp3unicode
.Nd Convert MP3 tags to Unicode
.Sh SYNOPSIS
.Nm mp3unicode
.Op options
.Ar file1
.Op file2
.Op ...
.Sh DESCRIPTION
.Nm mp3unicode
MP3Unicode is a command line utility to convert ID3 tags in mp3 files between
different encodings.
.Pp
In order to see the available encodings execute:
.Bd -literal -offset indent
.Nm iconv --list
.Ed
.Pp
.Sh OPTIONS
.Bl -tag -width "AAAAA"
.It -s, --source-encoding Ar <encoding>
Read current mp3 tags assuming they are encoded with <encoding>.
<encoding> is either "unicode" or any valid 8bit encoding.
.It -1, --id3v1-encoding Ar <encoding>
Write id3v1 tag in <encoding>, if <encoding> is "none", then strip id3v1
tag away. <encoding> may be any valid 8bit encoding, note however that it
is not possible to write id3v1 in Unicode.
.It -2, --id3v2-encoding Ar <encoding>
Write id3v2 tag in <encoding>, if <encoding> is "none", then strip id3v2
tag away. <encoding> may be either "unicode" or any valid 8bit encoding.
.It -p, --preserve-unicode
If source encoding is specified to be some specific encoding and not Unicode,
but the actual encoding seems to be Unicode, then assume it is Unicode. E.g.,
if you want to process a lot of files, some of which are in Unicode (or have
Unicode characters somewhere), but some are in cp1251, just issue -s cp1251 -p
along with other options. This should work as you would like it to work.
.It -w, --preview
Do not modify the files, instead show the tags that would be written. Useful to
test specified options for correctness.
.It -v, --version
Prints version number, compilation date and time.
.It -q, --quiet
Do not report what files have been processed.
.El
.Sh EXAMPLE
.Nm mp3unicode --source-encoding cp1251 --id3v1-encoding none
.Nm --id3v2-encoding unicode file.mp3

will read id3v2 tag (or id3v1 tag if there is no id3v2) from the file, convert
the text fields in the tag from cp1251 to Unicode and will write id3v2 tag
back, stripping away id3v1 tag.
.Pp
.Sh SEE ALSO
.Rs
.%T "mp3unicode Home Page"
.%O http://mp3unicode.sourceforge.net
.Re
.Rs
.Xr iconv 1p
.Re
.Sh AUTHORS AND COPYRIGHT
Copyright (c) 2005-2012 Alon Bar-Lev <alon.barlev@gmail.com>
.Pp
Copyright (c) 2005-2012 Andrey Dubovik
.Pp
All rights reserved.
.Pp
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.