.\"
.\" 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 تبدیل برچسب‌های MP3 به یونیکد
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm mp3unicode
.Op options
.Ar file1
.Op file2
.Op ...
.Sh "توضیحات (DESCRIPTION)"
.Nm mp3unicode
ابزار MP3Unicode یک برنامهٔ خط فرمانی برای تبدیل برچسب‌های ID3 در فایل‌های mp3 بین کدگذاری‌های مختلف است.
.Pp
به منظور مشاهدهٔ کدگذاری‌های موجود، دستور زیر را اجرا کنید:
.Bd -literal -offset indent
.Nm iconv --list
.Ed
.Pp
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width "AAAAA"
.It -s, --source-encoding Ar <encoding>
خواندن برچسب‌های فعلی mp3 با فرض اینکه با <encoding> کدگذاری شده‌اند.
<encoding> می‌تواند "unicode" یا هر کدگذاری ۸ بیتی معتبر دیگری باشد.
.It -1, --id3v1-encoding Ar <encoding>
نوشتن برچسب id3v1 در <encoding>؛ اگر <encoding> برابر با "none" باشد، برچسب id3v1 حذف خواهد شد. <encoding> می‌تواند هر کدگذاری ۸ بیتی معتبر باشد؛ اما توجه داشته باشید که نوشتن id3v1 به صورت یونیکد امکان‌پذیر نیست.
.It -2, --id3v2-encoding Ar <encoding>
نوشتن برچسب id3v2 در <encoding>؛ اگر <encoding> برابر با "none" باشد، برچسب id3v2 حذف خواهد شد. <encoding> می‌تواند "unicode" یا هر کدگذاری ۸ بیتی معتبر دیگری باشد.
.It -p, --preserve-unicode
اگر کدگذاری مبدأ، کدگذاری خاصی غیر از یونیکد تعیین شده باشد ولی کدگذاری واقعی یونیکد به نظر برسد، فرض می‌شود یونیکد است. برای مثال، اگر قصد پردازش پرونده‌های زیادی را دارید که برخی از آن‌ها دارای یونیکد هستند (یا در جایی نویسه‌های یونیکد دارند) اما برخی در قالب cp1251 هستند، کافی است -s cp1251 -p را همراه با سایر گزینه‌ها به کار ببرید. این دستور طبق انتظار شما عمل خواهد کرد.
.It -w, --preview
فایل‌ها را تغییر ندهید، در عوض برچسب‌هایی را که نوشته خواهند شد نمایش دهید. برای بررسی درستی گزینه‌های مشخص‌شده مفید است.
.It -v, --version
چاپ شماره نسخه، تاریخ و زمان کامپایل.
.It -q, --quiet
گزارش ندهید که چه فایل‌هایی پردازش شده‌اند.
.El
.Sh "مثال (EXAMPLE)"
.Nm mp3unicode --source-encoding cp1251 --id3v1-encoding none
.Nm --id3v2-encoding unicode file.mp3

برچسب id3v2 (یا در صورت نبود id3v2، برچسب id3v1) را از فایل خوانده، فیلدهای متنی برچسب را از cp1251 به یونیکد تبدیل می‌کند و برچسب id3v2 را بازنویسی کرده و برچسب id3v1 را حذف می‌نماید.
.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.