kid3-core - Dalam talian di Awan

JADUAL:

NAMA

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

SINOPSIS

kid3 [- membantu | --help-qt | --bantu-kde | --bantu-semua
|--pengarang | --versi | --lesen] [FAIL...]

kid3-qt [Pilihan Qt] [FAIL...]

kid3-cli [-h | - membantu] [-c PERINTAH1] [-c PERINTAH2...] [FAIL...]

PILIHAN

FAIL
If FAIL ialah laluan ke direktori, ia akan dibuka. Jika satu atau lebih laluan fail adalah
diberikan, direktori biasa mereka dibuka dan fail dipilih.

kid3
- membantu
Tunjukkan bantuan tentang pilihan.

--help-qt
Tunjukkan pilihan khusus Qt, lihat qtoptions(7).

--bantu-kde
Tunjukkan pilihan khusus KDE, lihat kdeoptions(7).

--bantu-semua
Tunjukkan semua pilihan.

--pengarang
Tunjukkan maklumat pengarang.

--versi
Tunjukkan maklumat versi.

--lesen
Tunjukkan maklumat lesen.

kid3-qt
Pilihan Qt
Lihat qtoptions(7), bagaimanapun, pilihan mempunyai "-" sebagai awalan, bukan "--".

kid3-cli
-c
Laksanakan arahan. Pelbagai -c pilihan adalah mungkin, ia dilaksanakan mengikut urutan.
Lihat bahagian tentang kid3-cli untuk penerangan tentang arahan yang tersedia.

-h|- membantu
Tunjukkan bantuan tentang pilihan dan arahan.

PENGENALAN

Kid3 ialah aplikasi untuk mengedit tag ID3v1 dan ID3v2 dalam fail MP3 dengan cara yang cekap.
Tag ini boleh diedit oleh kebanyakan pemain MP3, tetapi tidak dalam keadaan yang sangat selesa dan cekap
cara. Selain itu tag dalam Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex,
TrueAudio, WavPack, WMA, WAV, fail AIFF dan modul penjejak (MOD, S3M, IT, XM) ialah
disokong juga.

Kid3 tidak merebut atau mengekod fail MP3, tetapi ia disasarkan untuk mengedit tag ID3 semua
fail album dengan cara yang cekap, iaitu dengan sedikit klik tetikus dan pukulan kekunci
mungkin. Di mana kebanyakan program lain boleh mengedit sama ada teg ID3v1 atau ID3v2, Kid3 telah penuh
mengawal kedua-dua versi, boleh menukar teg antara kedua-dua format dan mempunyai akses kepada semua
Tag ID3v2. Tag berbilang fail boleh ditetapkan kepada nilai yang sama, cth artis, album,
tahun dan genre semua fail album biasanya mempunyai nilai yang sama dan boleh ditetapkan
bersama-sama. Jika maklumat untuk tag terkandung dalam nama fail, tag boleh
ditetapkan secara automatik daripada nama fail. Ia juga mungkin untuk menetapkan nama fail mengikut
kepada tag yang terdapat dalam fail dalam format sewenang-wenangnya.

Tugas penyuntingan disokong lagi dengan penggantian automatik aksara atau
subrentetan, contohnya untuk mengalih keluar aksara haram daripada nama fail. Kawalan automatik bagi
aksara besar dan kecil memudahkan penggunaan skema penamaan yang konsisten dalam semua
tags.

Maklumat tag untuk album penuh boleh diambil daripada gnudb.org[1], TrackType.org[2],
MusicBrainz[3], Discog[4], Amazon[5] atau sumber senarai lagu yang lain. Format import
boleh dikonfigurasikan secara bebas dengan ungkapan biasa.

Sila laporkan sebarang masalah atau permintaan ciri kepada pengarang.

MENGGUNAKAN KID3

Kid3 ciri-ciri
· Edit tag ID3v1.1

· Edit semua bingkai ID3v2.3 dan ID3v2.4

· Edit tag berbilang fail

· Tukar antara tag ID3v1 dan ID3v2

· Edit MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio,
Tag WavPack, WMA, WAV dan AIFF

· Hasilkan tag daripada nama fail

· Hasilkan tag daripada kandungan medan tag

· Hasilkan nama fail daripada tag

· Menjana dan menukar nama direktori daripada tag

· Hasilkan fail senarai main

· Penukaran kes automatik dan terjemahan rentetan

· Import daripada gnudb.org[1], TrackType.org[2], MusicBrainz[3], Discog[4], Amazon[5] dan
sumber data lain

· Eksport sebagai CSV, HTML, senarai main, Kover XML dan format lain. Fail CSV yang dieksport boleh
diimport lagi.

Contoh Penggunaan
Bahagian ini menerangkan sesi biasa dengan Kid3. Katakan kita mempunyai direktori
mengandungi fail MP3 dengan trek daripada album "Let's Tag" daripada kumpulan "One Hit
Wonder". Direktori ini dinamakan dalam format "artis - album", dalam kes kami One Hit Wonder
- Jom Tag. Direktori mengandungi trek dalam format "tajuk lagu.mp3", yang saya
think berguna kerana nama failnya pendek (penting apabila menggunakan pemain MP3 mudah alih
dengan paparan kecil) dan dalam susunan yang betul apabila disusun mengikut abjad (penting apabila
menggunakan pemain MP3 perkakasan yang memainkan trek dalam susunan abjad atau dalam susunan dalam
yang mana ia dibakar pada CD dan susunan itu mengikut abjad apabila digunakan mksofs). Selain itu
ini, maklumat artis dan album sudah ada dalam nama direktori dan tidak mempunyai
untuk diulang dalam nama fail. Tetapi kembali kepada contoh kami, senarai direktori kelihatan seperti
ini:

01 Pengenalan.mp3

02 Kami Hanya Dapat Ini.mp3

03 Outro.mp3

Fail ini belum mempunyai teg lagi dan kami mahu menjananya menggunakan Kid3. Kami menggunakan Open (Fail
menu atau bar alat) dan pilih salah satu fail dalam direktori ini. Semua fail akan menjadi
dipaparkan dalam kotak senarai fail. Malas kita nak guna maklumat dalam
direktori dan nama fail untuk menjana tag. Oleh itu kami memilih semua fail, kemudian klik pada
Kepada:Tag butang 1 dalam bahagian Fail. Ini akan menetapkan tajuk, artis, album dan lagu
nilai dalam semua fail. Untuk menetapkan tahun dan nilai genre semua fail, kami menyimpan semua fail
dipilih dan taip "2002" untuk Tahun dan pilih "Pop" daripada kotak kombo Genre. Untuk menetapkan
hanya dua nilai ini, kotak semaknya ditandakan secara automatik dan semua kotak semak lain
dibiarkan tanpa tanda. Sekarang kita menukar pemilihan dengan hanya memilih fail pertama dan kita
lihat bahawa semua teg mengandungi nilai yang betul. Teg fail lain boleh disahkan
juga dengan memilihnya satu persatu. Apabila kami berpuas hati dengan tag, kami menggunakan Simpan (Fail
menu atau bar alat). Memilih Cipta Senarai Main daripada menu Fail akan menjana satu fail
Hit Wonder - Jom Tag.m3u dalam direktori.

COMMAND RUJUKAN

. GUI Elements
GUI Kid3 dipisahkan dalam lima bahagian: Di sebelah kiri ialah fail dan direktori
kotak senarai, sebelah kanan mengandungi bahagian Fail, Tag 1 dan Tag 2.

File senarai
Senarai fail mengandungi nama semua fail dalam direktori yang dibuka yang sepadan
penapis nama fail yang dipilih (biasanya *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac
*.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). Bujang atau
berbilang fail boleh dipilih. Untuk memilih tiada fail, klik ke kawasan kosong selepas
entri kotak senarai. Pemilihan menentukan fail yang dipengaruhi oleh
operasi yang tersedia dengan menggunakan butang yang diterangkan di bawah.

Selain Nama, juga lajur lain Saiz, Jenis, Tarikh Diubah suai dengan butiran fail boleh
dipaparkan. Lajur boleh disembunyikan dengan menyahtanda nama mereka dalam menu konteks
pengepala senarai. Susunan lajur boleh ditukar dengan drag'n'drop. Urutan isihan
boleh ditogol dengan mengklik pada pengepala lajur.

Di sebelah kiri nama ikon boleh dipaparkan: cakera untuk menunjukkan bahawa fail itu mempunyai
telah diubah suai atau maklumat tentang teg yang ada (V1, V2, V1V2 atau NO TAG, tidak
ikon dipaparkan jika fail belum dibaca lagi).

Direktori dipaparkan dengan ikon folder. Jika direktori dibuka, failnya adalah
dipaparkan dalam pokok hierarki. Dengan memilih fail daripada subdirektori, operasi
boleh dilaksanakan pada fail dalam direktori yang berbeza, yang berguna jika muzik
koleksi disusun dengan folder untuk setiap artis yang mengandungi folder untuk album
artis ini.

Mengklik butang kanan tetikus di dalam senarai fail membuka menu konteks dengan
arahan berikut:

· Kembangkan semua: Kembangkan semua pepohon folder (hanya pepohon semasa jika kekunci anjakan ialah
ditekan)

· Runtuhkan semua: Runtuhkan semua pokok folder

· Namakan semula: Menukar nama fail

· Alihkan ke Sampah: Mengalihkan fail ke sampah

· Main: Memainkan fail, lihat Main

· Entri seterusnya ialah arahan pengguna, yang boleh ditakrifkan dalam Tindakan Pengguna
tab Configure Kid3. Main semula pada klik dua kali juga boleh diaktifkan di sana.

Direktori senarai
Senarai direktori mengandungi nama direktori dalam direktori yang dibuka, sebagai
serta direktori semasa (.) dan induk (..). Ia membolehkan seseorang berubah dengan cepat
direktori tanpa menggunakan arahan Open... atau seret dan lepas.

Keterlihatan lajur, susunan dan pengisihan boleh dikonfigurasikan seperti yang diterangkan dalam bahagian
tentang senarai fail.

File
Menunjukkan maklumat tentang pengekodan (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), kadar bit, kadar sampel, saluran dan
panjang fail.

Suntingan baris Nama mengandungi nama fail (jika hanya satu fail dipilih).
Jika nama ini ditukar, fail akan dinamakan semula apabila arahan Simpan digunakan.

Kotak kombo Format dan suntingan baris mengandungi format yang akan digunakan apabila nama fail adalah
dihasilkan daripada teg pertama atau kedua. Nama fail boleh mengandungi sewenang-wenangnya
aksara, walaupun bahagian direktori yang dipisahkan oleh garis miring daripada nama fail, tetapi itu
direktori mesti sudah wujud untuk penamaan semula berjaya. Kod khas berikut
digunakan untuk memasukkan nilai teg ke dalam nama fail:

· %s %{title} Tajuk (Lagu)

· %a %{artis} Artis

· %l %{album} Album

· %c %{comment} Ulasan

· %y %{year} Tahun

· %t %{track} Track (cth 01)

· %t %{track.n} Track dengan lebar medan n (cth 001 untuk %{track.3})

· %T %{tracknumber} Track (tanpa mendahului sifar, cth 1)

· %g %{genre} Genre

· %{ignore} Diabaikan apabila menjana teg daripada nama fail

Kod format tidak terhad kepada contoh yang diberikan di atas. Mana-mana nama bingkai boleh
digunakan, contohnya nama bingkai bersatu seperti %{bpm} atau format nama tertentu seperti
%{popm}.

Kotak kombo Format kedua (dengan anak panah ke bawah) digunakan untuk menjana teg daripada
nama fail. Jika format nama fail tidak sepadan dengan corak ini, beberapa yang lain
format yang biasa digunakan cuba.

Beberapa format nama fail yang biasa digunakan sudah tersedia dalam kotak kombo, tetapi ia adalah
juga mungkin untuk menaip beberapa format khas ke dalam suntingan baris.

Daripada:Teg 1, Teg 2: Menetapkan nama fail menggunakan format yang dipilih dan teg pertama atau
tag kedua, masing-masing.

Kepada:Tag 1, Tag 2: Teg ditetapkan daripada nama fail. Pertama, format yang dinyatakan dalam
Format digunakan. Jika nama fail sedia ada tidak sepadan dengan format ini, perkara berikut
format dicuba:

· Artis - Album/Lagu Trek

· Album/Trek - Artis - Lagu

· /Artis - Album - Lagu - Lagu

· Album/Artis - Lagu - Lagu

· Album/Artis - Lagu

· Artis/Album/Lagu Trek

Jika satu fail dipilih, kawalan GUI diisi dengan nilai yang diekstrak
daripada nama fail. Jika berbilang fail dipilih, teg fail adalah secara langsung
ditetapkan mengikut nama fail.

Tag 1
Widget edit baris untuk Tajuk, Artis, Album, Komen, Tahun, Lagu dan Genre ialah
digunakan untuk mengedit nilai yang sepadan dalam teg pertama bagi fail yang dipilih. Nilai
akan ditukar apabila pemilihan fail diubah atau sebelum operasi seperti Simpan dan
Berhenti dan apabila kotak semak yang sepadan di sebelah kiri nama medan ditandakan.
Ini berguna untuk menukar hanya beberapa nilai dan membiarkan nilai lain tidak berubah.

Jika satu fail dipilih, semua kotak semak ditandakan dan widget edit baris
mengandungi nilai yang terdapat dalam teg fail ini. Jika teg tidak ditemui dalam fail,
nilai kosong yang sepadan dipaparkan, iaitu rentetan kosong untuk Tajuk,
Suntingan baris Artis, Album dan Komen, 0 untuk Tahun berangka dan suntingan Trek dan a
kosongkan nilai yang dipilih untuk kotak kombo Genre. Nilai boleh diubah dan jika
kotak semak yang sepadan ditandakan, ia akan ditetapkan untuk fail yang dipilih selepas
pemilihan diubah. Fail kemudian ditandakan sebagai diubah suai oleh simbol cakera dalam fail
listbox tetapi kekal tidak berubah sehingga arahan Save digunakan.

Jika berbilang fail dipilih, hanya nilai yang sama dalam semua yang dipilih
fail dipaparkan. Dalam semua kawalan lain, nilai kosong seperti yang diterangkan di atas ialah
dipaparkan. Semua kotak semak tidak ditandakan untuk mengelakkan perubahan yang tidak diingini. Jika sesuatu nilai perlu
ditetapkan untuk semua fail yang dipilih, ia boleh diedit dan kotak semak perlu ditetapkan. The
nilai akan ditetapkan untuk semua fail yang dipilih apabila pemilihan diubah dan boleh
disimpan menggunakan arahan Simpan.

Kotak semak juga mengawal operasi kebanyakan arahan yang mempengaruhi teg, seperti
sebagai salin, tampal dan pindahkan antara tag 1 dan 2. Untuk memudahkan penggunaannya
berbilang fail di mana semua kotak semak tidak ditandakan, arahan ini berkelakuan sama
cara apabila semua kotak semak ditanda dan apabila semua kotak semak dinyahtanda.

Daripada Teg 2: Medan teg 1 ditetapkan daripada nilai yang sepadan dalam teg 2. Jika a
fail tunggal dipilih, kawalan GUI diisi dengan nilai dari tag 2. Jika
berbilang fail dipilih, tag fail ditetapkan secara langsung.

Salin: Penampan salinan diisi dengan nilai Tag 1. Hanya nilai dengan ditandai
kotak semak akan digunakan dalam arahan Tampal seterusnya.

Tampal: Tampalkan nilai daripada penimbal salin ke dalam kawalan GUI.

Alih Keluar: Ini akan menetapkan semua kawalan GUI kepada nilai kosongnya yang mengakibatkan dialih keluar
semua nilai. Fail yang disimpan kemudiannya tidak akan mengandungi teg 1.

Tag 2
Kawalan GUI berfungsi dengan cara yang sama seperti yang diterangkan untuk bahagian Tag 1, tetapi
saiz tali tidak terhad.

Untuk tag 2 Genre anda juga boleh menggunakan nama anda sendiri selain daripada genre yang disenaraikan dalam
kotak kombo, hanya taip nama ke dalam baris edit.

Teg 2 bukan sahaja boleh mengandungi nilai yang sama seperti teg 1, formatnya dibina dalam a
cara yang fleksibel daripada beberapa bingkai yang terdiri daripada beberapa medan. The
jadual tag 2 menunjukkan semua bingkai yang tersedia dalam fail yang dipilih.

Edit: Ini akan membuka tetingkap yang membolehkan seseorang mengedit semua medan yang dipilih
bingkai. Jika berbilang fail dipilih, medan yang diedit digunakan pada semua yang dipilih
fail yang mengandungi bingkai sedemikian.

Tambah: Peminta untuk memilih jenis bingkai akan muncul dan bingkai jenis yang dipilih
boleh diedit dan ditambah pada fail. Ini juga berfungsi untuk menambah bingkai kepada berbilang
fail yang dipilih.

Padam: Memadam bingkai yang dipilih dalam fail yang dipilih.

Seret karya seni album di sini ditunjukkan jika fail tidak mengandungi seni muka depan terbenam. A
gambar boleh ditambah menggunakan seret dan lepas dari penyemak imbas atau pengurus fail dan akan
dipaparkan di sini. Bingkai gambar boleh diedit atau ditambah dengan mengklik dua kali pada ini
kawalan.

Disegerakkan Lyrics and Acara Masa Kod
Untuk maklumat yang disegerakkan dengan data audio, editor khusus tersedia.
Bingkai ini disokong untuk teg ID3v2.3.0 dan ID3v2.4.0. Untuk menambah bingkai sedemikian,
nama bingkai tertentu perlu dipilih dalam senarai yang muncul apabila butang Tambah
diklik - Lirik Disegerakkan atau Kod Masa Acara, masing-masing. Editor ialah
sama untuk kedua-dua jenis, untuk kod pemasaan acara, hanya set acara yang dipratentukan
tersedia manakala untuk lirik yang disegerakkan, teks perlu dimasukkan. Di dalam
berikut, menyunting lirik yang disegerakkan dijelaskan.

Fail yang mempunyai tag ID3v2 dipilih, editor lirik dimasukkan menggunakan Tambah dan
memilih Lirik Disegerakkan. Untuk bingkai Lirik Tersegerak sedia ada, ia adalah
dipilih dan Edit diklik. Pemain dibuka secara automatik dengan fail semasa
supaya fail boleh dimainkan dan dijeda untuk menyegerakkan lirik.

Tetapan di bahagian atas editor SYLT biasanya tidak perlu ditukar. Sekiranya
lirik mengandungi aksara yang tidak terdapat dalam set aksara Latin 1,
menukar pengekodan teks kepada UTF16 (atau UTF8 untuk ID3v2.4.0) adalah dinasihatkan. Untuk bahasa Inggeris
lirik dan keserasian maksimum, ISO-8859-1 harus digunakan.

Bahagian Lirik mempunyai lima butang di bahagian atas. Tambah akan menambah acara masa baharu dalam
meja. Masa diambil dari kedudukan pemain, dengan itu menambah entri sambil
memainkan trek akan menambah garisan untuk kedudukan yang sedang dimainkan. Peristiwa dalam
jadual perlu disusun mengikut kronologi, oleh itu baris akan dimasukkan
sewajarnya. Entri dengan masa yang tidak sah dilayan secara khusus: Jika pada masa ini
baris yang dipilih mempunyai masa yang tidak sah, cap masanya akan digantikan dengan masa semasa
bukannya menambah baris baharu. Jika masa semasa tidak sah, baris pertama dengan a
masa tidak sah akan digunakan jika ada. Tingkah laku ini sepatutnya memudahkan penambahan masa
setem jika teks lirik sudah ada dalam jadual tetapi setem masa tiada
(yang berlaku apabila mengimport lirik yang tidak disegerakkan). Perhatikan bahawa masa tidak sah
diwakili sebagai 00:00.00, iaitu sama dengan masa pada permulaan mutlak
trek, yang tidak sah. Untuk membuat masa tidak sah, tekan kekunci Padam, atau gunakan
Kosongkan daripada menu konteks. Baris baharu disisipkan menggunakan Sisipkan baris daripada menu konteks
atau dicipta apabila mengimport lirik yang tidak disegerakkan dengan Dari Papan Klip atau Import juga
mengandungi setem masa yang tidak sah. Baris dalam jadual boleh dipadamkan dengan mengklik butang Padam
butang atau menggunakan Padam baris daripada menu konteks.

Lirik yang disegerakkan boleh diimport daripada fail menggunakan Import. Format yang diharapkan ialah
LRC mudah atau dipertingkatkan. Jika fail yang dipilih tidak mengandungi kurungan segi empat sama dalam
baris pertama, ia sepatutnya menjadi fail teks ringkas dengan lirik yang tidak disegerakkan. The
baris daripada fail sedemikian kemudiannya diimport mempunyai setem masa yang tidak sah. Masa
maklumat boleh ditambah menggunakan butang Tambah atau dengan kemasukan manual. Ia juga boleh
untuk mengimport lirik melalui salin-tampal menggunakan Dari Papan Klip. Lirik yang disegerakkan boleh
ditulis ke fail LRC menggunakan Eksport. Ambil perhatian bahawa hanya entri dengan setem masa yang sah akan
dieksport dan penyertaan akan diisih mengikut masa. Entri dengan masa yang tidak sah
tidak akan disimpan dalam bingkai SYLT sama ada, jadi pastikan anda memasukkan semua pemasaan
maklumat sebelum meninggalkan dialog.

. ID3 spesifikasi[6] mencadangkan cap masa untuk setiap suku kata. Bagaimanapun kebanyakan pemain
hanya menyokong kebutiran baris atau ayat. Untuk menyokong kedua-dua kes penggunaan, Kid3
mengikut konvensyen yang sama seperti SYLT Editor[7]. Teks yang dimasukkan ke dalam jadual
diandaikan memulakan baris baharu melainkan ia bermula dengan ruang atau tanda sempang. Pengecualian
kepada peraturan ini boleh dilakukan dengan memulakan baris dengan garis bawah ('_') untuk memaksa
kesinambungan atau tanda cincang ('#') untuk memaksa baris baharu. Watak melarikan diri ini tidak
disimpan di dalam bingkai SYLT. Di dalam bingkai SYLT, baris baharu bermula dengan suapan baris
aksara (hex 0A) manakala kesinambungan tidak. Apabila membaca bingkai SYLT, Kid3 menyemak
jika entri pertama bermula dengan suapan baris. Jika ini tidak berlaku, ia diandaikan
bahawa semua entri adalah baris baharu dan tiada sambungan suku kata digunakan.

Semasa trek dimainkan, baris yang dikaitkan dengan kedudukan main semasa ialah
diserlahkan, supaya ketepatan maklumat penyegerakan boleh
disahkan. Jika offset perlu ditambahkan pada satu atau lebih setem masa, ini boleh jadi
dicapai dengan menu konteks Tambah offset. Nilai negatif boleh digunakan untuk mengurangkan
masa. Menggunakan Seek to position dalam menu konteks, adalah mungkin untuk menetapkan
kedudukan bermain ke masa baris yang dipilih.

. File Menu
Fail → Buka... (Ctrl+O)
Membuka direktori. Semua fail yang sepadan dengan penapis nama fail yang dipilih akan dipaparkan
dalam kotak senarai fail dan fail yang dipilih dipilih.

Fail → Buka Terkini
Membuka direktori yang baru dibuka.

Fail → Buka Direktori... (Ctrl+D)
Membuka direktori. Semua fail yang sepadan dengan penapis nama fail yang dipilih akan dipaparkan
dalam kotak senarai fail.

Fail → Simpan (Ctrl+S)
Menyimpan semua fail yang diubah dalam direktori. Fail yang diubah ditandakan dengan cakera
simbol dalam kotak senarai fail. Jika mana-mana nama fail telah ditukar, fail tersebut akan diubah
dinamakan semula.

Fail → Kembalikan
Mengembalikan perubahan satu atau berbilang fail. Jika tiada fail dipilih dalam fail
listbox, perubahan semua fail akan dikembalikan, jika tidak hanya perubahan fail
fail yang dipilih dikembalikan.

Fail → Import...
Dialog Import boleh digunakan untuk mengimport data terus daripada pelayan freedb.org, daripada a
Pelayan MusicBrainz, daripada Discogs, Amazon atau sumber lain senarai lagu album dalam
format teks.

Import daripada pelayan freedb.org boleh dilakukan menggunakan dialog yang muncul apabila Dari
Pelayan:gnudb.org atau TrackType.org dipilih. Artis dan nama album untuk dicari
boleh dimasukkan dalam dua medan paling atas, album yang sepadan dengan pertanyaan ialah
dipaparkan apabila Cari diklik dan hasil daripada www.gnudb.org[8] diterima.
Mengimport data trek untuk album dilakukan dengan mengklik dua kali pada album dalam
senarai. Pelayan freedb.org untuk diimport boleh dipilih serta laluan CGI.
Data yang diimport dipaparkan dalam jadual pratonton dialog import. Bila
berpuas hati dengan trek yang dipaparkan, ia boleh diimport dengan menamatkan import
dialog dengan OK.

Carian pada pelayan Discogs boleh dilakukan menggunakan Discogs. Seperti dalam gnudb.org
dialog, anda boleh memasukkan artis dan album dan kemudian memilih daripada senarai keluaran. Jika
Teg Standard ditanda, maklumat standard diimport, cth artis, album dan
tajuk. Jika Teg Tambahan ditanda, lebih banyak maklumat diimport jika tersedia, cth
penghibur, pengatur, atau penerbit. Jika Seni Muka Depan ditanda, seni muka depan akan menjadi
dimuat turun jika ada.

Carian di Amazon boleh dilakukan menggunakan Amazon. Seperti dalam dialog gnudb.org, anda boleh
masukkan artis dan album dan kemudian pilih daripada senarai keluaran. Jika Tag Tambahan ialah
ditanda, lebih banyak maklumat diimport jika ada, cth penghibur, pengatur, atau
penerbit. Jika Seni Muka Depan ditanda, seni muka depan akan dimuat turun jika tersedia.

Anda boleh mencari dengan cara yang sama dalam pangkalan data keluaran MusicBrainz menggunakan Daripada
Keluaran MusicBrainz. Aliran kerja adalah sama seperti yang diterangkan untuk Dari gnudb.org.

Import daripada pelayan MusicBrainz boleh dilakukan menggunakan dialog yang muncul apabila Dari
Cap Jari MusicBrainz dipilih. Pelayan boleh dipilih seperti dalam freedb
dialog import. Di bawah ialah jadual yang memaparkan data trek yang diimport. Lajur kanan
menunjukkan keadaan pertanyaan MusicBrainz, yang bermula dengan "Belum selesai" apabila dialog
dibuka. Kemudian cap jari dilihat dan jika ia tidak membuahkan hasil,
carian lain menggunakan tag dalam fail cuba. Oleh itu ia boleh membantu untuk a
pertanyaan MusicBrainz berjaya untuk menyimpan maklumat yang diketahui (cth artis dan album) dalam
tag sebelum import. Jika keputusan ditemui, pencarian akan tamat di negeri ini
"Diiktiraf", jika tidak, tiada apa yang ditemui atau berbilang hasil samar-samar dan salah satu daripadanya
mereka perlu dipilih oleh pengguna. OK dan Guna gunakan data yang diimport, Batal
menutup dialog. Penutupan boleh mengambil sedikit masa sejak seluruh jentera MusicBrainz
terpaksa ditutup.

Untuk import data teks, Daripada Fail/Papan Klip membuka subdialog, di mana beberapa
format import prakonfigurasi tersedia. Dua yang pertama, "CSV unquoted" dan "CSV
dipetik" boleh digunakan untuk mengimport data yang telah dieksport oleh dialog Eksport. CSV
data boleh diedit dengan hamparan, dan hendaklah ditulis menggunakan tab sebagai pembatas.
Import kemudiannya boleh dilakukan menggunakan "CSV quoted", yang lebih fleksibel daripada "CSV
tidak disebut". Walau bagaimanapun, medannya tidak boleh mengandungi sebarang petikan berganda. Jika anda hanya mengeksport
daripada Kid3 dan import kemudian, "CSV unquoted" boleh digunakan sebagai format mudah untuk ini
tujuan. Ambil perhatian bahawa terdapat juga arahan "Eksport CSV" dan "Import CSV" dalam
menu konteks senarai fail, yang menggunakan skrip untuk mengeksport dan mengimport data CSV dalam a
cara yang lebih lengkap, berkuasa dan fleksibel.

Format seterusnya, "teks HTML freedb", boleh digunakan untuk menyalin maklumat daripada halaman HTML
of freedb.org[9]. Cari album dalam freedb dan jika maklumat yang dikehendaki adalah
dipaparkan dalam pelayar web, salin kandungan ke papan keratan. Kemudian klik butang Daripada
Butang papan klip dan trek yang diimport akan dipaparkan dalam jadual pratonton di
bahagian atas dialog. Jika anda berpuas hati dengan data yang diimport, tamatkan dialog
dengan OK, yang akan memasukkan data ke dalam tag direktori semasa. The
destinasi (Tag 1, Tag 2 atau Tag 1 dan Tag 2) boleh dipilih dengan kotak kombo. The
fail dalam direktori semasa hendaklah dalam susunan trek yang betul untuk mendapatkan tegnya
ditugaskan. Ini adalah kes jika mereka bernombor.

Format import prakonfigurasi seterusnya, "sumber HTML freedb", boleh digunakan, jika data
tersedia sebagai dokumen HTML. Import boleh dilakukan menggunakan butang Dari Fail, yang
membuka pemilih fail, atau menyalin kandungannya daripada editor dan kemudian mengimport daripada
papan keratan. Format ini boleh berguna untuk import luar talian, walaupun dokumen HTML
juga boleh dibuka dalam pelayar dan kemudian diimport dalam format pertama melalui
papan klip.

Lebih banyak format prakonfigurasi, cth. "Masa Tajuk Jejak", tersedia. Adat kosong
format boleh dibuat dengan Tambah untuk ditetapkan oleh pengguna. Dua baris di bawah nama format
boleh ditetapkan dengan ungkapan biasa untuk menangkap medan daripada teks import. The
ungkapan biasa pertama akan dihuraikan sekali setiap dokumen untuk mengumpulkan data setiap album
seperti artis, album, tahun dan genre. Baris kedua cuba dipadankan dari
permulaan dokumen hingga akhir untuk mendapatkan data trek, biasanya nombor dan tajuk. The
ungkapan biasa termasuk semua ciri yang ditawarkan oleh Qt, yang kebanyakannya adalah apa
Perl menawarkan. Pembinaan kurungan "(..)" mencipta penimbal tangkapan untuk medan
import dan didahului oleh kod khusus Kid3 untuk menentukan medan yang hendak ditangkap. The
kod adalah sama seperti yang digunakan untuk format nama fail, selain kod yang disenaraikan di bawah,
sebarang nama bingkai adalah mungkin:

· %s %{title} Tajuk (Lagu)

· %a %{artis} Artis

· %l %{album} Album

· %c %{comment} Ulasan

· %y %{year} Tahun

· %t %{track} Track

· %g %{genre} Genre

· %d %{duration} Tempoh

Contohnya, ungkapan biasa trek (baris kedua) untuk diimport daripada senarai main .m3u
boleh jadi "%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]". Semua format boleh diubah
dengan mengedit ungkapan biasa dan nama dan kemudian mengklik Simpan Tetapan. mereka
akan disimpan dalam fail kid3rc dalam direktori konfigurasi. Fail ini boleh
diedit terus untuk mempunyai lebih banyak format import atau ia boleh dipadamkan untuk kembali ke
format lalai. Format boleh dipadamkan menggunakan Alih keluar.

Ketepatan menunjukkan anggaran sejauh mana maklumat yang diimport sepadan dengan yang diberikan
trek. Ia menggunakan tempoh trek atau nama fail untuk mengira tahap persamaan
peratus. Seni Muka Depan menunjukkan URL imej muka depan album yang akan dimuat turun.

Untuk menyemak sama ada trek yang diimport sepadan dengan set fail semasa, tempoh masa
trek yang diimport boleh dibandingkan dengan tempoh fail. Pilihan ini boleh
didayakan dengan kotak semak Semak perbezaan masa maksimum yang dibenarkan dan maksimum
perbezaan masa yang boleh diterima boleh ditetapkan dalam beberapa saat. Jika tidak padan panjang adalah
dikesan, panjangnya dipaparkan dengan latar belakang merah dalam jadual pratonton.

Ia fail dipesan secara berbeza daripada trek yang diimport, trek yang diperuntukkan
kena tukar. Tugas ini boleh dipermudahkan menggunakan Match with buttons Length,
Trek, dan Tajuk, yang akan menyusun semula trek mengikut medan yang sepadan.
Untuk membetulkan tugasan secara manual, trek boleh diseret dengan butang tetikus kiri
dan kekunci Ctrl tahan, dan kemudian jatuh di lokasi baharu.

Apabila dialog import dibuka, ia mengandungi kandungan sebenar teg. Tag itu
jenis (Tag 1, Tag 2, Tag 1 dan Tag 2) boleh dipilih menggunakan kotak kombo Destinasi.
Butang di sebelah kanan kotak kombo ini boleh digunakan untuk mengembalikan jadual ke
kandungan semasa tag. Kotak semak dalam lajur jadual pertama boleh digunakan untuk
pilih trek yang diimport. Ini boleh berguna jika folder mengandungi
trek kedua-dua CD CD berganda dan hanya trek CD kedua yang perlu
diimport.

Untuk mengenal pasti trek yang diimport, adalah mungkin untuk memaparkan nama fail atau
laluan penuh ke fail menggunakan menu konteks pengepala jadual. Nilai dalam
jadual import boleh diedit. Butang undur di sebelah kanan Destinasi
kotak kombo boleh digunakan untuk memulihkan kandungan tag, yang juga boleh berguna
selepas menukar Destinasi.

Hampir semua dialog menampilkan butang Simpan Tetapan, yang boleh digunakan untuk menyimpan
tetapan khusus dialog dan saiz tetingkap secara berterusan.

Daripada Tag membawa kepada subdialog untuk menetapkan bingkai teg daripada kandungan teg lain
bingkai. Ini boleh digunakan untuk hanya menyalin maklumat antara tag atau mengekstrak bahagian
daripada satu bingkai dan masukkan ke dalam bingkai yang lain.

Seperti dalam import daripada fail/papan klip, terdapat format yang boleh dikonfigurasikan secara bebas untuk dilakukan
operasi yang berbeza. Sudah diprakonfigurasikan adalah format untuk menyalin nilai Album
Artis Album, Komposer atau Konduktor dan untuk mengekstrak Nombor Trek daripada medan Tajuk
yang mengandungi nombor. Terdapat juga format untuk mengekstrak Sari Kata daripada Tajuk
lapangan.

Contoh berikut menerangkan cara menambah format tersuai, yang menetapkan maklumat
daripada medan Sari kata juga dalam medan Komen. Buat format baharu menggunakan Tambah dan
tetapkan nama baharu, cth "Sari kata untuk Ulasan". Kemudian masukkan "%{subtitle}" dalam Sumber dan
"%{comment}(.*)" untuk Pengekstrakan dan klik Simpan Tetapan.

Ungkapan dalam Sumber boleh mengandungi kod format untuk bingkai teg arbitrari, berbilang
kod boleh digunakan untuk menggabungkan kandungan daripada bingkai yang berbeza. Bagi setiap trek, a
teks dijana daripada tegnya menggunakan format Sumber dan ungkapan biasa
daripada Extraction digunakan pada teks ini untuk menetapkan nilai baharu untuk teg. Kod format
digunakan sebelum kurungan tangkapan untuk menentukan bingkai teg tempat tangkapan
teks hendaklah disimpan. Ia berfungsi dengan cara yang sama seperti untuk import dari fail/papan klip.

Fail → Import daripada gnudb.org...
Import daripada pelayan freedb.org menggunakan carian album gnudb.org. Item menu ini dibuka
dialog import yang sama seperti Import..., tetapi membuka terus dialog gnudb.org.

Fail → Import daripada TrackType.org...
Import daripada pelayan TrackType.org. Item menu ini membuka dialog import yang sama seperti
Import..., tetapi membuka terus dialog TrackType.org.

Fail → Import daripada Discogs...
Import daripada pelayan Discogs. Item menu ini membuka dialog import yang sama seperti
Import..., tetapi membuka terus dialog Daripada Discogs.

Fail → Import dari Amazon...
Import dari Amazon. Item menu ini membuka dialog import yang sama seperti Import..., tetapi
membuka terus dialog Daripada Amazon.

Fail → Import daripada MusicBrainz Release...
Import daripada pangkalan data keluaran MusicBrainz. Item menu ini membuka import yang sama
dialog sebagai Import..., tetapi membuka terus dialog Keluaran MusicBrainz.

Fail → Import daripada Cap Jari MusicBrainz...
Import daripada pelayan MusicBrainz. Item menu ini membuka dialog import yang sama seperti
Import..., tetapi membuka terus dialog Dari MusicBrainz Cap Jari.

Fail → Import Automatik...
Import Automatik membolehkan seseorang mengimport maklumat untuk berbilang album daripada pelbagai web
perkhidmatan. Jika direktori dipilih dalam senarai fail, jejak data untuk yang dipilih
direktori akan diimport. Jika tiada direktori dipilih, semua direktori dalam fail
senarai akan diimport.

Jenis teg (Teg 1, Teg 2, Teg 1 dan Teg 2) boleh dipilih menggunakan Destinasi
kotak kombo.

Profil menentukan pelayan mana yang akan dihubungi untuk mengambil maklumat album. Beberapa
profil dipratentukan (Semua, MusicBrainz, Discogs, Cover Art), profil tersuai boleh
ditambah menggunakan butang Tambah di sebelah kanan kotak kombo Profil.

Jadual di bawah menunjukkan pelayan yang akan digunakan semasa mengimport maklumat album
menggunakan profil yang dipilih. Proses import untuk album telah selesai jika semua
maklumat yang diperlukan telah ditemui, jadi susunan baris dalam jadual adalah
penting. Ia boleh diubah menggunakan butang Move Up dan Move Down. Edit boleh
digunakan untuk menukar entri sedia ada. Pemilihan Pelayan menawarkan pelayan yang sama seperti yang boleh
digunakan dalam fungsi import. Teg Standard, Teg Tambahan, Seni Muka Depan tentukan
maklumat yang akan diambil daripada pelayan. Akhirnya, Ketepatan ialah
ketepatan minimum yang mesti dicapai untuk menerima data yang diimport. Jika ketepatan
tidak mencukupi, pelayan seterusnya dalam senarai akan dicuba. Dialog yang sama mengandungi
sifat pelayan muncul apabila Tambah diklik untuk menambah entri pelayan baharu. sedia ada
entri boleh dipadam menggunakan Alih keluar.

Untuk melancarkan import kelompok automatik dengan profil yang dipilih, klik Mula. Butiran
tentang import yang sedang berjalan dipaparkan di bahagian atas dialog. Prosesnya boleh
dibatalkan dengan butang Batalkan.

Fail → Semak imbas Seni Muka Depan...
Dialog Semak Imbas Seni Muka Depan membantu mencari seni muka depan album. Artis/Album sudah diisi
daripada tag jika boleh. Source menawarkan pelbagai laman web dengan seni kulit album.
URL dengan artis dan album sebagai parameter boleh didapati di bawah nama. dikodkan URL
nilai untuk artis dan album boleh disisipkan menggunakan %u{artis} and %u{album}, lain-lain
nilai daripada teg juga mungkin, seperti yang diterangkan dalam Konfigurasikan Kid3, Tindakan Pengguna.
Lebih banyak sumber boleh dimasukkan selepas entri "Sumber Tersuai" dengan menggantikan "Sumber Tersuai
Source" dengan nama sumber, tekan Enter, kemudian masukkan URL dan akhirnya
menekan Simpan Tetapan. Perintah pelayar yang terhasil dipaparkan di bahagian atas
dialog dan boleh dimulakan dengan mengklik Layari. Penyemak imbas, yang boleh dikonfigurasikan dalam
tetapan, dimulakan dengan sumber yang dipilih. Imej muka depan boleh diseret
daripada pelayar ke dalam tetingkap Kid3 dan akan ditetapkan dalam bingkai gambar
fail yang dipilih.

Kerana tidak semua pelayar menyokong drag'n'drop imej dan gambar di tapak web
selalunya mempunyai URL, dalam kes sedemikian Kid3 akan menerima URL dan bukan gambarnya. Sekiranya
URL menunjuk pada gambar, ia akan dimuat turun. Walau bagaimanapun, jika URL merujuk kepada beberapa
sumber web lain, ia perlu diterjemahkan kepada gambar yang sepadan. begitu
pemetaan ditakrifkan dalam pengekstrakan URL jadual. Lajur kiri Padanan mengandungi a
ungkapan biasa yang dibandingkan dengan URL. Jika ia sepadan, yang ditangkap
ungkapan dalam kurungan dimasukkan ke dalam corak URL Gambar yang betul
lajur (pada kedudukan yang ditanda dengan \1 dsb.). Ungkapan biasa yang digantikan
mengandungi URL gambar. Dengan cara ini seni muka depan boleh diimport dari Amazon,
Imej Google, dsb. menggunakan drag'n'drop. Ia juga mungkin untuk menentukan sendiri
pemetaan.

Fail → Eksport...
Dialog Eksport digunakan untuk menyimpan data daripada tag dalam fail atau papan keratan. The
editor di bahagian atas menunjukkan pratonton data untuk dieksport. Jika data eksport mengandungi
aksara penjadual, eksport dipaparkan dalam jadual. Data akan dijana
daripada teg dalam direktori semasa mengikut format yang dikonfigurasikan.

Tetapan format adalah serupa seperti dalam dialog Import: Medan paling atas mengandungi
tajuk (cth "CSV tidak disebut"), diikuti dengan pengepala, yang akan dijana pada
permulaan fail. Data trek berikut; ia digunakan untuk setiap trek. Akhirnya,
treler boleh digunakan untuk menjana beberapa teks penamat.

Medan format tidak mengandungi ungkapan biasa seperti dalam dialog Import, tetapi hanya
ungkapan format output dengan %-ungkapan khas, yang akan digantikan dengan nilai
daripada tag. Semuanya berfungsi seperti format nama fail, dan kod yang sama
digunakan serta beberapa kod tambahan. Bukan sahaja kod yang disenaraikan di bawah tetapi semua bingkai tag
nama boleh digunakan.

· %s %{title} Tajuk (Lagu)

· %a %{artis} Artis

· %l %{album} Album

· %c %{comment} Ulasan

· %y %{year} Tahun

· %t %{track} Track (cth 01)

· %t %{track.n} Track dengan lebar medan n (cth 001 untuk %{track.3})

· %T %{tracknumber} Track (tanpa mendahului sifar, cth 1)

· %g %{genre} Genre

· %f %{file} Nama fail

· %p %{filepath} Laluan

· %u %{url} URL

· %d %{duration} Tempoh dalam minit:saat

· %D %{seconds} Tempoh dalam saat

· %n %{tracks} Bilangan trek album

· %e %{extension} Sambungan fail

· %O %{tag1} Format teg 1 (ID3v1.1 atau kosong jika tiada)

· %o %{tag2} Format teg 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF atau kosong jika tiada)

· %b %{bitrate} Kadar bit dalam kbit/s

· %v %{vbr} VBR atau kosong (hanya untuk ID3v2.3 dengan id3lib)

· %r %{samplerate} Kadar sampel dalam Hz

· %m %{mode} Mod saluran (Stereo atau Stereo Bersama)

· %h %{channels} Bilangan saluran (1 atau 2)

· %k %{codec} Codec (cth MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

Beberapa format telah dipratentukan. "CSV tidak disebut" memisahkan medan mengikut tab. Data masuk
format ini boleh diimport semula ke dalam Kid3 menggunakan format import dengan yang sama
nama. "Petikan CSV" juga melampirkan medan dengan petikan berganda, yang memudahkan
import ke dalam aplikasi hamparan. Walau bagaimanapun, medan tidak boleh mengandungi sebarang dua kali ganda
petikan apabila format ini digunakan. "M3U Lanjutan" dan "PLS Lanjutan" menjana senarai main
dengan atribut lanjutan dan nama laluan mutlak. "HTML" boleh digunakan untuk menjana
Halaman HTML dengan hiperpautan ke trek. "Kover XML" mencipta fail yang boleh
diimport oleh program cetakan kulit muka Kover. "Butiran Teknikal" menyediakan maklumat
tentang kadar bit, kadar sampel, saluran, dsb. Akhirnya, "Format Tersuai" dibiarkan kosong untuk
definisi format tersuai. Anda boleh menentukan lebih banyak format anda sendiri dengan menambah baris
dalam fail kid3rc dalam direktori konfigurasi. Format lain boleh disesuaikan dengannya
keperluan anda.

Sumber tag untuk menjana data eksport (Tag 1 atau Tag 2) boleh dipilih
dengan kotak kombo. Menolak Ke Fail atau Ke Papan Klip menyimpan data dalam fail atau pada
papan keratan. OK dan Batal tutup dialog, manakala OK menerima dialog semasa
tetapan.

Fail → Cipta Senarai Main
Mencipta senarai main. Format dan kandungan senarai main boleh ditetapkan oleh pelbagai
pilihan.

Nama senarai main boleh sama dengan nama direktori atau gunakan Format dengan nilai
daripada tag, cth "%{artist} - %{album}" untuk mempunyai nama artis dan album dalam
nama fail senarai main. Kod format adalah sama seperti untuk Eksport. Sambungan bergantung
pada format senarai main.

Lokasi senarai main yang dijana ditentukan oleh pemilihan Buat masuk
kotak kombo.

Direktori semasa
Senarai main dibuat dalam direktori semasa dan hanya mengandungi fail
direktori semasa.

Setiap direktori
Senarai main dicipta dalam setiap direktori yang mengandungi fail tersenarai, dan setiap satu
senarai main mengandungi fail direktori itu.

Direktori peringkat atas
Hanya satu senarai main dibuat dalam direktori peringkat atas (iaitu direktori
senarai fail) dan ia mengandungi fail tersenarai bagi direktori peringkat atas dan semua
sub-direktorinya.

Format senarai main boleh menjadi M3U, PLS atau XSPF.

Jika Sertakan hanya fail yang dipilih disemak, hanya fail yang dipilih akan
disertakan dalam senarai main. Jika direktori dipilih, semua failnya dipilih.
Jika kotak semak ini tidak diaktifkan, semua fail audio disertakan dalam senarai main.

Isih mengikut nama fail memilih kes biasa di mana fail dipesan mengikut nama fail.
Dengan medan Isih mengikut teg, adalah mungkin untuk mengisih mengikut rentetan format dengan nilai daripada teg
padang. Sebagai contoh, "%{track.3}" boleh digunakan untuk mengisih mengikut nombor runut (".3" ialah
digunakan untuk mendapatkan tiga digit dengan sifar pendahuluan kerana rentetan digunakan untuk mengisih). Ia
juga boleh menggunakan berbilang medan, cth "%{genre}%{year}" untuk mengisih menggunakan rentetan
terdiri daripada genre dan tahun.

Entri senarai main akan mempunyai laluan fail relatif atau mutlak bergantung pada sama ada
Gunakan laluan relatif untuk fail dalam senarai main atau Gunakan laluan penuh untuk fail dalam senarai main ditetapkan.

Apabila Tulis senarai fail sahaja ditetapkan, senarai main hanya akan mengandungi laluan ke
fail. Untuk menjana senarai main lanjutan dengan maklumat tambahan, rentetan format
boleh ditetapkan menggunakan Tulis maklumat menggunakan kawalan.

Fail → Keluar (Ctrl+Q)
Keluar dari aplikasi.

. Edit Menu
Edit → Pilih Semua (Alt+A)
Memilih semua fail.

Edit → Nyahpilih (Ctrl+Shift+A)
Nyahpilih semua fail.

Edit → Pilih Semua dalam Direktori
Memilih semua fail direktori semasa.

Edit → Fail Sebelumnya (Alt+Up)
Memilih fail sebelumnya.

Edit → Fail Seterusnya (Alt+Bawah)
Memilih fail seterusnya.

Edit → Cari... (Ctrl+F)
Cari rentetan dalam nama fail dan tag. Dialog Cari ialah subset daripada
Gantikan dialog, yang diterangkan di bawah.

Edit → Ganti... (Ctrl+R)
Fungsi ini membuka dialog untuk mencari dan menggantikan rentetan dalam nama fail dan fail
tag. Set bingkai tempat carian dilakukan boleh dihadkan oleh
menyahaktifkan kotak semak Pilih semua dan memilih bingkai yang akan dicari.
Terdapat juga pilihan carian yang tersedia untuk mencari ke belakang, sensitif huruf besar dan kepada
menggunakan ungkapan biasa.

Bergantung pada bilangan fail, carian mungkin mengambil sedikit masa, oleh itu boleh jadi
dibatalkan dengan menutup dialog.

. Alatan Menu
Alat → Gunakan Format Nama Fail
Apabila Format semasa mengedit dimatikan untuk format nama fail dalam konfigurasi
dialog, item menu ini boleh digunakan untuk menggunakan format yang dikonfigurasikan pada nama-nama
fail yang dipilih. Ini juga boleh digunakan untuk menyemak sama ada nama fail mematuhi
format yang dikonfigurasikan dengan menggunakan format pada semua fail yang disimpan dan kemudian menyemak jika ada
fail telah ditukar (dan oleh itu ditandakan dengan simbol cakera dalam kotak senarai fail).

Alat → Gunakan Format Tag
Apabila Format semasa mengedit dimatikan untuk format teg dalam konfigurasi
dialog, item menu ini boleh digunakan untuk menggunakan format yang dikonfigurasikan pada teg bagi
fail yang dipilih. Ini juga boleh digunakan untuk menyemak sama ada teg mematuhi
format yang dikonfigurasikan dengan menggunakan format pada semua fail yang disimpan dan kemudian menyemak jika ada
fail telah ditukar (dan oleh itu ditandakan dengan simbol cakera dalam kotak senarai fail).

Alat → Gunakan Pengekodan Teks
Tetapkan pengekodan Teks yang dipilih dalam Tetapan/Konfigurasi Kid3.../Tags/Tag 2 untuk semua
fail yang dipilih. Jika UTF8 dipilih, UTF16 akan digunakan untuk teg ID3v2.3.0 kerana
UTF8 tidak disokong untuk format ini.

Alat → Namakan semula Direktori...
Dialog ini menawarkan kemungkinan untuk menamakan semula secara automatik yang sedang dibuka
direktori mengikut tag dalam fail. Beberapa format diprakonfigurasikan kepada
sertakan maklumat tentang artis, album dan tahun dalam nama direktori. Ia juga
mungkin untuk menetapkan format tersuai, kod khas berikut digunakan untuk memasukkan teg
nilai ke dalam nama direktori:

· %s %{title} Tajuk (Lagu)

· %a %{artis} Artis

· %l %{album} Album

· %c %{comment} Ulasan

· %y %{year} Tahun

· %t %{track} Track (cth 01)

· %t %{track.n} Track dengan lebar medan n (cth 001 untuk %{track.3})

· %T %{tracknumber} Track (tanpa mendahului sifar, cth 1)

· %g %{genre} Genre

Jika pemisah direktori "/" ditemui dalam format, berbilang direktori dicipta.
Jika anda ingin mencipta direktori baharu dan bukannya menamakan semula direktori semasa,
pilih Cipta Direktori dan bukannya Namakan semula Direktori. Sumber maklumat tag
boleh dipilih antara From Tag 1 dan Tag 2, From Tag 1 dan From Tag 2. Pratonton untuk
operasi menamakan semula yang dilakukan pada fail pertama boleh dilihat dalam Dari dan Kepada
bahagian dialog.

Berbilang direktori boleh dinamakan semula dengan memilihnya.

Alat → Trek Nombor...
Jika nombor runut dalam teg tidak ditetapkan atau mempunyai nilai yang salah, fungsi ini
boleh menomborkan trek secara automatik dalam tertib menaik. Nombor mula boleh ditetapkan
dialog itu. Jika hanya sebahagian daripada trek yang perlu dinomborkan, ia mesti dipilih.

Apabila Jumlah bilangan trek disemak, bilangan trek juga akan ditetapkan dalam
tags.

Adalah mungkin untuk menomborkan trek pada berbilang direktori. Folder mesti ada
dikembangkan dan dipilih.

Jika tetapkan semula kaunter untuk setiap direktori ditandakan, penomboran trek dimulakan semula dengan
nombor yang diberikan untuk setiap direktori apabila berbilang folder dipilih.

Dialog jejak nombor juga boleh digunakan untuk memformat nombor trek sedia ada tanpa
menukar nilai apabila kotak semak dibiarkan ke nombor Mula dinyahaktifkan. Jumlah
bilangan trek akan ditambah jika kotak semak yang sepadan aktif, yang boleh
digunakan untuk menetapkan jumlah untuk semua trek yang dipilih. Jika hanya memformat yang sedia ada
nombor dikehendaki, kotak semak ini juga perlu dinyahaktifkan.

Alatan → Penapis...
Penapis boleh digunakan untuk memaparkan hanya fail yang sepadan dengan kriteria tertentu. ini
berguna jika anda ingin mengatur koleksi yang besar dan hanya mengedit fail yang
tidak berada dalam skema yang dikehendaki. Ungkapan yang mentakrifkan fail yang hendak dipaparkan menggunakan
kod format yang sama yang digunakan dalam format nama fail, import dan eksport.

· %s %{title} Tajuk (Lagu)

· %a %{artis} Artis

· %l %{album} Album

· %c %{comment} Ulasan

· %y %{year} Tahun

· %t %{track} Track (cth 01)

· %t %{track.n} Track dengan lebar medan n (cth 001 untuk %{track.3})

· %T %{tracknumber} Track (tanpa mendahului sifar, cth 1)

· %g %{genre} Genre

· %f %{file} Nama fail

· %p %{filepath} Laluan mutlak ke fail

· %e %{extension} Sambungan fail

· %O %{tag1} Format teg 1 (ID3v1.1 atau kosong jika tiada)

· %o %{tag2} Format teg 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF atau kosong jika tiada)

· %b %{bitrate} Kadar bit dalam kbit/s

· %v %{vbr} VBR atau kosong (hanya untuk ID3v2.3 dengan id3lib)

· %r %{samplerate} Kadar sampel dalam Hz

· %m %{mode} Mod saluran (Stereo atau Stereo Bersama)

· %h %{channels} Bilangan saluran (1 atau 2)

· %k %{codec} Codec (cth MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

· %1a %1{artist}, ... Gunakan awalan 1 untuk mendapatkan nilai teg 1

· %2a %2{artist}, ... Gunakan awalan 2 untuk mendapatkan nilai teg 2

Kod ini digantikan dengan nilai untuk fail, dan rentetan yang terhasil boleh
dibandingkan dengan operasi berikut:

· s1 sama dengan s2: benar jika s1 dan s2 adalah sama.

· s1 mengandungi s2: benar jika s1 mengandungi s2, iaitu s2 ialah subrentetan s1.

· s padanan semula: benar jika s sepadan dengan ungkapan biasa semula.

Ungkapan benar digantikan dengan 1, palsu dengan 0. Nilai benar diwakili oleh 1,
benar, hidup dan ya, nilai palsu sebanyak 0, salah, mati dan tidak. Operasi Boolean bukan,
dan, atau (dalam susunan keutamaan ini) dan boleh dikumpulkan mengikut kurungan.

Beberapa peraturan penapis dipratentukan dan boleh dijadikan contoh untuk ungkapan anda sendiri:

SEMUA
Apabila senarai fail ditapis - ini ditunjukkan oleh "[ditapis]" dalam tajuk tetingkap
- dan semua fail akan dipaparkan semula, penapisan boleh dikembalikan menggunakan ini
penapis. Ia menggunakan ungkapan kosong, tetapi nilai sebenar akan mempunyai kesan yang sama.

Tidak Padan Teg Nama fail
tidak (%{filepath} mengandungi "%{artis} - %{album}/%{track} %{title}")

Menguji jika laluan fail mematuhi format nama fail. Peraturan ini adalah
disesuaikan secara automatik jika format nama fail berubah.

Tiada Tag 1
%{tag1} sama dengan ""

Memaparkan hanya fail yang tidak mempunyai tag 1.

Tiada Tag 2
%{tag2} sama dengan ""

Memaparkan hanya fail yang tidak mempunyai tag 2.

Teg ID3v2.3.0
%{tag2} sama dengan "ID3v2.3.0"

Memaparkan hanya fail yang mempunyai teg ID3v2.3.0.

Teg ID3v2.4.0
%{tag2} sama dengan "ID3v2.4.0"

Memaparkan hanya fail yang mempunyai teg ID3v2.4.0.

Tag 1!= Tag 2
tidak (%1{tajuk} sama dengan %2{title} and %1{album} sama dengan %2{album} and %1{artis}
sama dengan %2{artis} and %1 komen} sama dengan %2 komen} and %1 tahun} sama dengan %2 tahun}
and %1{track} sama dengan %2{track} and %1{genre} sama dengan %2{genre})

Memaparkan fail dengan perbezaan antara tag 1 dan tag2.

Tag 1 == Tag 2
%1{title} sama dengan %2{title} and %1{album} sama dengan %2{album} and %1{artis} sama dengan
%2{artis} and %1 komen} sama dengan %2 komen} and %1 tahun} sama dengan %2 tahun} and
%1{track} sama dengan %2{track} and %1{genre} sama dengan %2{genre}

Memaparkan fail dengan tag 1 dan tag 2 yang sama.

Tidak lengkap
%{title} sama dengan "" or %{artis} sama dengan "" or %{album} sama dengan "" or %{year} sama dengan
"" or %{nombor trek} sama dengan "" or %{genre} sama dengan ""

Memaparkan fail dengan nilai kosong dalam tag standard (tajuk, artis, album, tarikh,
nombor trek, genre).

Tiada Gambar
%{gambar} sama dengan ""

Memaparkan hanya fail yang tidak mempunyai gambar.

Penapis Tersuai
Untuk menambah penapis anda sendiri, pilih entri ini. Sebagai contoh, jika anda ingin mempunyai a
penapis untuk artis bermula dengan "The", gantikan "Custom Filter" dengan nama "The
Bands" dan tekan Enter. Kemudian masukkan ungkapan berikut ke dalam suntingan baris:

%{artis} perlawanan "The.*"

Kemudian klik Simpan Tetapan. Klik Guna untuk menapis fail. Semua fail yang diproses adalah
dipaparkan dalam paparan teks, dengan "+" untuk mereka yang sepadan dengan penapis dan "-"
untuk yang lain. Apabila selesai, hanya fail dengan artis yang bermula dengan "The"
dipaparkan, dan tajuk tetingkap ditandakan dengan "[ditapis]".

Alat → Tukar ID3v2.3 kepada ID3v2.4
Jika terdapat sebarang teg ID3v2.3 dalam fail yang dipilih, ia akan ditukar kepada ID3v2.4
tag. Bingkai yang tidak disokong oleh TagLib akan dibuang. Hanya fail tanpa
perubahan yang tidak disimpan akan ditukar.

Alat → Tukar ID3v2.4 kepada ID3v2.3
Jika terdapat sebarang teg ID3v2.4 dalam fail yang dipilih, ia akan ditukar kepada ID3v2.3
tag. Hanya fail tanpa perubahan yang belum disimpan akan ditukar.

Alatan → Main
Ini membuka bar alat mudah untuk memainkan fail audio. Ia mengandungi butang untuk asas
operasi (Main/Jeda, Hentikan main balik, Trek Sebelumnya, Trek Seterusnya, Tutup), peluncur untuk
kedudukan dan kelantangan dan paparan kedudukan semasa. Jika berbilang fail adalah
dipilih, trek yang dipilih dimainkan, jika tidak semua fail akan dimainkan.

. Tetapan Menu
Tetapan → Tunjukkan Bar Alat
Togol paparan bar alat.

Tetapan → Tunjukkan Bar Status
Togol paparan bar status, yang memaparkan tindakan yang lebih panjang seperti membuka atau
menyimpan direktori.

Tetapan → Tunjukkan Gambar
Togol paparan gambar pratonton seni kulit album.

Tetapan → Auto Sembunyikan Teg
Teg kosong disembunyikan secara automatik jika pilihan ini aktif. Fail, Tag 1 dan Tag
2 bahagian boleh diruntuhkan dan dikembangkan secara manual dengan mengklik pada -/+ yang sepadan
butang.

Tetapan → Konfigurasikan Kid3...
Membuka dialog konfigurasi, yang terdiri daripada halaman untuk teg, fail, tindakan pengguna,
dan tetapan rangkaian.

Pilihan khusus teg boleh didapati pada halaman Teg, yang dipisahkan dengan sendirinya
tiga tab untuk Teg 1, Teg 2 dan Teg 1 dan Teg 2.

Jika Tandakan medan terpenggal ditandakan, medan ID3v1.1 terpenggal akan ditanda merah. The
medan teks tag ID3v1.1 hanya boleh mempunyai 30 aksara, ulasan hanya 28
watak. Juga genre dan nombor trek adalah terhad, supaya medan boleh
dipenggal apabila diimport atau dipindahkan daripada ID3v2. Medan dipotong dan fail akan
ditanda merah, dan tanda itu akan dialih keluar selepas medan telah diedit.

Dengan pengekodan Teks untuk ID3v1 adalah mungkin untuk menetapkan set aksara yang digunakan dalam ID3v1
tag. Pengekodan ini sepatutnya ISO-8859-1, jadi disyorkan untuk menyimpannya
nilai asal. Walau bagaimanapun, terdapat teg di sekeliling dengan pengekodan yang berbeza, jadi boleh jadi
ditetapkan di sini dan teg ID3v1 kemudiannya boleh disalin ke ID3v2 yang menyokong Unicode.

Kotak semak Gunakan trek/jumlah bilangan trek format mengawal sama ada trek
medan nombor teg ID3v2 mengandungi hanya nombor trek atau tambahan jumlah
bilangan trek dalam direktori.

Apabila Genre sebagai teks dan bukannya rentetan angka disemak, semua genre ID3v2 akan menjadi
disimpan sebagai rentetan teks walaupun terdapat kod yang sepadan untuk genre ID3v1. Jika
pilihan ini tidak ditetapkan, genre yang mana kod ID3v1 wujud disimpan sebagai nombor
kod genre (dalam kurungan untuk ID3v2.3). Oleh itu genre Metal disimpan sebagai
"Logam" atau "(9)" bergantung pada pilihan ini. Genre yang tiada dalam senarai ID3v1
genre sentiasa disimpan sebagai rentetan teks. Tujuan pilihan ini dipertingkatkan
keserasian dengan peranti yang tidak mentafsir kod genre dengan betul.

Pengekodan teks mentakrifkan pengekodan lalai yang digunakan untuk bingkai ID3v2 dan boleh ditetapkan kepada
ISO-8859-1, UTF16 atau UTF8. UTF8 tidak sah untuk bingkai ID3v2.3.0; jika ia ditetapkan,
UTF16 akan digunakan sebaliknya. Untuk bingkai ID3v2.4.0, ketiga-tiga pengekodan adalah mungkin.

Versi yang digunakan untuk teg baharu menentukan sama ada teg ID3v2 baharu dibuat sebagai versi
2.3.0 atau 2.4.0. Dalam kes pertama, id3lib digunakan seperti dalam versi terdahulu
Kid3 dan TagLib hanya digunakan apabila teg ID3v2.4.0 ditemui. Pada yang kedua
kes, ID3v2.4.0 (TagLib), TagLib biasanya digunakan untuk fail MP3; berubah atau baru
teg yang dibuat kemudiannya akan disimpan dalam versi 2.4.0. Apabila ID3v2.3.0 (TagLib) dipilih,
TagLib juga digunakan untuk teg ID3v2.3.0.

Digit nombor trek ialah bilangan digit dalam medan Nombor Track. Sifar terkemuka ialah
digunakan untuk pad. Sebagai contoh, dengan nilai 2 nombor trek 5 ditetapkan sebagai "05".

Kotak kombo Nama medan Ulasan hanya relevan untuk fail Ogg/Vorbis dan FLAC dan
menetapkan nama medan yang digunakan untuk ulasan. Aplikasi yang berbeza nampaknya digunakan
nama yang berbeza, "COMMENT" misalnya digunakan oleh xmms, manakala amaroK menggunakan
"KETERANGAN".

Format gambar dalam fail Ogg/Vorbis ditentukan oleh nama medan Gambar, yang
boleh jadi METADATA_BLOCK_PICTURE atau COVERART. Yang pertama ialah piawaian dan kegunaan rasmi
format yang sama seperti gambar dalam tag FLAC. COVERART ialah cara tidak rasmi yang lebih awal untuk
sertakan gambar dalam komen Vorbis. Ia boleh digunakan untuk keserasian dengan warisan
pemain.

Jika kotak semak Tandai jika lebih besar daripada diaktifkan, fail yang mengandungi album terbenam
seni penutup melebihi saiz yang diberikan dalam bait ditanda merah. Ini boleh digunakan untuk mencari
fail yang mengandungi gambar bersaiz besar yang tidak diterima oleh sesetengah aplikasi dan
pemain. Nilai lalai ialah 131072 bait (128 KB).

Genre Tersuai boleh digunakan untuk menentukan genre yang tidak tersedia dalam standard
senarai genre, cth "Gothic Metal". Genre tersuai sedemikian akan muncul dalam kotak kombo Genre
daripada Tag 2. Untuk teg ID3v1.1, hanya genre yang telah ditetapkan boleh digunakan.

Senarai genre tersuai juga boleh digunakan untuk mengurangkan bilangan genre yang tersedia
kotak kombo Genre kepada yang biasa digunakan. Jika koleksi anda kebanyakannya mengandungi muzik
dalam genre Metal, Gothic Metal, Ancient dan Hard Rock, anda boleh memasuki genre tersebut
dan tanda Tunjukkan genre tersuai sahaja. Kotak kombo Tag 2Genre kemudiannya hanya akan mengandungi
empat genre tersebut dan anda tidak perlu mencari senarai genre yang lengkap untuk
mereka. Dalam contoh ini, hanya Metal dan Hard Rock akan disenaraikan dalam genre tag 1
senarai, kerana kedua-dua entri genre tersuai tersebut adalah genre standard. Jika Tunjukkan hanya adat
genre tidak aktif, genre tersuai boleh didapati di hujung senarai genre.

Bingkai Akses Pantas mentakrifkan jenis bingkai yang sentiasa ditunjukkan dalam bahagian Tag 2.
Bingkai tersebut kemudiannya boleh ditambah tanpa menggunakan butang Tambah terlebih dahulu. Urutan ini
bingkai capaian pantas boleh ditukar dengan menyeret dan menjatuhkan item.

Format Teg mengandungi pilihan untuk format teg. Apabila Format semasa mengedit adalah
diperiksa, konfigurasi format digunakan secara automatik semasa mengedit teks dalam baris
suntingan. Penukaran Kes boleh ditetapkan kepada Tiada perubahan, Semua huruf kecil, Semua huruf besar,
Huruf pertama huruf besar atau Semua huruf pertama huruf besar. Untuk menggunakan penukaran sedar setempat
antara huruf kecil dan huruf besar, tempat boleh dipilih dalam kotak kombo
di bawah. Senarai penggantian rentetan boleh ditetapkan kepada pemetaan rentetan sewenang-wenangnya. Untuk menambah a
pemetaan baharu, pilih sel Daripada baris dan masukkan teks untuk diganti, kemudian pergi ke
lajur Kepada dan masukkan teks gantian. Untuk mengalih keluar pemetaan tetapkan sel Dari kepada
nilai kosong (cth dengan menaip ruang dahulu dan kemudian backspace). Memasukkan dan memadam
baris juga boleh dilakukan menggunakan menu konteks yang muncul apabila butang kanan tetikus
diklik. Penggantian hanya aktif, jika kotak semak penggantian rentetan ditandakan.

Pada halaman Fail kotak semak Muatkan fail yang terakhir dibuka boleh ditanda supaya Kid3 akan melakukannya
buka dan pilih fail yang terakhir dipilih apabila ia dimulakan pada kali seterusnya. Memelihara
cap masa fail boleh disemak untuk mengekalkan cap masa pengubahsuaian fail. Nama fail
untuk penutup menetapkan nama yang dicadangkan apabila imej terbenam dieksport ke a
fail.

Jika Tandakan perubahan aktif, medan yang diubah ditandakan dengan label kelabu muda
latar belakang.

Format Nama fail mengandungi pilihan untuk format nama fail. Pilihan yang sama seperti
dalam Format Tag tersedia.

Halaman Tindakan Pengguna mengandungi jadual dengan arahan yang tersedia dalam
menu konteks senarai fail. Untuk operasi kritikal seperti memadam fail, ia adalah
dinasihatkan untuk menandakan Sahkan untuk memunculkan dialog pengesahan sebelum melaksanakan
perintah. Output boleh ditanda untuk melihat output yang ditulis oleh arahan konsol (standard
output dan ralat piawai). Nama ialah nama yang dipaparkan dalam menu konteks. Perintah
ialah baris arahan yang akan dilaksanakan. Hujah boleh diluluskan menggunakan kod berikut:

· %F %{files} Laluan fail (senarai jika berbilang fail dipilih)

· %f %{file} Laluan fail ke fail tunggal

· %uF %{urls} URL (senarai jika berbilang fail dipilih)

· %uf %{url} URL ke fail tunggal

· %d %{directory} Direktori

· %s %{title} Tajuk (Lagu)

· %a %{artis} Artis

· %l %{album} Album

· %c %{comment} Ulasan

· %y %{year} Tahun

· %t %{track} Track (cth 01)

· %t %{track.n} Track dengan lebar medan n (cth 001 untuk %{track.3})

· %T %{tracknumber} Track (tanpa mendahului sifar, cth 1)

· %g %{genre} Genre

· %b %{browser} Perintah untuk memulakan penyemak imbas web

· %q %{qmlpath} Direktori asas fail QML yang disediakan

Kod khas @pemisah boleh ditetapkan sebagai arahan untuk memasukkan pemisah ke dalam
menu konteks tindakan pengguna. Item menu boleh dimasukkan ke dalam submenu dengan melampirkannya dengan
@menu permulaan and @endmenu arahan. Nama submenu ditentukan oleh Nama
lajur @menu permulaan perintah.

Untuk melaksanakan skrip QML, @qml digunakan sebagai nama arahan. Laluan ke skrip QML ialah
diluluskan sebagai parameter. Skrip yang disediakan boleh didapati dalam folder
%{qmlpath}/script/ (pada Linux biasanya /usr/share/kid3/qml/script/, pada Windows
qml/script/ di dalam direktori pemasangan dan pada OS X dalam folder aplikasi
kid3.app/Contents/Resources/qml/script/). Skrip tersuai boleh disimpan dalam mana-mana
direktori. Jika kod QML menggunakan komponen GUI, @qmlview hendaklah digunakan sebagai ganti
@qml. Parameter tambahan dihantar ke skrip QML di mana ia akan tersedia
melalui getArguments() fungsi. Gambaran keseluruhan beberapa fungsi dan sifat yang
tersedia dalam QML boleh didapati dalam lampiran Antara Muka QML.

Perintah yang akan dimasukkan dengan %{browser} boleh ditakrifkan dalam penyemak imbas Web
suntingan baris di atas. Perintah yang bermula dengan %{browser} boleh digunakan untuk mengambil maklumat
tentang fail audio daripada web, contohnya

%{pelayar} http://lyricwiki.org/%u{artis}:%u{title}

akan menanyakan lirik lagu semasa dalam LirikWiki[10]. "u" dalam %u{artist} dan
%u{title} digunakan untuk mengekod URL maklumat artis %{artis} dan lagu %{title}. Ia
adalah mudah untuk menentukan pertanyaan anda sendiri dengan cara yang sama, contohnya carian imej dengan
Google[dua]:

%{pelayar} http://images.google.com/images?q=%u{artis}%20%u{album}

Untuk menambahkan seni kulit album pada tag 2, anda boleh mencari imej dengan menggunakan Google atau Amazon
arahan yang diterangkan di atas. Gambar boleh ditambah pada tag dengan seret dan lepas.
Anda juga boleh menambah imej dengan Tambah, kemudian pilih Bingkai gambar dan import imej
fail atau tampal daripada papan keratan. Bingkai gambar disokong untuk ID3v2, MP4, FLAC,
Tag Ogg dan ASF.

Untuk menambah dan memadam entri dalam jadual, menu konteks boleh digunakan.

Halaman Rangkaian hanya mengandungi medan untuk memasukkan alamat proksi dan secara pilihan
pelabuhan, dipisahkan oleh titik bertindih. Proksi akan digunakan apabila mengimport dari Internet
pelayan apabila kotak semak ditandakan.

Dalam halaman Pemalam, pemalam yang tersedia boleh didayakan atau dilumpuhkan. Pemalam adalah
dipisahkan kepada dua bahagian. Senarai Pemalam & Keutamaan Metadata mengandungi pemalam
yang menyokong format fail audio. Susunan pemalam adalah penting kerana ia
dicuba dari atas ke bawah. Sesetengah format disokong oleh berbilang pemalam, jadi fail
akan dibuka dengan pemalam pertama menyokongnya. TaglibMetadata menyokong kebanyakannya
format, jika ia berada di bahagian atas senarai, ia akan membuka kebanyakan fail. Jika anda mahu
untuk menggunakan pemalam yang berbeza untuk format fail, pastikan ia disenaraikan sebelum fail
Pemalam TaglibMetadata. Butiran tentang pemalam metadata dan sebab anda mungkin mahu gunakan
mereka dan bukannya TagLib disenaraikan di bawah.

· Id3libMetadata: Kegunaan id3lib[12] untuk teg ID3v1.1 dan ID3v2.3 dalam MP3, MP2, AAC
fail. Menyokong beberapa lagi jenis bingkai daripada TagLib. Sebab lain untuk menggunakannya ialah
bahawa TagLib hanya menyokong ID3v2.3 sejak versi 1.8.

· OggFlacMetadata: Kegunaan libogg[13], libvorbis, libvorbisfile[14] untuk fail Ogg, dan
tambahan libFLAC++ and libFLAC[15] untuk fail FLAC. Sebab untuk menggunakannya ialah
gambar dalam fail Ogg, yang tidak disokong oleh TagLib dan ini adalah
perpustakaan rasmi untuk format ini.

· TaglibMetadata: Kegunaan TagLib[16] yang menyokong banyak format fail audio. Sejak
versi 1.8, ia juga menyokong ID3v2.3, jadi ia boleh digunakan untuk semua fail audio
disokong oleh Kid3.

· Mp4v2Metadata: mp4v2[17] pada asalnya digunakan oleh Kid3 untuk menyokong fail M4A.
Walau bagaimanapun, versi TagLib yang lebih baharu menyediakan sokongan M4A yang baik, jadi pemalam ini tidak
dibina secara lalai.

Bahagian Pemalam Tersedia menyenaraikan pemalam yang tinggal. Perintah mereka tidak
penting, tetapi ia boleh didayakan atau dilumpuhkan menggunakan kotak semak.

· AmazonImport: Digunakan untuk fungsi Import daripada Amazon....

· DiscogsImport: Digunakan untuk fungsi Import daripada Discogs....

· FreedbImport: Digunakan untuk Import dari gnudb.org... dan Import dari
TrackType.org... fungsi.

· MusicBrainzImport: Digunakan untuk fungsi Import daripada MusicBrainz Release....

· AcoustidImport: Digunakan untuk fungsi Import dari MusicBrainz Cap Jari...,
yang bergantung kepada Chromaprint[18] dan percuma[19] perpustakaan.

Pemalam yang dilumpuhkan tidak akan dimuatkan. Ini boleh digunakan untuk mengoptimumkan sumber
penggunaan dan masa permulaan. Tetapan pada halaman ini hanya berkuat kuasa selepas dimulakan semula
kanak3.

Tetapan → Konfigurasi Pintasan...
Membuka dialog untuk menetapkan pintasan papan kekunci untuk kebanyakan fungsi program. di sana
malah berfungsi tanpa menu atau butang yang sepadan tersedia, contohnya fail seterusnya,
fail sebelumnya, pilih semua.

. Bantuan Menu
Bantuan → Buku Panduan Kid3
Membuka buku panduan ini.

Bantuan → Mengenai Kid3
Memaparkan maklumat ringkas tentang Kid3;.

KID3-CLI

arahan
kid3-cli menawarkan antara muka baris arahan untuk Kid3. Jika laluan direktori digunakan, the
direktori dibuka. Jika satu atau lebih laluan fail diberikan, direktori biasa dibuka
dan fail dipilih. Perintah seterusnya akan berfungsi pada fail ini. Perintah
ditentukan menggunakan -c pilihan. Jika berbilang arahan diluluskan, ia dilaksanakan dalam
diberi perintah. Jika fail diubah suai oleh arahan, ia akan disimpan pada penghujungnya. Jika tidak
pilihan arahan diluluskan, kid3-cli bermula dalam mod interaktif. Perintah boleh dimasukkan
dan akan beroperasi pada pemilihan semasa. Bahagian berikut menyenaraikan semua yang tersedia
menyuruh.

Bantuan
membantu [NAMA-PERINTAH]

Memaparkan bantuan tentang parameter bagi NAMA-PERINTAH atau tentang semua arahan jika tiada arahan
nama diberi.

tamat masa
timeout [lalai | dimatikan | MASA]

Tulis ganti tamat masa arahan lalai. Perintah CLI dibatalkan selepas perintah tertentu
tamat masa tamat. Tamat masa ini ialah 10 saat untuk ls and albumart, 60 saat untuk
autoimport and menapis, dan 3 saat untuk semua arahan lain. Jika bilangan fail yang besar
perlu diproses, tamat masa ini mungkin terlalu terhad, oleh itu tamat masa untuk semua
arahan boleh ditetapkan kepada MASA ms, dimatikan sama sekali atau dibiarkan pada lalai
nilai-nilai.

Berhenti permohonan
keluar [paksa]

Keluar dari aplikasi. Jika terdapat fail yang tidak disimpan yang diubah suai, fail kekuatan parameter ialah
diperlukan.

Tukar direktori
cd [DIREKTORI]

Jika tidak DIREKTORI diberikan, tukar kepada direktori rumah. Jika direktori diberikan,
tukar ke dalam direktori. Jika satu atau lebih laluan fail diberikan, tukar kepada laluan biasa mereka
direktori dan pilih fail.

Cetak yang semasa bekerja direktori
jentera

Cetak nama fail direktori kerja semasa.

Direktori senarai
ls

Senaraikan kandungan direktori semasa. Ini sepadan dengan senarai fail dalam
GUI Kanak-kanak. Empat aksara sebelum nama fail menunjukkan keadaan fail.

· > Fail dipilih.

· * Fail diubah suai.

· 1 Fail mempunyai tag 1, jika tidak '-' dipaparkan.

· 2 Fail mempunyai tag 2, jika tidak '-' dipaparkan.

kid3-cli> ls
1- 01 Pengenalan.mp3
> 12 02 Kami Hanya Dapat Yang Ini.mp3
*1- 03 Outro.mp3

Dalam contoh ini, semua fail mempunyai tag 1, fail kedua juga mempunyai tag 2 dan ia adalah
dipilih. Fail ketiga diubah suai.

Jimat yang berubah fail
menyelamatkan

pilih fail
pilih [semua | tiada | pertama | sebelumnya | seterusnya | FAIL...]

Untuk memilih semua fail, masukkan pilih semua, untuk menyahpilih semua fail, masukkan pilih tiada. Untuk
melintasi fail dalam direktori semasa bermula dengan pilih pertama, kemudian pergi ke hadapan
menggunakan pilih seterusnya atau ke belakang menggunakan pilih sebelumnya. Fail tertentu boleh ditambah ke
pemilihan semasa dengan memberikan nama fail mereka. Kad bebas adalah mungkin, jadi pilih
* .mp3 akan memilih semua fail MP3 dalam direktori semasa.

kid3-cli> pilih pertama
kid3-cli> ls
> 1- 01 Pengenalan.mp3
12 02 Kami Hanya Dapat Ini.mp3
*1- 03 Outro.mp3
kid3-cli> pilih seterusnya
kid3-cli> ls
1- 01 Pengenalan.mp3
> 12 02 Kami Hanya Dapat Yang Ini.mp3
*1- 03 Outro.mp3
kid3-cli> pilih * .mp3
kid3-cli> ls
> 1- 01 Pengenalan.mp3
> 12 02 Kami Hanya Dapat Yang Ini.mp3
>*1- 03 Outro.mp3

pilih tag
tag [TAG-NOMBOR]

Banyak arahan mempunyai pilihan TAG-NOMBOR parameter, yang menentukan sama ada
arahan beroperasi pada teg 1 atau teg 2. Jika parameter ini ditinggalkan, teg lalai
nombor digunakan, yang boleh ditetapkan oleh arahan ini. Pada permulaan, adalah ditetapkan kepada 12 yang
bermakna maklumat dibaca dari tag 2 jika ada, jika tidak dari tag 1; pengubahsuaian
dilakukan pada tag 2. The TAG-NOMBOR boleh diatur ke 1 or 2 untuk beroperasi hanya pada
tag yang sepadan. Jika parameter ditinggalkan, tetapan semasa dipaparkan.

Dapatkan tag bingkai
mendapatkan [semua | FRAME-NAME] [TAG-NOMBOR]

Perintah ini boleh digunakan untuk membaca nilai bingkai tag tertentu atau mendapatkan maklumat
tentang semua bingkai teg (jika hujah ditinggalkan atau semua digunakan). Bingkai yang diubah suai adalah
ditandakan dengan '*'.

kid3-cli> mendapatkan
Fail: MPEG 1 Lapisan 3 192 kbps 44100 Hz Stereo Bersama
Nama: 01 Intro.mp3
Teg 1: ID3v1.1
Pengenalan Tajuk
Artis One Hit Wonder
Album Jom Tag
Tarikh 2013
Nombor Trek 1
Genre Pop
kid3-cli> mendapatkan tajuk
Pengenalan

Untuk menyimpan kandungan bingkai gambar ke fail, gunakan

mendapatkan gambar:"/path/to/folder.jpg"

Untuk menyimpan lirik yang disegerakkan ke fail LRC, gunakan

mendapatkan SYLT:"/path/to/lyrics.lrc"

Tetapkan tag bingkai
menetapkan {FRAME-NAME} {FRAME-VALUE} [TAG-NOMBOR]

Perintah ini menetapkan nilai bingkai tag tertentu.

kid3-cli> menetapkan remixer "OH tertanya-tanya"

Untuk menetapkan kandungan bingkai gambar daripada fail, gunakan

menetapkan gambar:"/path/to/folder.jpg" "Gambar Penerangan"

Untuk menetapkan lirik disegerakkan daripada fail LRC, gunakan

menetapkan SYLT:"/path/to/lyrics.lrc" "Lirik Penerangan"

Kembalikan
kembali

Kembalikan semua pengubahsuaian dalam fail yang dipilih (atau semua fail jika tiada fail
dipilih).

Mengimport dari fail or clipboard
mengimport {FAIL} {FORMAT-NAME} [TAG-NOMBOR]

Teg diimport daripada fail FAIL (atau dari papan keratan jika clipboard digunakan untuk
FAIL) dalam format dengan nama FORMAT-NAME (contohnya "CSV tidak disebut", lihat Import).

automatik mengimport
autoimport [NAMA PROFIL] [TAG-NOMBOR]

Import kumpulan menggunakan profil NAMA PROFIL (lihat Import Automatik, "Semua" digunakan jika
ditinggalkan).

muat turun album meliputi karya seni
albumart {URL} [semua]

Tetapkan karya seni album dengan memuat turun gambar daripada URL. Peraturan yang ditakrifkan dalam
Dialog Seni Muka Depan Semak Imbas digunakan untuk mengubah URL umum (cth dari Amazon) kepada a
URL gambar. Untuk menetapkan kulit album daripada fail gambar setempat, gunakan arahan set.

kid3-cli> albumart
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

Eksport kepada fail or clipboard
mengeksport {FAIL} {FORMAT-NAME} [TAG-NOMBOR]

Teg dieksport ke fail FAIL (atau ke papan keratan jika clipboard digunakan untuk FAIL) dalam
format dengan nama FORMAT-NAME (contohnya "CSV tidak disebut", lihat Eksport).

Buat senarai main
senarai main

Cipta senarai main dalam format yang ditetapkan dalam konfigurasi, lihat Cipta Senarai Main.

Memohon nama fail format
format nama fail

Guna format nama fail yang ditetapkan dalam konfigurasi, lihat Guna Format Nama Fail.

Memohon tag format
format tag

Guna format nama teg yang ditetapkan dalam konfigurasi, lihat Guna Format Teg.

Memohon teks pengekodan
pengekodan teks

Guna set pengekodan teks dalam konfigurasi, lihat Guna Pengekodan Teks.

Namakan semula direktori
menamakan semula [FORMAT] [buat | menamakan semula | larian kering] [TAG-NOMBOR]

Namakan semula atau cipta direktori daripada nilai dalam teg mengikut yang diberikan FORMAT
(contohnya %{artis} - %{album}, lihat Namakan semula Direktori), jika tiada format diberikan, format
ditakrifkan dalam dialog Namakan semula direktori digunakan. Mod lalai ialah menamakan semula; untuk mencipta
direktori, mewujudkan mesti diberikan secara jelas. Tindakan menamakan semula akan dilakukan
segera, untuk melihat apa yang akan dilakukan, gunakan larian kering pilihan.

nombor trek
trek nombor [NOMBOR TRACK] [TAG-NOMBOR]

Nomborkan trek yang dipilih bermula dengan NOMBOR TRACK (1 jika ditinggalkan).

Saring
menapis [PENAPIS-NAMA | PENAPIS-FORMAT]

Tapis fail supaya hanya fail yang sepadan dengan PENAPIS-FORMAT kelihatan. The
nama ungkapan penapis yang dipratentukan (cth "Nama fail Tag Tidak padan") boleh digunakan
bukannya ungkapan penapis, lihat Penapis.

kid3-cli> menapis '%{title} mengandungi "tro"'
Bermula
/home/urs/One Hit Wonder - Jom Tag
+ 01 Pengenalan.mp3
- 02 Kami Hanya Dapat Ini.mp3
+ 03 Outro.mp3
Tamat
kid3-cli> ls
1- 01 Pengenalan.mp3
1- 03 Outro.mp3
kid3-cli> menapis SEMUA
Bermula
/home/urs/One Hit Wonder - Jom Tag
+ 01 Pengenalan.mp3
+ 02 Kami Hanya Dapat Yang Ini.mp3
+ 03 Outro.mp3
Tamat
kid3-cli> ls
1- 01 Pengenalan.mp3
12 02 Kami Hanya Dapat Ini.mp3
1- 03 Outro.mp3

Tukar ID3v2.3 kepada ID3v2.4
to24

Tukar ID3v2.4 kepada ID3v2.3
to23

Filename dari tag
fromtag [FORMAT] [TAG-NOMBOR]

Tetapkan nama fail bagi fail yang dipilih daripada nilai dalam teg, contohnya fromtag
"%{track} - %{title}" 1. Jika tiada format dinyatakan, format yang ditetapkan dalam GUI digunakan.

Tag dari nama fail
totag [FORMAT] [TAG-NOMBOR]

Tetapkan bingkai tag daripada nama fail, sebagai contoh totag "%{albumartist} -
%{album}/%{track} %{title}" 2. Jika tiada format dinyatakan, format yang ditetapkan dalam GUI ialah
digunakan. Jika format nama fail tidak sepadan dengan corak ini, beberapa yang lain biasanya
format yang digunakan dicuba.

Tag kepada lain tag
sinko {NOMBOR TAG}

Salin bingkai teg daripada satu teg ke teg yang lain, contohnya untuk menetapkan teg ID3v2 daripada teg
Tag ID3v1, gunakan sinko 2.

Salinan
salinan [NOMBOR TAG]

Salin bingkai tag bagi fail yang dipilih ke penimbal salinan dalaman. Mereka kemudiannya boleh
ditetapkan pada fail lain menggunakan tampal perintah.

Inti
tampal [NOMBOR TAG]

Tetapkan bingkai tag daripada kandungan salinan penimbal dalam fail yang dipilih.

Batalkan
mengeluarkan [NOMBOR TAG]

Alih keluar teg.

bermain
bermain [jeda | berhenti | sebelumnya | seterusnya]

Mulakan main balik audio. Sebaik sahaja ia telah dimulakan, ia boleh dikawal dengan berhenti seketika
(untuk berhenti seketika dan menyambung semula), berhenti, sebelumnya and seterusnya pilihan.

Contoh
Tetapkan kulit album dalam semua fail direktori menggunakan fungsi import kelompok:

kid3-cli -c 'autoimport "Penutup seni"' /path/to/dir

Alih keluar bingkai ulasan dan gunakan format teg dalam kedua-dua teg semua fail MP3 a
direktori:

kid3-cli -c 'set komen "" 1' -c 'set komen "" 2' \
-c 'format tag 1' -c 'format tag 2' /path/to/dir/*.mp3

Import teg 2 secara automatik, selaraskan ke teg 1, tetapkan nama fail daripada teg 2 dan akhirnya
buat senarai main:

kid3-cli -c autoimport -c 'syncto 1' -c fromtag -c senarai main \
/path/to/dir/*.mp3

Untuk semua fail dengan teg ID3v2.4.0, tukar kepada ID3v2.3.0 dan alih keluar bingkai pengatur:

kid3-cli -c "tapis 'ID3v2.4.0 Tag'" -c "pilih semua" -c to23 \
-c "set menguruskan ''" /path/to/dir

Skrip Python ini menggunakan kid3-cli untuk menjana bingkai iTunes Sound Check iTunNORM daripada
ulang tayang mendapatkan maklumat.

#!/usr/bin/env ular sawa
# Jana Semakan Bunyi iTunes daripada ReplayGain.
daripada __future__ import print_function
import os, sys, subproses

def rg2sc(dirpath):
untuk root, dirs, fail dalam os.walk(dirpath):
untuk nama dalam fail:
if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join(root, nama)
rg = subprocess.check_output([
'kid3-cli', '-c', 'dapatkan "replaygain_track_gain"',
fn]).jalur()
jika rg.endswith(b' dB'):
rg = rg[:-3]
cuba:
rg = terapung(rg)
kecuali ValueError:
print('Nilai %s daripada %s bukan apungan' % (rg, fn))
terus
sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
subprocess.call([
'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])

jika __nama__ == '__main__':
rg2sc(sys.argv[1])

KREDIT DAN LESEN

Kid3

Program yang ditulis oleh Urs Fleisch

LDF[20]

GPL[21]

PEMASANGAN

Cara kepada mendapatkan Kid3
Kid3 boleh didapati di http://kid3.sourceforge.net.

Keperluan Jawatan
Keperluan Kid3 Qt[22]. KDE[23] disyorkan tetapi tidak perlu, kerana Kid3 juga boleh disusun
sebagai aplikasi Qt. Kid3 boleh disusun untuk sistem di mana perpustakaan ini berada
tersedia, cth untuk GNU/Linux, Windows dan Mac OS X. Untuk menandai fail Ogg/Vorbis, libogg[13],
libvorbis and libvorbisfile[14] diperlukan, untuk fail FLAC libFLAC++ and libFLAC[15].
id3lib[12] digunakan untuk fail MP3. Empat format ini juga disokong oleh TagLib[16],
yang juga boleh mengendalikan fail Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
dan modul penjejak. Untuk mengimport daripada cap jari akustik, Chromaprint[18] dan percuma[19]
digunakan.

Kid3 tersedia untuk kebanyakan pengedaran Linux, Windows dan Mac OS X. Pautan boleh didapati
on http://kid3.sourceforge.net.

Penyusunan and Pemasangan
Anda boleh menyusun Kid3 dengan atau tanpa KDE. Tanpa KDE, Kid3 ialah aplikasi Qt yang mudah dan
tidak mempunyai beberapa ciri konfigurasi dan sesi.

Untuk versi KDE, pergi ke direktori teratas dan taip

% cicah .
% membuat
% membuat memasang

Untuk menyusun bagi versi Qt atau KDE yang berbeza, tetapkan yang sepadan cicah pilihan.

Jika tidak semua perpustakaan ada, Kid3 dibina dengan fungsi yang dikurangkan. Jadi anda sepatutnya
berhati-hati untuk memasang semua pakej pembangunan yang diingini. Di sebelah sana,
cicah-options mengawal perpustakaan mana yang disusun. Lalainya ialah -D
WITH_TAGLIB:BOOL=HIDUP -D WITH_MP4V2:BOOL=OFF -D WITH_ID3LIB:BOOL=ON -D
WITH_CHROMAPRINT:BOOL=ON -D WITH_VORBIS:BOOL=ON -D WITH_FLAC:BOOL=ON . Pilihan ini boleh
dilumpuhkan menggunakan OFF.

Untuk membina Kid3 sebagai aplikasi Qt tanpa KDE, gunakan cicah pilihan -DWITH_APPS=Qt. Untuk
bina kedua-dua aplikasi KDE dan Qt, set -DWITH_APPS="Qt;KDE".

Qt 4 atau Qt 5 boleh digunakan. Untuk memaksa penggunaan Qt 4, tetapkan -DWITH_QT4=HIDUP, untuk memaksa penggunaan
Qt 5, set -DWITH_QT5=HIDUP, jika kedua-dua pilihan ini MATI (lalai), Qt 4 adalah diutamakan jika
kedua-dua versi dipasang. Untuk menggunakan pemasangan Qt tertentu, tetapkan
-DQT_QMAKE_EXECUTABLE=/path/to/qmake. Jika membina aplikasi KDE didayakan, tetapkan
Qt 4 akan menggunakan KDE 4, manakala tetapan Qt 5 akan menggunakan KDE 5.

Penjanaan RPM-Pakej disokong oleh fail kid3.spec, untuk Debian-Packages,
skrip build-deb.shis tersedia.

Aplikasi Qt juga boleh disusun untuk Windows dan Mac OS X. Skrip dalam
folder win32 dan macosx boleh digunakan untuk membina dan mencipta pakej. Perpustakaan boleh
dipasang menggunakan buildlibs.sh.

konfigurasi
Dengan KDE, penapis dan format nama fail, format import, nama fail dan ID3
format, bar alat dan tetapan bar status serta saiz tetingkap akan disimpan dalam
lokasi standard dalam fail kid3rc. Sebagai aplikasi Qt, fail ini ada dalam
.config/Kid3/Kid3.conf. Pada Windows, konfigurasi disimpan dalam registri.

D-BAS INTERFACE

Bas-D Contoh
Versi Qt 4 dan KDE 4 di Linux menawarkan Antara Muka D-Bus untuk mengawal Kid3 melalui skrip.
Skrip boleh ditulis dalam mana-mana bahasa dengan D-Bus-bindings (cth dalam Python) dan boleh
ditambahkan pada Tindakan Pengguna untuk melanjutkan kefungsian Kid3.

Artis dalam teg 2 fail semasa boleh ditetapkan kepada nilai "One Hit Wonder" dengan
kod berikut:

Shell

dbus-send --dest=net.sourceforge.kid3 --print-reply=literal \
/Kid3 net.sourceforge.Kid3.setFrame int32:2 rentetan:'Artis' \
rentetan:'One Hit Wonder'

atau lebih mudah dengan Qt's qdbus (qdbusviewer boleh digunakan untuk meneroka antara muka dalam GUI):

qdbus net.sourceforge.kid3 /Kid3 setFrame 2 Artis \
'One Hit Wonder'

Python

import dbus
kid3 = dbus.SessionBus().get_object(
'net.sourceforge.kid3', '/Kid3')
kid3.setFrame(2, 'Artis', 'One Hit Wonder')

Perl

gunakan Net::DBus;
$kid3 = Net::DBus->session->get_service(
"net.sourceforge.kid3")->get_object(
"/Kid3", "net.sourceforge.Kid3");
$kid3->setFrame(2, "Artis", "One Hit Wonder");

Bas-D API
API D-Bus dinyatakan dalam net.sourceforge.Kid3.xml. Antara muka Kid3 mempunyai
kaedah berikut:

Buka fail or direktori
boolean openDirectory(rentetan jalan);

jalan
laluan ke fail atau direktori

Mengembalikan benar jika OK.

Jimat semua diubahsuai fail
boolean simpan(kosong);

Mengembalikan benar jika OK.

Dapatkan a terperinci kesilapan mesej disediakan by beberapa kaedah
rentetan getErrorMessage(kosong);

Mengembalikan mesej ralat terperinci.

Kembalikan perubahan in yang dipilih fail
kembalikan (kosong);

Start an automatik kumpulan mengimport
boolean batchImport(int32 tagMask, rentetan nama profil);

tagMask
tag mask (bit 0 untuk tag 1, bit 1 untuk tag 2)

nama profil
nama profil import kelompok untuk digunakan

Mengimport tags dari a fail
boolean importFromFile(int32 tagMask, rentetan jalan, int32 fmtIdx);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

jalan
laluan fail

fmtIdx
indeks format

Mengembalikan benar jika OK.

muat turun album meliputi Perkara
muat turunAlbumArt(rentetan url, boolean allFilesInDir);

url
URL fail gambar atau sumber seni album

allFilesInDir
benar untuk menambah imej pada semua fail dalam direktori

Eksport tags kepada a fail
boolean exportToFile(int32 tagMask, rentetan jalan, int32 fmtIdx);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

jalan
laluan fail

fmtIdx
indeks format

Mengembalikan benar jika OK.

Buat a senarai main
boolean createPlaylist(void);

Mengembalikan benar jika OK.

Berhenti yang permohonan
berhenti (tidak sah);

pilih semua fail
pilihSemua(kosong);

Nyahpilih semua fail
nyahpilihSemua(kosong);

Tetapkan yang pertama fail as yang semasa fail
boolean firstFile(kosong);

Mengembalikan benar jika terdapat fail pertama.

Tetapkan yang sebelumnya fail as yang semasa fail
boolean Fail sebelumnya(kosong);

Mengembalikan benar jika terdapat fail sebelumnya.

Tetapkan yang seterusnya fail as yang semasa fail
boolean nextFile(kosong);

Mengembalikan benar jika terdapat fail seterusnya.

pilih yang pertama fail
boolean pilihFirstFile(void);

Mengembalikan benar jika terdapat fail pertama.

pilih yang sebelumnya fail
boolean pilihPreviousFile(void);

Mengembalikan benar jika terdapat fail sebelumnya.

pilih yang seterusnya fail
boolean pilihNextFile(void);

Mengembalikan benar jika terdapat fail seterusnya.

pilih yang semasa fail
boolean pilihCurrentFile(kosong);

Mengembalikan benar jika terdapat fail semasa.

Mengembangkan or keruntuhan yang semasa fail item if it is a direktori
boolean expandDirectory(kosong);

Item senarai fail ialah direktori jika getFileName() mengembalikan nama dengan '/' sebagai yang terakhir
watak.

Mengembalikan benar jika item fail semasa ialah direktori.

Memohon yang fail nama format
applyFilenameFormat(void);

Memohon yang tag format
applyTagFormat(kosong);

Memohon teks pengekodan
applyTextEncoding(void);

Tetapkan yang direktori nama dari yang tags
boolean setDirNameFromTag(int32 tagMask, rentetan format, boolean mewujudkan);

tagMask
tag mask (bit 0 untuk tag 1, bit 1 untuk tag 2)

format
format nama direktori

mewujudkan
benar untuk mencipta, palsu untuk menamakan semula

Mengembalikan benar jika OK, jika tidak mesej ralat tersedia menggunakan getErrorMessage().

Tetapkan seterusnya menjejaki nombor in yang dipilih fail
numberTracks(int32 tagMask, int32 firstTrackNr);

tagMask
tag mask (bit 0 untuk tag 1, bit 1 untuk tag 2)

firstTrackNr
nombor untuk digunakan untuk fail pertama

Saring yang fail
penapis (rentetan ungkapan);

ungkapan
ungkapan penapis

Tukar ID3v2.3 tags kepada ID3v2.4
convertToId3v24(kosong);

Tukar ID3v2.4 tags kepada ID3v2.3
convertToId3v23(kosong);

Mengembalikan benar jika OK.

Dapatkan jalan of direktori
rentetan getDirectoryName(void);

Mengembalikan laluan mutlak direktori.

Dapatkan nama of semasa fail
rentetan getFileName(void);

Mengembalikan nama fail mutlak benar, berakhir dengan "/" jika ia adalah direktori.

Tetapkan nama of dipilih fail
setFileName(rentetan nama);

nama
nama fail

Fail akan dinamakan semula apabila direktori disimpan.

Tetapkan format kepada penggunaan apabila menetapkan yang nama fail dari yang tags
setFileNameFormat(rentetan format);

format
format nama fail

Tetapkan yang fail nama of yang dipilih fail dari yang tags
setFileNameFromTag(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Dapatkan nilai of bingkai
rentetan getFrame(int32 tagMask, rentetan nama);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

nama
nama bingkai (cth. "artis")

Untuk mendapatkan data binari seperti gambar, nama fail untuk ditulis boleh ditambah selepas
nama, cth "Gambar:/path/to/file". Dengan cara yang sama, lirik disegerakkan boleh
dieksport, cth "SYLT:/path/to/file".

Mengembalikan nilai bingkai.

Tetapkan nilai of bingkai
boolean setFrame(int32 tagMask, rentetan nama, rentetan nilai);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

nama
nama bingkai (cth. "artis")

nilai
nilai bingkai

Untuk tag 2 (tagMask 2), jika tiada bingkai dengan nama wujud, bingkai baharu ditambah, jika nilai is
kosong, bingkai dipadamkan. Untuk menambah data binari seperti gambar, fail boleh ditambah
selepas nama, cth "Gambar:/path/to/file". "SYLT:/path/to/file" boleh digunakan untuk
import lirik disegerakkan.

Mengembalikan benar jika OK.

Dapatkan semua bingkai of a tag
pelbagai of rentetan getTag(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Mengembalikan senarai dengan nama dan nilai bingkai berselang-seli.

Dapatkan teknikal maklumat mengenai fail
pelbagai of rentetan getInformation(void);

Sifat ialah Format, Kadar Bit, Kadar Sampel, Saluran, Tempoh, Mod Saluran, VBR, Teg
1, Tag 2. Sifat yang tidak tersedia akan ditinggalkan.

Mengembalikan senarai dengan nama dan nilai harta berselang-seli.

Tetapkan tag dari fail nama
setTagFromFileName(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Tetapkan tag dari lain tag
setTagFromOtherTag(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Salinan tag
copyTag(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Inti tag
pasteTag(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Batalkan tag
removeTag(int32 tagMask);

tagMask
bit tag (1 untuk tag 1, 2 untuk tag 2)

Reparse yang konfigurasi
reparseConfiguration(kosong);

Perubahan konfigurasi automatik boleh dilakukan dengan mengubah suai fail konfigurasi dan
kemudian menyusun semula konfigurasi.

bermain yang dipilih fail
mainAudio(kosong);

QML INTERFACE

QML Contoh
Skrip QML boleh digunakan melalui menu konteks senarai fail dan boleh ditetapkan dalam tab
Tindakan Pengguna dialog tetapan. Skrip yang ditetapkan di sana boleh digunakan sebagai
contoh untuk memprogram skrip tersuai. QML menggunakan JavaScript, berikut adalah wajib "Hello
Dunia":

import Kid3 1.0

Kid3Script {
onRun: {
console.log("Hello dunia, direktori ialah", app.dirName)
Qt.quit()
}
}

Jika skrip ini disimpan sebagai /path/to/Example.qml, arahan pengguna boleh ditakrifkan sebagai @qml
/path/to/Example.qml dengan nama QML ujian dan Output diperiksa. Ia kemudian boleh mula digunakan
item Ujian QML dalam menu konteks senarai fail, dan output akan kelihatan dalam
tingkap.

Sebagai alternatif, skrip juga boleh dimulakan secara bebas daripada Kid3 menggunakan alatan QML.

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

Untuk Qt 5, arahan

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

or

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

boleh digunakan. Pada Windows dan OS X, laluan import mesti disesuaikan dengan folder import
di dalam direktori pemasangan. Skrip yang dimulakan di luar Kid3 akan menggunakan arus
direktori, jadi ia harus diubah terlebih dahulu.

Untuk menyenaraikan tajuk dalam tag 2 semua fail dalam direktori semasa, perkara berikut
skrip boleh digunakan:

import Kid3 1.0

Kid3Script {
onRun: {
app.firstFile()
buat {
jika (app.selectionInfo.tagFormatV2)
console.log(app.getFrame(tagv2, "title"))
} manakala (app.nextFile())
}
}

Jika direktori mengandungi banyak fail, skrip sedemikian mungkin menyekat antara muka pengguna untuk
beberapa waktu. Untuk operasi yang lebih lama, ia sepatutnya mempunyai rehat dari semasa ke semasa. The
pelaksanaan alternatif di bawah mempunyai kerja untuk satu fail dipindahkan ke fungsi.
Fungsi ini memanggil dirinya sendiri dengan tamat masa 1 ms pada penghujungnya, memandangkan lebih banyak fail mempunyai
untuk diproses. Ini akan memastikan bahawa GUI kekal responsif semasa skrip adalah
berjalan.

import Kid3 1.0

Kid3Script {
onRun: {
fungsi doWork() {
jika (app.selectionInfo.tagFormatV2) {
console.log(app.getFrame(tagv2, "title"))
}
jika (!app.nextFile()) {
Qt.quit()
} Lain {
setTimeout(doWork, 1)
}
}

app.firstFile()
buat kerja()
}
}

Lebih banyak skrip contoh disertakan dengan Kid3 dan telah didaftarkan sebagai arahan pengguna.

· ReplayGain ke SoundCheck (ReplayGain2SoundCheck.qml): Cipta iTunNORM SoundCheck
maklumat daripada bingkai keuntungan main semula.

· Ubah saiz Seni Album (ResizeAlbumArt.qml): Ubah saiz imej seni muka depan terbenam yang
lebih besar daripada 500x500 piksel.

· Ekstrak Seni Album (ExtractAlbumArt.qml): Ekstrak semua gambar seni muka depan terbenam
mengelakkan pendua.

· Benamkan Seni Album (EmbedAlbumArt.qml): Benamkan seni muka depan yang terdapat dalam fail imej ke dalam audio
fail dalam folder yang sama.

· Benamkan Lirik (EmbedLyrics.qml): Ambil lirik yang tidak disegerakkan daripada perkhidmatan web.

· Pengekodan Teks ID3v1 (ShowTextEncodingV1.qml): Membantu mencari pengekodan teg ID3v1
dengan menunjukkan tag fail semasa dalam semua pengekodan aksara yang tersedia.

· Eksport CSV (ExportCsv.qml): Eksport secara rekursif semua teg semua fail ke fail CSV.

· Konsol QML (QmlConsole.qml): Konsol mudah untuk dimainkan dengan API QML Kid3.

QML API
API boleh diterokai dengan mudah menggunakan QML Console, yang tersedia sebagai contoh
skrip dengan antara muka pengguna.

Kid3Script
Kid3Script ialah komponen QML biasa yang terletak di dalam direktori pemalam. Kamu boleh
gunakan komponen QML yang lain juga. Menggunakan Kid3Script memudahkan untuk memulakan
fungsi skrip menggunakan onRun pengendali isyarat. Ia juga menyembunyikan perbezaan antara
versi QtQuick, untuk menjadikan skrip serasi dengan kedua-dua Qt 4 dan Qt 5.
Selain itu ia menawarkan beberapa fungsi:

onRun: Pengendali isyarat yang digunakan apabila skrip dimulakan
tagv1, tagv2, tagv2v1: Pemalar untuk parameter tag
skrip: Akses kepada fungsi skrip
configs: Akses kepada objek konfigurasi
getArguments(): Senarai argumen skrip
isStandalone(): benar jika skrip tidak dimulakan dari dalam Kid3
setTimeout(callback, delay): Memulakan panggilan balik selepas kelewatan ms

Skrip Fungsi
Oleh kerana JavaScript dan oleh itu QML juga hanya mempunyai set fungsi terhad untuk skrip,
yang skrip objek mempunyai beberapa kaedah tambahan, contohnya:

script.properties(obj): Rentetan dengan sifat Qt
script.writeFile(filePath, data): Tulis data ke fail, benar jika OK
script.readFile(filePath): Baca data daripada fail
script.removeFile(filePath): Padam fail, benar jika OK
script.fileExists(filePath): benar jika fail wujud
script.renameFile(oldName, newName): namakan semula fail, benar jika OK
script.tempPath(): laluan ke direktori sementara
script.listDir(path, [nameFilters], [classify]): Senaraikan entri direktori
script.system(program, [args], [msecs]): Mulakan perintah sistem secara serentak,
[kod keluar, output standard, ralat standard] jika tidak tamat masa
script.getEnv(varName): Dapatkan nilai pembolehubah persekitaran
script.setEnv(varName, value): Tetapkan nilai pembolehubah persekitaran
script.getQtVersion(): Rentetan versi Qt, cth "5.4.1"
script.getDataMd5(data): Dapatkan rentetan hex bagi cincangan data MD5
script.getDataSize(data): Dapatkan saiz tatasusunan bait
script.dataToImage(data, [format]): Buat imej daripada bait data
script.dataFromImage(img, [format]): Dapatkan bait data daripada imej
script.loadImage(filePath): Muatkan imej daripada fail
script.saveImage(img, filePath, [format]): Simpan imej pada fail, benar jika OK
script.imageProperties(img): Dapatkan sifat imej, peta yang mengandungi
"lebar", "tinggi", "dalam" dan "colorCount", kosongkan jika imej tidak sah
script.scaleImage(img, width, [height]): Skala imej, mengembalikan imej berskala
script.selectFileName(caption, dir, filter, saveFile): Buka dialog fail ke
pilih fail

Kesesuaian Konteks
Menggunakan QML, sebahagian besar fungsi Kid3 boleh diakses. API adalah serupa dengan
yang digunakan untuk D-Bus. Untuk butiran, rujuk nota masing-masing.

app.openDirectory(path): Buka direktori
app.saveDirectory(): Simpan direktori
app.revertFileModifications(): Kembalikan
app.importTags(tag, laluan, fmtIdx): Import fail
app.downloadImage(url, allFilesInDir): Muat turun imej
app.exportTags(tag, laluan, fmtIdx): Eksport fail
app.writePlaylist(): Tulis senarai main
app.selectAllFiles(): Pilih semua
app.deselectAllFiles(): Nyahpilih
app.firstFile([pilih]): Untuk fail pertama
app.nextFile([pilih]): Ke fail seterusnya
app.previousFile([select]): Ke fail sebelumnya
app.selectCurrentFile([select]): Pilih fail semasa
app.requestExpandFileList(): Kembangkan semua
app.applyFilenameFormat(): Gunakan format nama fail
app.applyTagFormat(): Gunakan format teg
app.applyTextEncoding(): Gunakan pengekodan teks
app.numberTracks(nr, jumlah, teg, [pilihan]): Nombor runut
app.applyFilter(expr): Penapis
app.convertToId3v23(): Tukar ID3v2.4.0 kepada ID3v2.3.0
app.convertToId3v24(): Tukar ID3v2.3.0 kepada ID3v2.4.0
app.getFilenameFromTags(tag): Nama fail daripada tag
app.getTagsFromFilename(tag): Nama fail kepada tag
app.getAllFrames(tag): Dapatkan objek dengan semua bingkai
app.getFrame(tag, nama): Dapatkan bingkai
app.setFrame(tag, nama, nilai): Tetapkan bingkai
app.getPictureData(): Dapatkan data daripada bingkai gambar
app.setPictureData(data): Tetapkan data dalam bingkai gambar
app.copyToOtherTag(tag): Teg pada teg lain
app.copyTags(tag): Salin
app.pasteTags(tag): Tampal
app.removeTags(tag): Alih keluar
app.playAudio(): Main
app.readConfig(): Baca konfigurasi
app.applyChangedConfiguration(): Gunakan konfigurasi
app.dirName: Nama direktori
app.selectionInfo.fileName: Nama fail
app.selectionInfo.filePath: Laluan fail mutlak
app.selectionInfo.detailInfo: Format butiran
app.selectionInfo.tagFormatV1: Format Tag 1
app.selectionInfo.tagFormatV2: Format Tag 2
app.selectionInfo.formatString(tag, format): Gantikan kod dalam rentetan format

Untuk operasi tak segerak, panggil balik boleh disambungkan kepada isyarat.

function automaticImport(profil) {
function onAutomaticImportFinished() {
app.batchImporter.finished.disconnect(onAutomaticImportFinished)
}
app.batchImporter.finished.connect(onAutomaticImportFinished)
app.batchImport(profil, tagv2)
}

function renameDirectory(format) {
function onRenameActionsScheduled() {
app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
app.performRenameActions()
}
app.renameActionsScheduled.connect(onRenameActionsScheduled)
app.renameDirectory(tagv2v1, format, false)
}

konfigurasi Objek
Bahagian konfigurasi yang berbeza boleh diakses melalui kaedah konfigurasi. Mereka
hartanah boleh disenaraikan dalam konsol QML.

script.properties(configs.networkConfig())

Hartanah boleh ditetapkan:

configs.networkConfig().useProxy = palsu

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()

Gunakan kid3-core dalam talian menggunakan perkhidmatan onworks.net