kid3-cli - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

kid3, kid3-qt, kid3-cli - Trình gắn thẻ Kid3 ID3

SYNOPSIS

đứa trẻ3 [--Cứu giúp | --help-qt | --help-kde | - trợ giúp tất cả
|--tác giả | --phiên bản | --giấy phép] [FILE...]

kid3-qt [Qt-tùy chọn] [FILE...]

kid3-cli [-h | --Cứu giúp] [-c LỆNH1] [-c LỆNH2...] [FILE...]

LỰA CHỌN

FILE
If FILE là đường dẫn đến một thư mục, nó sẽ được mở. Nếu một hoặc nhiều đường dẫn tệp
cho trước, thư mục chung của họ được mở và các tệp được chọn.

đứa trẻ3
--Cứu giúp
Hiển thị trợ giúp về các tùy chọn.

--help-qt
Hiển thị các tùy chọn cụ thể Qt, xem qtoptions(7).

--help-kde
Hiển thị các tùy chọn cụ thể của KDE, xem kdeoptions(7).

- trợ giúp tất cả
Hiển thị tất cả các tùy chọn.

--tác giả
Hiển thị thông tin tác giả.

--phiên bản
Hiển thị thông tin phiên bản.

--giấy phép
Hiển thị thông tin giấy phép.

kid3-qt
Qt-tùy chọn
Xem qtoptions(7), tuy nhiên, các tùy chọn có "-" làm tiền tố, không phải "-".

kid3-cli
-c
Thực hiện một lệnh. Nhiều -c các tùy chọn khả thi, chúng được thực hiện theo trình tự.
Xem phần về kid3-cli để biết mô tả về các lệnh có sẵn.

-h|--Cứu giúp
Hiển thị trợ giúp về các tùy chọn và lệnh.

GIỚI THIỆU

Kid3 là một ứng dụng để chỉnh sửa các thẻ ID3v1 và ID3v2 trong các tệp MP3 một cách hiệu quả.
Hầu hết các máy nghe nhạc MP3 đều có thể chỉnh sửa các thẻ này, nhưng không thoải mái và hiệu quả
đường. Hơn nữa, các thẻ trong Ogg / Vorbis, Opus, DSF, FLAC, MPC, APE, MP4 / AAC, MP2, Speex,
Tệp TrueAudio, WavPack, WMA, WAV, AIFF và mô-đun trình theo dõi (MOD, S3M, IT, XM) là
cũng được hỗ trợ.

Kid3 không lấy cũng như mã hóa các tệp MP3, nhưng nó được nhắm mục tiêu để chỉnh sửa các thẻ ID3 của tất cả
các tệp của anbom một cách hiệu quả, tức là chỉ với một vài cú nhấp chuột và nhấn phím như
khả thi. Trong trường hợp hầu hết các chương trình khác có thể chỉnh sửa thẻ ID3v1 hoặc ID3v2, Kid3 có đầy đủ
kiểm soát cả hai phiên bản, có thể chuyển đổi thẻ giữa hai định dạng và có quyền truy cập vào tất cả
Thẻ ID3v2. Các thẻ của nhiều tệp có thể được đặt thành cùng một giá trị, ví dụ: nghệ sĩ, album,
năm và thể loại của tất cả các tệp trong album thường có cùng giá trị và có thể được đặt
cùng nhau. Nếu thông tin cho các thẻ được chứa trong tên tệp, các thẻ có thể
tự động đặt từ tên tệp. Cũng có thể đặt tên tệp theo
cho các thẻ được tìm thấy trong tệp ở các định dạng tùy ý.

Tác vụ chỉnh sửa được hỗ trợ thêm bằng cách tự động thay thế các ký tự hoặc
chuỗi con, chẳng hạn để xóa các ký tự không hợp lệ khỏi tên tệp. Kiểm soát tự động
các ký tự viết hoa và viết thường giúp dễ dàng sử dụng một lược đồ đặt tên nhất quán trong tất cả
thẻ.

Thông tin thẻ cho toàn bộ album có thể được lấy từ gnudb.org[1], TrackType.org[2],
Âm nhạcBrainz[3], Vũ trường[4], đàn bà gan dạ[5] hoặc các nguồn danh sách theo dõi khác. Định dạng nhập
có thể tự do định cấu hình bằng các biểu thức chính quy.

Vui lòng báo cáo bất kỳ vấn đề hoặc yêu cầu tính năng nào cho tác giả.

SỬ DỤNG KID3

Kid3 Tính năng, đặc điểm
· Chỉnh sửa thẻ ID3v1.1

· Chỉnh sửa tất cả các khung ID3v2.3 và ID3v2.4

· Chỉnh sửa thẻ của nhiều tệp

· Chuyển đổi giữa thẻ ID3v1 và ID3v2

· Chỉnh sửa MP3, Ogg / Vorbis, Opus, DSF, FLAC, MPC, APE, MP4 / AAC, MP2, Speex, TrueAudio,
Các thẻ WavPack, WMA, WAV và AIFF

· Tạo thẻ từ tên tệp

· Tạo thẻ từ nội dung của các trường thẻ

· Tạo tên tệp từ các thẻ

· Tạo và thay đổi tên thư mục từ các thẻ

· Tạo tệp danh sách phát

· Chuyển đổi chữ hoa chữ thường tự động và dịch chuỗi

· Nhập khẩu từ gnudb.org[1], TrackType.org[2], Âm nhạcBrainz[3], Vũ trường[4], đàn bà gan dạ[5] và
các nguồn dữ liệu khác

· Xuất dưới dạng CSV, HTML, danh sách phát, Kover XML và các định dạng khác. Các tệp CSV đã xuất có thể được
đã nhập lại.

Ví dụ Sử dụng
Phần này mô tả một phiên thông thường với Kid3. Giả sử chúng ta có một thư mục
chứa các tệp MP3 với các bài hát trong album "Let's Tag" của ban nhạc "One Hit
Wonder ". Thư mục được đặt tên ở định dạng" nghệ sĩ - album ", trong trường hợp của chúng tôi là One Hit Wonder
- Hãy Tag. Thư mục chứa các bản nhạc ở định dạng "track title.mp3", mà tôi
nghĩ là hữu ích vì tên tệp ngắn (quan trọng khi sử dụng máy nghe nhạc MP3 di động
với màn hình nhỏ) và theo đúng thứ tự khi được sắp xếp theo thứ tự bảng chữ cái (quan trọng khi
sử dụng máy nghe nhạc MP3 phần cứng phát các bản nhạc theo thứ tự bảng chữ cái hoặc theo thứ tự
mà chúng được ghi trên đĩa CD và thứ tự đó được xếp theo thứ tự bảng chữ cái khi sử dụng mkisofs). ngoài ra
cái này, thông tin nghệ sĩ và album đã có trong tên thư mục và không có
được lặp lại trong tên tệp. Nhưng trở lại ví dụ của chúng tôi, danh sách thư mục trông giống như
điều này:

01 Gioi thieu.mp3

02 Chung toi chi co cai nay.mp3

03 Ngoai.mp3

Những tệp này chưa có thẻ và chúng tôi muốn tạo chúng bằng Kid3. Chúng tôi sử dụng Open (Tệp
menu hoặc thanh công cụ) và chọn một trong các tệp trong thư mục này. Tất cả các tệp sẽ được
hiển thị trong hộp danh sách tệp. Vì chúng tôi lười biếng, chúng tôi muốn sử dụng thông tin trong
tên thư mục và tệp để tạo thẻ. Do đó, chúng tôi chọn tất cả các tệp, sau đó nhấp vào
Tới: Gắn thẻ 1 nút trong phần Tệp. Thao tác này sẽ đặt tiêu đề, nghệ sĩ, album và bản nhạc
giá trị trong tất cả các tệp. Để đặt giá trị năm và thể loại của tất cả các tệp, chúng tôi giữ tất cả các tệp
đã chọn và nhập "2002" cho Năm và chọn "Pop" từ hộp kết hợp Thể loại. Để thiết lập
chỉ có hai giá trị này, hộp kiểm của chúng được tự động chọn và tất cả các hộp kiểm khác
được bỏ chọn. Bây giờ chúng tôi thay đổi lựa chọn bằng cách chỉ chọn tệp đầu tiên và chúng tôi
thấy rằng tất cả các thẻ đều chứa các giá trị chính xác. Các thẻ của các tệp khác có thể được xác minh
bằng cách chọn từng cái một. Khi chúng tôi hài lòng với các thẻ, chúng tôi sử dụng Lưu (Tệp
menu hoặc thanh công cụ). Chọn Tạo danh sách phát từ menu Tệp sẽ tạo một tệp Một
Nhấn Wonder - Hãy Tag.m3u vào thư mục.

COMMAND THAM KHẢO

Sản phẩm GUI Các yếu tố
Kid3 GUI được phân tách thành năm phần: Ở bên trái là tệp và thư mục
hộp danh sách, phía bên phải chứa các phần Tệp, Thẻ 1 và Thẻ 2.

Tập tin Danh sách
Danh sách tệp chứa tên của tất cả các tệp trong thư mục đã mở khớp với
bộ lọc tên tệp đã chọn (thường là * .mp3 * .ogg * .opus * .dsf * .flac * .mpc * .aac
* .m4a * .m4b * .m4p * .mp4 * .mp2 * .spx * .tta * .wv * .wma * .wav * .aiff * .ape). Một hoặc
nhiều tệp có thể được chọn. Để chọn không có tệp nào, hãy nhấp vào vùng trống sau
các mục hộp danh sách. Việc lựa chọn xác định các tệp bị ảnh hưởng bởi
các hoạt động khả dụng bằng cách sử dụng các nút được mô tả bên dưới.

Ngoài Tên, các cột khác Kích thước, Loại, Ngày sửa đổi với chi tiết tệp có thể được
hiển thị. Có thể ẩn các cột bằng cách bỏ chọn tên của chúng trong menu ngữ cảnh của
tiêu đề danh sách. Thứ tự của các cột có thể được thay đổi bằng cách kéo. Thứ tự sắp xếp
có thể được chuyển đổi bằng cách nhấp vào tiêu đề cột.

Ở bên trái của các tên, một biểu tượng có thể được hiển thị: một đĩa để hiển thị rằng tệp có
đã được sửa đổi hoặc thông tin về những thẻ nào hiện có (V1, V2, V1V2 hoặc KHÔNG CÓ TAG, không
biểu tượng được hiển thị nếu tệp chưa được đọc).

Các thư mục được hiển thị bằng biểu tượng thư mục. Nếu một thư mục được mở, các tệp của nó sẽ
được hiển thị trong một cây phân cấp. Bằng cách chọn tệp từ thư mục con, các hoạt động
có thể được thực thi trên các tệp trong các thư mục khác nhau, điều này rất hữu ích nếu nhạc
bộ sưu tập được tổ chức với một thư mục cho mỗi nghệ sĩ chứa các thư mục cho các album của
nghệ sĩ này.

Nhấp vào nút chuột phải bên trong danh sách tệp sẽ mở trình đơn ngữ cảnh với
các lệnh sau:

· Mở rộng tất cả: Mở rộng tất cả các cây thư mục (chỉ cây hiện tại nếu phím shift là
ép)

· Thu gọn tất cả: Thu gọn tất cả các cây thư mục

· Đổi tên: Thay đổi tên của một tập tin

· Chuyển vào Thùng rác: Chuyển một tệp vào thùng rác

· Chơi: Phát một tập tin, xem Play

· Các mục tiếp theo là lệnh của người dùng, có thể được định nghĩa trong Hành động của người dùng
tab Cấu hình Kid3. Phát lại khi nhấp đúp cũng có thể được kích hoạt ở đó.

thư mục Danh sách
Danh sách thư mục chứa tên của các thư mục trong thư mục đã mở, như
cũng như thư mục hiện tại (.) và thư mục mẹ (..). Nó cho phép một người nhanh chóng thay đổi
thư mục mà không cần sử dụng lệnh Open ... hoặc kéo và thả.

Khả năng hiển thị cột, thứ tự và sắp xếp có thể được định cấu hình như được mô tả trong phần
về danh sách tệp.

Tập tin
Hiển thị thông tin về mã hóa (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), tốc độ bit, tốc độ lấy mẫu, kênh và
độ dài của tệp.

Chỉnh sửa dòng Tên chứa tên của tệp (nếu chỉ chọn một tệp duy nhất).
Nếu tên này được thay đổi, tệp sẽ được đổi tên khi sử dụng lệnh Lưu.

Hộp tổ hợp Định dạng và chỉnh sửa dòng chứa định dạng được sử dụng khi tên tệp là
được tạo từ thẻ đầu tiên hoặc thẻ thứ hai. Tên tệp có thể chứa tùy ý
các ký tự, thậm chí một phần thư mục được phân tách bằng dấu gạch chéo từ tên tệp, nhưng
thư mục phải tồn tại để việc đổi tên thành công. Các mã đặc biệt sau
được sử dụng để chèn các giá trị thẻ vào tên tệp:

·% S% {title} Title (Bài hát)

·% A% {artist} Nghệ sĩ

·% L% {album} Anbom

·% C% {comment} Nhận xét

·% Y% {year} năm

·% T% {track} Theo dõi (ví dụ: 01)

·% T% {track.n} Theo dõi với chiều rộng trường n (ví dụ: 001 cho% {track.3})

·% T% {tracknumber} Theo dõi (không có số 1 ở đầu, ví dụ: XNUMX)

·% G% {category} Thể loại

·% {Ignore} bị bỏ qua khi tạo thẻ từ tên tệp

Các mã định dạng không bị hạn chế đối với các ví dụ được đưa ra ở trên. Bất kỳ tên khung nào cũng có thể là
được sử dụng, ví dụ: tên khung thống nhất như % {bpm} hoặc định dạng các tên cụ thể như
% {popm}.

Hộp tổ hợp Định dạng thứ hai (với mũi tên xuống) được sử dụng để tạo các thẻ từ
tên tệp. Nếu định dạng của tên tệp không khớp với mẫu này, một số khác
các định dạng thường được sử dụng được thử.

Một số định dạng tên tệp thường được sử dụng đã có sẵn trong hộp tổ hợp, nhưng nó
cũng có thể gõ ở một số định dạng đặc biệt vào dòng chỉnh sửa.

Từ: Thẻ 1, Thẻ 2: Đặt tên tệp bằng cách sử dụng định dạng đã chọn và thẻ đầu tiên hoặc
thẻ thứ hai, tương ứng.

Tới: Thẻ 1, Thẻ 2: Các thẻ được đặt từ tên tệp. Đầu tiên, định dạng được chỉ định trong
Định dạng được sử dụng. Nếu tên tệp hiện có không khớp với định dạng này, như sau
các định dạng được thử:

· Nghệ sĩ - Album / Bài hát

· Album / Bài hát - Nghệ sĩ - Bài hát

· / Nghệ sĩ - Album - Bản nhạc - Bài hát

· Album / Nghệ sĩ - Bản nhạc - Bài hát

· Album / Nghệ sĩ - Bài hát

· Nghệ sĩ / Album / Bài hát

Nếu một tệp duy nhất được chọn, các điều khiển GUI sẽ chứa đầy các giá trị được trích xuất
từ tên tệp. Nếu nhiều tệp được chọn, các thẻ của tệp sẽ trực tiếp
đặt theo tên tệp.

Nhãn 1
Các tiện ích chỉnh sửa dòng cho Tiêu đề, Nghệ sĩ, Album, Bình luận, Năm, Bản nhạc và Thể loại là
được sử dụng để chỉnh sửa giá trị tương ứng trong thẻ đầu tiên của các tệp đã chọn. Giá trị
sẽ được thay đổi khi lựa chọn tệp bị thay đổi hoặc trước các hoạt động như Lưu và
Thoát và khi hộp kiểm tương ứng ở bên trái của tên trường được chọn.
Điều này rất hữu ích khi chỉ thay đổi một số giá trị và giữ nguyên các giá trị khác.

Nếu một tệp được chọn, tất cả các hộp kiểm sẽ được chọn và các tiện ích con chỉnh sửa dòng
chứa các giá trị được tìm thấy trong các thẻ của tệp này. Nếu không tìm thấy thẻ trong tệp,
giá trị trống tương ứng được hiển thị, là một chuỗi trống cho Tiêu đề,
Các chỉnh sửa về nghệ sĩ, Album và dòng Nhận xét, 0 cho các chỉnh sửa về Năm và Bản nhạc bằng số và một
giá trị đã chọn trống cho hộp kết hợp Thể loại. Các giá trị có thể được thay đổi và nếu
hộp kiểm tương ứng được chọn, chúng sẽ được đặt cho tệp đã chọn sau khi
lựa chọn được thay đổi. Sau đó, tệp được đánh dấu là đã sửa đổi bằng ký hiệu đĩa trong tệp
hộp danh sách nhưng không thay đổi cho đến khi lệnh Lưu được sử dụng.

Nếu nhiều tệp được chọn, chỉ các giá trị giống nhau trong tất cả các tệp đã chọn
các tệp được hiển thị. Trong tất cả các điều khiển khác, các giá trị trống như được mô tả ở trên là
hiển thị. Tất cả các hộp kiểm được bỏ chọn để tránh những thay đổi không mong muốn. Nếu một giá trị phải
được đặt cho tất cả các tệp đã chọn, nó có thể được chỉnh sửa và hộp kiểm phải được đặt. Các
các giá trị sẽ được đặt cho tất cả các tệp đã chọn khi lựa chọn được thay đổi và có thể được
được lưu bằng lệnh Save.

Các hộp kiểm cũng kiểm soát hoạt động của hầu hết các lệnh ảnh hưởng đến thẻ, chẳng hạn như
như sao chép, dán và chuyển giữa các thẻ 1 và 2. Để giúp bạn sử dụng dễ dàng hơn với
nhiều tệp trong đó tất cả các hộp kiểm được bỏ chọn, các lệnh này hoạt động giống nhau
khi tất cả các hộp kiểm được chọn và khi tất cả các hộp kiểm được bỏ chọn.

Từ thẻ 2: Các trường của thẻ 1 được đặt từ các giá trị tương ứng trong thẻ 2. Nếu a
một tệp được chọn, các điều khiển GUI được lấp đầy bằng các giá trị từ thẻ 2. Nếu
nhiều tệp được chọn, các thẻ của tệp được đặt trực tiếp.

Sao chép: Bộ đệm sao chép được lấp đầy bởi các giá trị Thẻ 1. Chỉ các giá trị được chọn
hộp kiểm sẽ được sử dụng trong các lệnh Dán tiếp theo.

Dán: Dán các giá trị từ bộ đệm sao chép vào các điều khiển GUI.

Xóa: Điều này sẽ đặt tất cả các điều khiển GUI thành các giá trị trống của chúng, dẫn đến việc xóa
tất cả các giá trị. Sau đó, tệp đã lưu sẽ không chứa thẻ 1.

Nhãn 2
Chức năng điều khiển GUI theo cách tương tự như được mô tả cho phần Thẻ 1, nhưng
kích thước của các chuỗi không bị giới hạn.

Đối với thẻ 2 Thể loại, bạn cũng có thể sử dụng tên riêng của mình bên cạnh các thể loại được liệt kê trong
hộp kết hợp, chỉ cần nhập tên vào dòng chỉnh sửa.

Thẻ 2 không chỉ có thể chứa các giá trị giống như thẻ 1, định dạng được tạo trong
cách linh hoạt từ một số khung mà bản thân chúng bao gồm một số trường. Các
bảng tag 2 hiển thị tất cả các khung có sẵn trong tệp đã chọn.

Chỉnh sửa: Thao tác này sẽ mở ra một cửa sổ cho phép người ta chỉnh sửa tất cả các trường đã chọn
khung. Nếu nhiều tệp được chọn, các trường đã chỉnh sửa sẽ được áp dụng cho tất cả các trường đã chọn
các tệp chứa một khung như vậy.

Thêm: Người yêu cầu chọn loại khung sẽ xuất hiện và một khung thuộc loại đã chọn
có thể được chỉnh sửa và thêm vào tệp. Điều này cũng hoạt động để thêm một khung vào nhiều
các tệp đã chọn.

Xóa: Xóa khung đã chọn trong các tệp đã chọn.

Tác phẩm nghệ thuật của album kéo ở đây được hiển thị nếu tệp không chứa ảnh bìa được nhúng. MỘT
có thể thêm hình ảnh bằng cách sử dụng kéo và thả từ trình duyệt hoặc trình quản lý tệp và sẽ
hiển thị ở đây. Khung ảnh có thể được chỉnh sửa hoặc thêm vào bằng cách nhấp đúp vào đây
kiểm soát.

Đồng bộ Lyrics và Sự kiện Thời gian Mã số
Đối với thông tin được đồng bộ hóa với dữ liệu âm thanh, một trình chỉnh sửa cụ thể có sẵn.
Các khung này được hỗ trợ cho các thẻ ID3v2.3.0 và ID3v2.4.0. Để thêm một khung như vậy,
tên khung cụ thể phải được chọn trong danh sách xuất hiện khi nút Thêm
được nhấp vào - Lời bài hát được đồng bộ hóa hoặc Mã thời gian sự kiện, tương ứng. Người biên tập là
giống nhau đối với cả hai loại, đối với mã thời gian sự kiện, chỉ một nhóm sự kiện được xác định trước
có sẵn trong khi đối với lời bài hát được đồng bộ hóa, văn bản phải được nhập. bên trong
sau đây, chỉnh sửa lời bài hát được đồng bộ hóa được giải thích.

Một tệp có thẻ ID3v2 được chọn, trình chỉnh sửa lời bài hát được nhập bằng cách sử dụng Thêm và
chọn Lời bài hát được đồng bộ hóa. Đối với khung Lời bài hát được đồng bộ hóa hiện có, nó là
đã chọn và Chỉnh sửa được nhấp. Trình phát được mở tự động với tệp hiện tại
để tệp có thể được phát và tạm dừng để đồng bộ hóa lời bài hát.

Các cài đặt ở trên cùng của trình soạn thảo SYLT thường không phải thay đổi. Nếu
lời bài hát chứa các ký tự không có trong bộ ký tự Latin 1,
nên thay đổi mã hóa văn bản thành UTF16 (hoặc UTF8 cho ID3v2.4.0). Đối với tiếng Anh
lời bài hát và khả năng tương thích tối đa, nên sử dụng ISO-8859-1.

Phần Lời bài hát có năm nút ở trên cùng. Thêm sẽ thêm một sự kiện thời gian mới trong
bàn. Thời gian được lấy từ vị trí của người chơi, do đó thêm một mục trong khi
chơi bản nhạc sẽ thêm một dòng cho vị trí đang phát. Các sự kiện trong
bảng phải được sắp xếp theo thứ tự thời gian, do đó hàng sẽ được chèn
cho phù hợp. Các mục nhập có thời gian không hợp lệ được xử lý đặc biệt: Nếu hiện tại
hàng đã chọn có thời gian không hợp lệ, dấu thời gian của nó sẽ được thay thế bằng thời gian hiện tại
thay vì thêm một hàng mới. Nếu thời gian hiện tại không phải là không hợp lệ, thì hàng đầu tiên có
thời gian không hợp lệ sẽ được sử dụng nếu có. Hành vi này sẽ tạo điều kiện cho việc thêm thời gian
đóng dấu nếu văn bản lời bài hát đã có trong bảng nhưng thiếu dấu thời gian
(đó là trường hợp nhập lời bài hát không đồng bộ). Lưu ý rằng thời gian không hợp lệ
được biểu thị là 00: 00.00, tức là giống với thời gian ở đầu tuyệt đối của
theo dõi, không phải là không hợp lệ. Để làm cho thời gian không hợp lệ, hãy nhấn phím Xóa hoặc sử dụng
Xóa khỏi menu ngữ cảnh. Đã chèn hàng mới bằng cách sử dụng Chèn hàng từ menu ngữ cảnh
hoặc được tạo khi nhập lời bài hát không đồng bộ với Từ khay nhớ tạm hoặc Nhập cũng
chứa tem thời gian không hợp lệ. Các hàng trong bảng có thể bị xóa bằng cách nhấp vào Xóa
hoặc sử dụng Xóa hàng khỏi menu ngữ cảnh.

Lời bài hát được đồng bộ hóa có thể được nhập từ một tệp bằng cách sử dụng Nhập. Định dạng dự kiến ​​là
LRC đơn giản hoặc nâng cao. Nếu tệp đã chọn không chứa dấu ngoặc vuông trong
dòng đầu tiên, nó được cho là một tệp văn bản đơn giản với lời bài hát không được đồng bộ hóa. Các
các dòng từ tệp như vậy sau đó được nhập có dấu thời gian không hợp lệ. Thời gian
thông tin có thể được thêm vào bằng cách sử dụng nút Thêm hoặc bằng cách nhập thủ công. Nó cũng có thể
để nhập lời bài hát qua copy-paste bằng From Clipboard. Lời bài hát được đồng bộ hóa có thể được
được ghi vào các tệp LRC bằng cách sử dụng Xuất. Lưu ý rằng chỉ những mục nhập có dấu thời gian hợp lệ mới được
được xuất và các mục nhập sẽ được sắp xếp theo thời gian. Các bài viết có thời gian không hợp lệ
cũng sẽ không được lưu trữ trong khung SYLT, vì vậy hãy đảm bảo bao gồm tất cả thời gian
thông tin trước khi rời khỏi hộp thoại.

Sản phẩm ID3 đặc điểm kỹ thuật[6] gợi ý dấu thời gian cho mỗi âm tiết. Tuy nhiên hầu hết người chơi
chỉ hỗ trợ mức độ chi tiết của một dòng hoặc câu. Để hỗ trợ cả hai trường hợp sử dụng, Kid3
tuân theo các quy ước tương tự như SYLT Biên tập viên[7]. Văn bản được nhập vào bảng
được giả định là bắt đầu một dòng mới trừ khi nó bắt đầu bằng dấu cách hoặc dấu gạch ngang. Ngoại lệ
có thể thực hiện quy tắc này bằng cách bắt đầu một dòng với dấu gạch dưới ('_') để buộc
tiếp tục hoặc một dấu thăng ('#') để buộc một dòng mới. Các ký tự thoát này không
được lưu trữ bên trong khung SYLT. Bên trong khung SYLT, các dòng mới bắt đầu bằng một nguồn cấp dòng
ký tự (hex 0A) trong khi các phép liên tục thì không. Khi đọc khung SYLT, Kid3 sẽ kiểm tra
nếu mục nhập đầu tiên bắt đầu bằng nguồn cấp dòng. Nếu đây không phải là trường hợp, nó được giả định
rằng tất cả các mục nhập đều là dòng mới và không có âm tiết liên tục nào được sử dụng.

Trong khi bản nhạc được phát, hàng được liên kết với vị trí phát hiện tại là
được đánh dấu, để tính chính xác của thông tin đồng bộ hóa có thể được
đã xác minh. Nếu một phần bù phải được thêm vào một hoặc nhiều tem thời gian, thì điều này có thể
hoàn thành với menu ngữ cảnh Thêm bù đắp. Giá trị âm có thể được sử dụng để giảm
thời gian. Sử dụng Tìm kiếm vị trí trong menu ngữ cảnh, có thể đặt
vị trí chơi đến thời điểm của hàng đã chọn.

Sản phẩm Tập tin Menu
Tệp → Mở ... (Ctrl + O)
Mở một thư mục. Tất cả các tệp phù hợp với bộ lọc tên tệp đã chọn sẽ được hiển thị
trong hộp danh sách tệp và tệp đã chọn được chọn.

Tệp → Mở gần đây
Mở một thư mục đã mở gần đây.

Tệp → Mở thư mục ... (Ctrl + D)
Mở một thư mục. Tất cả các tệp phù hợp với bộ lọc tên tệp đã chọn sẽ được hiển thị
trong hộp danh sách tệp.

Tệp → Lưu (Ctrl + S)
Lưu tất cả các tệp đã thay đổi trong thư mục. Các tệp đã thay đổi được đánh dấu bằng đĩa
biểu tượng trong hộp danh sách tệp. Nếu bất kỳ tên tệp nào đã được thay đổi, các tệp đó sẽ
đổi tên.

Tệp → Hoàn nguyên
Hoàn nguyên các thay đổi của một hoặc nhiều tệp. Nếu không có tệp nào được chọn trong tệp
hộp danh sách, các thay đổi của tất cả các tệp sẽ được hoàn nguyên, chỉ những thay đổi của
các tệp đã chọn được hoàn nguyên.

Tệp → Nhập ...
Hộp thoại Nhập có thể được sử dụng để nhập dữ liệu trực tiếp từ máy chủ Freedb.org, từ một
Máy chủ MusicBrainz, từ Discogs, Amazon hoặc các nguồn danh sách theo dõi album khác trong
định dạng văn bản.

Có thể nhập từ máy chủ Freedb.org bằng cách sử dụng hộp thoại xuất hiện khi Từ
Máy chủ: gnudb.org hoặc TrackType.org được chọn. Nghệ sĩ và tên album để tìm kiếm
có thể được nhập vào hai trường trên cùng, các anbom phù hợp với truy vấn sẽ được
hiển thị khi Tìm được nhấp và kết quả từ www.gnudb.org[8] được nhận.
Nhập dữ liệu bản nhạc cho một album được thực hiện bằng cách nhấp đúp vào album đó trong
danh sách. Có thể chọn máy chủ Freedb.org để nhập từ đó cũng như đường dẫn CGI.
Dữ liệu đã nhập được hiển thị trong bảng xem trước của hộp thoại nhập. Khi nào
hài lòng với các bản nhạc được hiển thị, chúng có thể được nhập bằng cách kết thúc quá trình nhập
hộp thoại với OK.

Tìm kiếm trên máy chủ Discogs có thể được thực hiện bằng Discogs. Như trong gnudb.org
, bạn có thể nhập nghệ sĩ và album, sau đó chọn từ danh sách các bản phát hành. Nếu như
Thẻ tiêu chuẩn được đánh dấu, thông tin tiêu chuẩn được nhập, ví dụ: nghệ sĩ, album và
chức vụ. Nếu Thẻ bổ sung được đánh dấu, thông tin khác sẽ được nhập nếu có, ví dụ:
người biểu diễn, người sắp xếp, hoặc nhà xuất bản. Nếu Ảnh bìa được đánh dấu, ảnh bìa sẽ là
đã tải xuống nếu có.

Tìm kiếm trên Amazon có thể được thực hiện bằng Amazon. Như trong hộp thoại gnudb.org, bạn có thể
nhập nghệ sĩ và album, sau đó chọn từ danh sách các bản phát hành. Nếu Thẻ bổ sung là
được đánh dấu, nhiều thông tin hơn được nhập nếu có, ví dụ như người biểu diễn, người sắp xếp, hoặc
nhà xuất bản. Nếu Ảnh bìa được đánh dấu, ảnh bìa sẽ được tải xuống nếu có.

Bạn có thể tìm kiếm theo cách tương tự trong cơ sở dữ liệu phát hành của MusicBrainz bằng Từ
Bản phát hành MusicBrainz. Quy trình làm việc giống như được mô tả cho Từ gnudb.org.

Có thể nhập từ máy chủ MusicBrainz bằng hộp thoại xuất hiện khi Từ
Vân tay MusicBrainz được chọn. Máy chủ có thể được chọn như trong giải phóngb
hộp thoại nhập. Dưới đây là bảng hiển thị dữ liệu đường đi đã nhập. Cột bên phải
hiển thị trạng thái của truy vấn MusicBrainz, bắt đầu bằng "Đang chờ xử lý" khi hộp thoại
được mở. Sau đó, dấu vân tay được tra cứu và nếu nó không mang lại kết quả,
tra cứu khác bằng cách sử dụng các thẻ trong tệp được thử. Vì vậy, nó có thể hữu ích cho một
truy vấn MusicBrainz thành công để lưu trữ thông tin đã biết (ví dụ: nghệ sĩ và album) trong
trước khi nhập. Nếu một kết quả được tìm thấy, tìm kiếm sẽ kết thúc ở trạng thái
"Đã nhận dạng", nếu không thì không tìm thấy gì hoặc nhiều kết quả không rõ ràng và một trong các
chúng phải được người dùng lựa chọn. OK và Áp dụng sử dụng dữ liệu đã nhập, Hủy
đóng hộp thoại. Việc đóng cửa có thể mất một lúc vì toàn bộ bộ máy MusicBrainz
đã được đóng cửa.

Để nhập dữ liệu dạng văn bản, Từ Tệp / Bảng tạm sẽ mở ra một hộp số con, trong đó một số
định dạng nhập cấu hình sẵn có sẵn. Hai phần đầu tiên, "CSV chưa được trích dẫn" và "CSV
được trích dẫn "có thể được sử dụng để nhập dữ liệu đã được xuất bằng hộp thoại Xuất. CSV
dữ liệu có thể được chỉnh sửa bằng bảng tính và sẽ được viết bằng các tab làm dấu phân cách.
Sau đó, có thể nhập bằng cách sử dụng "CSV được trích dẫn", linh hoạt hơn "CSV
không được trích dẫn ". Tuy nhiên, các trường của nó không được chứa bất kỳ dấu ngoặc kép nào. Nếu bạn chỉ xuất
từ Kid3 và nhập sau đó, "CSV chưa được trích dẫn" có thể được sử dụng làm định dạng đơn giản cho việc này
mục đích. Lưu ý rằng cũng có các lệnh "Xuất CSV" và "Nhập CSV" trong
menu ngữ cảnh của danh sách tệp, sử dụng tập lệnh để xuất và nhập dữ liệu CSV trong
một cách đầy đủ, mạnh mẽ và linh hoạt hơn.

Định dạng tiếp theo, "văn bản HTML được giải phóng", có thể được sử dụng để sao chép thông tin từ một trang HTML
of Liberationb.org[9]. Tìm kiếm một anbom trong freedb và nếu thông tin mong muốn là
hiển thị trong trình duyệt web, sao chép nội dung vào khay nhớ tạm. Sau đó nhấp vào Từ
Nút khay nhớ tạm và các bản nhạc đã nhập sẽ được hiển thị trong bảng xem trước tại
đầu hộp thoại. Nếu bạn hài lòng với dữ liệu đã nhập, hãy chấm dứt hộp thoại
với OK, sẽ chèn dữ liệu vào các thẻ của thư mục hiện tại. Các
đích (Thẻ 1, Thẻ 2 hoặc Thẻ 1 và Thẻ 2) có thể được chọn bằng một hộp tổ hợp. Các
các tệp trong thư mục hiện tại phải theo đúng thứ tự để lấy thẻ của chúng
giao. Đây là trường hợp nếu chúng được đánh số.

Có thể sử dụng định dạng nhập được định cấu hình trước tiếp theo, "nguồn HTML giải phóng", nếu dữ liệu
có sẵn dưới dạng tài liệu HTML. Có thể nhập bằng nút Từ Tệp, nút này
mở bộ chọn tệp hoặc sao chép nội dung của nó từ trình chỉnh sửa rồi nhập từ
khay nhớ tạm. Định dạng này có thể hữu ích cho việc nhập ngoại tuyến, mặc dù tài liệu HTML
cũng có thể được mở trong trình duyệt và sau đó được nhập ở định dạng đầu tiên thông qua
clipboard.

Có nhiều định dạng được định cấu hình sẵn hơn, ví dụ như "Thời gian tiêu đề theo dõi", có sẵn. Một tùy chỉnh trống rỗng
định dạng có thể được tạo bằng Thêm để người dùng thiết lập. Hai dòng bên dưới tên định dạng
có thể được đặt bằng một biểu thức chính quy để nắm bắt các trường từ văn bản nhập. Các
biểu thức chính quy đầu tiên sẽ được phân tích cú pháp một lần cho mỗi tài liệu để thu thập dữ liệu cho mỗi album
chẳng hạn như nghệ sĩ, album, năm và thể loại. Dòng thứ hai được cố gắng so khớp từ
bắt đầu của tài liệu đến cuối để lấy dữ liệu theo dõi, thường là số và tiêu đề. Các
biểu thức chính quy bao gồm tất cả các tính năng do Qt cung cấp, đây là hầu hết những gì
Perl cung cấp. Các cấu trúc Bracketing "(..)" tạo bộ đệm chụp cho các trường để
nhập và được đặt trước bởi các mã cụ thể của Kid3 để chỉ định trường nào cần chụp. Các
các mã giống như được sử dụng cho định dạng tên tệp, bên cạnh các mã được liệt kê bên dưới,
bất kỳ tên khung nào đều có thể:

·% S% {title} Title (Bài hát)

·% A% {artist} Nghệ sĩ

·% L% {album} Anbom

·% C% {comment} Nhận xét

·% Y% {year} năm

·% T% {track} Theo dõi

·% G% {category} Thể loại

·% D% {thời lượng} Thời lượng

Ví dụ: một biểu thức chính quy theo dõi (dòng thứ hai) để nhập từ danh sách phát .m3u
có thể là "% {track} (\ d +) \ s +% {title} (\ S [^ \ r \ n] *) \. mp3 [\ r \ n]". Tất cả các định dạng có thể được thay đổi
bằng cách chỉnh sửa biểu thức chính quy và tên, sau đó nhấp vào Lưu cài đặt. Họ
sẽ được lưu trữ trong tệp kid3rc trong thư mục cấu hình. Tệp này có thể là
được chỉnh sửa trực tiếp để có nhiều định dạng nhập hơn hoặc nó có thể bị xóa để hoàn nguyên về
các định dạng mặc định. Có thể xóa các định dạng bằng cách sử dụng Xóa.

Độ chính xác cho thấy ước tính về mức độ tốt của thông tin được nhập khớp với thông tin đã cho
các bản nhạc. Nó sử dụng thời lượng theo dõi hoặc tên tệp để tính toán mức độ giống nhau trong
phần trăm. Ảnh bìa hiển thị URL của ảnh bìa album sẽ được tải xuống.

Để kiểm tra xem các bản nhạc đã nhập có khớp với tập hợp tệp hiện tại hay không, thời lượng của
các bản nhạc đã nhập có thể được so sánh với thời lượng của tệp. Tùy chọn này có thể được
được bật bằng hộp kiểm Kiểm tra chênh lệch thời gian tối đa cho phép và tối đa
chênh lệch thời gian dung nạp có thể được thiết lập trong vài giây. Nếu độ dài không khớp là
được phát hiện, chiều dài được hiển thị với nền màu đỏ trong bảng xem trước.

Các tệp được sắp xếp thứ tự khác với các bản nhạc đã nhập, các bản nhạc được chỉ định của chúng
phải được thay đổi. Tác vụ này có thể được thực hiện dễ dàng bằng cách sử dụng Độ dài khớp với các nút,
Theo dõi và Tiêu đề, sẽ sắp xếp lại thứ tự các bản nhạc theo trường tương ứng.
Để sửa các bài tập theo cách thủ công, bạn có thể kéo một bản nhạc bằng nút chuột trái
và giữ phím Ctrl, rồi thả vào vị trí mới.

Khi hộp thoại nhập được mở, nó chứa nội dung thực của các thẻ. Tag
có thể chọn loại (Thẻ 1, Thẻ 2, Thẻ 1 và Thẻ 2) bằng cách sử dụng hộp kết hợp Đích.
Nút ở bên phải của hộp tổ hợp này có thể được sử dụng để hoàn nguyên bảng về
nội dung hiện tại của các thẻ. Các hộp kiểm trong cột bảng đầu tiên có thể được sử dụng để
chọn các bản nhạc được nhập. Điều này có thể hữu ích nếu một thư mục chứa
các bản nhạc của cả hai đĩa CD của một CD đôi và chỉ các bản nhạc của CD thứ hai mới phải
nhập khẩu.

Để xác định các bản nhạc được nhập, có thể hiển thị tên tệp hoặc
đường dẫn đầy đủ đến các tệp bằng menu ngữ cảnh của tiêu đề bảng. Các giá trị trong
bảng nhập có thể được chỉnh sửa. Nút hoàn nguyên ở bên phải của Điểm đến
hộp tổ hợp có thể được sử dụng để khôi phục nội dung của các thẻ, điều này cũng có thể hữu ích
sau khi thay đổi Điểm đến.

Hầu hết tất cả các hộp thoại đều có nút Lưu Cài đặt, nút này có thể được sử dụng để lưu trữ
cài đặt cụ thể của hộp thoại và kích thước cửa sổ liên tục.

Từ Thẻ dẫn đến một ô số phụ để đặt các khung thẻ từ nội dung của thẻ khác
khung. Điều này có thể được sử dụng để sao chép thông tin giữa các thẻ hoặc trích xuất một phần
từ một khung và chèn nó vào một khung khác.

Như trong quá trình nhập từ tệp / khay nhớ tạm, có các định dạng có thể cấu hình tự do để thực hiện
các hoạt động khác nhau. Các định dạng đã được định cấu hình sẵn để sao chép giá trị Album sang
Nghệ sĩ album, Nhà soạn nhạc hoặc Nhạc trưởng và để trích xuất Số bản nhạc từ các trường Tiêu đề
chứa một số. Ngoài ra còn có một định dạng để trích xuất Phụ đề từ Tiêu đề
trường.

Ví dụ sau giải thích cách thêm định dạng tùy chỉnh, định dạng này sẽ đặt thông tin
từ trường Phụ đề cũng trong trường Nhận xét. Tạo một định dạng mới bằng cách sử dụng Thêm và
đặt tên mới, ví dụ: "Phụ đề cho Bình luận". Sau đó, nhập "% {subtitle}" vào Nguồn và
"% {comment} (. *)" để Trích xuất và nhấp vào Lưu Cài đặt.

Biểu thức trong Nguồn có thể chứa mã định dạng cho các khung thẻ tùy ý, nhiều
mã có thể được sử dụng để kết hợp nội dung từ các khung khác nhau. Đối với mỗi bản nhạc, một
văn bản được tạo từ các thẻ của nó bằng cách sử dụng định dạng Nguồn và biểu thức chính quy
từ Trích xuất được áp dụng cho văn bản này để đặt giá trị mới cho các thẻ. Định dạng mã
được sử dụng trước dấu ngoặc đơn chụp để chỉ định khung thẻ nơi chụp
văn bản sẽ được lưu trữ. Nó hoạt động giống như cách nhập từ tệp / khay nhớ tạm.

Tệp → Nhập từ gnudb.org ...
Nhập từ máy chủ freedb.org bằng cách sử dụng tìm kiếm album gnudb.org. Mục menu này sẽ mở ra
hộp thoại nhập giống như Nhập ..., nhưng mở trực tiếp hộp thoại gnudb.org.

Tệp → Nhập từ TrackType.org ...
Nhập từ máy chủ TrackType.org. Mục menu này sẽ mở ra cùng một hộp thoại nhập với
Nhập ..., nhưng mở trực tiếp hộp thoại TrackType.org.

Tệp → Nhập từ đĩa ...
Nhập từ máy chủ Discogs. Mục menu này sẽ mở ra cùng một hộp thoại nhập với
Nhập ..., nhưng mở trực tiếp hộp thoại Từ đĩa.

Tệp → Nhập từ Amazon ...
Nhập từ Amazon. Mục menu này sẽ mở ra cùng một hộp thoại nhập với Nhập ..., nhưng
mở trực tiếp hộp thoại Từ Amazon.

Tệp → Nhập từ Bản phát hành MusicBrainz ...
Nhập từ cơ sở dữ liệu phát hành MusicBrainz. Mục menu này mở cùng một lần nhập
hộp thoại dưới dạng Nhập ..., nhưng mở trực tiếp hộp thoại Bản phát hành từ MusicBrainz.

Tệp → Nhập từ Vân tay MusicBrainz ...
Nhập từ máy chủ MusicBrainz. Mục menu này sẽ mở ra cùng một hộp thoại nhập với
Nhập ..., nhưng mở trực tiếp hộp thoại Từ vân tay từ MusicBrainz.

Tệp → Nhập tự động ...
Nhập tự động cho phép một người nhập thông tin cho nhiều album từ các trang web khác nhau
dịch vụ. Nếu các thư mục được chọn trong danh sách tệp, hãy theo dõi dữ liệu cho mục đã chọn
thư mục sẽ được nhập. Nếu không có thư mục nào được chọn, tất cả các thư mục trong tệp
danh sách sẽ được nhập.

Có thể chọn loại thẻ (Thẻ 1, Thẻ 2, Thẻ 1 và Thẻ 2) bằng cách sử dụng Đích
hộp kết hợp.

Hồ sơ xác định máy chủ nào sẽ được liên hệ để tìm nạp thông tin album. Một vài
cấu hình được xác định trước (Tất cả, MusicBrainz, Discogs, Cover Art), cấu hình tùy chỉnh có thể
được thêm bằng cách sử dụng nút Thêm ở bên phải của hộp tổ hợp Hồ sơ.

Bảng bên dưới hiển thị các máy chủ sẽ được sử dụng khi nhập thông tin album
bằng cách sử dụng hồ sơ đã chọn. Quá trình nhập anbom kết thúc nếu tất cả
thông tin bắt buộc đã được tìm thấy, vì vậy thứ tự của các hàng trong bảng là
quan trọng. Nó có thể được thay đổi bằng cách sử dụng các nút Di chuyển lên và Di chuyển xuống. Chỉnh sửa có thể được
được sử dụng để thay đổi một mục nhập hiện có. Lựa chọn Máy chủ cung cấp các máy chủ giống như có thể
được sử dụng trong các chức năng nhập. Thẻ tiêu chuẩn, Thẻ bổ sung, Ảnh bìa xác định
thông tin sẽ được lấy từ máy chủ. Cuối cùng, Độ chính xác là
độ chính xác tối thiểu phải đạt được để chấp nhận dữ liệu đã nhập. Nếu độ chính xác
không đủ, máy chủ tiếp theo trong danh sách sẽ được thử. Cùng một hộp thoại chứa
thuộc tính máy chủ xuất hiện khi nhấp vào Thêm để thêm mục nhập máy chủ mới. Hiện có
các mục nhập có thể được xóa bằng cách sử dụng Xóa.

Để khởi chạy nhập hàng loạt tự động với cấu hình đã chọn, hãy nhấp vào Bắt đầu. Thông tin chi tiết
về quá trình nhập đang chạy được hiển thị ở đầu hộp thoại. Quá trình có thể được
đã hủy bỏ bằng nút Hủy bỏ.

Tệp → Duyệt Ảnh bìa ...
Hộp thoại Browse Cover Art giúp tìm ảnh bìa album. Nghệ sĩ / Album đã được lấp đầy
từ các thẻ nếu có thể. Nguồn cung cấp nhiều loại trang web với bìa album.
Bạn có thể tìm thấy URL chứa nghệ sĩ và album dưới dạng thông số bên dưới tên. Được mã hóa URL
các giá trị cho nghệ sĩ và album có thể được chèn bằng cách sử dụng % u {artist} và % u {album}, khác
cũng có thể có giá trị từ các thẻ, như được mô tả trong Định cấu hình Kid3, Hành động của người dùng.
Có thể nhập thêm nhiều nguồn sau mục nhập "Nguồn tùy chỉnh" bằng cách thay thế "Tùy chỉnh
Nguồn "với tên của nguồn, nhấn Enter, sau đó chèn URL và cuối cùng
nhấn Lưu Cài đặt. Lệnh trình duyệt kết quả được hiển thị ở đầu
và có thể được bắt đầu bằng cách nhấp vào Duyệt qua. Trình duyệt, có thể được định cấu hình trong
cài đặt, được bắt đầu với nguồn đã chọn. Sau đó có thể kéo ảnh bìa
từ trình duyệt vào cửa sổ Kid3 và sẽ được đặt trong khung ảnh của
các tệp đã chọn.

Bởi vì không phải tất cả các trình duyệt đều hỗ trợ drag'n'drop hình ảnh và hình ảnh trên các trang web
thường có một URL, trong những trường hợp như vậy Kid3 sẽ nhận URL chứ không phải hình ảnh. Nếu
URL trỏ đến một hình ảnh, nó sẽ được tải xuống. Tuy nhiên, nếu URL đề cập đến một số
tài nguyên web khác, nó phải được dịch sang hình ảnh tương ứng. Như là
ánh xạ được xác định trong trích xuất URL bảng. Cột bên trái Khớp chứa một
biểu thức chính quy được so sánh với URL. Nếu nó phù hợp,
các biểu thức trong ngoặc đơn được chèn vào mẫu của URL Hình ảnh bên phải
(tại các vị trí được đánh dấu bằng \ 1, v.v.). Biểu thức chính quy được thay thế
chứa URL của hình ảnh. Bằng cách này có nghĩa là ảnh bìa có thể được nhập từ Amazon,
Google Hình ảnh, v.v. bằng cách sử dụng drag'n'drop. Nó cũng có thể xác định của riêng bạn
ánh xạ.

Tệp → Xuất ...
Hộp thoại Xuất được sử dụng để lưu trữ dữ liệu từ các thẻ trong tệp hoặc khay nhớ tạm. Các
trình chỉnh sửa ở trên cùng hiển thị bản xem trước của dữ liệu cần xuất. Nếu dữ liệu xuất chứa
các ký tự lập bảng, việc xuất được hiển thị trong một bảng. Dữ liệu sẽ được tạo
từ các thẻ trong thư mục hiện tại theo định dạng đã cấu hình.

Cài đặt định dạng tương tự như trong hộp thoại Nhập: Trường trên cùng chứa
tiêu đề (ví dụ: "CSV chưa được trích dẫn"), theo sau là tiêu đề, sẽ được tạo tại
phần đầu của tệp. Dữ liệu theo dõi sau đây; nó được sử dụng cho mọi bản nhạc. Cuối cùng,
đoạn giới thiệu có thể được sử dụng để tạo ra một số văn bản hoàn thiện.

Các trường định dạng không chứa các biểu thức chính quy như trong hộp thoại Nhập, nhưng chỉ
đầu ra các biểu thức định dạng với% -expressions đặc biệt, sẽ được thay thế bằng các giá trị
từ các thẻ. Toàn bộ hoạt động giống như định dạng tên tệp và các mã giống nhau
được sử dụng cộng với một số mã bổ sung. Không chỉ các mã được liệt kê bên dưới mà tất cả khung thẻ
tên có thể được sử dụng.

·% S% {title} Title (Bài hát)

·% A% {artist} Nghệ sĩ

·% L% {album} Anbom

·% C% {comment} Nhận xét

·% Y% {year} năm

·% T% {track} Theo dõi (ví dụ: 01)

·% T% {track.n} Theo dõi với chiều rộng trường n (ví dụ: 001 cho% {track.3})

·% T% {tracknumber} Theo dõi (không có số 1 ở đầu, ví dụ: XNUMX)

·% G% {category} Thể loại

·% F% {file} Tên tệp

·% P% {filepath} Đường dẫn

·% U% {url} URL

·% D% {thời lượng} Thời lượng tính bằng phút: giây

·% D% {giây} Thời lượng tính bằng giây

·% N% {rãnh} Số lượng bản nhạc của album

·% E% {extension} Phần mở rộng tệp

·% O% {tag1} Định dạng của thẻ 1 (ID3v1.1 hoặc trống nếu không tồn tại)

·% O% {tag2} Định dạng của thẻ 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF hoặc trống nếu không tồn tại)

·% B% {bitrate} Tốc độ bit tính bằng kbit / s

·% V% {vbr} VBR hoặc trống (chỉ dành cho ID3v2.3 với id3lib)

·% R% {samplerate} Tốc độ lấy mẫu tính bằng Hz

·% M% {mode} Chế độ kênh (Âm thanh nổi hoặc Âm thanh nổi chung)

·% H% {kênh} Số kênh (1 hoặc 2)

·% K% {codec} Codec (ví dụ: MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

Một số định dạng được xác định trước. "CSV chưa được trích dẫn" phân tách các trường bằng các tab. Dữ liệu trong
định dạng này có thể được nhập lại vào Kid3 bằng cách sử dụng định dạng nhập tương tự
Tên. "CSV được trích dẫn" cũng bao quanh các trường bằng dấu ngoặc kép, điều này giúp giảm bớt
nhập vào các ứng dụng bảng tính. Tuy nhiên, các trường không được chứa bất kỳ
dấu ngoặc kép khi định dạng này được sử dụng. "M3U mở rộng" và "PLS mở rộng" tạo danh sách phát
với các thuộc tính mở rộng và tên đường dẫn tuyệt đối. "HTML" có thể được sử dụng để tạo
Trang HTML với các siêu liên kết đến các tuyến đường. "Kover XML" tạo một tệp có thể
được nhập bởi chương trình in bìa Kover. "Chi tiết kỹ thuật" cung cấp thông tin
về tốc độ bit, tốc độ mẫu, kênh, v.v. Cuối cùng, "Định dạng tùy chỉnh" được để trống cho
định nghĩa của một định dạng tùy chỉnh. Bạn có thể xác định nhiều định dạng hơn của riêng mình bằng cách thêm các dòng
trong tệp kid3rc trong thư mục cấu hình. Các định dạng khác có thể được điều chỉnh để
bạn cần.

Nguồn của các thẻ để tạo dữ liệu xuất (Thẻ 1 hoặc Thẻ 2) có thể được chọn
với một hộp kết hợp. Đẩy vào tệp hoặc vào khay nhớ tạm lưu trữ dữ liệu trong tệp hoặc trên
khay nhớ tạm. OK và Hủy đóng hộp thoại, trong khi OK chấp nhận hộp thoại hiện tại
cài đặt.

Tệp → Tạo danh sách phát
Tạo danh sách phát. Định dạng và nội dung của danh sách phát có thể được thiết lập bởi nhiều
tùy chọn.

Tên của danh sách phát có thể giống với tên thư mục hoặc sử dụng Định dạng có giá trị
từ các thẻ, ví dụ: "% {artist} -% {album}" để có tên nghệ sĩ và album trong
tên tệp danh sách phát. Các mã định dạng giống như đối với Xuất. Phần mở rộng phụ thuộc
trên định dạng danh sách phát.

Vị trí của danh sách phát đã tạo được xác định bằng cách lựa chọn Tạo trong
hộp kết hợp.

Thư mục hiện tại
Danh sách phát được tạo trong thư mục hiện tại và chỉ chứa các tệp của
thư mục hiện tại.

Mọi thư mục
Danh sách phát được tạo trong mọi thư mục chứa các tệp được liệt kê và mỗi
danh sách phát chứa các tệp của thư mục đó.

Thư mục cấp cao nhất
Chỉ một danh sách phát được tạo trong thư mục cấp cao nhất (tức là thư mục của
danh sách tệp) và nó chứa các tệp được liệt kê của thư mục cấp cao nhất và tất cả
các thư mục con của nó.

Định dạng của danh sách phát có thể là M3U, PLS hoặc XSPF.

Nếu Chỉ bao gồm các tệp đã chọn được chọn, thì chỉ các tệp đã chọn sẽ được
có trong danh sách phát. Nếu một thư mục được chọn, tất cả các tệp của nó sẽ được chọn.
Nếu hộp kiểm này không được kích hoạt, tất cả các tệp âm thanh sẽ được đưa vào danh sách phát.

Sắp xếp theo tên tệp chọn trường hợp thông thường các tệp được sắp xếp theo tên tệp.
Với trường Sắp xếp theo thẻ, có thể sắp xếp theo chuỗi định dạng với các giá trị từ thẻ
lĩnh vực. Ví dụ: "% {track.3}" có thể được sử dụng để sắp xếp theo số bản nhạc (".3" là
được sử dụng để lấy ba chữ số với các số không ở đầu vì các chuỗi được sử dụng để sắp xếp). Nó
cũng có thể sử dụng nhiều trường, ví dụ: "% {category}% {year}" để sắp xếp bằng cách sử dụng một chuỗi
bao gồm thể loại và năm.

Các mục nhập danh sách phát sẽ có đường dẫn tệp tương đối hoặc tuyệt đối tùy thuộc vào việc
Sử dụng đường dẫn tương đối cho các tệp trong danh sách phát hoặc Sử dụng đường dẫn đầy đủ cho các tệp trong danh sách phát được thiết lập.

Khi chỉ ghi danh sách các tệp được đặt, danh sách phát sẽ chỉ chứa các đường dẫn đến
các tập tin. Để tạo danh sách phát mở rộng với thông tin bổ sung, một chuỗi định dạng
có thể được thiết lập bằng cách sử dụng điều khiển Viết thông tin.

Tệp → Thoát (Ctrl + Q)
Thoát ứng dụng.

Sản phẩm Chỉnh sửa Menu
Chỉnh sửa → Chọn tất cả (Alt + A)
Chọn tất cả các tệp.

Chỉnh sửa → Bỏ chọn (Ctrl + Shift + A)
Bỏ chọn tất cả các tệp.

Chỉnh sửa → Chọn Tất cả trong Thư mục
Chọn tất cả các tệp của thư mục hiện tại.

Chỉnh sửa → Tệp trước (Alt + Up)
Chọn tệp trước đó.

Chỉnh sửa → Tệp tiếp theo (Alt + Xuống)
Chọn tệp tiếp theo.

Chỉnh sửa → Tìm ... (Ctrl + F)
Tìm các chuỗi trong tên tệp và thẻ. Hộp thoại Tìm là một tập hợp con của
Hộp thoại thay thế, được mô tả bên dưới.

Chỉnh sửa → Thay thế ... (Ctrl + R)
Hàm này mở một hộp thoại để tìm và thay thế các chuỗi trong tên tệp và
các thẻ. Tập hợp các khung nơi thực hiện tìm kiếm có thể bị hạn chế bởi
hủy kích hoạt hộp kiểm Chọn tất cả và chọn các khung sẽ được tìm kiếm.
Ngoài ra còn có các tùy chọn tìm kiếm có sẵn để tìm kiếm ngược lại, phân biệt chữ hoa chữ thường và
sử dụng biểu thức chính quy.

Tùy thuộc vào số lượng tệp, việc tìm kiếm có thể mất một khoảng thời gian, do đó có thể
bị hủy bỏ bằng cách đóng hộp thoại.

Sản phẩm CÔNG CỤ Menu
Công cụ → Áp dụng định dạng tên tệp
Khi Định dạng trong khi chỉnh sửa bị tắt đối với định dạng tên tệp trong cấu hình
, mục menu này có thể được sử dụng để áp dụng định dạng đã định cấu hình cho tên của
các tệp đã chọn. Điều này cũng có thể được sử dụng để kiểm tra xem tên tệp có phù hợp với
định dạng đã định cấu hình bằng cách áp dụng định dạng cho tất cả các tệp đã lưu và sau đó kiểm tra nếu có
các tệp đã bị thay đổi (và do đó được đánh dấu bằng ký hiệu đĩa trong hộp danh sách tệp).

Công cụ → Áp dụng định dạng thẻ
Khi Định dạng trong khi chỉnh sửa bị tắt đối với định dạng thẻ trong cấu hình
, mục menu này có thể được sử dụng để áp dụng định dạng đã định cấu hình cho các thẻ của
các tệp đã chọn. Điều này cũng có thể được sử dụng để kiểm tra xem các thẻ có phù hợp với
định dạng đã định cấu hình bằng cách áp dụng định dạng cho tất cả các tệp đã lưu và sau đó kiểm tra nếu có
các tệp đã bị thay đổi (và do đó được đánh dấu bằng ký hiệu đĩa trong hộp danh sách tệp).

Công cụ → Áp dụng mã hóa văn bản
Đặt mã hóa Văn bản đã chọn trong Cài đặt / Định cấu hình Kid3 ... / Thẻ / Thẻ 2 cho tất cả
các tệp đã chọn. Nếu UTF8 được chọn, UTF16 sẽ được sử dụng cho thẻ ID3v2.3.0 vì
UTF8 không được hỗ trợ cho định dạng này.

Công cụ → Đổi tên thư mục ...
Hộp thoại này cung cấp khả năng tự động đổi tên tệp hiện đang mở
thư mục theo các thẻ trong tệp. Một số định dạng được định cấu hình trước để
bao gồm thông tin về nghệ sĩ, album và năm trong tên danh bạ. Nó cũng là
có thể đặt định dạng tùy chỉnh, các mã đặc biệt sau được sử dụng để chèn thẻ
giá trị vào tên thư mục:

·% S% {title} Title (Bài hát)

·% A% {artist} Nghệ sĩ

·% L% {album} Anbom

·% C% {comment} Nhận xét

·% Y% {year} năm

·% T% {track} Theo dõi (ví dụ: 01)

·% T% {track.n} Theo dõi với chiều rộng trường n (ví dụ: 001 cho% {track.3})

·% T% {tracknumber} Theo dõi (không có số 1 ở đầu, ví dụ: XNUMX)

·% G% {category} Thể loại

Nếu tìm thấy dấu phân tách thư mục "/" trong định dạng, nhiều thư mục sẽ được tạo.
Nếu bạn muốn tạo một thư mục mới thay vì đổi tên thư mục hiện tại,
chọn Tạo Thư mục thay vì Đổi tên Thư mục. Nguồn của thông tin thẻ
có thể được chọn giữa Từ thẻ 1 và Thẻ 2, Từ thẻ 1 và Từ thẻ 2. Bản xem trước cho
thao tác đổi tên được thực hiện trên tệp đầu tiên có thể được nhìn thấy trong Từ và Đến
các phần của hộp thoại.

Nhiều thư mục có thể được đổi tên bằng cách chọn chúng.

Công cụ → Theo dõi số ...
Nếu số theo dõi trong các thẻ không được đặt hoặc có giá trị sai, chức năng này
có thể đánh số các bản nhạc tự động theo thứ tự tăng dần. Số bắt đầu có thể được đặt trong
hộp thoại. Nếu chỉ một phần của các bản nhạc phải được đánh số, thì chúng phải được chọn.

Khi Tổng số bản nhạc được chọn, số lượng bản nhạc cũng sẽ được đặt trong
thẻ.

Có thể đánh số các bản nhạc trên nhiều thư mục. Các thư mục phải được
được mở rộng và được chọn.

Nếu Đặt lại bộ đếm cho từng thư mục được chọn, việc đánh số bản nhạc sẽ được khởi động lại với
số nhất định cho mỗi thư mục khi nhiều thư mục được chọn.

Hộp thoại số bản nhạc cũng có thể được sử dụng để định dạng số bản nhạc hiện có mà không
thay đổi các giá trị khi hộp kiểm bên trái thành số Bắt đầu bị vô hiệu hóa. Tổng số
số lượng bản nhạc sẽ được thêm vào nếu hộp kiểm tương ứng đang hoạt động, có thể là
được sử dụng để đặt tổng số cho tất cả các bản nhạc đã chọn. Nếu chỉ định dạng của hiện tại
số là mong muốn, hộp kiểm này cũng phải được hủy kích hoạt.

Công cụ → Bộ lọc ...
Bộ lọc có thể được sử dụng để chỉ hiển thị những tệp phù hợp với các tiêu chí nhất định. Cái này
rất hữu ích nếu bạn muốn tổ chức một bộ sưu tập lớn và chỉ chỉnh sửa những tệp
không có trong chương trình mong muốn. Biểu thức xác định tệp nào sẽ hiển thị sử dụng
mã định dạng giống nhau được sử dụng trong định dạng tên tệp, nhập và xuất.

·% S% {title} Title (Bài hát)

·% A% {artist} Nghệ sĩ

·% L% {album} Anbom

·% C% {comment} Nhận xét

·% Y% {year} năm

·% T% {track} Theo dõi (ví dụ: 01)

·% T% {track.n} Theo dõi với chiều rộng trường n (ví dụ: 001 cho% {track.3})

·% T% {tracknumber} Theo dõi (không có số 1 ở đầu, ví dụ: XNUMX)

·% G% {category} Thể loại

·% F% {file} Tên tệp

·% P% {filepath} Đường dẫn tuyệt đối đến tệp

·% E% {extension} Phần mở rộng tệp

·% O% {tag1} Định dạng của thẻ 1 (ID3v1.1 hoặc trống nếu không tồn tại)

·% O% {tag2} Định dạng của thẻ 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF hoặc trống nếu không tồn tại)

·% B% {bitrate} Tốc độ bit tính bằng kbit / s

·% V% {vbr} VBR hoặc trống (chỉ dành cho ID3v2.3 với id3lib)

·% R% {samplerate} Tốc độ lấy mẫu tính bằng Hz

·% M% {mode} Chế độ kênh (Âm thanh nổi hoặc Âm thanh nổi chung)

·% H% {kênh} Số kênh (1 hoặc 2)

·% K% {codec} Codec (ví dụ: MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

·% 1a% 1 {artist}, ... Sử dụng tiền tố 1 để nhận các giá trị của thẻ 1

·% 2a% 2 {artist}, ... Sử dụng tiền tố 2 để nhận các giá trị của thẻ 2

Các mã này được thay thế bằng các giá trị cho tệp và các chuỗi kết quả có thể
được so sánh với các hoạt động sau:

· S1 bằng s2: đúng nếu s1 và s2 bằng nhau.

· S1 chứa s2: true nếu s1 chứa s2, tức là s2 là một chuỗi con của s1.

· S khớp với re: true nếu s khớp với biểu thức chính quy re.

Biểu thức đúng được thay thế bằng 1, sai bằng 0. Giá trị đúng được biểu thị bằng 1,
giá trị true, on và yes, false bằng 0, false, off và no. Các phép toán boolean không,
và, hoặc (theo thứ tự ưu tiên này) và có thể được nhóm bằng dấu ngoặc đơn.

Một số quy tắc bộ lọc được xác định trước và có thể dùng làm ví dụ cho các biểu thức của riêng bạn:

Tất cả
Khi danh sách tệp được lọc - điều này được hiển thị bằng "[lọc]" trong tiêu đề cửa sổ
- và tất cả các tệp sẽ được hiển thị lại, quá trình lọc có thể được hoàn nguyên bằng cách sử dụng
lọc. Nó sử dụng một biểu thức trống, nhưng một giá trị true sẽ có tác dụng tương tự.

Tên tệp không khớp thẻ
không (%{đường dẫn tập tin} chứa "%{họa sĩ} - % {album} /% {track} %{chức vụ}")

Kiểm tra xem đường dẫn tệp có phù hợp với định dạng tên tệp hay không. Quy tắc này là
tự động điều chỉnh nếu định dạng tên tệp thay đổi.

Không có thẻ 1
% {tag1} bằng ""

Chỉ hiển thị các tệp không có thẻ 1.

Không có thẻ 2
% {tag2} bằng ""

Chỉ hiển thị các tệp không có thẻ 2.

Thẻ ID3v2.3.0
% {tag2} bằng "ID3v2.3.0"

Chỉ hiển thị các tệp có thẻ ID3v2.3.0.

Thẻ ID3v2.4.0
% {tag2} bằng "ID3v2.4.0"

Chỉ hiển thị các tệp có thẻ ID3v2.4.0.

Thẻ 1! = Thẻ 2
không (% 1 {title} bằng % 2 {title} và % 1 {anbom} bằng % 2 {anbom} và % 1 {nghệ sĩ}
bằng % 2 {nghệ sĩ} và %1 bình luận} bằng %2 bình luận} và %1 năm} bằng %2 năm}
và % 1 {track} bằng % 2 {track} và % 1 {thể loại} bằng % 2 {thể loại})

Hiển thị các tệp có sự khác biệt giữa thẻ 1 và thẻ2.

Thẻ 1 == Thẻ 2
% 1 {title} bằng % 2 {title} và % 1 {anbom} bằng % 2 {anbom} và % 1 {nghệ sĩ} bằng
% 2 {nghệ sĩ} và %1 bình luận} bằng %2 bình luận} và %1 năm} bằng %2 năm} và
% 1 {track} bằng % 2 {track} và % 1 {thể loại} bằng % 2 {thể loại}

Hiển thị các tệp có thẻ 1 và thẻ 2 giống hệt nhau.

Không đầy đủ
%{chức vụ} bằng "" or %{họa sĩ} bằng "" or % {anbom} bằng "" or %{năm} bằng
"" or % {tracknumber} bằng "" or % {thể loại} bằng ""

Hiển thị các tệp có giá trị trống trong các thẻ tiêu chuẩn (tiêu đề, nghệ sĩ, album, ngày tháng,
số bản nhạc, thể loại).

Không có ảnh
%{bức ảnh} bằng ""

Chỉ hiển thị các tệp không có hình ảnh.

Bộ lọc tùy chỉnh
Để thêm bộ lọc của riêng bạn, hãy chọn mục nhập này. Ví dụ, nếu bạn muốn có một
bộ lọc cho các nghệ sĩ bắt đầu bằng "The", thay thế "Custom Filter" bằng tên "The
Bands "và nhấn Enter. Sau đó, chèn biểu thức sau vào dòng chỉnh sửa:

%{họa sĩ} diêm "Các.*"

Sau đó nhấp vào Lưu Cài đặt. Nhấp vào Áp dụng để lọc các tệp. Tất cả các tệp được xử lý là
hiển thị trong chế độ xem văn bản, với dấu "+" cho những người phù hợp với bộ lọc và dấu "-"
cho những người khác. Khi hoàn tất, chỉ các tệp có nghệ sĩ bắt đầu bằng "The"
được hiển thị và tiêu đề cửa sổ được đánh dấu bằng "[đã lọc]".

Công cụ → Chuyển đổi ID3v2.3 thành ID3v2.4
Nếu có bất kỳ thẻ ID3v2.3 nào trong các tệp đã chọn, chúng sẽ được chuyển đổi thành ID3v2.4
các thẻ. Các khung không được TagLib hỗ trợ sẽ bị loại bỏ. Chỉ các tệp không có
các thay đổi chưa được lưu sẽ được chuyển đổi.

Công cụ → Chuyển đổi ID3v2.4 thành ID3v2.3
Nếu có bất kỳ thẻ ID3v2.4 nào trong các tệp đã chọn, chúng sẽ được chuyển đổi thành ID3v2.3
các thẻ. Chỉ các tệp không có các thay đổi chưa được lưu sẽ được chuyển đổi.

Công cụ → Chơi
Thao tác này sẽ mở ra một thanh công cụ đơn giản để phát các tệp âm thanh. Nó chứa các nút cơ bản
hoạt động (Phát / Tạm dừng, Dừng phát lại, Bản nhạc trước, Bản nhạc tiếp theo, Đóng), thanh trượt cho
vị trí và âm lượng và hiển thị vị trí hiện tại. Nếu nhiều tệp thì
đã chọn, các bản nhạc đã chọn sẽ được phát, nếu không, tất cả các tệp sẽ được phát.

Sản phẩm Cài đặt Menu
Cài đặt → Hiển thị Thanh công cụ
Chuyển đổi hiển thị của thanh công cụ.

Cài đặt → Hiển thị Thanh trạng thái
Chuyển đổi hiển thị thanh trạng thái, hiển thị các hành động dài hơn như mở hoặc
lưu một thư mục.

Cài đặt → Hiển thị hình ảnh
Chuyển đổi hiển thị ảnh xem trước bìa album.

Cài đặt → Tự động ẩn thẻ
Các thẻ trống sẽ tự động bị ẩn nếu tùy chọn này đang hoạt động. Tệp, Thẻ 1 và Thẻ
2 phần có thể được thu gọn và mở rộng theo cách thủ công bằng cách nhấp vào - / + tương ứng
nút.

Cài đặt → Định cấu hình Kid3 ...
Mở hộp thoại cấu hình, bao gồm các trang cho thẻ, tệp, hành động của người dùng,
và cài đặt mạng.

Bạn có thể tìm thấy các tùy chọn cụ thể về thẻ trên trang Thẻ, trang này được tách thành
ba tab cho Thẻ 1, Thẻ 2 và Thẻ 1 và Thẻ 2.

Nếu Đánh dấu các trường bị cắt ngắn được chọn, các trường ID3v1.1 bị cắt ngắn sẽ được đánh dấu màu đỏ. Các
trường văn bản của thẻ ID3v1.1 chỉ có thể có 30 ký tự, chú thích chỉ có 28
nhân vật. Ngoài ra, số lượng thể loại và bản nhạc cũng bị hạn chế, để các trường có thể
bị cắt bớt khi nhập hoặc chuyển từ ID3v2. Các trường được cắt bớt và tệp sẽ
được đánh dấu màu đỏ, và dấu sẽ bị xóa sau khi trường đã được chỉnh sửa.

Với mã hóa Văn bản cho ID3v1, có thể đặt bộ ký tự được sử dụng trong ID3v1
các thẻ. Mã hóa này được cho là ISO-8859-1, vì vậy bạn nên giữ nguyên
giá trị mặc định. Tuy nhiên, có các thẻ xung quanh với các mã hóa khác nhau, vì vậy nó có thể
được đặt ở đây và các thẻ ID3v1 sau đó có thể được sao chép sang ID3v2 hỗ trợ Unicode.

Hộp kiểm Sử dụng bản nhạc / tổng số định dạng bản nhạc kiểm soát xem bản nhạc
trường số thẻ ID3v2 chỉ chứa số theo dõi hoặc thêm vào đó là tổng số
số lượng bản nhạc trong thư mục.

Khi Thể loại dưới dạng văn bản thay vì chuỗi số được chọn, tất cả các thể loại ID3v2 sẽ
được lưu trữ dưới dạng chuỗi văn bản ngay cả khi có mã tương ứng cho các thể loại ID3v1. Nếu như
tùy chọn này không được đặt, các thể loại mà mã ID3v1 tồn tại được lưu trữ dưới dạng số
của mã thể loại (trong ngoặc đơn cho ID3v2.3). Do đó, thể loại Metal được lưu trữ dưới dạng
"Kim loại" hoặc "(9)" tùy thuộc vào tùy chọn này. Các thể loại không có trong danh sách của ID3v1
thể loại luôn được lưu trữ dưới dạng chuỗi văn bản. Mục đích của tùy chọn này được cải thiện
khả năng tương thích với các thiết bị không diễn giải chính xác mã thể loại.

Mã hóa văn bản xác định mã hóa mặc định được sử dụng cho các khung ID3v2 và có thể được đặt thành
ISO-8859-1, UTF16 hoặc UTF8. UTF8 không hợp lệ cho các khung ID3v2.3.0; nếu nó được thiết lập,
UTF16 sẽ được sử dụng thay thế. Đối với các khung ID3v2.4.0, cả ba cách mã hóa đều có thể thực hiện được.

Phiên bản được sử dụng cho thẻ mới xác định xem thẻ ID3v2 mới có được tạo như phiên bản hay không
2.3.0 hoặc 2.4.0. Trong trường hợp đầu tiên, id3lib được sử dụng như trong các phiên bản trước của
Kid3 và TagLib chỉ được áp dụng khi gặp thẻ ID3v2.4.0. Trong lần thứ hai
case, ID3v2.4.0 (TagLib), TagLib thường được sử dụng cho các tệp MP3; đã thay đổi hoặc mới
các thẻ đã tạo sau đó sẽ được lưu trong phiên bản 2.4.0. Khi ID3v2.3.0 (TagLib) được chọn,
TagLib cũng được sử dụng cho thẻ ID3v2.3.0.

Số bản nhạc là số chữ số trong các trường Số bản nhạc. Các số không đứng đầu là
dùng để độn. Ví dụ: với giá trị là 2, bản nhạc số 5 được đặt là "05".

Hộp tổ hợp Tên trường nhận xét chỉ có liên quan đến các tệp Ogg / Vorbis và FLAC và
đặt tên của trường được sử dụng cho các nhận xét. Các ứng dụng khác nhau dường như sử dụng
các tên khác nhau, ví dụ: "COMMENT" được xmms sử dụng, trong khi amaroK sử dụng
"SỰ MÔ TẢ".

Định dạng của ảnh trong tệp Ogg / Vorbis được xác định bởi tên trường Ảnh, tên này
có thể là METADATA_BLOCK_PICTURE hoặc COVERART. Đầu tiên là tiêu chuẩn chính thức và sử dụng
định dạng tương tự như hình ảnh trong thẻ FLAC. COVERART là một cách không chính thức trước đó để
bao gồm hình ảnh trong bình luận của Vorbis. Nó có thể được sử dụng để tương thích với di sản
người chơi.

Nếu hộp kiểm Đánh dấu nếu lớn hơn được kích hoạt, các tệp chứa album được nhúng
Ảnh bìa vượt quá kích thước cho trước tính bằng byte được đánh dấu màu đỏ. Điều này có thể được sử dụng để tìm
các tệp chứa hình ảnh quá khổ không được một số ứng dụng chấp nhận và
người chơi. Giá trị mặc định là 131072 byte (128 KB).

Thể loại tùy chỉnh có thể được sử dụng để xác định các thể loại không có sẵn trong tiêu chuẩn
danh sách thể loại, ví dụ: "Gothic Metal". Các thể loại tùy chỉnh như vậy sẽ xuất hiện trong hộp kết hợp Thể loại
của Thẻ 2. Đối với thẻ ID3v1.1, chỉ các thể loại được xác định trước mới có thể được sử dụng.

Danh sách các thể loại tùy chỉnh cũng có thể được sử dụng để giảm số lượng các thể loại có sẵn trong
hộp kết hợp Thể loại cho những người thường được sử dụng. Nếu bộ sưu tập của bạn chủ yếu chứa nhạc
trong các thể loại Metal, Gothic Metal, Ancient và Hard Rock, bạn có thể nhập các thể loại đó
và đánh dấu Chỉ hiển thị các thể loại tùy chỉnh. Hộp kết hợp Tag 2Genre sau đó sẽ chỉ chứa
bốn thể loại đó và bạn sẽ không phải tìm kiếm trong toàn bộ danh sách thể loại cho
họ. Trong ví dụ này, chỉ Metal và Hard Rock sẽ được liệt kê trong các thể loại thẻ 1
danh sách, bởi vì hai mục nhập thể loại tùy chỉnh đó là thể loại tiêu chuẩn. Nếu Chỉ hiển thị tùy chỉnh
thể loại không hoạt động, bạn có thể tìm thể loại tùy chỉnh ở cuối danh sách thể loại.

Khung truy cập nhanh xác định loại khung nào luôn được hiển thị trong phần Thẻ 2.
Các khung như vậy sau đó có thể được thêm vào mà không cần sử dụng nút Thêm trước. Thứ tự của những
Các khung truy cập nhanh có thể được thay đổi bằng cách kéo và thả các mục.

Định dạng thẻ chứa các tùy chọn cho định dạng của thẻ. Khi Định dạng trong khi chỉnh sửa là
đã chọn, cấu hình định dạng được tự động sử dụng trong khi chỉnh sửa văn bản trong dòng
các chỉnh sửa. Chuyển đổi Chữ hoa thường có thể được đặt thành Không thay đổi, Tất cả chữ thường, Tất cả chữ hoa,
Chữ cái đầu tiên viết hoa hoặc Tất cả các chữ cái đầu tiên viết hoa. Để sử dụng chuyển đổi nhận biết ngôn ngữ
giữa các ký tự viết thường và viết hoa, một ngôn ngữ có thể được chọn trong hộp tổ hợp
phía dưới. Danh sách thay thế chuỗi có thể được đặt thành ánh xạ chuỗi tùy ý. Để thêm một
ánh xạ mới, chọn ô Từ của một hàng và chèn văn bản để thay thế, sau đó đi tới
cột Tới và nhập văn bản thay thế. Để xóa một ánh xạ, hãy đặt ô Từ thành
một giá trị trống (ví dụ: bằng cách gõ đầu tiên và sau đó là dấu cách lùi). Chèn và xóa
hàng cũng có thể sử dụng menu ngữ cảnh xuất hiện khi nút chuột phải
được nhấp vào. Thay thế chỉ hoạt động, nếu hộp kiểm Thay thế chuỗi được chọn.

Trên trang Tệp, hộp kiểm Tải tệp mở lần cuối có thể được đánh dấu để Kid3 sẽ
mở và chọn tệp được chọn cuối cùng khi nó được khởi động vào lần tiếp theo. Bảo tồn
dấu thời gian tệp có thể được kiểm tra để duy trì dấu thời gian sửa đổi tệp. Tên tệp
cho bìa đặt tên được đề xuất khi xuất hình ảnh nhúng sang
tập tin.

Nếu Đánh dấu thay đổi đang hoạt động, các trường đã thay đổi được đánh dấu bằng nhãn màu xám nhạt
nền.

Định dạng tên tệp chứa các tùy chọn cho định dạng của tên tệp. Các tùy chọn tương tự như
trong Định dạng thẻ có sẵn.

Trang Hành động của Người dùng chứa một bảng với các lệnh có sẵn trong
menu ngữ cảnh của danh sách tệp. Đối với các hoạt động quan trọng như xóa tệp, nó là
nên đánh dấu Xác nhận để bật lên hộp thoại xác nhận trước khi thực hiện
chỉ huy. Đầu ra có thể được đánh dấu để xem đầu ra được viết bởi các lệnh console (tiêu chuẩn
đầu ra và lỗi tiêu chuẩn). Tên là tên được hiển thị trong menu ngữ cảnh. Chỉ huy
là dòng lệnh được thực thi. Các đối số có thể được thông qua bằng các mã sau:

·% F% {files} Đường dẫn tệp (danh sách nếu nhiều tệp được chọn)

·% F% {file} Đường dẫn tệp đến một tệp duy nhất

·% UF% {urls} URL (danh sách nếu nhiều tệp được chọn)

·% Uf% {url} URL đến một tệp

·% D% {directory} Thư mục

·% S% {title} Title (Bài hát)

·% A% {artist} Nghệ sĩ

·% L% {album} Anbom

·% C% {comment} Nhận xét

·% Y% {year} năm

·% T% {track} Theo dõi (ví dụ: 01)

·% T% {track.n} Theo dõi với chiều rộng trường n (ví dụ: 001 cho% {track.3})

·% T% {tracknumber} Theo dõi (không có số 1 ở đầu, ví dụ: XNUMX)

·% G% {category} Thể loại

·% B% {browser} Lệnh khởi động trình duyệt web

·% Q% {qmlpath} Thư mục cơ sở của các tệp QML được cung cấp

Mã đặc biệt @dấu phân cách có thể được đặt làm lệnh để chèn dấu phân cách vào
trình đơn ngữ cảnh hành động của người dùng. Các mục menu có thể được đưa vào menu con bằng cách đặt chúng bằng
@beginmenu và @endmenu các lệnh. Tên của menu con được xác định bởi Tên
cột của @beginmenu chỉ huy.

Để thực thi các tập lệnh QML, @qml được sử dụng như một tên lệnh. Đường dẫn đến tập lệnh QML là
được truyền dưới dạng tham số. Các tập lệnh được cung cấp có thể được tìm thấy trong thư mục
% {qmlpath} / script / (trên Linux thường là / usr / share / kid3 / qml / script /, trên Windows
qml / script / bên trong thư mục cài đặt và trên OS X trong thư mục ứng dụng
kid3.app/Contents/Resources/qml/script/). Các tập lệnh tùy chỉnh có thể được lưu trữ trong bất kỳ
danh mục. Nếu mã QML sử dụng các thành phần GUI, @qmlview sẽ được sử dụng thay vì
@qml. Các tham số bổ sung được chuyển đến tập lệnh QML nơi chúng sẽ có sẵn
thông qua getArguments () hàm số. Tổng quan về một số chức năng và thuộc tính
có sẵn trong QML có thể được tìm thấy trong phụ lục Giao diện QML.

Lệnh sẽ được chèn với% {browser} có thể được xác định trong trình duyệt Web
chỉnh sửa dòng ở trên. Các lệnh bắt đầu bằng% {browser} có thể được sử dụng để tìm nạp thông tin
về các tệp âm thanh từ web, chẳng hạn

% {browser} http://lyricwiki.org/% u {artist}:% u {title}

sẽ truy vấn lời bài hát hiện tại trong Lời bài hátWiki[10]. Chữ "u" trong% u {artist} và
% u {title} được sử dụng để mã hóa URL của thông tin nghệ sĩ% {artist} và bài hát% {title}. Nó
dễ dàng xác định các truy vấn của riêng bạn theo cùng một cách, ví dụ: tìm kiếm hình ảnh với
Google[ba mươi]:

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

Để thêm ảnh bìa album vào thẻ 2, bạn có thể tìm kiếm hình ảnh bằng Google hoặc Amazon bằng
các lệnh được mô tả ở trên. Hình ảnh có thể được thêm vào thẻ bằng cách kéo và thả.
Bạn cũng có thể thêm hình ảnh bằng tính năng Thêm, sau đó chọn khung Hình ảnh và nhập hình ảnh
tệp hoặc dán từ khay nhớ tạm. Khung ảnh được hỗ trợ cho ID3v2, MP4, FLAC,
Thẻ Ogg và ASF.

Để thêm và xóa các mục nhập trong bảng, có thể sử dụng menu ngữ cảnh.

Trang Mạng chỉ chứa một trường để chèn địa chỉ proxy và tùy chọn
cổng, được phân tách bằng dấu hai chấm. Proxy sẽ được sử dụng khi nhập từ Internet
máy chủ khi hộp kiểm được chọn.

Trong trang Plugin, các plugin có sẵn có thể được bật hoặc tắt. Các plugin là
tách thành hai phần. Danh sách Ưu tiên & Plugin Siêu dữ liệu chứa các plugin
hỗ trợ các định dạng tệp âm thanh. Thứ tự của các plugin rất quan trọng vì chúng
được cố gắng từ trên xuống dưới. Một số định dạng được hỗ trợ bởi nhiều plugin, vì vậy các tệp
sẽ được mở bằng plugin đầu tiên hỗ trợ chúng. TaglibMetadata hỗ trợ hầu hết
, nếu nó ở đầu danh sách, nó sẽ mở hầu hết các tệp. Nếu bạn muốn
để sử dụng một plugin khác cho một định dạng tệp, hãy đảm bảo rằng nó được liệt kê trước
Plugin TaglibMetadata. Thông tin chi tiết về plugin siêu dữ liệu và lý do bạn có thể muốn sử dụng
chúng thay vì TagLib được liệt kê bên dưới.

· Id3libMetadata: Sử dụng id3lib[12] cho thẻ ID3v1.1 và ID3v2.3 trong MP3, MP2, AAC
các tập tin. Hỗ trợ nhiều loại khung hơn TagLib. Một lý do khác để sử dụng nó là
TagLib chỉ hỗ trợ ID3v2.3 kể từ phiên bản 1.8.

· OggFlacMetadata: Sử dụng libogg[13], thư giãn, tập tin libvorbis[14] đối với tệp Ogg và
Ngoài ra libFLAC ++ và libFLAC[15] đối với tệp FLAC. Lý do sử dụng chúng là
ảnh trong tệp Ogg, không được TagLib hỗ trợ và đây là
thư viện chính thức cho các định dạng này.

· TaglibMetadata: Sử dụng TagLib[16] hỗ trợ rất nhiều định dạng tệp âm thanh. Từ
phiên bản 1.8, nó cũng hỗ trợ ID3v2.3, vì vậy nó có thể được sử dụng cho tất cả các tệp âm thanh
được hỗ trợ bởi Kid3.

· Siêu dữ liệu Mp4v2: mp4v2[17] ban đầu được Kid3 sử dụng để hỗ trợ các tệp M4A.
Tuy nhiên, các phiên bản mới hơn của TagLib cung cấp hỗ trợ M4A tốt, vì vậy plugin này không
được xây dựng theo mặc định.

Phần Plugin có sẵn liệt kê các plugin còn lại. Thứ tự của họ không phải là
quan trọng, nhưng chúng có thể được bật hoặc tắt bằng cách sử dụng các hộp kiểm.

· AmazonImport: Được sử dụng cho chức năng Nhập từ Amazon ...

· DiscogsImport: Được sử dụng cho chức năng Nhập từ Discogs ...

· FreedbImport: Được sử dụng để Nhập từ gnudb.org ... và Nhập từ
Các chức năng của TrackType.org ....

· MusicBrainzImport: Được sử dụng cho chức năng Nhập từ MusicBrainz Release ...

· AcoustidImport: Được sử dụng cho chức năng Nhập từ vân tay MusicBrainz ...,
mà phụ thuộc vào sắc ký[18] và libav[19] thư viện.

Các plugin bị vô hiệu hóa sẽ không được tải. Điều này có thể được sử dụng để tối ưu hóa tài nguyên
sử dụng và thời gian khởi động. Cài đặt trên trang này chỉ có hiệu lực sau khi khởi động lại
Nhóc con3.

Cài đặt → Định cấu hình phím tắt ...
Mở hộp thoại để gán phím tắt cho hầu hết các chức năng của chương trình. Ở đó
thậm chí là các chức năng không có menu hoặc nút tương ứng, ví dụ: tệp tiếp theo,
tập tin trước, chọn tất cả.

Sản phẩm Trợ giúp Menu
Trợ giúp → Sổ tay Kid3
Mở cuốn sổ tay này.

Trợ giúp → Giới thiệu về Kid3
Hiển thị một thông tin ngắn về Kid3 ;.

KID3-CLI

Lệnh
kid3-cli cung cấp giao diện dòng lệnh cho Kid3. Nếu một đường dẫn thư mục được sử dụng,
thư mục được mở. Nếu một hoặc nhiều đường dẫn tệp được cung cấp, thư mục chung sẽ được mở
và các tệp được chọn. Các lệnh tiếp theo sau đó sẽ hoạt động trên các tệp này. Lệnh
được chỉ định bằng cách sử dụng -c tùy chọn. Nếu nhiều lệnh được chuyển, chúng sẽ được thực thi trong
đơn đặt hàng đã cho. Nếu các tệp được sửa đổi bởi các lệnh, chúng sẽ được lưu ở cuối. Nếu không
các tùy chọn lệnh được thông qua, kid3-cli bắt đầu ở chế độ tương tác. Các lệnh có thể được nhập
và sẽ hoạt động trên lựa chọn hiện tại. Các phần sau liệt kê tất cả có sẵn
lệnh.

Trợ giúp
giúp đỡ [CỘNG TÊN]

Hiển thị trợ giúp về các tham số của CỘNG TÊN hoặc về tất cả các lệnh nếu không có lệnh
tên được đưa ra.

Timeout
thời gian chờ [mặc định | tắt | THỜI GIAN]

Ghi đè thời gian chờ lệnh mặc định. Các lệnh CLI hủy bỏ sau một lệnh cụ thể
hết thời gian chờ. Thời gian chờ này là 10 giây cho ls và album Nghệ thuật, 60 giây cho
tự động nhập khẩu và lọcvà 3 giây cho tất cả các lệnh khác. Nếu một số lượng lớn các tệp
phải được xử lý, thời gian chờ này có thể quá hạn chế, do đó thời gian chờ cho tất cả
các lệnh có thể được đặt thành THỜI GIAN ms, bị tắt hoàn toàn hoặc để ở chế độ mặc định
các giá trị.

Thoát ứng dụng
ra [lực lượng]

Ứng dụng xuất cảnh. Nếu có các tệp chưa được lưu đã sửa đổi, lực lượng tham số là
yêu cầu.

Thay đổi thư mục
cd [MỤC]

Nếu không MỤC được đưa ra, thay đổi thành thư mục chính. Nếu một thư mục được cung cấp,
thay đổi vào thư mục. Nếu một hoặc nhiều đường dẫn tệp được cung cấp, hãy thay đổi đường dẫn chung của chúng
thư mục và chọn các tệp.

In các hiện hành đang làm việc thư mục
pwd

In tên tệp của thư mục làm việc hiện tại.

thư mục
ls

Liệt kê nội dung của thư mục hiện tại. Điều này tương ứng với danh sách tệp trong
Kid3 GUI. Bốn ký tự trước tên tệp hiển thị trạng thái của tệp.

·> Tệp được chọn.

· * Tập tin được sửa đổi.

· 1 Tệp có thẻ 1, nếu không thì '-' được hiển thị.

· 2 Tệp có thẻ 2, nếu không thì '-' được hiển thị.

kid3-cli> ls
1- 01 Giam doc.mp3
> 12 02 Chúng Tôi Chỉ Có Cái Này.mp3
* 1- 03 Outro.mp3

Trong ví dụ này, tất cả các tệp đều có thẻ 1, tệp thứ hai cũng có thẻ 2 và nó là
đã chọn. Tệp thứ ba được sửa đổi.

Lưu các thay đổi các tập tin
tiết kiệm

Chọn hồ sơ
chọn [tất cả | không có | đầu tiên | trước đó | tiếp theo | FILE...]

Để chọn tất cả các tệp, hãy nhập chọn tất cả các, để bỏ chọn tất cả các tệp, hãy nhập chọn không ai. Đến
duyệt các tệp trong thư mục hiện tại bắt đầu bằng chọn Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên, sau đó đi tiếp
sử dụng chọn tiếp theo hoặc ngược lại bằng cách sử dụng chọn trước. Các tệp cụ thể có thể được thêm vào
lựa chọn hiện tại bằng cách đặt tên tệp của chúng. Có thể sử dụng các ký tự đại diện, vì vậy chọn
* .mp3 sẽ chọn tất cả các tệp MP3 trong thư mục hiện tại.

kid3-cli> chọn Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 Chúng Tôi Chỉ Có Cái Này.mp3
* 1- 03 Outro.mp3
kid3-cli> chọn tiếp theo
kid3-cli> ls
1- 01 Giam doc.mp3
> 12 02 Chúng Tôi Chỉ Có Cái Này.mp3
* 1- 03 Outro.mp3
kid3-cli> chọn * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 Chúng Tôi Chỉ Có Cái Này.mp3
> * 1- 03 Outro.mp3

Chọn tag
tag [TAG-SỐ]

Nhiều lệnh có tùy chọn TAG-SỐ tham số này chỉ định xem
lệnh hoạt động trên thẻ 1 hoặc thẻ 2. Nếu tham số này bị bỏ qua, thẻ mặc định
số được sử dụng, có thể được đặt bằng lệnh này. Khi khởi động, được đặt thành 12
có nghĩa là thông tin được đọc từ thẻ 2 nếu có, khác từ thẻ 1; sửa đổi
được thực hiện trên thẻ 2. TAG-SỐ có thể được đặt thành 1 or 2 chỉ hoạt động trên
thẻ tương ứng. Nếu tham số bị bỏ qua, cài đặt hiện tại sẽ được hiển thị.

Nhận tag khung
được [tất cả | KHUNG-TÊN] [TAG-SỐ]

Lệnh này có thể được sử dụng để đọc giá trị của một khung thẻ cụ thể hoặc lấy thông tin
về tất cả các khung thẻ (nếu đối số bị bỏ qua hoặc tất cả các Được sử dụng). Khung được sửa đổi là
được đánh dấu bằng dấu '*'.

kid3-cli> được
Tập tin: MPEG 1 Lớp 3 Âm thanh nổi chung 192 kbps 44100 Hz
Tên: 01 Intro.mp3
Thẻ 1: ID3v1.1
Giới thiệu tiêu đề
Nghệ sĩ One Hit Wonder
Album Let's Tag
Ngày 2013
Theo dõi số 1
Thể loại Pop
kid3-cli> được tiêu đề
Giới thiệu

Để lưu nội dung của khung ảnh vào một tệp, hãy sử dụng

được ảnh: "/ path / to / folder.jpg"

Để lưu lời bài hát đã đồng bộ hóa vào tệp LRC, hãy sử dụng

được SYLT: "/ path / to / lyrics.lrc"

Thiết lập tag khung
định {KHUNG-TÊN} {KHUNG-GIÁ TRỊ} [TAG-SỐ]

Lệnh này đặt giá trị của một khung thẻ cụ thể.

kid3-cli> định phối trộn "Ồ Thắc mắc"

Để đặt nội dung của khung ảnh từ một tệp, hãy sử dụng

định ảnh: "/ path / to / folder.jpg" "Bức ảnh Sự miêu tả"

Để đặt lời bài hát được đồng bộ hóa từ tệp LRC, hãy sử dụng

định SYLT: "/ path / to / lyrics.lrc" "Lời bài hát Sự miêu tả"

Hoàn nguyên
trở lại

Hoàn nguyên tất cả các sửa đổi trong các tệp đã chọn (hoặc tất cả các tệp nếu không có tệp nào
đã chọn).

Nhập khẩu từ hồ sơ or vào clipboard
nhập khẩu {FILE} {ĐỊNH DẠNG-TÊN} [TAG-SỐ]

Các thẻ được nhập từ tệp FILE (hoặc từ khay nhớ tạm nếu vào clipboard được sử dụng để
FILE) ở định dạng có tên ĐỊNH DẠNG-TÊN (ví dụ "CSV không được trích dẫn ", xem Nhập).

Tự động nhập khẩu
tự động nhập khẩu [TÊN HỒ SƠ] [TAG-SỐ]

Nhập hàng loạt bằng cách sử dụng hồ sơ TÊN HỒ SƠ (xem Nhập tự động, "Tất cả các" được sử dụng nếu
bỏ qua).

Tải về album che tác phẩm nghệ thuật
album Nghệ thuật {URL} [tất cả các]

Đặt tác phẩm nghệ thuật cho album bằng cách tải xuống ảnh từ URL. Các quy tắc được xác định trong
Hộp thoại Browse Cover Art được sử dụng để chuyển đổi các URL chung (ví dụ: từ Amazon) thành
URL hình ảnh. Để đặt bìa album từ tệp ảnh cục bộ, hãy sử dụng lệnh set.

kid3-cli> album Nghệ thuật
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

Xuất khẩu đến hồ sơ or vào clipboard
xuất khẩu {FILE} {ĐỊNH DẠNG-TÊN} [TAG-SỐ]

Thẻ được xuất sang tệp FILE (hoặc vào khay nhớ tạm nếu vào clipboard được sử dụng để FILE) trong
định dạng với tên ĐỊNH DẠNG-TÊN (ví dụ "CSV không được trích dẫn ", xem Xuất).

Tạo danh sách
danh sách

Tạo danh sách phát ở định dạng được đặt trong cấu hình, xem Tạo danh sách phát.

Đăng Nhập tên tập tin định dạng
định dạng tên tệp

Áp dụng định dạng tên tệp đã đặt trong cấu hình, hãy xem Áp dụng Định dạng Tên tệp.

Đăng Nhập tag định dạng
thẻ định dạng

Áp dụng bộ định dạng tên thẻ trong cấu hình, hãy xem Áp dụng định dạng thẻ.

Đăng Nhập văn bản mã hóa
mã hóa văn bản

Áp dụng bộ mã hóa văn bản trong cấu hình, hãy xem Áp dụng mã hóa văn bản.

Đổi tên thư mục
đổi tên [FORMAT] [tạo | đổi tên | Dryrun] [TAG-SỐ]

Đổi tên hoặc tạo thư mục từ các giá trị trong thẻ theo một FORMAT
(ví dụ %{họa sĩ} - % {anbom}, xem Đổi tên Thư mục), nếu không có định dạng nào, thì định dạng
được định nghĩa trong hộp thoại Đổi tên thư mục được sử dụng. Chế độ mặc định là đổi tên; để tạo ra
thư mục, tạo phải được đưa ra một cách rõ ràng. Các hành động đổi tên sẽ được thực hiện
ngay lập tức, để chỉ cần xem những gì sẽ được thực hiện, hãy sử dụng Dryrun tùy chọn.

Con số bài hát
đường số [SỐ THEO DÕI] [TAG-SỐ]

Đánh số các bản nhạc đã chọn bắt đầu bằng SỐ THEO DÕI (1 nếu bỏ qua).

Lọc
lọc [TÊN BỘ LỌC | ĐỊNH DẠNG BỘ LỌC]

Lọc các tệp để chỉ các tệp phù hợp với ĐỊNH DẠNG BỘ LỌC có thể nhìn thấy được. Các
tên của một biểu thức bộ lọc xác định trước (ví dụ: "Tên tệp Nhãn Không khớp ") có thể được sử dụng
thay vì một biểu thức bộ lọc, hãy xem Bộ lọc.

kid3-cli> lọc '%{chức vụ} chứa "tro"
Bắt đầu
/ home / urs / One Hit Wonder - Hãy gắn thẻ
+ 01 Phần Giới Thiệu.mp3
- 02 Chung Ta Chỉ Có Cái Này.mp3
+ 03 Ngoai.mp3
Đã kết thúc
kid3-cli> ls
1- 01 Giam doc.mp3
1- 03 Ngoai.mp3
kid3-cli> lọc Tất cả
Bắt đầu
/ home / urs / One Hit Wonder - Hãy gắn thẻ
+ 01 Phần Giới Thiệu.mp3
+ 02 Chung Ta Chỉ Có Cái Này.mp3
+ 03 Ngoai.mp3
Đã kết thúc
kid3-cli> ls
1- 01 Giam doc.mp3
12 02 Chúng Tôi Chỉ Có Cái Này.mp3
1- 03 Ngoai.mp3

Chuyển đổi ID3v2.3 đến ID3v2.4
to24

Chuyển đổi ID3v2.4 đến ID3v2.3
to23

Tên tập tin từ tag
từ tag [FORMAT] [TAG-SỐ]

Ví dụ: đặt tên tệp của các tệp đã chọn từ các giá trị trong thẻ từ tag
"%{theo dõi} - %{chức vụ}" 1. Nếu không có định dạng nào được chỉ định, thì định dạng được đặt trong GUI sẽ được sử dụng.

Nhãn từ tên tập tin
gắn thẻ [FORMAT] [TAG-SỐ]

Ví dụ: đặt các khung thẻ từ tên tệp gắn thẻ "%{album Nghệ sĩ} -
% {album} /% {track} %{chức vụ}" 2. Nếu không có định dạng nào được chỉ định, thì định dạng được đặt trong GUI là
đã sử dụng. Nếu định dạng của tên tệp không khớp với mẫu này, một số định dạng khác thường gặp
các định dạng đã sử dụng được thử.

Nhãn đến khác tag
đồng bộ hóa {THẺ-SỐ}

Sao chép các khung thẻ từ thẻ này sang thẻ khác, ví dụ: để đặt thẻ ID3v2 từ
Thẻ ID3v1, sử dụng đồng bộ hóa 2.

Sao chép
bản sao [THẺ-SỐ]

Sao chép các khung thẻ của tệp đã chọn vào bộ đệm sao chép nội bộ. Sau đó họ có thể
đặt trên một tệp khác bằng cách sử dụng dán chỉ huy.

Dán
dán [THẺ-SỐ]

Đặt khung thẻ từ nội dung của bản sao đệm trong các tệp đã chọn.

Hủy bỏ
tẩy [THẺ-SỐ]

Xóa thẻ.

Play
chơi [tạm dừng | dừng lại | trước đó | Kế tiếp]

Bắt đầu phát lại âm thanh. Khi nó đã được khởi động, nó có thể được điều khiển bằng tạm dừng
(để tạm dừng và tiếp tục), dừng lại, trước và tiếp theo tùy chọn.

Các ví dụ
Đặt bìa album trong tất cả các tệp của thư mục bằng chức năng nhập hàng loạt:

kid3-cli -c 'autoimport "Che Nghệ thuật"' / path / to / dir

Xóa khung nhận xét và áp dụng định dạng thẻ trong cả hai thẻ của tất cả các tệp MP3 của
danh mục:

kid3-cli -c 'bộ bình luận "" 1' -c 'bộ bình luận "" 2' \
-c 'tagformat 1' -c 'tagformat 2' /path/to/dir/*.mp3

Tự động nhập thẻ 2, đồng bộ hóa với thẻ 1, đặt tên tệp từ thẻ 2 và cuối cùng
tạo danh sách phát:

kid3-cli -c tự động nhập khẩu -c 'syncto 1' -c từ tag -c danh sách \
/path/to/dir/*.mp3

Đối với tất cả các tệp có thẻ ID3v2.4.0, hãy chuyển đổi thành ID3v2.3.0 và xóa khung trình sắp xếp:

kid3-cli -c "lọc 'ID3v2.4.0 Nhãn'" -c "lựa chọn tất cả các" -c to23 \
-c "bộ sắp xếp '' " / path / to / dir

Tập lệnh Python này sử dụng kid3-cli để tạo khung iTunes Sound Check iTunNORM từ
phát lại thông tin đạt được.

#!/ usr / bin / env mãng xà
# Tạo Kiểm tra âm thanh iTunes từ ReplayGain.
từ __future__ nhập print_ Chức năng
nhập hệ điều hành, hệ thống, quy trình con

def rg2sc (dirpath):
cho thư mục gốc, dirs, tệp trong os.walk (dirpath):
cho tên trong tệp:
if name.endswith (('. mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join (root, name)
rg = subprocess.check_output ([
'kid3-cli', '-c', 'get "replaygain_track_gain"',
fn]). dải ()
nếu rg.endswith (b 'dB'):
rg = rg [: - 3]
thử:
rg = float (rg)
ngoại trừ ValueError:
print ('Giá trị% s của% s không phải là số float'% (rg, fn))
tiếp tục
sc = ('' + ('% 08X'% int ((10 ** (-rg / 10)) * 1000))) * 10
subprocess.call ([
'kid3-cli', '-c', 'set iTunNORM "% s"'% sc, fn])

if __name__ == '__main__':
rg2sc (sys.argv [1])

TÍN VÀ GIẤY PHÉP

Kid3

Chương trình do Urs Fleisch viết

LDF[20]

GPL[21]

LẮP ĐẶT

Độ đáng tin của đến được Kid3
Kid3 có thể được tìm thấy tại http://kid3.sourceforge.net.

Yêu cầu
Kid3 cần Qt[22. KDE[23] được khuyến khích nhưng không cần thiết, vì Kid3 cũng có thể được biên dịch
như một ứng dụng Qt. Kid3 có thể được biên dịch cho các hệ thống có các thư viện này
có sẵn, ví dụ như cho GNU / Linux, Windows và Mac OS X. Để gắn thẻ các tệp Ogg / Vorbis, libogg[13],
libvorbis và tập tin libvorbis[14] là bắt buộc đối với tệp FLAC libFLAC ++ và libFLAC[15.
id3lib[12] được sử dụng cho các tệp MP3. Bốn định dạng này cũng được hỗ trợ bởi TagLib[16],
mà cũng có thể xử lý các tệp Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
và các mô-đun trình theo dõi. Để nhập từ dấu vân tay âm thanh, sắc ký[18] và libav[19]
được sử dụng.

Kid3 có sẵn cho hầu hết các bản phân phối Linux, Windows và Mac OS X. Bạn có thể tìm thấy các liên kết
on http://kid3.sourceforge.net.

Biên soạn và của DINTEK
Bạn có thể biên dịch Kid3 có hoặc không có KDE. Không có KDE, Kid3 là một ứng dụng Qt đơn giản và
thiếu một số tính năng cấu hình và phiên.

Đối với phiên bản KDE, hãy vào thư mục trên cùng và nhập

% cmake .
% làm cho
% làm cho cài đặt, dựng lên

Để biên dịch cho các phiên bản khác nhau của Qt hoặc KDE, hãy đặt cmake tùy chọn.

Nếu không phải tất cả các thư viện đều có mặt, Kid3 được xây dựng với chức năng bị giảm bớt. Bạn nên làm điều đó
cẩn thận để cài đặt tất cả các gói phát triển mong muốn. Mặt khác,
cmake-options kiểm soát thư viện nào được biên dịch trong đó. Giá trị mặc định là -D
WITH_TAGLIB: BOOL = BẬT -D WITH_MP4V2: BOOL = TẮT -D WITH_ID3LIB: BOOL = BẬT -D
WITH_CHROMAPRINT: BOOL = ON -D WITH_VORBIS: BOOL = BẬT -D WITH_FLAC: BOOL = BẬT . Các tùy chọn này có thể
bị vô hiệu hóa bằng cách sử dụng TẮT.

Để xây dựng Kid3 như một ứng dụng Qt mà không có KDE, hãy sử dụng cmake tùy chọn -DWITH_APPS = Qt. Đến
xây dựng cả ứng dụng KDE và Qt, thiết lập -DWITH_APPS = "Qt; KDE".

Qt 4 hoặc Qt 5 có thể được sử dụng. Để buộc sử dụng Qt 4, hãy đặt -DWITH_QT4 = BẬT, để buộc sử dụng
Qt 5, bộ -DWITH_QT5 = BẬT, nếu cả hai tùy chọn này đều TẮT (mặc định), thì Qt 4 được ưu tiên nếu
cả hai phiên bản đều được cài đặt. Để sử dụng một cài đặt Qt cụ thể, hãy đặt
-DQT_QMAKE_EXECUTABLE = / path / to / qmake. Nếu việc xây dựng ứng dụng KDE được bật, cài đặt
Qt 4 sẽ sử dụng KDE 4, trong khi cài đặt Qt 5 sẽ sử dụng KDE 5.

Việc tạo gói RPM được hỗ trợ bởi tệp kid3.spec, đối với Debian-Packages,
script build-deb. có sẵn.

Ứng dụng Qt cũng có thể được biên dịch cho Windows và Mac OS X. Các tập lệnh trong
thư mục win32 và macosx có thể được sử dụng để xây dựng và tạo gói. Các thư viện có thể
được cài đặt bằng buildlibs.sh.

Cấu hình
Với KDE, bộ lọc và định dạng tên tệp, định dạng nhập, tên tệp và ID3
định dạng, thanh công cụ và cài đặt thanh trạng thái cũng như kích thước cửa sổ sẽ được lưu trong
vị trí chuẩn trong tệp kid3rc. Là một ứng dụng Qt, tệp này nằm trong
.config / Kid3 / Kid3.conf. Trên Windows, cấu hình được lưu trữ trong sổ đăng ký.

D-BUS GIAO DIỆN

Xe buýt D Các ví dụ
Các phiên bản Qt 4 và KDE 4 trên Linux cung cấp Giao diện D-Bus để điều khiển Kid3 bằng các tập lệnh.
Tập lệnh có thể được viết bằng bất kỳ ngôn ngữ nào có ràng buộc D-Bus (ví dụ: bằng Python) và có thể
được thêm vào Hành động của người dùng để mở rộng chức năng của Kid3.

Nghệ sĩ trong thẻ 2 của tệp hiện tại có thể được đặt thành giá trị "One Hit Wonder" với
mã sau:

Shell

dbus-send --dest = net.sourceforge.kid3 --print-reply = Lite \
/ Kid3 net.sourceforge.Kid3.setFrame int32: 2 string: 'Artist' \
string: 'One Hit Wonder'

hoặc dễ dàng hơn với Qt's qdbus (qdbusviewer có thể được sử dụng để khám phá giao diện trong GUI):

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

Python

nhập khẩu dbus
kid3 = dbus.SessionBus (). get_object (
'net.sourceforge.kid3', '/ Kid3')
kid3.setFrame (2, 'Nghệ sĩ', 'One Hit Wonder')

Perl

sử dụng Net :: DBus;
$ kid3 = Net :: DBus-> session-> get_service (
"net.sourceforge.kid3") -> get_object (
"/ Kid3", "net.sourceforge.Kid3");
$ kid3-> setFrame (2, "Nghệ sĩ", "One Hit Wonder");

Xe buýt D API
API D-Bus được chỉ định trong net.sourceforge.Kid3.xml. Giao diện Kid3 có
các phương pháp sau:

Mở hồ sơ or thư mục
boolean openDirectory (chuỗi con đường);

con đường
đường dẫn đến tệp hoặc thư mục

Trả về true nếu OK.

Lưu tất cả các sửa đổi các tập tin
boolean lưu (vô hiệu);

Trả về true nếu OK.

Nhận a chi tiết lôi tin nhắn cung cấp by một số phương pháp
chuỗi getErrorMessage (vô hiệu);

Trả về thông báo lỗi chi tiết.

Hoàn nguyên thay đổi in các chọn các tập tin
hoàn nguyên (vô hiệu);

Bắt đầu an tự động hàng loạt nhập khẩu
boolean batchImport (int32 thẻmặt nạ, chuỗi Tên hồ sơ);

thẻmặt nạ
mặt nạ thẻ (bit 0 cho thẻ 1, bit 1 cho thẻ 2)

Tên hồ sơ
tên của hồ sơ nhập hàng loạt để sử dụng

Nhập khẩu thẻ từ a hồ sơ
boolean importFromFile (int32 thẻmặt nạ, chuỗi con đường, intxnumx fmtIdx);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

con đường
đường dẫn của tệp

fmtIdx
chỉ mục của định dạng

Trả về true nếu OK.

Tải về album che nghệ thuật
downloadAlbumArt (chuỗi url, boolean allFilesInDir);

url
URL của tệp ảnh hoặc tài nguyên ảnh bìa album

allFilesInDir
true để thêm hình ảnh vào tất cả các tệp trong thư mục

Xuất khẩu thẻ đến a hồ sơ
boolean exportToFile (int32 thẻmặt nạ, chuỗi con đường, intxnumx fmtIdx);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

con đường
đường dẫn của tệp

fmtIdx
chỉ mục của định dạng

Trả về true nếu OK.

Tạo a danh sách
boolean createPlaylist (void);

Trả về true nếu OK.

Thoát các ứng dụng
bỏ (vô hiệu);

Chọn tất cả các các tập tin
selectAll (vô hiệu);

Bỏ chọn tất cả các các tập tin
deselectAll (vô hiệu);

Thiết lập các Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên hồ sơ as các hiện hành hồ sơ
boolean firstFile (void);

Trả về true nếu có tệp đầu tiên.

Thiết lập các trước hồ sơ as các hiện hành hồ sơ
boolean beforeFile (void);

Trả về true nếu có tệp trước đó.

Thiết lập các tiếp theo hồ sơ as các hiện hành hồ sơ
boolean nextFile (void);

Trả về true nếu có tệp tiếp theo.

Chọn các Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên hồ sơ
boolean selectFirstFile (void);

Trả về true nếu có tệp đầu tiên.

Chọn các trước hồ sơ
boolean selectPreviousFile (void);

Trả về true nếu có tệp trước đó.

Chọn các tiếp theo hồ sơ
boolean selectNextFile (void);

Trả về true nếu có tệp tiếp theo.

Chọn các hiện hành hồ sơ
boolean selectCurrentFile (void);

Trả về true nếu có tệp hiện tại.

Mở rộng or sụp đổ các hiện hành hồ sơ mục if it is a thư mục
boolean expandDirectory (void);

Mục danh sách tệp là một thư mục nếu getFileName () trả về tên với '/' là tên cuối cùng
nhân vật.

Trả về true nếu mục tệp hiện tại là một thư mục.

Đăng Nhập các hồ sơ tên định dạng
applyFilenameFormat (void);

Đăng Nhập các tag định dạng
applyTagFormat (void);

Đăng Nhập văn bản mã hóa
applyTextEncoding (void);

Thiết lập các thư mục tên từ các thẻ
boolean setDirNameFromTag (int32 thẻmặt nạ, chuỗi định dạng, boolean tạo);

thẻmặt nạ
mặt nạ thẻ (bit 0 cho thẻ 1, bit 1 cho thẻ 2)

định dạng
định dạng tên thư mục

tạo
true để tạo, false để đổi tên

Trả về true nếu OK, nếu không sẽ có thông báo lỗi bằng getErrorMessage ().

Thiết lập tiếp theo theo dõi số in các chọn các tập tin
numberTracks (int32 thẻmặt nạ, intxnumx firstTrackNr);

thẻmặt nạ
mặt nạ thẻ (bit 0 cho thẻ 1, bit 1 cho thẻ 2)

firstTrackNr
số để sử dụng cho tệp đầu tiên

Lọc các các tập tin
bộ lọc (chuỗi biểu hiện);

biểu hiện
bộ lọc biểu thức

Chuyển đổi ID3v2.3 thẻ đến ID3v2.4
convertToId3v24 (vô hiệu);

Chuyển đổi ID3v2.4 thẻ đến ID3v2.3
convertToId3v23 (vô hiệu);

Trả về true nếu OK.

Nhận con đường of thư mục
chuỗi getDirectoryName (void);

Trả về đường dẫn tuyệt đối của thư mục.

Nhận tên of hiện hành hồ sơ
chuỗi getFileName (void);

Trả về tên tệp tuyệt đối đúng, kết thúc bằng "/" nếu nó là một thư mục.

Thiết lập tên of chọn hồ sơ
setFileName (chuỗi tên);

tên
tên tập tin

Tệp sẽ được đổi tên khi thư mục được lưu.

Thiết lập định dạng đến sử dụng khi nào thiết lập các tên tập tin từ các thẻ
setFileNameFormat (chuỗi định dạng);

định dạng
định dạng tên tệp

Thiết lập các hồ sơ tên of các chọn các tập tin từ các thẻ
setFileNameFromTag (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Nhận giá trị of khung
chuỗi getFrame (int32 thẻmặt nạ, chuỗi tên);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

tên
tên của khung (ví dụ: "nghệ sĩ")

Để có được dữ liệu nhị phân như một bức tranh, tên của tệp cần ghi có thể được thêm vào sau
tên, ví dụ: "Hình ảnh: / đường dẫn / đến / tệp". Theo cách tương tự, lời bài hát được đồng bộ hóa có thể được
được xuất, ví dụ: "SYLT: / path / to / file".

Trả về giá trị của khung.

Thiết lập giá trị of khung
boolean setFrame (int32 thẻmặt nạ, chuỗi tên, chuỗi giá trị);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

tên
tên của khung (ví dụ: "nghệ sĩ")

giá trị
giá trị của khung

Đối với thẻ 2 (thẻmặt nạ 2), nếu không có khung với tên tồn tại, một khung mới được thêm vào, nếu giá trị is
trống, khung bị xóa. Để thêm dữ liệu nhị phân như hình, có thể thêm tệp
sau tên, ví dụ: "Hình ảnh: / đường dẫn / đến / tệp". "SYLT: / path / to / file" có thể được sử dụng để
nhập lời bài hát được đồng bộ hóa.

Trả về true nếu OK.

Nhận tất cả các khung of a tag
mảng of chuỗi getTag (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Trả về danh sách với các tên và giá trị khung xen kẽ.

Nhận kỹ thuật thông tin về hồ sơ
mảng of chuỗi getInformation (vô hiệu);

Các thuộc tính là Định dạng, Tốc độ bit, Tốc độ lấy mẫu, Kênh, Thời lượng, Chế độ kênh, VBR, Thẻ
1, Thẻ 2. Các thuộc tính không có sẵn sẽ bị bỏ qua.

Trả về danh sách với các tên và giá trị thuộc tính xen kẽ.

Thiết lập tag từ hồ sơ tên
setTagFromFileName (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Thiết lập tag từ khác tag
setTagFromOtherTag (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Sao chép tag
copyTag (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Dán tag
pasteTag (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Hủy bỏ tag
removeTag (int32 thẻmặt nạ);

thẻmặt nạ
bit thẻ (1 cho thẻ 1, 2 cho thẻ 2)

Báo cáo lại các cấu hình
reparseConfiguration (void);

Có thể tự động thay đổi cấu hình bằng cách sửa đổi tệp cấu hình và
sau đó reparsing cấu hình.

Vở kịch các chọn các tập tin
playAudio (vô hiệu);

QML GIAO DIỆN

QML Các ví dụ
Các tập lệnh QML có thể được gọi thông qua menu ngữ cảnh của danh sách tệp và có thể được đặt trong tab
Hành động của người dùng trong hộp thoại cài đặt. Các tập lệnh được đặt ở đó có thể được sử dụng như
ví dụ để lập trình các tập lệnh tùy chỉnh. QML sử dụng JavaScript, đây là bắt buộc "Xin chào
Thế giới":

nhập Kid3 1.0

Kid3Script {
trênRun: {
console.log ("Hello world, directory is", app.dirName)
Qt.quit ()
}
}

Nếu tập lệnh này được lưu dưới dạng /path/to/Example.qml, thì lệnh người dùng có thể được định nghĩa là @qml
/path/to/Example.qml với tên QML Thử nghiệm và Kiểm tra đầu ra. Sau đó, nó có thể được bắt đầu sử dụng
mục Kiểm tra QML trong menu ngữ cảnh danh sách tệp và đầu ra sẽ hiển thị trong
cửa sổ.

Ngoài ra, tập lệnh cũng có thể được bắt đầu độc lập với Kid3 bằng cách sử dụng các công cụ QML.

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

Đối với Qt 5, các lệnh

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

or

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

có thể được sử dụng. Trên Windows và OS X, đường dẫn nhập phải được điều chỉnh cho phù hợp với thư mục nhập
bên trong thư mục cài đặt. Các tập lệnh bắt đầu bên ngoài Kid3 sẽ sử dụng
thư mục, vì vậy nó nên được thay đổi trước.

Để liệt kê các tiêu đề trong thẻ 2 của tất cả các tệp trong thư mục hiện tại, hãy làm như sau
script có thể được sử dụng:

nhập Kid3 1.0

Kid3Script {
trênRun: {
app.firstFile ()
làm {
nếu (app.selectionInfo.tagFormatV2)
console.log (app.getFrame (tagv2, "title"))
} while (app.nextFile ())
}
}

Nếu thư mục chứa nhiều tệp, một tập lệnh như vậy có thể chặn giao diện người dùng cho
thỉnh thoảng. Đối với các hoạt động lâu hơn, do đó, nó nên có thời gian nghỉ ngơi. Các
triển khai thay thế bên dưới có công việc cho một tệp đơn lẻ được chuyển thành một hàm.
Hàm này tự gọi nó với thời gian chờ là 1 ms ở cuối, vì nhiều tệp hơn có
để được xử lý. Điều này sẽ đảm bảo rằng GUI vẫn đáp ứng trong khi tập lệnh
đang chạy.

nhập Kid3 1.0

Kid3Script {
trênRun: {
function doWork () {
nếu (app.selectionInfo.tagFormatV2) {
console.log (app.getFrame (tagv2, "title"))
}
if (! app.nextFile ()) {
Qt.quit ()
} Else {
setTimeout (doWork, 1)
}
}

app.firstFile ()
làm việc()
}
}

Các tập lệnh ví dụ khác đi kèm với Kid3 và đã được đăng ký dưới dạng lệnh của người dùng.

· ReplayGain to SoundCheck (ReplayGain2SoundCheck.qml): Tạo iTunNORM SoundCheck
thông tin từ các khung đạt được phát lại.

· Thay đổi kích thước ảnh bìa album (ResizeAlbumArt.qml): Thay đổi kích thước ảnh bìa được nhúng
lớn hơn 500x500 pixel.

· Trích xuất Album Art (ExtractAlbumArt.qml): Trích xuất tất cả các ảnh bìa được nhúng
tránh trùng lặp.

· Nhúng ảnh bìa album (EmbedAlbumArt.qml): Nhúng ảnh bìa được tìm thấy trong các tệp hình ảnh vào âm thanh
các tệp trong cùng một thư mục.

· Embed Lyrics (EmbedLyrics.qml): Tìm nạp lời bài hát không đồng bộ từ dịch vụ web.

· Mã hóa văn bản ID3v1 (ShowTextEncodingV1.qml): Giúp tìm mã hóa của thẻ ID3v1
bằng cách hiển thị các thẻ của tệp hiện tại trong tất cả các bảng mã ký tự có sẵn.

· Xuất CSV (ExportCsv.qml): Xuất đệ quy tất cả các thẻ của tất cả các tệp sang tệp CSV.

· Bảng điều khiển QML (QmlConsole.qml): Bảng điều khiển đơn giản để chơi với API QML của Kid3.

QML API
Có thể dễ dàng khám phá API bằng Bảng điều khiển QML, có sẵn làm ví dụ
script với giao diện người dùng.

Kid3Script
Kid3Script là một thành phần QML thông thường nằm bên trong thư mục plugin. Bạn có thể
cũng sử dụng một thành phần QML khác. Sử dụng Kid3Script giúp bạn dễ dàng bắt đầu
chức năng script bằng cách sử dụng đang chạy bộ xử lý tín hiệu. Nó cũng ẩn đi sự khác biệt giữa
các phiên bản QtQuick, để tạo các tập lệnh tương thích với cả Qt 4 và Qt 5.
Hơn nữa, nó cung cấp một số chức năng:

onRun: Trình xử lý tín hiệu được gọi khi bắt đầu tập lệnh
tagv1, tagv2, tagv2v1: Hằng số cho thông số thẻ
script: Quyền truy cập vào các chức năng script
configs: Quyền truy cập vào các đối tượng cấu hình
getArguments (): Danh sách các đối số tập lệnh
isStandalone (): true nếu tập lệnh không được bắt đầu từ bên trong Kid3
setTimeout (gọi lại, trì hoãn): Bắt đầu gọi lại sau vài giây trễ

Scripting Chức năng
Vì JavaScript và do đó QML cũng chỉ có một bộ chức năng hạn chế dành cho kịch bản,
các kịch bản đối tượng có một số phương thức bổ sung, ví dụ:

script.properties (obj): Chuỗi có thuộc tính Qt
script.writeFile (filePath, data): Ghi dữ liệu vào tệp, true nếu OK
script.readFile (filePath): Đọc dữ liệu từ tệp
script.removeFile (filePath): Xóa tệp, true nếu OK
script.fileExists (filePath): true nếu tệp tồn tại
script.renameFile (oldName, newName): đổi tên tệp, true nếu OK
script.tempPath (): đường dẫn đến thư mục tạm thời
script.listDir (đường dẫn, [nameFilters], [phân loại]): Liệt kê các mục nhập thư mục
script.system (chương trình, [args], [msecs]): Khởi động đồng bộ một lệnh hệ thống,
[mã thoát, đầu ra tiêu chuẩn, lỗi tiêu chuẩn] nếu không phải thời gian chờ
script.getEnv (varName): Nhận giá trị của biến môi trường
script.setEnv (varName, value): Đặt giá trị của biến môi trường
script.getQtVersion (): Chuỗi phiên bản Qt, ví dụ: "5.4.1"
script.getDataMd5 (data): Lấy chuỗi hex của dữ liệu băm MD5
script.getDataSize (dữ liệu): Lấy kích thước của mảng byte
script.dataToImage (data, [format]): Tạo hình ảnh từ các byte dữ liệu
script.dataFromImage (img, [format]): Lấy byte dữ liệu từ hình ảnh
script.loadImage (filePath): Tải hình ảnh từ một tệp
script.saveImage (img, filePath, [format]): Lưu hình ảnh vào tệp, true nếu OK
script.imageProperties (img): Lấy thuộc tính của một hình ảnh, bản đồ chứa
"width", "height", "depth" và "colorCount", để trống nếu hình ảnh không hợp lệ
script.scaleImage (img, width, [height]): Chia tỷ lệ hình ảnh, trả về hình ảnh được chia tỷ lệ
script.selectFileName (caption, dir, filter, saveFile): Mở hộp thoại tệp để
Chọn một tập tin

Các Ứng Dụng Bối cảnh
Sử dụng QML, một phần lớn các chức năng của Kid3 có thể truy cập được. API tương tự như
cái được sử dụng cho D-Bus. Để biết chi tiết, hãy tham khảo các ghi chú tương ứng.

app.openDirectory (đường dẫn): Mở thư mục
app.saveDirectory (): Lưu thư mục
app.revertFileModification (): Hoàn nguyên
app.importTags (thẻ, đường dẫn, fmtIdx): Nhập tệp
app.downloadImage (url, allFilesInDir): Tải xuống hình ảnh
app.exportTags (thẻ, đường dẫn, fmtIdx): Xuất tệp
app.writePlaylist (): Viết danh sách phát
app.selectAllFiles (): Chọn tất cả
app.deselectAllFiles (): Bỏ chọn
app.firstFile ([select]): Tới tệp đầu tiên
app.nextFile ([select]): Tới tệp tiếp theo
app.previousFile ([select]): Tới tệp trước đó
app.selectCurrentFile ([select]): Chọn tệp hiện tại
app.requestExpandFileList (): Mở rộng tất cả
app.applyFilenameFormat (): Áp dụng định dạng tên tệp
app.applyTagFormat (): Áp dụng định dạng thẻ
app.applyTextEncoding (): Áp dụng mã hóa văn bản
app.numberTracks (nr, tổng, thẻ, [tùy chọn]): Số bản nhạc
app.applyFilter (expr): Bộ lọc
app.convertToId3v23 (): Chuyển đổi ID3v2.4.0 thành ID3v2.3.0
app.convertToId3v24 (): Chuyển đổi ID3v2.3.0 thành ID3v2.4.0
app.getFilenameFromTags (tag): Tên tệp từ các thẻ
app.getTagsFromFilename (tag): Tên tệp cho các thẻ
app.getAllFrames (thẻ): Lấy đối tượng với tất cả các khung
app.getFrame (thẻ, tên): Lấy khung
app.setFrame (thẻ, tên, giá trị): Đặt khung
app.getPictureData (): Lấy dữ liệu từ khung ảnh
app.setPictureData (dữ liệu): Đặt dữ liệu trong khung ảnh
app.copyToOtherTag (thẻ): Thẻ cho các thẻ khác
app.copyTags (thẻ): Sao chép
app.pasteTags (tag): Dán
app.removeTags (tag): Xóa
app.playAudio (): Chơi
app.readConfig (): Đọc cấu hình
app.applyChangedConfiguration (): Áp dụng cấu hình
app.dirName: Tên thư mục
app.selectionInfo.fileName: Tên tệp
app.selectionInfo.filePath: Đường dẫn tệp tuyệt đối
app.selectionInfo.detailInfo: Chi tiết định dạng
app.selectionInfo.tagFormatV1: Định dạng thẻ 1
app.selectionInfo.tagFormatV2: Định dạng thẻ 2
app.selectionInfo.formatString (thẻ, định dạng): Mã thay thế trong chuỗi định dạng

Đối với các hoạt động không đồng bộ, các lệnh gọi lại có thể được kết nối với các tín hiệu.

function automaticImport (hồ sơ) {
function onAutomaticImportFinishing () {
app.batchImporter.ished.disconnect (onAutomaticImportFinishing)
}
app.batchImporter.ished.connect (onAutomaticImportFinishing)
app.batchImport (hồ sơ, tagv2)
}

function renameDirectory (format) {
function onRenameActionsSchedoned () {
app.renameActionsSchedoned.disconnect (onRenameActionsSchedoned)
app.performRenameActions ()
}
app.renameActionsSchedoned.connect (onRenameActionsSchedoned)
app.renameDirectory (tagv2v1, format, false)
}

Cấu hình Đối tượng
Các phần cấu hình khác nhau có thể truy cập được thông qua các phương thức của cấu hình. Của chúng
các thuộc tính có thể được liệt kê trong bảng điều khiển QML.

script.properties (configs.networkConfig ())

Các thuộc tính có thể được thiết lập:

configs.networkConfig (). useProxy = false

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

Sử dụng kid3-cli trực tuyến bằng các dịch vụ onworks.net