kid3 - آنلاین در ابر

برنامه:

نام

kid3, kid3-qt, kid3-cli - Kid3 ID3 Tagger

خلاصه

kid3 [--کمک | -مارپیچ | -مارپیچ | --کمک-همه
|--نویسنده | - نسخه | --مجوز] [فایل...]

kid3-qt [گزینه های Qt] [فایل...]

kid3-cli [-h | --کمک] [-c دستور 1] [-c دستور 2...] [فایل...]

OPTIONS

فایل
If فایل مسیر یک دایرکتوری است، باز خواهد شد. اگر یک یا چند مسیر فایل باشد
داده شده، دایرکتوری مشترک آنها باز می شود و فایل ها انتخاب می شوند.

kid3
--کمک
در مورد گزینه ها راهنمایی نشان دهید.

-مارپیچ
گزینه های خاص Qt را نشان دهید، ببینید qtoptions(7).

-مارپیچ
نمایش گزینه های خاص KDE، ببینید kdeoptions(7).

--کمک-همه
نمایش همه گزینه ها

--نویسنده
نمایش اطلاعات نویسنده

- نسخه
نمایش اطلاعات نسخه

--مجوز
نمایش اطلاعات مجوز

kid3-qt
گزینه های Qt
دیدن qtoptions(7)، با این حال، گزینه ها "-" به عنوان پیشوند دارند، نه "--".

kid3-cli
-c
یک دستور را اجرا کنید. چندگانه -c گزینه ها ممکن است، آنها به ترتیب اجرا می شوند.
برای توضیح دستورات موجود، بخش مربوط به kid3-cli را ببینید.

-h|--کمک
در مورد گزینه ها و دستورات راهنمایی نشان دهید.

معرفی

Kid3 اپلیکیشنی برای ویرایش تگ های ID3v1 و ID3v2 در فایل های MP3 به روشی کارآمد است.
این برچسب ها توسط اکثر پخش کننده های MP3 قابل ویرایش هستند، اما نه به صورت بسیار راحت و کارآمد
مسیر. علاوه بر این برچسب ها در Ogg/Vorbis، Opus، DSF، FLAC، MPC، APE، MP4/AAC، MP2، Speex،
فایل‌های TrueAudio، WavPack، WMA، WAV، AIFF و ماژول‌های ردیاب (MOD، S3M، IT، XM) هستند.
نیز پشتیبانی می شود.

Kid3 فایل‌های MP3 را نمی‌گیرد و کدگذاری نمی‌کند، اما هدف آن ویرایش برچسب‌های ID3 همه است.
فایل های یک آلبوم به روشی کارآمد، یعنی با کمترین کلیک ماوس و زدن کلید
ممکن است. جایی که اکثر برنامه های دیگر می توانند تگ های ID3v1 یا ID3v2 را ویرایش کنند، Kid3 دارای کامل است
کنترل هر دو نسخه، می تواند تگ ها را بین دو فرمت تبدیل کند و به همه دسترسی دارد
برچسب های ID3v2 برچسب های چندین فایل را می توان روی یک مقدار تنظیم کرد، به عنوان مثال هنرمند، آلبوم،
سال و ژانر همه فایل‌های آلبوم معمولاً مقادیر یکسانی دارند و قابل تنظیم هستند
با یکدیگر. اگر اطلاعات برچسب ها در نام فایل موجود باشد، تگ ها می توانند باشند
به طور خودکار از نام فایل تنظیم می شود. همچنین امکان تنظیم نام فایل بر اساس آن وجود دارد
به تگ های موجود در فایل در قالب های دلخواه.

وظیفه ویرایش بیشتر با جایگزینی خودکار کاراکترها یا
رشته های فرعی، به عنوان مثال برای حذف کاراکترهای غیرقانونی از نام فایل ها. کنترل خودکار از
حروف بزرگ و کوچک استفاده از یک طرح نامگذاری ثابت را در همه آسان می کند
برچسب ها

اطلاعات برچسب برای فول آلبوم ها را می توان از آن گرفت gnudb.org[1]، TrackType.org[2]،
MusicBrainz[3]، مشروبات الکلی[4]، آمازون[5] یا سایر منابع لیست آهنگ. قالب واردات
آزادانه توسط عبارات منظم قابل تنظیم است.

لطفاً هرگونه مشکل یا درخواست ویژگی را به نویسنده گزارش دهید.

استفاده كردن KID3

Kid3 امکانات
· ویرایش برچسب های ID3v1.1

· ویرایش تمام فریم های ID3v2.3 و ID3v2.4

· ویرایش برچسب ها از چندین فایل

· تبدیل بین ID3v1 و ID3v2 تگ

· ویرایش MP3، Ogg/Vorbis، Opus، DSF، FLAC، MPC، APE، MP4/AAC، MP2، Speex، TrueAudio،
برچسب های WavPack، WMA، WAV و AIFF

· تولید برچسب ها از نام فایل

· ایجاد برچسب از محتویات فیلدهای برچسب

· تولید نام فایل از برچسب ها

· تولید و تغییر نام دایرکتوری از برچسب ها

· تولید فایل لیست پخش

· تبدیل خودکار مورد و ترجمه رشته

· واردات از gnudb.org[1]، TrackType.org[2]، MusicBrainz[3]، مشروبات الکلی[4]، آمازون[5] و
سایر منابع داده

· صادرات به عنوان CSV، HTML، لیست پخش، Kover XML و فرمت های دیگر. فایل های CSV صادر شده می تواند باشد
دوباره وارد شد

مثال استفاده
این بخش یک جلسه معمولی با Kid3 را توضیح می دهد. فرض کنید یک دایرکتوری داریم
حاوی فایل های MP3 با آهنگ های آلبوم "Let's Tag" از گروه "One Hit"
نام دایرکتوری در قالب "هنرمند - آلبوم" در مورد ما One Hit Wonder است
- بیا تگ کنیم دایرکتوری حاوی تراک هایی با فرمت "Track title.mp3" است که من
فکر می کنم مفید است زیرا نام فایل ها کوتاه هستند (در هنگام استفاده از پخش کننده های MP3 موبایل مهم است
با نمایشگرهای کوچک) و به ترتیب صحیح در صورت مرتب شدن بر اساس حروف الفبا (مهم است که
با استفاده از پخش کننده های سخت افزاری MP3 که آهنگ ها را به ترتیب حروف الفبا یا به ترتیب پخش می کنند
که روی سی دی رایت می شوند و در هنگام استفاده به ترتیب حروف الفبا می باشد mkisofs). بعلاوه
این، اطلاعات هنرمند و آلبوم از قبل در نام دایرکتوری موجود است و ندارد
در نام فایل تکرار شود. اما به مثال ما برگردیم، فهرست دایرکتوری به نظر می رسد
این:

01 Intro.mp3

02 ما فقط این یکی را گرفتیم.mp3

03 Outro.mp3

این فایل ها هنوز تگ ندارند و می خواهیم با استفاده از Kid3 آنها را تولید کنیم. ما از Open (File
منو یا نوار ابزار) و یکی از فایل های این فهرست را انتخاب کنید. همه فایل ها خواهد بود
در لیست فایل نمایش داده می شود. همانطور که تنبل هستیم، می خواهیم از اطلاعات موجود در آن استفاده کنیم
نام دایرکتوری و فایل برای تولید تگ. بنابراین ما همه فایل ها را انتخاب می کنیم، سپس روی آن کلیک می کنیم
To:در قسمت File دکمه 1 را تگ کنید. با این کار عنوان، هنرمند، آلبوم و آهنگ تنظیم می شود
مقادیر در همه فایل ها برای تنظیم سال و مقادیر ژانر همه فایل ها، همه فایل ها را نگه می داریم
انتخاب کنید و "2002" را برای سال تایپ کنید و "Pop" را از جعبه ترکیبی ژانر انتخاب کنید. برای تنظیم
فقط این دو مقدار، چک باکس های آنها به طور خودکار بررسی می شوند و همه چک باکس های دیگر
بدون بررسی رها می شوند. حالا فقط با انتخاب اولین فایل و ما انتخاب را تغییر می دهیم
ببینید که همه تگ ها حاوی مقادیر صحیح هستند. برچسب‌های فایل‌های دیگر قابل تأیید است
همچنین با انتخاب یک به یک آنها. وقتی از تگ ها راضی بودیم از Save (File
منو یا نوار ابزار). با انتخاب Create Playlist از منوی File یک فایل One ایجاد می شود
Wonder را بزنید - Let's Tag.m3u را در دایرکتوری قرار دهید.

COMMAND منابع

La GUI عناصر
رابط کاربری گرافیکی Kid3 در پنج بخش جدا شده است: در سمت چپ فایل و فهرست هستند
لیست باکس ها، سمت راست شامل بخش های File، Tag 1 و Tag 2 است.

پرونده فهرست
لیست فایل شامل نام تمام فایل های موجود در فهرست باز شده است که مطابقت دارند
فیلتر نام فایل انتخابی (معمولا *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac
*.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). یک یا
چندین فایل را می توان انتخاب کرد. برای انتخاب هیچ فایلی، در قسمت خالی بعد از کلیک کنید
ورودی های فهرست انتخاب فایل هایی را که تحت تاثیر قرار می گیرند تعیین می کند
عملیاتی که با استفاده از دکمه های شرح داده شده در زیر در دسترس هستند.

علاوه بر نام، ستون‌های دیگر Size, Type, Date را می‌توان با جزئیات فایل تغییر داد
نمایش داده. ستون ها را می توان با برداشتن تیک نام آنها در منوی زمینه پنهان کرد
سرفصل لیست ترتیب ستون ها را می توان با کشیدن و رها کردن تغییر داد. ترتیب مرتب سازی
را می توان با کلیک بر روی سربرگ ستون تغییر داد.

در سمت چپ نام ها می توان یک نماد نمایش داده شود: یک دیسک برای نشان دادن وجود فایل
اصلاح شده یا اطلاعاتی در مورد اینکه کدام برچسب ها وجود دارد (V1، V2، V1V2 یا NO TAG، خیر
اگر فایل هنوز خوانده نشده باشد، نماد نمایش داده می شود.

دایرکتوری ها با نماد پوشه نمایش داده می شوند. اگر یک دایرکتوری باز شود، فایل های آن هستند
در یک درخت سلسله مراتبی نمایش داده می شود. با انتخاب فایل ها از زیر شاخه ها، عملیات
را می توان بر روی فایل های موجود در دایرکتوری های مختلف اجرا کرد که در صورت پخش موسیقی مفید است
مجموعه با یک پوشه برای هر هنرمند شامل پوشه‌هایی برای آلبوم‌های سازماندهی شده است
این هنرمند

با کلیک بر روی دکمه سمت راست ماوس در داخل لیست فایل، یک منوی زمینه باز می شود
دستورات زیر:

· Expand all: همه درختان پوشه را گسترش می دهد (فقط درخت فعلی اگر کلید shift باشد
فشرده)

· Collapse all: همه درختان پوشه را جمع می کند

· تغییر نام: نام یک فایل را تغییر می دهد

· انتقال به سطل زباله: یک فایل را به سطل زباله منتقل می کند

· پخش: یک فایل را پخش می کند، به پخش مراجعه کنید

· ورودی های بعدی دستورات کاربر هستند که می توانند در User Actions تعریف شوند
تب Configure Kid3. پخش با دوبار کلیک نیز می تواند در آنجا فعال شود.

فهرست راهنما فهرست
فهرست دایرکتوری شامل نام دایرکتوری ها در دایرکتوری باز شده است
همچنین دایرکتوری فعلی (.) و والد (..). این اجازه می دهد تا به سرعت تغییر کند
دایرکتوری بدون استفاده از دستور Open... یا کشیدن و رها کردن.

نمایان بودن ستون، ترتیب و مرتب سازی را می توان همانطور که در بخش توضیح داده شد پیکربندی کرد
در مورد لیست فایل

پرونده
اطلاعات مربوط به رمزگذاری را نشان می دهد (MP3، Ogg، Opus، DSF، FLAC، MPC، APE، MP2، MP4،
AAC، Speex، TrueAudio، WavPack، WMA، WAV، AIFF)، نرخ بیت، نرخ نمونه، کانال ها و
طول فایل

ویرایش خط نام حاوی نام فایل است (اگر فقط یک فایل انتخاب شده باشد).
اگر این نام تغییر کند، با استفاده از دستور Save، نام فایل تغییر خواهد کرد.

کادر ترکیبی Format و ویرایش خط حاوی فرمتی است که باید در هنگام استفاده از نام فایل استفاده شود
از تگ اول یا دوم تولید می شود. نام فایل می تواند شامل موارد دلخواه باشد
کاراکترها، حتی یک بخش دایرکتوری که با یک اسلش از نام فایل جدا شده است، اما این
برای موفقیت در تغییر نام، دایرکتوری باید از قبل وجود داشته باشد. کدهای ویژه زیر
برای درج مقادیر تگ در نام فایل استفاده می شود:

· %s %{title} عنوان (آهنگ)

· %a %{artist} هنرمند

· %l %{آلبوم} آلبوم

· %c %{comment} نظر

· %y %{year} سال

· %t %{track} آهنگ (به عنوان مثال 01)

· %t %{track.n} آهنگ با عرض میدان n (به عنوان مثال 001 برای %{track.3})

· %T %{tracknumber} آهنگ (بدون صفرهای ابتدایی، به عنوان مثال 1)

· ژانر %g %{genre}

· %{ignore} هنگام ایجاد برچسب از نام فایل نادیده گرفته می شود

کدهای قالب به مثال های ذکر شده در بالا محدود نمی شوند. هر نام قاب می تواند باشد
استفاده می شود، به عنوان مثال نام فریم های یکپارچه مانند %{bpm} یا فرمت نام های خاص مانند
%{popm}.

دومین کادر ترکیبی Format (با فلش رو به پایین) برای تولید تگ ها استفاده می شود
نام فایل. اگر فرمت نام فایل با این الگو مطابقت ندارد، چند مورد دیگر
فرمت های رایج مورد استفاده امتحان شده است.

برخی از قالب‌های رایج نام فایل در حال حاضر در جعبه ترکیبی موجود هستند، اما اینطور است
همچنین امکان تایپ در فرمت خاصی در ویرایش خط وجود دارد.

From:Tag 1, Tag 2: نام فایل را با استفاده از فرمت انتخاب شده و اولین تگ یا تنظیم می کند
تگ دوم به ترتیب

To:Tag 1, Tag 2: برچسب ها از روی نام فایل تنظیم می شوند. ابتدا فرمت مشخص شده در
فرمت استفاده می شود. اگر نام فایل موجود با این فرمت مطابقت ندارد، موارد زیر را انجام دهید
فرمت ها امتحان می شوند:

· هنرمند - آلبوم / آهنگ آهنگ

· آلبوم / آهنگ - هنرمند - آهنگ

· /هنرمند - آلبوم - آهنگ - آهنگ

· آلبوم / هنرمند - آهنگ - آهنگ

· آلبوم/هنرمند - آهنگ

· هنرمند / آلبوم / آهنگ آهنگ

اگر یک فایل انتخاب شود، کنترل‌های رابط کاربری گرافیکی با مقادیر استخراج‌شده پر می‌شوند
از نام فایل اگر چندین فایل انتخاب شده باشد، تگ های فایل ها مستقیما می باشد
با توجه به نام فایل ها تنظیم کنید.

برچسب 1
ویجت های ویرایش خط برای عنوان، هنرمند، آلبوم، نظر، سال، آهنگ و ژانر عبارتند از
برای ویرایش مقدار مربوطه در اولین تگ فایل های انتخاب شده استفاده می شود. ارزش
هنگامی که انتخاب فایل تغییر می کند یا قبل از عملیاتی مانند ذخیره و
خروج و زمانی که تیک مربوطه در سمت چپ نام فیلد علامت زده شود.
این برای تغییر فقط برخی از مقادیر و بدون تغییر باقی گذاشتن مقادیر دیگر مفید است.

اگر یک فایل منفرد انتخاب شده باشد، تمام چک باکس ها علامت زده می شوند و ویجت های ویرایش خط
حاوی مقادیر موجود در تگ های این فایل باشد. اگر برچسبی در فایل یافت نشد،
مقدار خالی مربوطه نمایش داده می شود که یک رشته خالی برای عنوان است،
ویرایش‌های خط هنرمند، آلبوم و نظر، 0 برای ویرایش‌های سال عددی و آهنگ و یک
مقدار انتخاب شده را برای جعبه ترکیبی Genre خالی کنید. مقادیر را می توان تغییر داد و اگر
چک باکس مربوطه علامت زده شده است، آنها برای فایل انتخابی بعد از تنظیم تنظیم می شوند
انتخاب تغییر می کند سپس فایل به عنوان تغییر یافته توسط یک نماد دیسک در فایل علامت گذاری می شود
لیست باکس اما تا زمانی که دستور Save استفاده نشود بدون تغییر باقی می ماند.

اگر چند فایل انتخاب شده باشد، فقط مقادیری که در همه انتخاب شده یکسان هستند
فایل ها نمایش داده می شوند. در تمام کنترل های دیگر، مقادیر خالی همانطور که در بالا توضیح داده شد هستند
نمایش داده. برای جلوگیری از تغییرات ناخواسته، علامت تمام چک باکس ها را بردارید. اگر یک مقدار باید
برای همه فایل های انتخاب شده تنظیم شود، می توان آن را ویرایش کرد و کادر انتخاب باید تنظیم شود. را
هنگامی که انتخاب تغییر می کند، مقادیر برای همه فایل های انتخاب شده تنظیم می شود و می تواند باشد
با استفاده از دستور Save ذخیره می شود.

چک باکس ها همچنین عملکرد اکثر دستورات موثر بر برچسب ها را کنترل می کنند
به عنوان کپی، چسباندن و انتقال بین تگ های 1 و 2. برای سهولت استفاده از آن
چندین فایل که در آن همه چک باکس ها بدون علامت هستند، این دستورات به یک شکل عمل می کنند
زمانی که همه چک باکس ها علامت زده می شوند و زمانی که همه چک باکس ها علامت ندارند.

از تگ 2: فیلدهای تگ 1 از مقادیر مربوطه در تگ 2 تنظیم می شوند.
یک فایل انتخاب می شود، کنترل های رابط کاربری گرافیکی با مقادیر تگ 2 پر می شوند
چندین فایل انتخاب می شوند، برچسب های فایل ها مستقیماً تنظیم می شوند.

کپی: بافر کپی با مقادیر Tag 1 پر شده است. فقط مقادیر با علامت زده شده است
چک باکس در دستورات بعدی Paste استفاده خواهد شد.

Paste: مقادیر را از بافر کپی در کنترل‌های رابط کاربری گرافیکی جای‌گذاری می‌کند.

Remove: این همه کنترل‌های رابط کاربری گرافیکی را روی مقادیر خالی تنظیم می‌کند که منجر به حذف می‌شود
همه ارزش ها سپس فایل ذخیره شده حاوی برچسب 1 نخواهد بود.

برچسب 2
کنترل‌های رابط کاربری گرافیکی به همان روشی که برای بخش Tag 1 توضیح داده شد، عمل می‌کند، اما
اندازه رشته ها محدود نیست.

برای ژانر تگ 2 همچنین می توانید از نام های خود علاوه بر ژانرهای فهرست شده در آن استفاده کنید
جعبه ترکیبی، فقط نام را در ویرایش خط تایپ کنید.

تگ 2 نه تنها می تواند حاوی همان مقادیر تگ 1 باشد، بلکه فرمت آن در a ساخته شده است
راه انعطاف پذیر از چندین فریم که خود از چندین فیلد تشکیل شده اند. در
جدول تگ 2 تمام فریم های موجود در فایل انتخاب شده را نشان می دهد.

ویرایش: با این کار پنجره ای باز می شود که به فرد اجازه می دهد تمام فیلدهای انتخاب شده را ویرایش کند
قاب اگر چندین فایل انتخاب شده باشد، فیلدهای ویرایش شده برای همه انتخاب شده اعمال می شود
فایل هایی که حاوی چنین قاب هستند.

افزودن: یک درخواست کننده برای انتخاب نوع فریم و یک فریم از نوع انتخاب شده ظاهر می شود
قابل ویرایش و افزودن به فایل این همچنین برای افزودن یک فریم به چند مورد نیز کار می کند
فایل های انتخاب شده

Delete: فریم انتخاب شده را در فایل های انتخابی حذف می کند.

اگر فایل دارای جلد هنری جاسازی شده نباشد، آثار هنری آلبوم را در اینجا بکشید نشان داده می‌شود. آ
تصویر را می توان با کشیدن و رها کردن از یک مرورگر یا مدیر فایل اضافه کرد و خواهد بود
در اینجا نمایش داده شده است. با دوبار کلیک کردن روی این قاب عکس ها را می توان ویرایش یا اضافه کرد
کنترل.

همگام شده متن ترانه و واقعه تنظیم وقت کد
برای اطلاعات همگام شده با داده های صوتی، یک ویرایشگر خاص در دسترس است.
این فریم ها برای تگ های ID3v2.3.0 و ID3v2.4.0 پشتیبانی می شوند. برای افزودن چنین قاب،
نام فریم خاصی باید در لیستی که با دکمه Add ظاهر می شود انتخاب شود
کلیک شده است - متن ترانه های همگام یا کدهای زمان رویداد، به ترتیب. ویرایشگر است
برای هر دو نوع یکسان است، برای کدهای زمان‌بندی رویداد، فقط مجموعه‌ای از رویدادها از پیش تعریف شده است
در دسترس است در حالی که برای اشعار همگام شده، متن باید وارد شود. در
در ادامه، ویرایش اشعار همگام توضیح داده شده است.

فایلی با برچسب ID3v2 انتخاب می شود، ویرایشگر اشعار با استفاده از Add و وارد می شود
انتخاب اشعار همگام شده برای یک قاب اشعار همگام‌سازی شده موجود، این است
انتخاب شده و ویرایش کلیک می شود. پخش کننده به طور خودکار با فایل فعلی باز می شود
به طوری که فایل می تواند پخش شود و برای همگام سازی اشعار متوقف شود.

تنظیمات بالای ویرایشگر SYLT معمولاً نیازی به تغییر ندارند. اگر
اشعار شامل کاراکترهایی است که در مجموعه کاراکترهای لاتین 1 وجود ندارند،
تغییر رمزگذاری متن به UTF16 (یا UTF8 برای ID3v2.4.0) توصیه می شود. برای انگلیسی
اشعار و حداکثر سازگاری، ISO-8859-1 باید استفاده شود.

بخش Lyrics دارای پنج دکمه در بالا است. افزودن یک رویداد زمانی جدید را در قسمت اضافه می کند
جدول. زمان از موقعیت بازیکن گرفته می شود، بنابراین یک ورودی در حالی که اضافه می شود
پخش آهنگ یک خط برای موقعیت پخش فعلی اضافه می کند. حوادث در
جدول باید به ترتیب زمانی باشد، بنابراین ردیف درج خواهد شد
بر این اساس. ورودی‌های دارای زمان نامعتبر به‌طور ویژه رفتار می‌شوند: اگر در حال حاضر
سطر انتخاب شده دارای زمان نامعتبر است، مهر زمانی آن با زمان فعلی جایگزین می شود
به جای اضافه کردن یک ردیف جدید اگر زمان فعلی نامعتبر نیست، ردیف اول با علامت
در صورت وجود از زمان نامعتبر استفاده خواهد شد. این رفتار باید افزودن زمان را تسهیل کند
اگر متن اشعار از قبل در جدول وجود داشته باشد اما مهرهای زمانی از بین رفته باشد، مهر می زند
(که در هنگام وارد کردن اشعار غیرهمگام صدق می کند). توجه داشته باشید که زمان نامعتبر است
به عنوان 00:00.00 نشان داده می شود، یعنی همان زمان در ابتدای مطلق
آهنگ، که نامعتبر نیست. برای نامعتبر کردن زمان، کلید Delete را فشار دهید یا از آن استفاده کنید
از منوی زمینه پاک کنید. ردیف‌های جدید با استفاده از درج ردیف از منوی زمینه درج شدند
یا هنگام وارد کردن اشعار غیرهمگام با From Clipboard یا Import نیز ایجاد می شود
حاوی مهرهای زمانی نامعتبر است. سطرهای جدول را می توان با کلیک بر روی Delete حذف کرد
را فشار دهید یا با استفاده از حذف ردیف ها از منوی زمینه.

اشعار همگام شده را می توان از یک فایل با استفاده از Import وارد کرد. قالب مورد انتظار است
LRC ساده یا پیشرفته اگر فایل انتخابی شامل یک براکت مربع در
خط اول، قرار است یک فایل متنی ساده با اشعار غیرهمگام باشد. در
سپس خطوطی از چنین فایلی با مهرهای زمانی نامعتبر وارد می شوند. زمان
اطلاعات را می توان با استفاده از دکمه افزودن یا با ورود دستی اضافه کرد. همچنین امکان پذیر است
برای وارد کردن اشعار از طریق کپی-پیست با استفاده از From Clipboard. اشعار همگام می تواند باشد
با استفاده از Export روی فایل های LRC نوشته می شود. توجه داشته باشید که فقط ورودی‌هایی که دارای مهر زمانی معتبر هستند، این کار را انجام خواهند داد
صادر شود و ورودی ها بر اساس زمان مرتب شوند. ورودی های با زمان نامعتبر
در قاب SYLT نیز ذخیره نخواهد شد، بنابراین مطمئن شوید که تمام زمان بندی را در نظر بگیرید
اطلاعات قبل از خروج از گفتگو

La ID3 مشخصات[6] برای هر هجا یک مهر زمانی پیشنهاد می کند. با این حال اکثر بازیکنان
فقط از جزئیات یک خط یا جمله پشتیبانی می کند. برای پشتیبانی از هر دو مورد استفاده، Kid3
از همان قراردادها پیروی می کند SYLT ویرایشگر[7]. متنی که در جدول وارد می شود
فرض می شود که یک خط جدید را شروع می کند مگر اینکه با فاصله یا خط فاصله شروع شود. استثناها
این قانون با شروع یک خط با خط زیر ('_') برای اجبار امکان پذیر است
ادامه یا علامت هش ('#') برای اجبار یک خط جدید. این شخصیت های فراری نیستند
داخل قاب SYLT ذخیره می شود. در داخل قاب SYLT، خطوط جدید با تغذیه خط شروع می شوند
کاراکتر (هگز 0A) در حالی که ادامه ها اینطور نیستند. هنگام خواندن فریم های SYLT، Kid3 چک می کند
اگر اولین ورودی با تغذیه خط شروع شود. اگر اینطور نباشد، فرض می شود
که همه مدخل ها سطرهای جدید هستند و از ادامه هجا استفاده نمی شود.

در حالی که آهنگ پخش می شود، ردیف مربوط به موقعیت پخش فعلی است
برجسته شده است، به طوری که صحت اطلاعات همگام سازی می تواند باشد
تایید شده است. اگر باید یک افست به یک یا چند تمبر زمانی اضافه شود، این می تواند باشد
با منوی زمینه افزودن افست انجام می شود. برای کاهش می توان از مقادیر منفی استفاده کرد
زمان. با استفاده از Seek to position در منوی زمینه، امکان تنظیم آن وجود دارد
موقعیت بازی تا زمان سطر انتخاب شده.

La پرونده فهرست
فایل → باز کردن... (Ctrl+O)
یک دایرکتوری را باز می کند. تمام فایل های مطابق با فیلتر نام فایل انتخابی نمایش داده می شوند
در لیست باکس فایل و فایل انتخابی انتخاب می شود.

فایل → اخیر را باز کنید
فهرستی که اخیراً باز شده را باز می کند.

فایل → باز کردن دایرکتوری... (Ctrl+D)
یک دایرکتوری را باز می کند. تمام فایل های مطابق با فیلتر نام فایل انتخابی نمایش داده می شوند
در لیست باکس فایل

فایل → ذخیره (Ctrl+S)
تمام فایل های تغییر یافته را در دایرکتوری ذخیره می کند. فایل های تغییر یافته با دیسک مشخص می شوند
نماد در لیست فایل اگر نام هر فایلی تغییر کرده باشد، آن فایل ها تغییر خواهند کرد
تغییر نام داد.

فایل → برگرداندن
تغییرات یک یا چند فایل را برمی گرداند. اگر هیچ فایلی در فایل انتخاب نشده باشد
لیست باکس، تغییرات همه فایل‌ها برگردانده می‌شوند، در غیر این صورت فقط تغییرات فایل‌ها
فایل های انتخاب شده برگردانده می شوند.

فایل → وارد کردن...
از کادر گفتگوی Import می توان برای وارد کردن داده ها به طور مستقیم از سرور freedb.org، از یک استفاده کرد
سرور MusicBrainz، از Discogs، Amazon یا سایر منابع لیست آهنگ آلبوم در
قالب متنی

وارد کردن از یک سرور freedb.org با استفاده از یک گفتگو که در هنگام From ظاهر می شود امکان پذیر است
Server:gnudb.org یا TrackType.org انتخاب شده است. هنرمند و نام آلبوم برای جستجو
را می توان در دو قسمت بالای صفحه وارد کرد، آلبوم هایی که با پرس و جو مطابقت دارند خواهند بود
هنگامی که Find کلیک می شود و نتایج از www.gnudb.org[8] دریافت می شود.
وارد کردن اطلاعات آهنگ برای یک آلبوم با دوبار کلیک کردن روی آلبوم در قسمت انجام می شود
فهرست سرور freedb.org برای وارد کردن از آن می تواند و همچنین مسیر CGI انتخاب شود.
داده های وارد شده در جدول پیش نمایش گفتگوی واردات نمایش داده می شود. چه زمانی
با رضایت از آهنگ های نمایش داده شده، می توان آنها را با پایان دادن به واردات وارد کرد
گفتگو با OK

جستجو در سرور Discogs را می توان با استفاده از Discogs انجام داد. همانطور که در gnudb.org
گفت و گو، می توانید هنرمند و آلبوم را وارد کنید و سپس از لیستی از انتشارات انتخاب کنید. اگر
برچسب های استاندارد علامت گذاری شده است، اطلاعات استاندارد وارد می شود، به عنوان مثال هنرمند، آلبوم، و
عنوان. اگر برچسب‌های اضافی علامت‌گذاری شده باشد، اطلاعات بیشتری در صورت موجود بودن وارد می‌شود، به عنوان مثال
نوازندگان، تنظیم کنندگان، یا ناشر. اگر Cover Art علامت گذاری شده باشد، Cover Art خواهد بود
در صورت موجود بودن دانلود می شود

جستجو در آمازون را می توان با استفاده از آمازون انجام داد. همانطور که در گفتگوی gnudb.org، می توانید
هنرمند و آلبوم را وارد کنید و سپس از لیستی از انتشارات انتخاب کنید. اگر برچسب های اضافی است
علامت گذاری شده، اطلاعات بیشتری در صورت موجود بودن وارد می شود، به عنوان مثال، اجراکنندگان، تنظیم کنندگان، یا
ناشر اگر Cover Art علامت گذاری شده باشد، در صورت موجود بودن Cover Art دانلود می شود.

می توانید به همین ترتیب در پایگاه داده انتشار MusicBrainz با استفاده از From جستجو کنید
انتشار MusicBrainz. گردش کار همان چیزی است که برای From gnudb.org توضیح داده شد.

وارد کردن از سرور MusicBrainz با استفاده از گفتگوی که هنگام From ظاهر می شود امکان پذیر است
اثر انگشت MusicBrainz انتخاب شده است. سرور را می توان مانند freedb انتخاب کرد
گفتگوی واردات در زیر جدولی وجود دارد که داده‌های آهنگ وارد شده را نشان می‌دهد. ستون سمت راست
وضعیت پرس و جو MusicBrainz را نشان می دهد که در هنگام گفتگو با "در انتظار" شروع می شود
باز می شود. سپس اثر انگشت جستجو می شود و اگر نتیجه ای حاصل نشد،
جستجوی دیگری با استفاده از تگ های موجود در فایل امتحان شده است. بنابراین می تواند برای یک
جستجوی موفق MusicBrainz برای ذخیره اطلاعات شناخته شده (به عنوان مثال هنرمند و آلبوم) در
برچسب ها قبل از واردات اگر نتیجه ای پیدا شد، جستجو در وضعیت به پایان می رسد
"شناسایی"، در غیر این صورت چیزی یافت نشد یا چندین نتیجه مبهم و یکی از
آنها باید توسط کاربر انتخاب شوند. OK و Apply از داده های وارد شده استفاده کنید، لغو کنید
دیالوگ را می بندد بسته شدن می تواند مدتی طول بکشد زیرا کل دستگاه MusicBrainz است
باید تعطیل شود

برای وارد کردن داده های متنی، From File/Clipboard یک زیر دیالوگ را باز می کند که در آن چندین
فرمت های واردات از پیش پیکربندی شده در دسترس هستند. دو مورد اول، "CSV unquoted" و "CSV
quoted" می تواند برای وارد کردن داده هایی استفاده شود که توسط کادر گفتگوی صادرات صادر شده اند. CSV
داده ها را می توان با یک صفحه گسترده ویرایش کرد و باید با استفاده از زبانه ها به عنوان جداکننده نوشته شود.
سپس باید با استفاده از «CSV quoted» که انعطاف‌پذیرتر از «CSV» است، واردات انجام شود
بدون نقل قول
از Kid3 و وارد کردن بعد، "CSV unquoted" را می توان به عنوان یک قالب ساده برای این مورد استفاده کرد
هدف توجه داشته باشید که دستورات "Export CSV" و "Import CSV" نیز در این قسمت وجود دارد
منوی زمینه لیست فایل، که از اسکریپت ها برای صادرات و وارد کردن داده های CSV در یک استفاده می کند
راهی کامل تر، قدرتمندتر و انعطاف پذیرتر.

فرمت بعدی، "متن HTML freeb"، می تواند برای کپی کردن اطلاعات از یک صفحه HTML استفاده شود
of freedb.org[9]. یک آلبوم را در freedb جستجو کنید و در صورت وجود اطلاعات مورد نظر
نمایش داده شده در مرورگر وب، محتویات را در کلیپ بورد کپی کنید. سپس بر روی From کلیک کنید
دکمه کلیپ بورد و آهنگ های وارد شده در جدول پیش نمایش نمایش داده می شوند
بالای دیالوگ اگر از داده های وارد شده راضی هستید، گفتگو را خاتمه دهید
با OK، که داده ها را در تگ های دایرکتوری فعلی وارد می کند. را
مقصد (برچسب 1، تگ 2 یا تگ 1 و تگ 2) را می توان با یک جعبه ترکیبی انتخاب کرد. در
فایل‌های موجود در فهرست فعلی باید به ترتیب مسیر صحیح باشند تا تگ‌های خود را دریافت کنند
اختصاص داده. این در صورتی است که آنها شماره گذاری شوند.

فرمت واردات از پیش پیکربندی شده بعدی، "مبنای HTML freedb"، در صورت داده می تواند مورد استفاده قرار گیرد
به عنوان یک سند HTML در دسترس است. واردات با استفاده از دکمه From File امکان پذیر است که
یک انتخابگر فایل را باز می کند یا محتوای آن را از یک ویرایشگر کپی می کند و سپس از آن وارد می کند
کلیپ بورد این قالب می تواند برای واردات آفلاین مفید باشد، اگرچه سند HTML
همچنین می تواند در یک مرورگر باز شود و سپس در قالب اول از طریق وارد شود
کلیپ بورد

فرمت های از پیش پیکربندی شده بیشتری، به عنوان مثال "Track Title Time" در دسترس هستند. یک رسم خالی
فرمت را می توان با افزودن ایجاد کرد تا توسط کاربر تنظیم شود. دو خط زیر نام قالب
را می توان با یک عبارت منظم تنظیم کرد تا فیلدها را از متن واردات ضبط کند. در
اولین عبارت منظم یک بار در هر سند برای جمع آوری داده های هر آلبوم تجزیه می شود
مانند هنرمند، آلبوم، سال و ژانر. سعی شده است خط دوم از روی همخوانی داشته باشد
شروع سند تا انتها برای دریافت داده های مسیر، معمولاً شماره و عنوان. در
عبارات منظم شامل تمام ویژگی های ارائه شده توسط Qt است که بیشتر آن چیزی است
پرل ارائه می دهد. ساختارهای براکتینگ "(..)" بافرهای ضبط را برای فیلدها ایجاد می کنند
وارد کنید و قبل از کدهای Kid3 مشخص کنید که کدام فیلد را بگیرد. در
کدها همان کدهایی هستند که برای قالب نام فایل استفاده می شود، علاوه بر کدهای ذکر شده در زیر،
هر نام فریم ممکن است:

· %s %{title} عنوان (آهنگ)

· %a %{artist} هنرمند

· %l %{آلبوم} آلبوم

· %c %{comment} نظر

· %y %{year} سال

· %t %{track} آهنگ

· ژانر %g %{genre}

· مدت زمان %d %{duration}

به عنوان مثال، یک آهنگ عبارت منظم (خط دوم) برای وارد کردن از لیست پخش m3u
می تواند "%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n] باشد. تمامی فرمت ها قابل تغییر است
با ویرایش عبارات معمولی و نام و سپس کلیک بر روی ذخیره تنظیمات. آنها
در فایل kid3rc در دایرکتوری تنظیمات ذخیره می شود. این فایل می تواند باشد
مستقیماً ویرایش می شود تا فرمت های وارداتی بیشتری داشته باشد یا می توان آن را حذف کرد تا به آن بازگردد
فرمت های پیش فرض قالب ها را می توان با استفاده از Remove حذف کرد.

دقت تخمینی را نشان می دهد که چقدر اطلاعات وارد شده با داده شده مطابقت دارد
آهنگ های. از مدت زمان آهنگ یا نام فایل برای محاسبه سطح شباهت استفاده می کند
درصد Cover Art نشانی اینترنتی تصویر جلد آلبوم را که دانلود می شود نشان می دهد.

برای بررسی اینکه آیا آهنگ‌های وارد شده با مجموعه فایل‌های فعلی مطابقت دارند یا خیر، مدت زمان
آهنگ های وارد شده را می توان با مدت زمان فایل ها مقایسه کرد. این گزینه می تواند باشد
با چک باکس فعال شد حداکثر اختلاف زمانی مجاز و حداکثر را بررسی کنید
تفاوت قابل تحمل در زمان را می توان در ثانیه تنظیم کرد. اگر عدم تطابق در طول است
شناسایی شده، طول با پس زمینه قرمز در جدول پیش نمایش نمایش داده می شود.

ترتیب فایل‌ها متفاوت از آهنگ‌های وارداتی، آهنگ‌های اختصاص‌داده‌شده آن‌ها است
باید تغییر کنند این کار را می توان با استفاده از مطابقت با طول دکمه ها تسهیل کرد،
آهنگ، و عنوان، که ترتیب آهنگ ها را مطابق فیلد مربوطه تغییر می دهد.
برای تصحیح تکالیف به صورت دستی، یک آهنگ را می توان با دکمه سمت چپ ماوس کشید
و کلید Ctrl را نگه دارید و سپس در مکان جدید رها کنید.

هنگامی که گفتگوی واردات باز می شود، حاوی محتوای واقعی تگ ها است. برچسب
نوع (برچسب 1، تگ 2، تگ 1 و تگ 2) را می توان با استفاده از جعبه ترکیبی مقصد انتخاب کرد.
از دکمه سمت راست این جعبه ترکیبی می توان برای برگرداندن جدول به حالت استفاده کرد
محتوای فعلی برچسب ها از چک باکس های ستون جدول اول می توان استفاده کرد
آهنگ های وارد شده را انتخاب کنید. این می تواند مفید باشد اگر یک پوشه حاوی این باشد
ترک های هر دو سی دی یک سی دی دوبل و فقط تراک های سی دی دوم باید باشند
وارداتی

برای شناسایی تراک هایی که وارد می شوند، امکان نمایش نام فایل ها وجود دارد
مسیرهای کامل فایل ها با استفاده از منوی زمینه هدر جدول. مقادیر در
جدول واردات قابل ویرایش است. دکمه بازگشت در سمت راست مقصد
از جعبه ترکیبی می توان برای بازیابی محتویات تگ ها استفاده کرد که می تواند مفید باشد
پس از تغییر مقصد

تقریباً همه دیالوگ ها دارای دکمه Save Settings هستند که می توان از آن برای ذخیره سازی استفاده کرد
تنظیمات خاص گفتگو و اندازه پنجره به طور مداوم.

From Tags به یک زیر دیالوگ برای تنظیم فریم های برچسب از محتویات برچسب دیگر منتهی می شود
قاب ها از این می توان برای کپی کردن اطلاعات بین تگ ها یا استخراج بخشی استفاده کرد
از یک فریم و آن را در قاب دیگری وارد کنید.

همانطور که در واردات از فایل/کلیپ بورد، فرمت های آزادانه قابل تنظیم برای اجرا وجود دارد
عملیات های مختلف فرمت هایی برای کپی کردن مقدار آلبوم از قبل پیکربندی شده اند
هنرمند، آهنگساز یا رهبر آلبوم و استخراج شماره آهنگ از فیلدهای عنوان
که حاوی یک عدد هستند. همچنین قالبی برای استخراج زیرنویس از عنوان وجود دارد
رشته.

مثال زیر نحوه اضافه کردن یک قالب سفارشی را توضیح می دهد که اطلاعات را تنظیم می کند
از قسمت زیرنویس نیز در قسمت نظر. با استفاده از Add و یک قالب جدید ایجاد کنید
یک نام جدید تنظیم کنید، به عنوان مثال "زیرنویس برای نظر". سپس «%{subtitle}» را در Source و وارد کنید
"%{comment}(.*)" برای Extraction و روی Save Settings کلیک کنید.

عبارت در Source می تواند حاوی کدهای قالب برای فریم های تگ دلخواه، چندگانه باشد
از کدها می توان برای ترکیب محتویات فریم های مختلف استفاده کرد. برای هر آهنگ، یک
متن از برچسب های آن با استفاده از فرمت Source و عبارت منظم تولید می شود
از Extraction روی این متن اعمال می شود تا مقادیر جدیدی برای تگ ها تنظیم شود. فرمت کدها
قبل از پرانتزهای گرفتن برای مشخص کردن قاب برچسب که در آن گرفته شده استفاده می شود
متن باید ذخیره شود. به همان روشی که برای واردات از فایل/کلیپ بورد کار می کند.

فایل → وارد کردن از gnudb.org...
با استفاده از جستجوی آلبوم gnudb.org از سرور freedb.org وارد کنید. این آیتم منو باز می شود
همان محاوره import مانند Import...، اما مستقیماً گفتگوی gnudb.org را باز می کند.

فایل → وارد کردن از TrackType.org...
از سرور TrackType.org وارد کنید. این آیتم منو همان گفتگوی واردات را باز می کند
وارد کردن...، اما مستقیماً گفتگوی TrackType.org را باز می کند.

فایل → وارد کردن از Discogs...
از سرور Discogs وارد کنید. این آیتم منو همان گفتگوی واردات را باز می کند
وارد کردن...، اما مستقیماً گفتگوی From Discogs را باز می کند.

فایل → واردات از آمازون...
واردات از آمازون این آیتم منو همان محاوره واردات را با Import... باز می کند، اما
مستقیماً گفتگوی From Amazon را باز می کند.

فایل → وارد کردن از MusicBrainz Release...
واردات از پایگاه داده انتشار MusicBrainz. این آیتم منو همان واردات را باز می کند
گفتگو به عنوان Import...، اما مستقیماً گفتگوی From MusicBrainz Release را باز می کند.

فایل → وارد کردن از اثر انگشت MusicBrainz...
وارد کردن از سرور MusicBrainz. این آیتم منو همان گفتگوی واردات را باز می کند
وارد کردن...، اما مستقیماً کادر گفتگوی اثر انگشت From MusicBrainz را باز می کند.

فایل → وارد کردن خودکار...
وارد کردن خودکار به فرد اجازه می دهد تا اطلاعات چندین آلبوم را از وب های مختلف وارد کند
خدمات. اگر دایرکتوری ها در لیست فایل انتخاب شده اند، داده های انتخاب شده را ردیابی کنید
دایرکتوری ها وارد خواهند شد. اگر هیچ دایرکتوری انتخاب نشده باشد، تمام دایرکتوری های موجود در فایل
لیست وارد خواهد شد.

نوع برچسب (برچسب 1، تگ 2، تگ 1 و تگ 2) را می توان با استفاده از مقصد انتخاب کرد.
جعبه ترکیبی

نمایه ها تعیین می کنند که با کدام سرورها برای واکشی اطلاعات آلبوم تماس گرفته می شود. مقداری
پروفایل ها از پیش تعریف شده اند (همه، MusicBrainz، Discogs، Cover Art)، پروفایل های سفارشی می توانند
با استفاده از دکمه افزودن در سمت راست کادر ترکیبی Profile اضافه شده است.

جدول زیر سرورهایی را نشان می دهد که هنگام وارد کردن اطلاعات آلبوم مورد استفاده قرار می گیرند
با استفاده از نمایه انتخاب شده اگر تمام شود، فرآیند واردات یک آلبوم تمام شده است
اطلاعات مورد نیاز پیدا شده است، بنابراین ترتیب ردیف ها در جدول است
مهم. با استفاده از دکمه های Move Up و Move Down می توان آن را تغییر داد. ویرایش می تواند باشد
برای تغییر یک ورودی موجود استفاده می شود. انتخاب سرور همان سرورهایی را که می تواند ارائه می دهد
در توابع واردات استفاده شود. برچسب های استاندارد، برچسب های اضافی، هنر جلد تعیین می کنند
اطلاعاتی که باید از سرور واکشی شود. در نهایت، دقت است
حداقل دقتی که برای پذیرش داده های وارد شده باید به دست آید. اگر دقت
کافی نیست، سرور بعدی در لیست امتحان خواهد شد. همان گفت و گو حاوی
هنگامی که برای افزودن یک ورودی سرور جدید روی Add کلیک می شود، ویژگی های سرور ظاهر می شود. موجود
ورودی ها را می توان با استفاده از حذف حذف کرد.

برای راه اندازی یک وارد کردن دسته ای خودکار با نمایه انتخاب شده، روی شروع کلیک کنید. جزئیات
در مورد واردات در حال اجرا در بالای کادر گفتگو نمایش داده می شود. فرآیند می تواند باشد
با دکمه Abort سقط شد.

فایل → مرور روی جلد...
گفتگوی Browse Cover Art به پیدا کردن جلد آلبوم کمک می کند. هنرمند/آلبوم پر شده است
در صورت امکان از برچسب ها منبع وب‌سایت‌های مختلفی را با جلد آلبوم ارائه می‌دهد.
URL با پارامترهای هنرمند و آلبوم را می توان در زیر نام یافت. URL-کدگذاری شده است
مقادیر هنرمند و آلبوم را می توان با استفاده از درج کرد %u{هنرمند} و %u{آلبوم}، دیگر
مقادیر از تگ ها نیز ممکن است، همانطور که در Configure Kid3، User Actions توضیح داده شده است.
منابع بیشتری را می توان پس از ورودی "منبع سفارشی" با جایگزینی "Custom" وارد کرد
منبع" با نام منبع، فشردن Enter، سپس درج URL و در نهایت
ذخیره تنظیمات را فشار دهید. دستور مرورگر به دست آمده در بالای صفحه نمایش داده می شود
گفتگو و می توان با کلیک کردن بر روی Browse شروع به کار کرد. مرورگر که می تواند در آن پیکربندی شود
تنظیمات، با منبع انتخاب شده شروع می شود. سپس می توان یک تصویر جلد را کشید
از مرورگر وارد پنجره Kid3 می شود و در قاب عکس تنظیم می شود
فایل های انتخاب شده

زیرا همه مرورگرها از کشیدن و رها کردن تصاویر و تصاویر در وب سایت ها پشتیبانی نمی کنند
اغلب یک URL دارند، در چنین مواردی Kid3 URL را دریافت می کند و نه تصویر را. اگر
URL به یک عکس اشاره می کند، دانلود خواهد شد. با این حال، اگر URL به برخی اشاره دارد
منبع وب دیگر، باید به تصویر مربوطه ترجمه شود. چنین
نگاشت ها در استخراج URL جدول تعریف شده اند. ستون سمت چپ Match شامل a
عبارت منظم که با URL مقایسه می شود. اگر مطابقت داشته باشد، اسیر شده است
عبارات داخل پرانتز در الگوی URL تصویر سمت راست درج می شوند
ستون (در موقعیت هایی که با \1 و غیره مشخص شده اند). عبارت منظم جایگزین شد
حاوی آدرس تصویر به این ترتیب می توان هنر جلد را از آمازون وارد کرد،
Google Images و غیره با استفاده از drag'n'drop. همچنین می توان خود را تعریف کرد
نقشه برداری ها

فایل → صادرات...
Export Dialog برای ذخیره داده ها از برچسب ها در یک فایل یا کلیپ بورد استفاده می شود. را
ویرایشگر در بالا پیش‌نمایش داده‌های مورد نظر را برای صادرات نشان می‌دهد. اگر داده های صادراتی حاوی
کاراکترهای جدول ساز، صادرات در یک جدول نمایش داده می شود. داده ها تولید خواهد شد
از برچسب های موجود در فهرست فعلی مطابق با فرمت پیکربندی شده.

تنظیمات قالب شبیه به کادر گفتگوی واردات است: بالاترین قسمت شامل
عنوان (به عنوان مثال "CSV بدون نقل قول")، و به دنبال آن هدر، که در تولید خواهد شد
ابتدای فایل داده های آهنگ به شرح زیر است. برای هر آهنگ استفاده می شود. سرانجام،
از تریلر می توان برای تولید متن تکمیلی استفاده کرد.

فیلدهای قالب شامل عبارات منظم مانند گفتگوی Import نیستند، بلکه فقط شامل عبارات منظم هستند
عبارات فرمت خروجی با عبارات %- خاص که با مقادیر جایگزین می شوند
از برچسب ها همه چیز مانند فرمت نام فایل کار می کند، و همان کدها هستند
استفاده شده به علاوه چند کد اضافی. نه تنها کدهای فهرست شده در زیر، بلکه تمامی فریم های برچسب
می توان از نام ها استفاده کرد.

· %s %{title} عنوان (آهنگ)

· %a %{artist} هنرمند

· %l %{آلبوم} آلبوم

· %c %{comment} نظر

· %y %{year} سال

· %t %{track} آهنگ (به عنوان مثال 01)

· %t %{track.n} آهنگ با عرض میدان n (به عنوان مثال 001 برای %{track.3})

· %T %{tracknumber} آهنگ (بدون صفرهای ابتدایی، به عنوان مثال 1)

· ژانر %g %{genre}

· %f %{file} نام فایل

· مسیر %p %{filepath}

· URL %u %{url}

· %d %{duration} مدت زمان بر حسب دقیقه: ثانیه

· %D %{seconds} مدت زمان در ثانیه

· %n %{tracks} تعداد آهنگ های آلبوم

· پسوند فایل %e %{extension}

· %O %{tag1} قالب برچسب 1 (ID3v1.1 یا خالی اگر موجود نیست)

· %o %{tag2} قالب برچسب 2 (ID3v2.3.0، ID3v2.4.0، ID3v2.2.0، ID3v2.2.1،
Vorbis، APE، MP4، ASF، یا خالی اگر موجود نیست)

· %b %{bit} نرخ بیت بر حسب کیلوبیت بر ثانیه

· %v %{vbr} VBR یا خالی (فقط برای ID3v2.3 با id3lib)

· %r %{samplerate} نرخ نمونه بر حسب هرتز

· %m %{mode} حالت کانال (استریو یا استریو مشترک)

· %h %{channels} تعداد کانال (1 یا 2)

· %k %{codec} کدک (مثلاً MPEG 1 Layer 3، MP4، Ogg Vorbis، FLAC، MPC، APE، ASF،
AIFF، WAV)

چند فرمت از پیش تعریف شده است. "CSV unquoted" فیلدها را با برگه ها جدا می کند. داده ها در
این فرمت را می توان دوباره با استفاده از فرمت import با همان به Kid3 وارد کرد
نام. "CSV quoted" علاوه بر این فیلدها را با نقل قول های دوتایی محصور می کند، که این کار را آسان می کند
وارد کردن به برنامه های صفحه گسترده با این حال، فیلدها نباید حاوی دوگانه باشند
وقتی از این قالب استفاده می شود نقل قول می کند. "Extended M3U" و "Extended PLS" لیست پخش تولید می کنند
با ویژگی های توسعه یافته و نام مسیرهای مطلق. از "HTML" می توان برای تولید یک
صفحه HTML با لینک‌هایی به آهنگ‌ها. "Kover XML" فایلی را ایجاد می کند که می تواند باشد
وارد شده توسط برنامه چاپ جلد Kover. "جزئیات فنی" اطلاعاتی را ارائه می دهد
در مورد نرخ بیت، نرخ نمونه، کانال ها، و غیره. در نهایت، "فرمت سفارشی" برای خالی باقی می ماند
تعریف قالب سفارشی با افزودن خطوط می توانید فرمت های بیشتری از خود تعریف کنید
در فایل kid3rc در دایرکتوری تنظیمات. فرمت های دیگر را می توان با آنها سازگار کرد
نیازهای شما.

منبع تگ ها برای تولید داده های صادراتی (برچسب 1 یا تگ 2) را می توان انتخاب کرد
با جعبه ترکیبی فشار دادن به فایل یا به کلیپ بورد داده ها را در یک فایل یا روی آن ذخیره می کند
کلیپ بورد OK و Cancel گفتگو را می بندند، در حالی که OK گفتگوی فعلی را می پذیرد
تنظیمات می پردازیم.

فایل → ایجاد لیست پخش
یک لیست پخش ایجاد می کند. قالب و محتویات لیست پخش را می توان با انواع مختلف تنظیم کرد
گزینه.

نام لیست پخش می تواند همان نام دایرکتوری باشد یا از یک Format با مقادیر استفاده کند
از برچسب ها، به عنوان مثال "%{artist} - %{album}" تا نام هنرمند و آلبوم در
نام فایل لیست پخش کدهای قالب مانند Export هستند. پسوند بستگی دارد
در قالب لیست پخش

مکان لیست پخش تولید شده با انتخاب Create in تعیین می شود
جعبه ترکیبی

پوشه کنونی
لیست پخش در دایرکتوری فعلی ایجاد می شود و فقط حاوی فایل های آن است
پوشه کنونی.

هر دایرکتوری
یک لیست پخش در هر دایرکتوری ایجاد می شود که حاوی فایل های فهرست شده و هر کدام است
لیست پخش شامل فایل های آن دایرکتوری است.

دایرکتوری سطح بالا
فقط یک لیست پخش در دایرکتوری سطح بالا ایجاد می شود (یعنی دایرکتوری
لیست فایل) و شامل فایل های فهرست شده دایرکتوری سطح بالا و همه آنها می باشد
دایرکتوری های فرعی آن

فرمت لیست پخش می تواند M3U، PLS یا XSPF باشد.

اگر Include only the selected files علامت زده شود، فقط فایل های انتخاب شده خواهند بود
در لیست پخش گنجانده شده است. اگر دایرکتوری انتخاب شده باشد، تمام فایل های آن انتخاب می شوند.
اگر این چک باکس فعال نباشد، تمام فایل های صوتی در لیست پخش قرار می گیرند.

مرتب سازی بر اساس نام فایل حالت معمولی را انتخاب می کند که در آن فایل ها بر اساس نام فایل مرتب می شوند.
با فیلد مرتب سازی بر اساس برچسب، امکان مرتب سازی بر اساس رشته فرمت با مقادیر تگ وجود دارد
زمینه های. برای مثال، "%{track.3}" را می توان برای مرتب سازی بر اساس شماره تراک استفاده کرد (".3"
برای به دست آوردن سه رقم با صفرهای ابتدایی استفاده می شود زیرا رشته ها برای مرتب سازی استفاده می شوند). آی تی
همچنین می توان از چندین فیلد استفاده کرد، به عنوان مثال "%{genre}%{year}" برای مرتب سازی با استفاده از یک رشته
متشکل از ژانر و سال

ورودی های لیست پخش بسته به اینکه آیا مسیرهای فایل نسبی یا مطلق خواهند داشت
استفاده از مسیر نسبی برای فایل ها در لیست پخش یا استفاده از مسیر کامل برای فایل ها در لیست پخش تنظیم شده است.

هنگامی که لیست فقط نوشتن فایل ها تنظیم شده است، لیست پخش فقط شامل مسیرهای مربوط به فایل ها خواهد بود
فایل ها. برای ایجاد یک لیست پخش گسترده با اطلاعات اضافی، یک رشته قالب
را می توان با استفاده از Write info using control تنظیم کرد.

فایل → خروج (Ctrl+Q)
برنامه را ترک می کند.

La ویرایش فهرست
ویرایش → انتخاب همه (Alt+A)
همه فایل ها را انتخاب می کند.

ویرایش → لغو انتخاب (Ctrl+Shift+A)
همه فایل ها را از حالت انتخاب خارج می کند.

Edit → All in Directory را انتخاب کنید
تمام فایل های دایرکتوری فعلی را انتخاب می کند.

ویرایش → فایل قبلی (Alt+Up)
فایل قبلی را انتخاب می کند.

ویرایش → فایل بعدی (Alt+Down)
فایل بعدی را انتخاب می کند.

ویرایش → یافتن... (Ctrl+F)
رشته ها را در نام فایل ها و برچسب ها پیدا کنید. گفتگوی Find زیرمجموعه ای از
گفتگو را جایگزین کنید که در زیر توضیح داده شده است.

ویرایش → جایگزین... (Ctrl+R)
این تابع یک دیالوگ را برای یافتن و جایگزینی رشته ها در نام فایل ها و در باز می کند
برچسب ها مجموعه فریم هایی که جستجو در آن انجام می شود را می توان محدود کرد
غیرفعال کردن چک باکس Select all و انتخاب فریم هایی که باید جستجو شوند.
همچنین گزینه های جستجو برای جستجوی عقب، حساس به حروف کوچک و بزرگ وجود دارد
از عبارات منظم استفاده کنید

بسته به تعداد فایل‌ها، جستجو ممکن است کمی طول بکشد، بنابراین ممکن است انجام شود
با بستن کادر گفتگو لغو شد.

La ابزار فهرست
ابزارها → اعمال فرمت نام فایل
هنگامی که فرمت هنگام ویرایش برای قالب نام فایل در پیکربندی خاموش است
گفت و گو، از این آیتم منو می توان برای اعمال فرمت پیکربندی شده به نام ها استفاده کرد
فایل های انتخاب شده این همچنین می تواند برای بررسی اینکه آیا نام فایل ها مطابقت دارند یا خیر استفاده می شود
با اعمال فرمت بر روی همه فایل های ذخیره شده و سپس بررسی وجود فرمت پیکربندی شده است
فایل‌ها تغییر کردند (و بنابراین با نماد دیسک در فهرست فایل‌ها مشخص شدند).

ابزارها → اعمال قالب برچسب
وقتی فرمت هنگام ویرایش برای قالب برچسب در پیکربندی خاموش است
گفت و گو، از این آیتم منو می توان برای اعمال فرمت پیکربندی شده به برچسب ها استفاده کرد
فایل های انتخاب شده این همچنین می تواند برای بررسی اینکه آیا تگ ها مطابقت دارند یا خیر استفاده می شود
با اعمال فرمت بر روی همه فایل های ذخیره شده و سپس بررسی وجود فرمت پیکربندی شده است
فایل‌ها تغییر کردند (و بنابراین با نماد دیسک در فهرست فایل‌ها مشخص شدند).

ابزارها → اعمال رمزگذاری متن
رمزگذاری متن انتخاب شده در تنظیمات/پیکربندی Kid3.../برچسب‌ها/برچسب 2 را برای همه تنظیم می‌کند.
فایل های انتخاب شده اگر UTF8 انتخاب شود، UTF16 برای تگ های ID3v2.3.0 استفاده می شود زیرا
UTF8 برای این قالب پشتیبانی نمی شود.

ابزارها → تغییر نام دایرکتوری...
این محاوره امکان تغییر نام خودکار موارد باز فعلی را ارائه می دهد
دایرکتوری با توجه به تگ های موجود در فایل ها. چندین فرمت از قبل پیکربندی شده اند
اطلاعات مربوط به هنرمند، آلبوم و سال را در نام دایرکتوری قرار دهید. همچنین است
برای تنظیم یک قالب سفارشی، از کدهای ویژه زیر برای درج برچسب استفاده می شود
مقادیر در نام دایرکتوری:

· %s %{title} عنوان (آهنگ)

· %a %{artist} هنرمند

· %l %{آلبوم} آلبوم

· %c %{comment} نظر

· %y %{year} سال

· %t %{track} آهنگ (به عنوان مثال 01)

· %t %{track.n} آهنگ با عرض میدان n (به عنوان مثال 001 برای %{track.3})

· %T %{tracknumber} آهنگ (بدون صفرهای ابتدایی، به عنوان مثال 1)

· ژانر %g %{genre}

اگر یک جداکننده دایرکتوری "/" در قالب پیدا شود، چندین دایرکتوری ایجاد می شود.
اگر می خواهید به جای تغییر نام دایرکتوری فعلی یک دایرکتوری جدید ایجاد کنید،
به جای تغییر نام دایرکتوری، گزینه Create Directory را انتخاب کنید. منبع اطلاعات برچسب
می توان بین از تگ 1 و تگ 2، از تگ 1 و از تگ 2 انتخاب کرد. پیش نمایشی برای
عملیات تغییر نام انجام شده بر روی فایل اول را می توان در From و To مشاهده کرد
بخش های گفتگو

با انتخاب چندین دایرکتوری می توان نام آنها را تغییر داد.

ابزارها → آهنگ های شماره...
اگر اعداد آهنگ در برچسب ها تنظیم نشده باشند یا مقادیر اشتباهی داشته باشند، این عملکرد را انجام دهید
می تواند آهنگ ها را به صورت خودکار به ترتیب صعودی شماره گذاری کند. شماره شروع را می توان تنظیم کرد
گفتگو اگر فقط بخشی از آهنگ ها باید شماره گذاری شوند، باید انتخاب شوند.

هنگامی که تعداد کل آهنگ ها بررسی شود، تعداد آهنگ ها نیز در قسمت تنظیم می شود
برچسب ها

امکان شماره گذاری آهنگ ها در چندین فهرست وجود دارد. پوشه ها باید باشند
گسترش یافته و انتخاب شده است.

اگر بازنشانی شمارنده برای هر دایرکتوری علامت زده شود، شماره گذاری آهنگ با علامت شروع مجدد می شود
هنگامی که چندین پوشه انتخاب می شوند، برای هر دایرکتوری شماره داده می شود.

همچنین می‌توان از گفتگوی آهنگ‌های شماره برای قالب‌بندی شماره‌های آهنگ موجود بدون استفاده استفاده کرد
هنگامی که چک باکس سمت چپ به شماره شروع غیرفعال می شود، مقادیر را تغییر دهید. کل
اگر تیک مربوطه فعال باشد، تعداد آهنگ ها اضافه می شود که می تواند باشد
برای تنظیم کل برای تمام آهنگ های انتخاب شده استفاده می شود. اگر فقط قالب بندی موجود است
اعداد مورد نظر است، این چک باکس نیز باید غیرفعال شود.

ابزار → فیلتر...
از این فیلتر می توان برای نمایش تنها فایل هایی استفاده کرد که با معیارهای خاصی مطابقت دارند. این
اگر می خواهید مجموعه بزرگی را سازماندهی کنید و فقط آن فایل هایی را ویرایش کنید مفید است
در طرح مورد نظر نیستند. عبارتی که مشخص می کند کدام فایل ها نمایش داده می شوند از عبارت استفاده می کند
کدهای فرمت یکسانی که در قالب نام فایل، واردات و صادرات استفاده می شود.

· %s %{title} عنوان (آهنگ)

· %a %{artist} هنرمند

· %l %{آلبوم} آلبوم

· %c %{comment} نظر

· %y %{year} سال

· %t %{track} آهنگ (به عنوان مثال 01)

· %t %{track.n} آهنگ با عرض میدان n (به عنوان مثال 001 برای %{track.3})

· %T %{tracknumber} آهنگ (بدون صفرهای ابتدایی، به عنوان مثال 1)

· ژانر %g %{genre}

· %f %{file} نام فایل

· %p %{filepath} مسیر مطلق به فایل

· پسوند فایل %e %{extension}

· %O %{tag1} قالب برچسب 1 (ID3v1.1 یا خالی اگر موجود نیست)

· %o %{tag2} قالب برچسب 2 (ID3v2.3.0، ID3v2.4.0، ID3v2.2.0، ID3v2.2.1،
Vorbis، APE، MP4، ASF، یا خالی اگر موجود نیست)

· %b %{bit} نرخ بیت بر حسب کیلوبیت بر ثانیه

· %v %{vbr} VBR یا خالی (فقط برای ID3v2.3 با id3lib)

· %r %{samplerate} نرخ نمونه بر حسب هرتز

· %m %{mode} حالت کانال (استریو یا استریو مشترک)

· %h %{channels} تعداد کانال (1 یا 2)

· %k %{codec} کدک (مثلاً MPEG 1 Layer 3، MP4، Ogg Vorbis، FLAC، MPC، APE، ASF،
AIFF، WAV)

· %1a %1{هنرمند}، ... از پیشوند 1 برای دریافت مقادیر تگ 1 استفاده کنید

· %2a %2{هنرمند}، ... از پیشوند 2 برای دریافت مقادیر تگ 2 استفاده کنید

این کدها با مقادیر فایل جایگزین می شوند و رشته های حاصل می توانند
با عملیات زیر مقایسه شود:

· s1 برابر با s2 است: اگر s1 و s2 برابر باشند درست است.

· s1 حاوی s2 است: اگر s1 حاوی s2 باشد، درست است، یعنی s2 زیررشته ای از s1 باشد.

· s matches re: درست است اگر s با عبارت منظم re مطابقت داشته باشد.

عبارات True با 1، false با 0 جایگزین می شوند. مقادیر True با 1 نشان داده می شوند.
درست، روشن و بله، مقادیر false با 0، false، off و no. عملیات بولی نیست،
و، یا (به این ترتیب اولویت) و می توان با پرانتز گروه بندی کرد.

برخی از قوانین فیلتر از پیش تعریف شده اند و می توانند به عنوان مثال برای عبارات خود شما باشند:

معرفی
هنگامی که لیست فایل فیلتر می شود - این با "[filtered]" در عنوان پنجره نشان داده می شود
- و همه فایل‌ها دوباره نمایش داده می‌شوند، فیلتر کردن را می‌توان با استفاده از آن برگرداند
فیلتر از یک عبارت خالی استفاده می کند، اما مقدار واقعی همان اثر را خواهد داشت.

عدم تطابق تگ نام فایل
نه (٪{مسیر فایل} شامل "%{هنرمند} - %{آلبوم}/%{تراک} ٪{عنوان}")

آزمایش می کند که آیا مسیر فایل با فرمت نام فایل مطابقت دارد یا خیر. این قانون است
در صورت تغییر فرمت نام فایل به طور خودکار سازگار می شود.

بدون برچسب 1
%{tag1} برابر است ""

فقط فایل هایی را نشان می دهد که برچسب 1 ندارند.

بدون برچسب 2
%{tag2} برابر است ""

فقط فایل هایی را نشان می دهد که برچسب 2 ندارند.

برچسب ID3v2.3.0
%{tag2} برابر است "ID3v2.3.0"

فقط فایل هایی را نمایش می دهد که دارای برچسب ID3v2.3.0 هستند.

برچسب ID3v2.4.0
%{tag2} برابر است "ID3v2.4.0"

فقط فایل هایی را نمایش می دهد که دارای برچسب ID3v2.4.0 هستند.

تگ 1 != تگ 2
نه (% 1{عنوان} برابر است %2{عنوان} و %1{آلبوم} برابر است %2{آلبوم} و %1{هنرمند}
برابر است %2{هنرمند} و %1{نظر} برابر است %2{نظر} و ٪1 سال} برابر است ٪2 سال}
و %1{تراک} برابر است %2{تراک} و %1{ژانر} برابر است %2{ژانر})

فایل هایی را با تفاوت بین تگ 1 و تگ 2 نمایش می دهد.

تگ 1 == تگ 2
%1{عنوان} برابر است %2{عنوان} و %1{آلبوم} برابر است %2{آلبوم} و %1{هنرمند} برابر است
%2{هنرمند} و %1{نظر} برابر است %2{نظر} و ٪1 سال} برابر است ٪2 سال} و
%1{تراک} برابر است %2{تراک} و %1{ژانر} برابر است %2{ژانر}

فایل هایی با تگ 1 و تگ 2 یکسان را نمایش می دهد.

ناتمام
٪{عنوان} برابر است "" or %{هنرمند} برابر است "" or %{آلبوم} برابر است "" or %{year} برابر است
"" or ٪{شماره پیگیری} برابر است "" or ٪{ژانر. دسته} برابر است ""

فایل هایی با مقادیر خالی در برچسب های استاندارد (عنوان، هنرمند، آلبوم، تاریخ،
شماره آهنگ، ژانر).

فاقد تصویر
%{تصویر} برابر است ""

فقط فایل هایی را نمایش می دهد که تصویر ندارند.

فیلتر سفارشی
برای افزودن فیلتر خود، این ورودی را انتخاب کنید. به عنوان مثال، اگر می خواهید یک
فیلتر برای هنرمندانی که با "The" شروع می شود، به جای "Custom Filter" با نام "The
Bands" و Enter را فشار دهید. سپس عبارت زیر را در ویرایش خط وارد کنید:

%{هنرمند} کبریت ".*"

سپس روی Save Settings کلیک کنید. برای فیلتر کردن فایل ها روی Apply کلیک کنید. تمام فایل های پردازش شده هستند
نمایش داده شده در نمای متن، با "+" برای کسانی که با فیلتر مطابقت دارند و "-"
برای بقیه پس از پایان، فقط فایل‌هایی با هنرمندی که با "The" شروع می‌شوند
نمایش داده می شوند و عنوان پنجره با "[filtered]" مشخص می شود.

ابزارها → تبدیل ID3v2.3 به ID3v2.4
اگر در فایل های انتخابی تگ های ID3v2.3 وجود داشته باشد، به ID3v2.4 تبدیل می شوند.
برچسب ها فریم هایی که توسط TagLib پشتیبانی نمی شوند کنار گذاشته می شوند. فقط فایل های بدون
تغییرات ذخیره نشده تبدیل خواهند شد.

ابزارها → تبدیل ID3v2.4 به ID3v2.3
اگر در فایل های انتخابی تگ های ID3v2.4 وجود داشته باشد، به ID3v2.3 تبدیل می شوند.
برچسب ها فقط فایل های بدون تغییرات ذخیره نشده تبدیل می شوند.

ابزار → پخش
با این کار یک نوار ابزار ساده برای پخش فایل های صوتی باز می شود. این شامل دکمه هایی برای پایه است
عملیات (پخش/مکث، توقف پخش، آهنگ قبلی، آهنگ بعدی، بستن)، لغزنده برای
موقعیت و حجم و نمایش موقعیت فعلی. اگر چندین فایل هستند
انتخاب شده، آهنگ های انتخاب شده پخش می شوند، در غیر این صورت همه فایل ها پخش خواهند شد.

La تنظیمات فهرست
تنظیمات → نمایش نوار ابزار
نمایش نوار ابزار را تغییر می دهد.

تنظیمات → نمایش نوار وضعیت
نمایش نوار وضعیت را تغییر می دهد، که اقدامات طولانی تر مانند باز کردن یا نمایش داده می شود
ذخیره یک دایرکتوری

تنظیمات → نمایش تصویر
نمایش تصویر پیش‌نمایش هنر جلد آلبوم را تغییر می‌دهد.

تنظیمات → پنهان کردن خودکار برچسب ها
اگر این گزینه فعال باشد، تگ های خالی به طور خودکار پنهان می شوند. فایل، تگ 1 و تگ
2 بخش را می توان با کلیک بر روی -/+ مربوطه جمع کرد و گسترش داد
دکمه.

تنظیمات → پیکربندی Kid3...
گفتگوی پیکربندی را باز می کند که شامل صفحات برچسب ها، فایل ها، اقدامات کاربر،
و تنظیمات شبکه

گزینه های خاص برچسب را می توان در صفحه برچسب ها یافت که خود به آن جدا شده است
سه تب برای تگ 1، تگ 2، و تگ 1 و تگ 2.

اگر علامت گذاری فیلدهای کوتاه شده علامت زده شود، فیلدهای کوتاه شده ID3v1.1 با رنگ قرمز مشخص می شوند. را
فیلدهای متنی تگ های ID3v1.1 فقط می توانند 30 کاراکتر داشته باشند و نظر فقط 28 کاراکتر
شخصیت ها. همچنین ژانر و شماره آهنگ محدود شده است، به طوری که فیلدها می توانند باشند
هنگام واردات یا انتقال از ID3v2 کوتاه می شود. فیلدهای کوتاه شده و فایل خواهد شد
قرمز علامت گذاری شود و پس از ویرایش فیلد علامت حذف خواهد شد.

با رمزگذاری متن برای ID3v1 می توان مجموعه کاراکترهای مورد استفاده در ID3v1 را تنظیم کرد
برچسب ها این رمزگذاری قرار است ISO-8859-1 باشد، بنابراین توصیه می شود این را حفظ کنید
مقدار پیش فرض. با این حال، برچسب هایی در اطراف با رمزگذاری های مختلف وجود دارد، بنابراین می تواند باشد
در اینجا تنظیم کنید و تگ های ID3v1 را می توان در ID3v2 که از یونیکد پشتیبانی می کند کپی کرد.

کادر انتخاب فرمت استفاده از آهنگ/تعداد کل آهنگ‌ها کنترل می‌کند که آیا آهنگ
فیلد شماره تگ های ID3v2 به سادگی شامل شماره آهنگ یا کل آن است
تعداد آهنگ های موجود در فهرست

وقتی ژانر به عنوان متن به جای رشته عددی علامت زده شود، همه ژانرهای ID3v2 خواهند بود
حتی اگر کد مربوط به ژانرهای ID3v1 وجود داشته باشد به عنوان یک رشته متن ذخیره می شود. اگر
این گزینه تنظیم نشده است، ژانرهایی که کد ID3v1 برای آنها وجود دارد به عنوان شماره ذخیره می شوند
کد ژانر (در پرانتز برای ID3v2.3). بنابراین ژانر Metal به عنوان ذخیره می شود
"Metal" یا "(9)" بسته به این گزینه. ژانرهایی که در لیست ID3v1 نیستند
ژانرها همیشه به عنوان یک رشته متن ذخیره می شوند. هدف این گزینه بهبود یافته است
سازگاری با دستگاه هایی که کدهای ژانر را به درستی تفسیر نمی کنند.

کدگذاری متن، رمزگذاری پیش‌فرض مورد استفاده برای فریم‌های ID3v2 را تعریف می‌کند و می‌توان آن را روی آن تنظیم کرد
ISO-8859-1، UTF16، یا UTF8. UTF8 برای فریم های ID3v2.3.0 معتبر نیست. اگر تنظیم شده باشد،
به جای آن از UTF16 استفاده خواهد شد. برای فریم های ID3v2.4.0، هر سه کدگذاری امکان پذیر است.

نسخه استفاده شده برای برچسب های جدید تعیین می کند که آیا برچسب های ID3v2 جدید به عنوان نسخه ایجاد می شوند یا خیر
2.3.0 یا 2.4.0. در مورد اول، id3lib همانطور که در نسخه های قبلی بود استفاده می شود
Kid3 و TagLib فقط زمانی اعمال می شوند که با یک برچسب ID3v2.4.0 مواجه شوید. در دومی
مورد، ID3v2.4.0 (TagLib)، TagLib به طور کلی برای فایل های MP3 استفاده می شود. تغییر کرده یا جدید
تگ های ایجاد شده در نسخه 2.4.0 ذخیره می شوند. وقتی ID3v2.3.0 (TagLib) انتخاب شده است،
TagLib همچنین برای تگ های ID3v2.3.0 استفاده می شود.

رقم شماره آهنگ تعداد ارقام در فیلدهای Track Number است. صفرهای پیشرو هستند
برای پد استفاده می شود. به عنوان مثال، با مقدار 2، آهنگ شماره 5 به عنوان "05" تنظیم می شود.

نام فیلد نظر جعبه ترکیبی فقط برای فایل‌های Ogg/Vorbis و FLAC مرتبط است
نام فیلد مورد استفاده برای نظرات را تعیین می کند. به نظر می رسد برنامه های مختلف استفاده می کنند
نام‌های مختلف، برای مثال "COMMENT" توسط xmms استفاده می‌شود، در حالی که amaroK استفاده می‌کند
"شرح".

فرمت تصاویر در فایل‌های Ogg/Vorbis با نام فیلد Picture تعیین می‌شود
می تواند METADATA_BLOCK_PICTURE یا COVERART باشد. اولین مورد استاندارد رسمی و موارد استفاده است
همان فرمت تصاویر در برچسب های FLAC. COVERART یک روش غیر رسمی قبلی است
شامل تصاویر در نظرات Vorbis. می توان از آن برای سازگاری با میراث استفاده کرد
بازیکنان.

اگر کادر علامت گذاری بزرگتر از فعال باشد، فایل های حاوی آلبوم جاسازی شده هستند
جلد هنری بیش از اندازه داده شده در بایت قرمز علامت گذاری شده است. از این می توان برای یافتن استفاده کرد
فایل های حاوی تصاویر بزرگ که توسط برخی از برنامه ها پذیرفته نمی شود و
بازیکنان مقدار پیش فرض 131072 بایت (128 کیلوبایت) است.

از ژانرهای سفارشی می توان برای تعریف ژانرهایی استفاده کرد که در استاندارد موجود نیستند
فهرست ژانر، به عنوان مثال "گوتیک متال". چنین ژانرهای سفارشی در جعبه ترکیبی Genre ظاهر می شوند
از Tag 2. برای برچسب های ID3v1.1، فقط می توان از ژانرهای از پیش تعریف شده استفاده کرد.

از فهرست ژانرهای سفارشی نیز می توان برای کاهش تعداد ژانرهای موجود در آن استفاده کرد
جعبه ترکیبی ژانر به مواردی که معمولا استفاده می شود. اگر مجموعه شما بیشتر حاوی موسیقی است
در ژانرهای متال، گوتیک متال، باستانی و هارد راک می توانید وارد آن ژانرها شوید
و Show only custom genres را علامت بزنید. پس از آن جعبه ترکیبی Tag 2Genre فقط شامل خواهد شد
آن چهار ژانر و شما مجبور نخواهید بود در فهرست کامل ژانرها جستجو کنید
آنها در این مثال، تنها متال و هارد راک در ژانرهای تگ 1 فهرست می شوند
لیست، زیرا آن دو ورودی ژانرهای سفارشی ژانرهای استاندارد هستند. اگر فقط سفارشی نمایش داده شود
ژانرها فعال نیستند، ژانرهای سفارشی را می توان در انتهای لیست ژانرها یافت.

فریم های دسترسی سریع مشخص می کند که کدام نوع قاب همیشه در بخش Tag 2 نشان داده می شود.
سپس می توان چنین فریم هایی را بدون استفاده از دکمه افزودن اضافه کرد. ترتیب اینها
فریم های دسترسی سریع را می توان با کشیدن و رها کردن آیتم ها تغییر داد.

قالب برچسب شامل گزینه هایی برای قالب تگ ها می باشد. وقتی فرمت در حین ویرایش است
علامت زده شده است، پیکربندی قالب به طور خودکار هنگام ویرایش متن در خط استفاده می شود
ویرایش ها تبدیل Case را می توان روی بدون تغییر، همه حروف کوچک، همه حروف بزرگ تنظیم کرد،
حرف اول بزرگ یا همه حروف اول بزرگ. برای استفاده از تبدیل محلی آگاه
بین کاراکترهای کوچک و بزرگ، می توان محلی را در جعبه ترکیبی انتخاب کرد
زیر لیست جایگزینی رشته را می توان روی نگاشت رشته دلخواه تنظیم کرد. برای اضافه کردن یک
نگاشت جدید، سلول From یک ردیف را انتخاب کنید و متن را برای جایگزینی وارد کنید، سپس به آن بروید
ستون To و متن جایگزین را وارد کنید. برای حذف یک نقشه، سلول From را روی تنظیم کنید
یک مقدار خالی (مثلا با تایپ ابتدا space و سپس backspace). درج و حذف
ردیف ها نیز با استفاده از منوی زمینه که با دکمه سمت راست ماوس ظاهر می شود امکان پذیر است
کلیک شده است. جایگزینی تنها در صورتی فعال است که چک باکس جایگزینی رشته علامت زده شود.

در صفحه Files، کادر بررسی Load آخرین باز شده را می توان علامت گذاری کرد تا Kid3 این کار را انجام دهد
باز کنید و آخرین فایل انتخاب شده را هنگامی که دفعه بعد شروع شد انتخاب کنید. حفظ
مهر زمانی فایل را می توان برای حفظ مهر زمانی اصلاح فایل بررسی کرد. نام فایل
for cover نامی را که هنگام صادرات یک تصویر جاسازی شده به a پیشنهاد می شود را تنظیم می کند
فایل.

اگر علامت گذاری تغییرات فعال باشد، فیلدهای تغییر یافته با یک برچسب خاکستری روشن مشخص می شوند
زمینه.

فرمت نام فایل شامل گزینه هایی برای قالب نام فایل ها است. گزینه های مشابه
در قالب برچسب در دسترس هستند.

صفحه اقدامات کاربر حاوی جدولی با دستورات موجود در صفحه است
منوی زمینه لیست فایل برای عملیات های حیاتی مانند حذف فایل ها، این است
توصیه می شود قبل از اجرای آن، Confirm را علامت بزنید تا یک گفتگوی تأیید ظاهر شود
فرمان خروجی را می توان برای مشاهده خروجی نوشته شده توسط دستورات کنسول علامت گذاری کرد (استاندارد
خروجی و خطای استاندارد). Name نامی است که در منوی زمینه نمایش داده می شود. فرمان
خط فرمانی است که باید اجرا شود. آرگومان ها را می توان با استفاده از کدهای زیر منتقل کرد:

· %F %{files} مسیرهای فایل (لیستی در صورت انتخاب چند فایل)

· %f %{file} مسیر فایل به یک فایل

· %uF %{urls} URL (لیستی در صورت انتخاب چند فایل)

· %uf %{url} URL به یک فایل

· دایرکتوری %d %{directory}

· %s %{title} عنوان (آهنگ)

· %a %{artist} هنرمند

· %l %{آلبوم} آلبوم

· %c %{comment} نظر

· %y %{year} سال

· %t %{track} آهنگ (به عنوان مثال 01)

· %t %{track.n} آهنگ با عرض میدان n (به عنوان مثال 001 برای %{track.3})

· %T %{tracknumber} آهنگ (بدون صفرهای ابتدایی، به عنوان مثال 1)

· ژانر %g %{genre}

· %b %{browser} دستور شروع مرورگر وب

· %q %{qmlpath} دایرکتوری پایه فایل های QML ارائه شده

کد ویژه @separator را می توان به عنوان یک دستور برای قرار دادن جداکننده در
منوی زمینه اقدامات کاربر آیتم های منو را می توان با قرار دادن آنها در یک زیر منو قرار داد
@beginmenu و @endmenu دستورات نام زیر منو با نام تعیین می شود
ستون از @beginmenu فرمان

برای اجرای اسکریپت های QML، @qml به عنوان نام فرمان استفاده می شود. مسیر اسکریپت QML است
به عنوان یک پارامتر ارسال می شود. اسکریپت های ارائه شده را می توان در پوشه پیدا کرد
%{qmlpath}/script/ (در لینوکس معمولا /usr/share/kid3/qml/script/، در ویندوز
qml/script/ در پوشه نصب و در OS X در پوشه برنامه
kid3.app/Contents/Resources/qml/script/). اسکریپت های سفارشی را می توان در هر کدام ذخیره کرد
فهرست راهنما. اگر کد QML از اجزای رابط کاربری گرافیکی استفاده می کند، @qmlview باید به جای استفاده شود
@qml. پارامترهای اضافی به اسکریپت QML منتقل می شوند که در آن در دسترس خواهند بود
از طریق getArguments() عملکرد. مروری بر برخی از توابع و خواص که
در QML موجود هستند را می توان در پیوست QML Interface یافت.

فرمانی که با %{browser} وارد می شود را می توان در مرورگر وب تعریف کرد
ویرایش خط بالا برای واکشی اطلاعات می توان از دستوراتی که با %{browser} شروع می شود استفاده کرد
به عنوان مثال در مورد فایل های صوتی از وب

%{مرورگر} http://lyricwiki.org/%u{هنرمند}:%u{title}

اشعار آهنگ فعلی را در پرس و جو خواهد کرد LyricWiki[10]. "u" در %u{artist} و
%u{title} برای رمزگذاری URL اطلاعات هنرمند %{artist} و آهنگ %{title} استفاده می‌شود. آی تی
به آسانی می توان پرس و جوهای خود را به همان روش تعریف کرد، به عنوان مثال جستجوی تصویر با
گوگل[دو]:

%{مرورگر} http://images.google.com/images?q=%u{artist}%20%u{آلبوم}

برای افزودن جلد آلبوم به تگ 2، می توانید با استفاده از گوگل یا آمازون تصاویر را جستجو کنید
دستورات شرح داده شده در بالا تصویر را می توان با کشیدن و رها کردن به برچسب اضافه کرد.
همچنین می توانید با افزودن یک تصویر اضافه کنید، سپس کادر تصویر را انتخاب کرده و یک تصویر را وارد کنید
فایل یا چسباندن از کلیپ بورد. قاب عکس برای ID3v2، MP4، FLAC،
برچسب های Ogg و ASF.

برای افزودن و حذف ورودی های جدول، می توان از منوی زمینه استفاده کرد.

صفحه شبکه فقط حاوی یک فیلد برای درج آدرس پراکسی و به صورت اختیاری است
پورت، با یک کولون از هم جدا شده است. پروکسی هنگام وارد کردن از اینترنت استفاده خواهد شد
سرور زمانی که چک باکس تیک خورده است.

در صفحه پلاگین ها، افزونه های موجود را می توان فعال یا غیرفعال کرد. پلاگین ها هستند
به دو بخش جدا شده است. فهرست پلاگین‌ها و اولویت‌های فراداده شامل افزونه‌ها است
که از فرمت های فایل صوتی پشتیبانی می کنند. ترتیب پلاگین ها مهم است زیرا آنها هستند
از بالا به پایین امتحان می شوند. برخی از فرمت ها توسط چندین پلاگین پشتیبانی می شوند، بنابراین فایل ها
با اولین پلاگینی که از آنها پشتیبانی می کند باز می شود. TaglibMetadata بیشتر پشتیبانی می کند
فرمت ها، اگر در بالای لیست باشد، اکثر فایل ها را باز می کند. اگر بخواهید
برای استفاده از یک پلاگین دیگر برای فرمت فایل، مطمئن شوید که قبل از فهرست موجود باشد
افزونه TaglibMetadata. جزئیات در مورد افزونه ابرداده و اینکه چرا ممکن است بخواهید از آن استفاده کنید
آنها به جای TagLib در زیر فهرست شده اند.

· Id3libMetadata: موارد استفاده id3lib[12] برای برچسب های ID3v1.1 و ID3v2.3 در MP3، MP2، AAC
فایل ها. از چند نوع فریم بیشتر از TagLib پشتیبانی می کند. دلیل دیگر استفاده از آن است
که TagLib از نسخه 3 فقط از ID2.3v1.8 پشتیبانی می کند.

· OggFlacMetadata: موارد استفاده لیبوگ[13]، libvorbis، libvorbisfile[14] برای فایل های Ogg، و
علاوه بر این libFLAC++ و libFLAC[15] برای فایل های FLAC. دلایل استفاده از آنها هستند
تصاویر موجود در فایل‌های Ogg، که توسط TagLib پشتیبانی نمی‌شوند و اینها هستند
کتابخانه های رسمی برای این فرمت ها

· TaglibMetadata: موارد استفاده TagLib[16] که بسیاری از فرمت های فایل صوتی را پشتیبانی می کند. از آنجا که
نسخه 1.8 از ID3v2.3 نیز پشتیبانی می کند، بنابراین برای تمامی فایل های صوتی قابل استفاده است
پشتیبانی شده توسط Kid3.

· فراداده Mp4v2: mp4v2[17] در ابتدا توسط Kid3 برای پشتیبانی از فایل های M4A استفاده شد.
با این حال، نسخه های جدیدتر TagLib پشتیبانی خوبی از M4A ارائه می دهند، بنابراین این افزونه چنین نیست
به صورت پیش فرض ساخته شده است.

بخش افزونه های موجود، افزونه های باقی مانده را فهرست می کند. دستور آنها نیست
مهم است، اما می توان آنها را با استفاده از چک باکس ها فعال یا غیرفعال کرد.

· AmazonImport: برای عملکرد واردات از آمازون ... استفاده می شود.

· DiscogsImport: برای عملکرد Import from Discogs... استفاده می شود.

· FreedbImport: برای Import از gnudb.org... و Import from استفاده می شود
TrackType.org... توابع.

· MusicBrainzImport: برای واردات از MusicBrainz Release... استفاده می شود.

· AcoustidImport: برای واردات از عملکرد اثر انگشت MusicBrainz ... استفاده می شود،
که بستگی به کروماپرینت[18] و لیباو[19] کتابخانه ها.

افزونه هایی که غیرفعال هستند بارگیری نمی شوند. این می تواند برای بهینه سازی منابع استفاده شود
زمان استفاده و راه اندازی تنظیمات این صفحه فقط پس از راه اندازی مجدد اعمال می شوند
بچه 3.

تنظیمات → پیکربندی میانبرها...
گفتگویی را برای اختصاص میانبرهای صفحه کلید برای اکثر عملکردهای برنامه باز می کند. آنجا
حتی عملکردهایی بدون منو یا دکمه مربوطه در دسترس هستند، به عنوان مثال فایل بعدی،
فایل قبلی، همه را انتخاب کنید.

La کمک فهرست
راهنما → کتابچه راهنمای Kid3
این کتابچه راهنما را باز می کند.

راهنما → درباره Kid3
نمایش اطلاعات کوتاه در مورد Kid3;.

KID3-CLI

دستورات
kid3-cli یک رابط خط فرمان برای Kid3 ارائه می دهد. اگر از مسیر دایرکتوری استفاده شود،
دایرکتوری باز می شود اگر یک یا چند مسیر فایل داده شود، دایرکتوری مشترک باز می شود
و فایل ها انتخاب می شوند. سپس دستورات بعدی روی این فایل ها کار خواهند کرد. دستورات
با استفاده مشخص می شوند -c گزینه ها. اگر چندین دستور داده شود، در دستور اجرا می شوند
دستور داده شده اگر فایل ها با دستورات اصلاح شوند، در انتها ذخیره می شوند. اگر نه
گزینه های فرمان منتقل می شوند، kid3-cli در حالت تعاملی شروع می شود. دستورات را می توان وارد کرد
و بر اساس انتخاب فعلی عمل خواهد کرد. بخش‌های زیر همه موارد موجود را فهرست می‌کنند
دستورات

کمک
کمک [COMMAND-NAME]

نمایش راهنمایی در مورد پارامترهای COMMAND-NAME یا در مورد همه دستورات اگر دستوری وجود نداشته باشد
نام داده شده است.

وقفه
فاصله [پیش‌فرض | خاموش | TIME]

بازنویسی زمان پایان فرمان پیش فرض. دستورات CLI پس از یک دستور خاص لغو می شوند
تایم اوت منقضی شده است این تایم اوت 10 ثانیه برای ls و آلبومارت، 60 ثانیه برای
واردات خودکار و فیلترو 3 ثانیه برای همه دستورات دیگر. اگر تعداد زیادی فایل
باید پردازش شود، این مهلت زمانی ممکن است بسیار محدود کننده باشد، بنابراین زمان برای همه
دستورات را می توان تنظیم کرد TIME ms، به طور کلی خاموش شود یا در حالت پیش فرض باقی بماند
ارزش ها.

ترک استفاده
خروج [زور]

خروج از برنامه اگر فایل های ذخیره نشده اصلاح شده وجود داشته باشد، مجبور پارامتر است
مورد نیاز است.

تغییر دادن فهرست راهنما
cd [دایرکتوری]

اگر نه دایرکتوری داده می شود، به فهرست اصلی تغییر دهید. اگر دایرکتوری داده شود،
به دایرکتوری تغییر دهید اگر یک یا چند مسیر فایل داده شده است، به مشترک آنها تغییر دهید
دایرکتوری و فایل ها را انتخاب کنید.

چاپ la جاری کارگر فهرست راهنما
pwd

نام فایل دایرکتوری فعلی را چاپ کنید.

فهرست راهنما فهرست
ls

فهرست محتویات دایرکتوری فعلی این مربوط به لیست فایل در
رابط کاربری گرافیکی Kid3. چهار کاراکتر قبل از نام فایل، وضعیت فایل را نشان می دهد.

· > فایل انتخاب شده است.

· * فایل اصلاح شده است.

· 1 فایل دارای برچسب 1 است، در غیر این صورت '-' نمایش داده می شود.

· 2 فایل دارای برچسب 2 است، در غیر این صورت '-' نمایش داده می شود.

kid3-cli> ls
1- 01 Intro.mp3
> 12 02 ما فقط این یکی را دریافت کردیم.mp3
*1- 03 Outro.mp3

در این مثال همه فایل ها دارای تگ 1 هستند، فایل دوم نیز دارای تگ 2 است و همینطور است
انتخاب شد. فایل سوم اصلاح شده است.

ذخیره la تغییر فایل ها
صرفه جویی

انتخاب کنید پرونده
را انتخاب کنید [همه | هیچکدام | اول | قبلی | بعدی | فایل...]

برای انتخاب همه فایل ها وارد شوید را انتخاب کنید تمام، برای لغو انتخاب همه فایل ها، را وارد کنید را انتخاب کنید هیچ. به
پیمایش فایل های موجود در دایرکتوری فعلی با شروع را انتخاب کنید اول، سپس به جلو بروید
با استفاده از را انتخاب کنید بعد یا با استفاده از عقب را انتخاب کنید قبلی. فایل های خاصی را می توان به آن اضافه کرد
انتخاب فعلی با دادن نام فایل آنها. حروف عام امکان پذیر است، بنابراین را انتخاب کنید
* .mp3 تمام فایل های MP3 موجود در فهرست فعلی را انتخاب می کند.

kid3-cli> را انتخاب کنید اول
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 ما فقط این یکی را گرفتیم.mp3
*1- 03 Outro.mp3
kid3-cli> را انتخاب کنید بعد
kid3-cli> ls
1- 01 Intro.mp3
> 12 02 ما فقط این یکی را دریافت کردیم.mp3
*1- 03 Outro.mp3
kid3-cli> را انتخاب کنید * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 ما فقط این یکی را دریافت کردیم.mp3
>*1- 03 Outro.mp3

انتخاب کنید برچسب
برچسب [TAG-NUMBERS]

بسیاری از دستورات اختیاری دارند TAG-NUMBERS پارامتر، که مشخص می کند آیا
دستور بر روی تگ 1 یا تگ 2 عمل می کند. اگر این پارامتر حذف شود، تگ پیش فرض
از اعداد استفاده می شود که با این دستور می توان آنها را تنظیم کرد. هنگام راه اندازی، روی 12 تنظیم شده است که
به این معنی که اطلاعات از تگ 2 در صورت وجود خوانده می شود و در غیر این صورت از تگ 1 خوانده می شود. اصلاحات
روی تگ 2 انجام می شود TAG-NUMBERS را می توان تنظیم کرد 1 or 2 فقط بر روی
برچسب مربوطه اگر پارامتر حذف شود، تنظیمات فعلی نمایش داده می شود.

گرفتن برچسب قاب
دریافت کنید [همه | FRAME-NAME] [TAG-NUMBERS]

از این دستور می توان برای خواندن مقدار یک فریم تگ خاص یا دریافت اطلاعات استفاده کرد
در مورد تمام فریم های برچسب (اگر آرگومان حذف شده باشد یا تمام استفاده می شود). فریم های اصلاح شده هستند
با علامت "*" مشخص شده است.

kid3-cli> دریافت کنید
فایل: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
نام: 01 Intro.mp3
برچسب 1: ID3v1.1
معرفی عنوان
Artist One Hit Wonder
آلبوم بیایید تگ کنیم
تاریخ 2013
آهنگ شماره 1
ژانر پاپ
kid3-cli> دریافت کنید عنوان
معرفی

برای ذخیره محتویات یک قاب عکس در یک فایل، استفاده کنید

دریافت کنید تصویر:"/path/to/folder.jpg"

برای ذخیره اشعار همگام شده در یک فایل LRC، استفاده کنید

دریافت کنید SYLT:"/path/to/lyrics.lrc"

تنظیم برچسب قاب
تنظیم {FRAME-NAME} {FRAME-VALUE} [TAG-NUMBERS]

این دستور مقدار یک فریم تگ خاص را تعیین می کند.

kid3-cli> تنظیم ریمیکس "اوه تعجب"

برای تنظیم محتویات یک قاب عکس از یک فایل، استفاده کنید

تنظیم تصویر:"/path/to/folder.jpg" "تصویر شرح"

برای تنظیم اشعار همگام شده از یک فایل LRC، استفاده کنید

تنظیم SYLT:"/path/to/lyrics.lrc" "متن ترانه شرح"

برگرداندن
برگرداندن

تمام تغییرات در فایل های انتخاب شده (یا همه فایل ها در صورت عدم وجود فایل) را برگردانید
انتخاب شد).

وارد كردن از جانب پرونده or کلیپ بورد
واردات {فایل} {FORMAT-NAME} [TAG-NUMBERS]

برچسب ها از فایل وارد می شوند فایل (یا از کلیپ بورد اگر کلیپ بورد استفاده شده برای
فایل) در قالب با نام FORMAT-NAME (به عنوان مثال "CSV بی نقل"، واردات را ببینید).

اتوماتیک واردات
واردات خودکار [نام پروفایل] [TAG-NUMBERS]

وارد کردن دسته ای با استفاده از نمایه نام پروفایل (به واردات خودکار مراجعه کنید، "همه" استفاده می شود اگر
حذف شده است).

دانلود البوم پوشش آثار هنری
آلبومارت {URL} [همه]

با بارگیری یک عکس از آلبوم، آثار هنری را تنظیم کنید URL. قوانین تعریف شده در
گفتگوی Browse Cover Art برای تبدیل URL های عمومی (به عنوان مثال از آمازون) به a استفاده می شود
آدرس تصویر. برای تنظیم جلد آلبوم از یک فایل تصویر محلی، از دستور set استفاده کنید.

kid3-cli> آلبومارت
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

صادرات به پرونده or کلیپ بورد
صادرات {فایل} {FORMAT-NAME} [TAG-NUMBERS]

برچسب ها به فایل صادر می شوند فایل (یا به کلیپ بورد اگر کلیپ بورد استفاده شده برای فایل) که در
قالب با نام FORMAT-NAME (به عنوان مثال "CSV بی نقل"، صادرات را ببینید).

ساختن پخش
پخش

لیست پخش را با فرمت تنظیم شده در پیکربندی ایجاد کنید، به ایجاد لیست پخش مراجعه کنید.

درخواست نام فایل قالب
فرمت نام فایل

اعمال فرمت نام فایل تنظیم شده در پیکربندی، به اعمال فرمت نام فایل مراجعه کنید.

درخواست برچسب قالب
قالب برچسب

اعمال قالب نام برچسب تنظیم شده در پیکربندی، به اعمال قالب برچسب مراجعه کنید.

درخواست متن پشتیبانی می کند
کدگذاری متنی

اعمال کدگذاری متن در پیکربندی، به اعمال رمزگذاری متن مراجعه کنید.

تغییر نام فهرست راهنما
renamedir [FORMAT] [ایجاد | تغییر نام | خشک کردن] [TAG-NUMBERS]

مطابق با داده شده، دایرکتوری ها را از مقادیر موجود در برچسب ها تغییر نام دهید یا ایجاد کنید FORMAT
(به عنوان مثال %{هنرمند} - %{آلبوم}، به تغییر نام دایرکتوری مراجعه کنید)، اگر هیچ قالبی داده نشده است، قالب
تعریف شده در گفتگوی تغییر نام دایرکتوری استفاده می شود. حالت پیش فرض است تغییر نام دهید; خلق كردن
دایرکتوری ها ، ایجاد باید به صراحت داده شود. اقدامات تغییر نام انجام خواهد شد
بلافاصله، برای اینکه ببینید چه کاری انجام می شود، از آن استفاده کنید خشک کردن گزینه.

شماره آهنگ
آهنگ های اعداد [شماره پیگیری] [TAG-NUMBERS]

آهنگ های انتخاب شده را با شروع شماره گذاری کنید شماره پیگیری (1 در صورت حذف).

فیلتر
فیلتر [FILTER-NAME | FILTER-FORMAT]

فایل‌ها را فیلتر کنید تا فقط فایل‌هایی که با آن مطابقت دارند FILTER-FORMAT قابل مشاهده هستند. در
نام یک عبارت فیلتر از پیش تعریف شده (مثلا "نام فایل برچسب عدم تطابق") می تواند به کار رود
به جای عبارت فیلتر، فیلتر را ببینید.

kid3-cli> فیلتر '٪{عنوان} شامل "ترو"
آغاز شده
/home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
- 02 ما فقط این یکی را گرفتیم.mp3
+ 03 Outro.mp3
تمام شده
kid3-cli> ls
1- 01 Intro.mp3
1- 03 Outro.mp3
kid3-cli> فیلتر معرفی
آغاز شده
/home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
+ 02 ما فقط این یکی را گرفتیم.mp3
+ 03 Outro.mp3
تمام شده
kid3-cli> ls
1- 01 Intro.mp3
12 02 ما فقط این یکی را گرفتیم.mp3
1- 03 Outro.mp3

تبدیل ID3v2.3 به ID3v2.4
to24

تبدیل ID3v2.4 به ID3v2.3
to23

نام فایل از جانب برچسب
از برچسب [FORMAT] [TAG-NUMBERS]

به عنوان مثال، نام فایل های فایل های انتخاب شده را از مقادیر موجود در برچسب ها تنظیم کنید از برچسب
"٪{مسیر} - ٪{عنوان}" 1. اگر هیچ فرمتی مشخص نشده باشد، از فرمت تنظیم شده در رابط کاربری گرافیکی استفاده می شود.

برچسب از جانب نام فایل
برای برچسب زنی [FORMAT] [TAG-NUMBERS]

برای مثال، فریم های برچسب را از نام فایل ها تنظیم کنید برای برچسب زنی "%{آلبومماریست} -
%{آلبوم}/%{تراک} ٪{عنوان}" 2. اگر هیچ فرمتی مشخص نشده باشد، فرمت تنظیم شده در رابط کاربری گرافیکی است
استفاده شده. اگر فرمت نام فایل با این الگو مطابقت نداشته باشد، معمولاً تعداد کمی دیگر
فرمت های استفاده شده امتحان شده است.

برچسب به دیگر برچسب
همگام سازی {شماره برچسب}

فریم های تگ را از یک تگ به تگ دیگر کپی کنید، به عنوان مثال برای تنظیم تگ ID3v2 از
برچسب ID3v1، استفاده کنید همگام سازی 2.

نسخه
کپی کنید [شماره برچسب]

فریم های برچسب فایل انتخاب شده را در بافر داخلی کپی کپی کنید. آنها سپس می توانند باشند
با استفاده از چسباندن فرمان

چسباندن
چسباندن [شماره برچسب]

تنظیم فریم های برچسب از محتویات کپی کنید بافر در فایل های انتخاب شده

برداشتن
برداشتن [شماره برچسب]

یک برچسب را حذف کنید.

بازی
بازی [مکث | توقف | قبلی | بعد]

پخش صدا را شروع کنید. پس از راه اندازی، می توان با آن کنترل کرد توقف
(برای مکث و از سرگیری)، متوقف کردن, قبلی و بعد گزینه.

مثال ها
با استفاده از تابع وارد کردن دسته ای، جلد آلبوم را در همه فایل های یک دایرکتوری تنظیم کنید:

kid3-cli -c واردات خودکار "پوشش دادن هنر" /path/to/dir

فریم های نظر را حذف کنید و قالب تگ را در هر دو تگ تمام فایل های MP3 a اعمال کنید
دایرکتوری:

kid3-cli -c 'تنظیم توضیح "" 1' -c 'تنظیم توضیح "" 2' \
-c 'فرمت برچسب 1' -c 'فرمت برچسب 2' /path/to/dir/*.mp3

وارد کردن خودکار برچسب 2، همگام سازی با برچسب 1، تنظیم نام فایل ها از برچسب 2 و در نهایت
ایجاد یک لیست پخش:

kid3-cli -c واردات خودکار -c همگام 1' -c از برچسب -c پخش \
/path/to/dir/*.mp3

برای همه فایل‌های دارای تگ ID3v2.4.0، به ID3v2.3.0 تبدیل کنید و قاب تنظیم‌کننده را حذف کنید:

kid3-cli -c "فیلتر ID3v2.4.0 برچسب"" -c "انتخاب کنید همه" -c to23 \
-c "تنظیم مرتب کردن "" /path/to/dir

این اسکریپت پایتون استفاده می کند kid3-cli برای تولید صدای iTunes فریم های iTunNORM را بررسی کنید
اطلاعات کسب مجدد پخش

#!/usr/bin/env پایتون
# چک صدای iTunes را از ReplayGain ایجاد کنید.
از __future__ import print_function
واردات سیستم عامل، سیستم، پردازش فرعی

def rg2sc (dirpath):
برای root، dirs، فایل ها در os.walk(dirpath):
برای نام در فایل ها:
if name.endswith(('.mp3'، '.m4a'، '.aiff'، '.aif')):
fn = os.path.join (ریشه، نام)
rg = subprocess.check_output([
'kid3-cli'، '-c'، 'دریافت "replaygain_track_gain"'،
fn]).strip()
اگر rg.endswith(b' dB'):
rg = rg[:-3]
تلاش كردن:
rg = شناور (rg)
به جز ValueError:
print('مقدار %s %s در یک شناور نیست' % (rg, fn))
ادامه دادن
sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
subprocess.call([
'kid3-cli'، '-c'، 'set iTunNORM "%s"' % sc, fn])

اگر __name__ == '__main__':
rg2sc(sys.argv[1])

اعتبارات و مجوز

Kid3

برنامه نوشته شده توسط Urs Fleisch

LDF[20]

GPL[21]

نصب و راه اندازی

چگونه به گرفتن Kid3
Kid3 را می توان در پیدا کرد http://kid3.sourceforge.net.

مورد نیاز
نیازهای Kid3 Qt[22]. KDE[23] توصیه می شود، اما ضروری نیست، زیرا Kid3 نیز قابل کامپایل است
به عنوان یک برنامه Qt. Kid3 را می توان برای سیستم هایی که این کتابخانه ها هستند کامپایل کرد
در دسترس است، به عنوان مثال برای GNU/Linux، Windows و Mac OS X. برای برچسب گذاری فایل های Ogg/Vorbis، لیبوگ[13]،
libvorbis و libvorbisfile[14] برای فایل های FLAC مورد نیاز است libFLAC++ و libFLAC[15].
id3lib[12] برای فایل های MP3 استفاده می شود. این چهار فرمت نیز توسط TagLib[16]،
که همچنین می تواند فایل های Opus، MPC، APE، MP2، Speex، TrueAudio، WavPack، WMA، WAV، AIFF را مدیریت کند.
و ماژول های ردیاب برای وارد کردن از اثر انگشت آکوستیک، کروماپرینت[18] و لیباو[19]
استفاده می شود.

Kid3 برای اکثر توزیع‌های لینوکس، ویندوز و Mac OS X در دسترس است. پیوندها را می‌توان پیدا کرد
on http://kid3.sourceforge.net.

فيلم هاي سكسي تلفيقي و نصب و راه اندازی
می توانید Kid3 را با یا بدون KDE کامپایل کنید. بدون KDE، Kid3 یک برنامه Qt ساده است و
فاقد برخی از ویژگی های پیکربندی و جلسه است.

برای یک نسخه KDE، به فهرست بالا بروید و تایپ کنید

% ساختن .
% ساخت
% ساخت نصب

برای کامپایل برای نسخه های مختلف Qt یا KDE، مربوطه را تنظیم کنید ساختن گزینه.

اگر همه کتابخانه ها وجود نداشته باشند، Kid3 با عملکرد کمتر ساخته شده است. بنابرین تو باید
مراقب باشید که تمام بسته های توسعه دلخواه را نصب کنید. از طرف دیگر،
ساختن-گزینه ها کنترل می کنند که کدام کتابخانه ها در آنها کامپایل شوند. پیش فرض این است -D
WITH_TAGLIB:BOOL=روشن -D WITH_MP4V2:BOOL=OFF -D WITH_ID3LIB:BOOL=روشن -D
WITH_CHROMAPRINT:BOOL=روشن -D WITH_VORBIS:BOOL=روشن -D WITH_FLAC:BOOL=روشن . این گزینه ها می توانند
با استفاده غیرفعال شود OFF.

برای ساخت Kid3 به عنوان یک برنامه Qt بدون KDE، از ساختن انتخاب -DWITH_APPS=Qt. به
هم یک برنامه KDE و هم یک برنامه Qt بسازید، تنظیم کنید -DWITH_APPS="Qt;KDE".

می توان از Qt 4 یا Qt 5 استفاده کرد. برای اجبار استفاده از Qt 4، تنظیم کنید -DWITH_QT4=روشن، برای اجبار استفاده از
Qt 5، مجموعه -DWITH_QT5=روشن، اگر هر دو گزینه OFF (پیش‌فرض) باشند، Qt 4 ترجیح داده می‌شود
هر دو نسخه نصب شده است برای استفاده از نصب Qt خاص، تنظیم کنید
-DQT_QMAKE_EXECUTABLE=/path/to/qmake. اگر ساختن برنامه KDE فعال است، تنظیم کنید
Qt 4 از KDE 4 استفاده می کند، در حالی که تنظیم Qt 5 از KDE 5 استفاده می کند.

تولید بسته‌های RPM توسط فایل kid3.spec پشتیبانی می‌شود، برای بسته‌های Debian،
اسکریپت build-deb.shis موجود است.

برنامه Qt را می توان برای ویندوز و Mac OS X نیز کامپایل کرد. اسکریپت های موجود در
پوشه های win32 و macosx می توانند برای ساخت و ایجاد بسته ها استفاده شوند. کتابخانه ها می توانند باشند
با استفاده از buildlibs.sh نصب شده است.

پیکر بندی
با KDE، فیلتر و قالب نام فایل، فرمت‌های وارد کردن، نام فایل و ID3
فرمت ها، تنظیمات نوار ابزار و نوار وضعیت و همچنین اندازه پنجره در آن ذخیره می شود
مکان استاندارد در فایل kid3rc. به عنوان یک برنامه Qt، این فایل در است
.config/Kid3/Kid3.conf. در ویندوز، پیکربندی در رجیستری ذخیره می شود.

D-BUS رابط

اتوبوس D مثال ها
نسخه‌های Qt 4 و KDE 4 در لینوکس یک D-Bus-Interface برای کنترل Kid3 توسط اسکریپت‌ها ارائه می‌کنند.
اسکریپت ها را می توان به هر زبانی با D-Bus-bindings (مثلاً در پایتون) نوشت و می تواند
برای گسترش عملکرد Kid3 به اقدامات کاربر اضافه شده است.

هنرمند در تگ 2 فایل فعلی را می توان با مقدار "One Hit Wonder" تنظیم کرد
کد زیر:

صدف

dbus-send --dest=net.sourceforge.kid3 --print-reply=literal \
/Kid3 net.sourceforge.Kid3.setFrame int32:2 string:'Artist' \
رشته: "One Hit Wonder"

یا با Qt راحت تر qdbus (qdbusviewer می توان برای بررسی رابط کاربری در یک رابط کاربری گرافیکی استفاده کرد:

qdbus net.sourceforge.kid3 /Kid3 setFrame 2 Artist \
"One Hit Wonder"

پــایتــون

وارد کردن dbus
kid3 = dbus.SessionBus().get_object(
'net.sourceforge.kid3'، '/Kid3')
kid3.setFrame (2، "هنرمند"، "یک ضربه شگفت انگیز")

پرل

استفاده از Net::DBus;
$kid3 = Net::DBus->session->get_service(
"net.sourceforge.kid3")->get_object(
"/Kid3"، "net.sourceforge.Kid3");
$kid3->setFrame(2، "Artist"، "One Hit Wonder");

اتوبوس D API
API D-Bus در net.sourceforge.Kid3.xml مشخص شده است. رابط Kid3 دارای
روش های زیر:

باز کن پرونده or فهرست راهنما
بولی openDirectory(رشته مسیر);

مسیر
مسیر فایل یا دایرکتوری

اگر درست باشد، true را برمی‌گرداند.

ذخیره تمام اصلاح شده فایل ها
بولی ذخیره (باطل)؛

اگر درست باشد، true را برمی‌گرداند.

گرفتن a دقیق خطا پیام ارائه by برخی از روش
رشته getErrorMessage(void);

پیغام خطای دقیق را برمی گرداند.

برگرداندن تغییرات in la انتخاب شد فایل ها
revert (void);

آغاز an اتوماتیک دسته واردات
بولی batchImport(int32 برچسب ماسک, رشته نام پروفایل);

برچسب ماسک
ماسک برچسب (بیت 0 برای تگ 1، بیت 1 برای تگ 2)

نام پروفایل
نام نمایه واردات دسته ای برای استفاده

وارد كردن برچسب ها از جانب a پرونده
بولی importFromFile(int32 برچسب ماسک, رشته مسیر, intxnumx fmtIdx);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

مسیر
مسیر فایل

fmtIdx
نمایه فرمت

اگر درست باشد، true را برمی‌گرداند.

دانلود البوم پوشش هنر
دانلودآلبوم آرت(رشته آدرس, بولی allFilesInDir);

آدرس
URL فایل تصویر یا منبع هنری آلبوم

allFilesInDir
درست است تا تصویر را به تمام فایل های دایرکتوری اضافه کنید

صادرات برچسب ها به a پرونده
بولی exportToFile(int32 برچسب ماسک, رشته مسیر, intxnumx fmtIdx);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

مسیر
مسیر فایل

fmtIdx
نمایه فرمت

اگر درست باشد، true را برمی‌گرداند.

ساختن a پخش
بولی createPlaylist(void);

اگر درست باشد، true را برمی‌گرداند.

ترک la استفاده
ترک (باطل)

انتخاب کنید تمام فایل ها
selectAll(void);

لغو انتخاب تمام فایل ها
deselectAll(void);

تنظیم la اول پرونده as la جاری پرونده
بولی firstFile(void);

اگر اولین فایل وجود داشته باشد، true را برمی گرداند.

تنظیم la قبلی پرونده as la جاری پرونده
بولی previousFile(void);

اگر فایل قبلی وجود داشته باشد، true را برمی گرداند.

تنظیم la بعد پرونده as la جاری پرونده
بولی nextFile(void);

اگر فایل بعدی وجود داشته باشد، true را برمی گرداند.

انتخاب کنید la اول پرونده
بولی selectFirstFile(void);

اگر اولین فایل وجود داشته باشد، true را برمی گرداند.

انتخاب کنید la قبلی پرونده
بولی selectPreviousFile(void);

اگر فایل قبلی وجود داشته باشد، true را برمی گرداند.

انتخاب کنید la بعد پرونده
بولی selectNextFile(void);

اگر فایل بعدی وجود داشته باشد، true را برمی گرداند.

انتخاب کنید la جاری پرونده
بولی selectCurrentFile(void);

اگر فایل فعلی وجود داشته باشد، true را برمی گرداند.

گسترش or سقوط la جاری پرونده آیتم if it is a فهرست راهنما
بولی expandDirectory(void);

در صورتی که getFileName() نامی را با '/' به عنوان آخرین نام بازگرداند، یک آیتم لیست فایل یک دایرکتوری است.
شخصیت.

اگر مورد فایل فعلی یک دایرکتوری باشد، true را برمی‌گرداند.

درخواست la پرونده نام قالب
applyFilenameFormat(void);

درخواست la برچسب قالب
applicationTagFormat(void);

درخواست متن پشتیبانی می کند
applicationTextEncoding(void);

تنظیم la فهرست راهنما نام از جانب la برچسب ها
بولی setDirNameFromTag(int32 برچسب ماسک, رشته قالب, بولی ایجاد);

برچسب ماسک
ماسک برچسب (بیت 0 برای تگ 1، بیت 1 برای تگ 2)

قالب
فرمت نام دایرکتوری

ایجاد
درست برای ایجاد، نادرست برای تغییر نام

اگر درست باشد مقدار true را برمی‌گرداند، در غیر این صورت پیام خطا با استفاده از getErrorMessage() در دسترس است.

تنظیم متعاقب مسیر تعداد in la انتخاب شد فایل ها
numberTracks(int32 برچسب ماسک, intxnumx firstTrackNr);

برچسب ماسک
ماسک برچسب (بیت 0 برای تگ 1، بیت 1 برای تگ 2)

firstTrackNr
شماره برای استفاده برای اولین فایل

فیلتر la فایل ها
فیلتر (رشته بیان);

بیان
بیان فیلتر

تبدیل ID3v2.3 برچسب ها به ID3v2.4
convertToId3v24(void);

تبدیل ID3v2.4 برچسب ها به ID3v2.3
convertToId3v23(void);

اگر درست باشد، true را برمی‌گرداند.

گرفتن مسیر of فهرست راهنما
رشته getDirectoryName(void);

مسیر مطلق دایرکتوری را برمی گرداند.

گرفتن نام of جاری پرونده
رشته getFileName(void);

نام فایل مطلق واقعی را برمی‌گرداند، اگر دایرکتوری باشد با "/" ختم می‌شود.

تنظیم نام of انتخاب شد پرونده
setFileName(رشته نام);

نام
نام پرونده

پس از ذخیره فهرست، نام فایل تغییر خواهد کرد.

تنظیم قالب به استفاده کنید چه زمانی محیط la نام فایل از جانب la برچسب ها
setFileNameFormat(رشته قالب);

قالب
فرمت نام فایل

تنظیم la پرونده نام of la انتخاب شد فایل ها از جانب la برچسب ها
setFileNameFromTag(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

گرفتن ارزش of قاب
رشته getFrame(int32 برچسب ماسک, رشته نام);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

نام
نام قاب (به عنوان مثال "هنرمند")

برای به دست آوردن داده های باینری مانند یک تصویر، نام فایلی که باید بنویسید را می توان بعد از آن اضافه کرد
نام، به عنوان مثال "تصویر:/path/to/file". به همین ترتیب، اشعار همگام می تواند باشد
صادر شده، به عنوان مثال "SYLT:/path/to/file".

ارزش قاب را برمی گرداند.

تنظیم ارزش of قاب
بولی setFrame(int32 برچسب ماسک, رشته نام, رشته ارزش);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

نام
نام قاب (به عنوان مثال "هنرمند")

ارزش
ارزش قاب

برای تگ 2 (برچسب ماسک 2)، اگر بدون قاب با نام وجود دارد، یک فریم جدید اضافه می شود، اگر ارزش is
خالی، فریم حذف می شود. برای افزودن داده های باینری مانند یک تصویر، می توان یک فایل اضافه کرد
بعد از نام، به عنوان مثال "تصویر:/path/to/file". می توان از "SYLT:/path/to/file" استفاده کرد
وارد کردن اشعار همگام شده

اگر درست باشد، true را برمی‌گرداند.

گرفتن تمام قاب of a برچسب
صف of رشته getTag(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

لیستی را با نام ها و مقادیر متناوب فریم برمی گرداند.

گرفتن فنی اطلاعات در باره پرونده
صف of رشته getInformation(void);

ویژگی ها عبارتند از: فرمت، نرخ بیت، نمونه گیری، کانال ها، مدت زمان، حالت کانال، VBR، برچسب
1، برچسب 2. ویژگی هایی که در دسترس نیستند حذف می شوند.

لیستی را با نام‌ها و مقادیر دارایی متناوب برمی‌گرداند.

تنظیم برچسب از جانب پرونده نام
setTagFromFileName(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

تنظیم برچسب از جانب دیگر برچسب
setTagFromOtherTag(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

نسخه برچسب
copyTag(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

چسباندن برچسب
pasteTag(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

برداشتن برچسب
removeTag(int32 برچسب ماسک);

برچسب ماسک
بیت برچسب (1 برای تگ 1، 2 برای تگ 2)

جبران کنید la پیکر بندی
reparseConfiguration(void);

تغییرات پیکربندی خودکار با تغییر فایل پیکربندی و
سپس پیکربندی را مجدداً بازسازی کنید.

نمایشنامه la انتخاب شد فایل ها
playAudio(void);

QML رابط

QML مثال ها
اسکریپت های QML را می توان از طریق منوی زمینه لیست فایل فراخوانی کرد و در برگه تنظیم کرد.
اقدامات کاربر گفتگوی تنظیمات. اسکریپت هایی که در آنجا تنظیم می شوند را می توان به عنوان استفاده کرد
نمونه هایی برای برنامه نویسی اسکریپت های سفارشی QML از جاوا اسکریپت استفاده می کند، در اینجا "سلام".
جهان":

وارد کردن Kid3 1.0

Kid3Script {
در حال اجرا: {
console.log ("Hello world, directory is"، app.dirName)
Qt.quit()
}
}

اگر این اسکریپت به صورت /path/to/Example.qml ذخیره شود، دستور کاربر را می توان به صورت تعریف کرد. @qml
/path/to/Example.qml با نام QML تست و خروجی بررسی شد. سپس می توان استفاده از آن را شروع کرد
مورد QML Test در منوی زمینه لیست فایل، و خروجی در قسمت قابل مشاهده خواهد بود
پنجره.

متناوبا، اسکریپت همچنین می تواند مستقل از Kid3 با استفاده از ابزار QML شروع شود.

qmlviewer -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

برای Qt 5، دستورات

qml -apptype ویجت -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

or

qmlscene -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

می تواند به کار رود. در ویندوز و OS X، مسیر واردات باید با پوشه imports تطبیق داده شود
داخل دایرکتوری نصب اسکریپت هایی که خارج از Kid3 شروع شده اند از جریان استفاده می کنند
دایرکتوری، بنابراین باید از قبل تغییر داده شود.

برای فهرست کردن عناوین موجود در تگ‌های 2 همه فایل‌ها در فهرست فعلی، موارد زیر را انجام دهید
می توان از اسکریپت استفاده کرد:

وارد کردن Kid3 1.0

Kid3Script {
در حال اجرا: {
app.firstFile()
انجام دادن {
if (app.selectionInfo.tagFormatV2)
console.log(app.getFrame(tagv2، "عنوان"))
} while (app.nextFile())
}
}

اگر دایرکتوری حاوی فایل های زیادی باشد، چنین اسکریپتی ممکن است رابط کاربری را مسدود کند
چند وقت. بنابراین، برای عملیات طولانی‌تر، هر از گاهی باید استراحت داشته باشد. در
اجرای جایگزین زیر کار برای یک فایل واحد را به یک تابع منتقل می کند.
با توجه به اینکه تعداد فایل‌های بیشتری وجود دارد، این تابع خود را با 1 میلی ثانیه در پایان فراخوانی می‌کند
پردازش شود. این اطمینان حاصل می کند که رابط کاربری گرافیکی در حین پاسخگویی اسکریپت باقی می ماند
در حال اجرا

وارد کردن Kid3 1.0

Kid3Script {
در حال اجرا: {
تابع doWork() {
if (app.selectionInfo.tagFormatV2) {
console.log(app.getFrame(tagv2، "عنوان"))
}
if (!app.nextFile()) {
Qt.quit()
} دیگری {
setTimeout (doWork، 1)
}
}

app.firstFile()
doWork()
}
}

اسکریپت‌های نمونه بیشتری همراه Kid3 هستند و قبلاً به عنوان دستورات کاربر ثبت شده‌اند.

· ReplayGain به SoundCheck (ReplayGain2SoundCheck.qml): ایجاد iTunNORM SoundCheck
اطلاعات از فریم های افزایش مجدد پخش.

· تغییر اندازه آلبوم هنری (ResizeAlbumArt.qml): تغییر اندازه تصاویر جلد هنری تعبیه شده که
بزرگتر از 500x500 پیکسل

· Extract Album Art (ExtractAlbumArt.qml): استخراج تمام تصاویر جلد هنری تعبیه شده
اجتناب از تکراری

· جاسازی آلبوم هنری (EmbedAlbumArt.qml): هنر جلد موجود در فایل های تصویری را در فایل صوتی جاسازی کنید
فایل ها در همان پوشه

· جاسازی متن ترانه (EmbedLyrics.qml): اشعار غیرهمگام را از سرویس وب واکشی کنید.

· کدگذاری متن ID3v1 (ShowTextEncodingV1.qml): به یافتن رمزگذاری برچسب های ID3v1 کمک می کند.
با نشان دادن تگ های فایل فعلی در تمام رمزگذاری های کاراکتر موجود.

· صادرات CSV (ExportCsv.qml): همه تگ های همه فایل ها را به صورت بازگشتی به یک فایل CSV صادر کنید.

· کنسول QML (QmlConsole.qml): کنسول ساده برای بازی با API QML Kid3.

QML API
API را می توان به راحتی با استفاده از کنسول QML که به عنوان نمونه موجود است، کاوش کرد
اسکریپت با رابط کاربری

Kid3Script
Kid3Script یک جزء QML معمولی است که در داخل فهرست پلاگین قرار دارد. شما می توانید
به همین خوبی از یک جزء QML دیگر استفاده کنید. استفاده از Kid3Script شروع را آسان می کند
تابع اسکریپت با استفاده از در اجرا کنترل کننده سیگنال همچنین تفاوت های بین آنها را پنهان می کند
نسخه های QtQuick، تا اسکریپت ها با هر دو Qt 4 و Qt 5 سازگار شوند.
علاوه بر این، برخی از توابع را ارائه می دهد:

onRun: کنترل کننده سیگنال که هنگام شروع اسکریپت فراخوانی می شود
tagv1, tagv2, tagv2v1: ثابت برای پارامترهای برچسب
script: دسترسی به توابع اسکریپت نویسی
configs: دسترسی به اشیاء پیکربندی
getArguments(): فهرست آرگومان های اسکریپت
isStandalone(): true اگر اسکریپت از داخل Kid3 شروع نشده باشد
setTimeout(Callback, Delay): پاسخ به تماس را پس از تاخیر ms شروع می کند

برنامه نویسی توابع
به عنوان جاوا اسکریپت و در نتیجه QML نیز تنها مجموعه محدودی از توابع برای اسکریپت نویسی دارد.
la خط شی چند روش اضافی دارد، به عنوان مثال:

script.properties(obj): رشته ای با ویژگی های Qt
script.writeFile(filePath, data): داده ها را در فایل بنویسید، اگر درست باشد درست است
script.readFile(filePath): خواندن داده ها از فایل
script.removeFile(filePath): فایل را حذف کنید، اگر درست باشد درست است
script.fileExists(filePath): در صورت وجود فایل درست است
script.renameFile(oldName, newName): تغییر نام فایل، درست در صورت تایید
script.tempPath(): مسیر به دایرکتوری موقت
script.listDir(مسیر، [nameFilters]، [طبقه بندی]): فهرست ورودی های فهرست
script.system (برنامه، [args]، [msecs]): به طور همزمان یک فرمان سیستم را شروع کنید،
[کد خروج، خروجی استاندارد، خطای استاندارد] در صورت عدم وقفه
script.getEnv(varName): مقدار متغیر محیطی را دریافت کنید
script.setEnv(varName, value): مقدار تنظیم متغیر محیطی
script.getQtVersion(): رشته نسخه Qt، به عنوان مثال "5.4.1"
script.getDataMd5(data): رشته هگز از هش MD5 داده را دریافت کنید
script.getDataSize(data): اندازه آرایه بایت را دریافت کنید
script.dataToImage(داده، [فرمت]): یک تصویر از بایت داده ایجاد کنید
script.dataFromImage(img، [فرمت]): بایت های داده را از تصویر دریافت کنید
script.loadImage(filePath): یک تصویر را از یک فایل بارگیری کنید
script.saveImage(img، filePath، [فرمت]): یک تصویر را در یک فایل ذخیره کنید، اگر درست باشد درست است
script.imageProperties(img): دریافت ویژگی های یک تصویر، نقشه حاوی
"عرض"، "ارتفاع"، "عمق" و "ColorCount"، در صورت نامعتبر بودن تصویر خالی است
script.scaleImage(img، عرض، [ارتفاع]): مقیاس یک تصویر، تصویر مقیاس شده را برمی گرداند
script.selectFileName(caption، dir، filter، saveFile): گفتگوی فایل را باز کنید
یک فایل را انتخاب کنید

کاربرد زمینه
با استفاده از QML، بخش بزرگی از توابع Kid3 قابل دسترسی است. API مشابه است
مورد استفاده برای D-Bus. برای جزئیات، به یادداشت های مربوطه مراجعه کنید.

app.openDirectory(path): دایرکتوری را باز کنید
app.saveDirectory(): ذخیره دایرکتوری
app.revertFileModifications(): برگرداندن
app.importTags (برچسب، مسیر، fmtIdx): فایل را وارد کنید
app.downloadImage(url, allFilesInDir): دانلود تصویر
app.exportTags (برچسب، مسیر، fmtIdx): فایل صادراتی
app.writePlaylist(): نوشتن لیست پخش
app.selectAllFiles(): همه را انتخاب کنید
app.deselectAllFiles(): لغو انتخاب کنید
app.firstFile([انتخاب]): به اولین فایل
app.nextFile([انتخاب]): به فایل بعدی
app.previousFile([انتخاب]): به فایل قبلی
app.selectCurrentFile([انتخاب]): فایل فعلی را انتخاب کنید
app.requestExpandFileList(): همه را گسترش دهید
app.applyFilenameFormat(): فرمت نام فایل را اعمال کنید
app.applyTagFormat(): فرمت تگ را اعمال کنید
app.applyTextEncoding(): اعمال رمزگذاری متن
app.numberTracks (شماره، کل، برچسب، [گزینه‌ها]): تعداد آهنگ‌ها
app.applyFilter(expr): فیلتر
app.convertToId3v23(): تبدیل ID3v2.4.0 به ID3v2.3.0
app.convertToId3v24(): تبدیل ID3v2.3.0 به ID3v2.4.0
app.getFilenameFromTags(tag): نام فایل از تگ ها
app.getTagsFromFilename(tag): نام فایل به برچسب ها
app.getAllFrames(tag): دریافت شی با تمام فریم ها
app.getFrame (برچسب، نام): فریم را دریافت کنید
app.setFrame (برچسب، نام، مقدار): قاب را تنظیم کنید
app.getPictureData(): داده ها را از قاب عکس دریافت کنید
app.setPictureData(data): داده ها را در قاب عکس تنظیم کنید
app.copyToOtherTag (برچسب): برچسب‌ها به برچسب‌های دیگر
app.copyTags(tag): کپی کنید
app.pasteTags(tag): چسباندن
app.removeTags(tag): حذف
app.playAudio(): پخش
app.readConfig(): خواندن پیکربندی
app.applyChangedConfiguration(): اعمال تنظیمات
app.dirName: نام دایرکتوری
app.selectionInfo.fileName: نام فایل
app.selectionInfo.filePath: مسیر فایل مطلق
app.selectionInfo.detailInfo: جزئیات را قالب بندی کنید
app.selectionInfo.tagFormatV1: فرمت برچسب 1
app.selectionInfo.tagFormatV2: فرمت برچسب 2
app.selectionInfo.formatString (برچسب، قالب): کدها را در رشته قالب جایگزین کنید

برای عملیات ناهمزمان، تماس ها را می توان به سیگنال ها متصل کرد.

تابع automaticImport(پروفایل) {
تابع onAutomaticImportFinished() {
app.batchImporter.finished.disconnect(onAutomaticImportFinished)
}
app.batchImporter.finished.connect(onAutomaticImportFinished)
app.batchImport (نمایه، tagv2)
}

تابع renameDirectory(format) {
تابع onRenameActionsScheduled() {
app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
app.performRenameActions()
}
app.renameActionsScheduled.connect(onRenameActionsScheduled)
app.renameDirectory (tagv2v1، قالب، نادرست)
}

پیکر بندی اشیاء
بخش های پیکربندی مختلف از طریق روش های قابل دسترسی هستند configs. آنها
خواص را می توان در کنسول QML فهرست کرد.

script.properties(configs.networkConfig())

ویژگی ها را می توان تنظیم کرد:

configs.networkConfig().useProxy = false

configs.batchImportConfig()
configs.exportConfig()
configs.fileConfig()
configs.filenameFormatConfig()
configs.filterConfig()
configs.findReplaceConfig()
configs.guiConfig()
configs.importConfig()
configs.mainWindowConfig()
configs.networkConfig()
configs.numberTracksConfig()
configs.playlistConfig()
configs.renDirConfig()
configs.tagConfig()
configs.tagFormatConfig()
configs.userActionsConfig()

با استفاده از خدمات onworks.net از kid3 به صورت آنلاین استفاده کنید