The Kid3 Handbook

Urs Fleisch

Copyright © 2008 Urs Fleisch

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. Also tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported. It is easy to set tags of multiple files to the same values (e.g. album, artist, year and genre in all files of the same album) and generate the tags from the file name or vice versa.

FDL

Table of Contents
1. Introduction
2. Using Kid3
2.1. Kid3 features
2.2. Example Usage
3. Command Reference
3.1. The Kid3 Window
3.1.1. The GUI Elements
3.1.2. The File Menu
3.1.3. The Edit Menu
3.1.4. The Tools Menu
3.1.5. The Settings Menu
3.1.6. The Help Menu
4. Credits and License
A. Installation
A.1. How to obtain Kid3
A.2. Requirements
A.3. Compilation and Installation
A.4. Configuration
B. D-Bus Interface
B.1. D-Bus Examples
B.2. D-Bus API
B.2.1. Open file or directory
B.2.2. Save all modified files
B.2.3. Get a detailed error message provided by some methods
B.2.4. Revert changes in the selected files
B.2.5. Import tags from a file
B.2.6. Export tags to a file
B.2.7. Create a playlist
B.2.8. Quit the application
B.2.9. Select all files
B.2.10. Deselect all files
B.2.11. Select the first file
B.2.12. Select the previous file
B.2.13. Select the next file
B.2.14. Expand or collapse the current file item if it is a directory
B.2.15. Apply the file name format
B.2.16. Apply the tag format
B.2.17. Set the directory name from the tags
B.2.18. Set subsequent track numbers in the selected files
B.2.19. Filter the files
B.2.20. Convert ID3v2.3 tags to ID3v2.4
B.2.21. Convert ID3v2.4 tags to ID3v2.3
B.2.22. Get path of directory
B.2.23. Get name of current file
B.2.24. Set name of selected file
B.2.25. Set format to use when setting the filename from the tags
B.2.26. Set the file names of the selected files from the tags
B.2.27. Get value of frame
B.2.28. Set value of frame
B.2.29. Get all frames of a tag
B.2.30. Get technical information about file
B.2.31. Set tag from file name
B.2.32. Set tag from other tag
B.2.33. Copy tag
B.2.34. Paste tag
B.2.35. Remove tag
B.2.36. Hide or show tag in GUI
B.2.37. Reparse the configuration

Chapter 1. Introduction

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. These tags can be edited by most MP3 players, but not in a very comfortable and efficient way. Moreover the tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported too.

Kid3 does not grab, encode nor play MP3 files, but it is targeted to edit the ID3 tags of all files of an album in an efficient way, i.e. with as few mouse clicks and key strokes as possible. Where most other programs can edit either ID3v1 or ID3v2 tags, Kid3 has full control over both versions, can convert tags between the two formats and has access to all ID3v2 tags. Tags of multiple files can be set to the same value, e.g. the artist, album, year and genre of all files of an album typically have the same values and can be set together. If the information for the tags is contained in the file name, the tags can be automatically set from the file name. It is also possible to set the file name according to the tags found in the file in arbitrary formats.

The editing task is further supported by automatic replacement of characters or substrings, for instance to remove illegal characters from filenames. Automatic control of upper and lower case characters makes it easy to use a consistent naming scheme in all tags.

The tag information for full albums can be taken from gnudb.org, TrackType.org, MusicBrainz, Discogs or other sources of track lists. The import format is freely configurable by regular expressions.

Please report any problems or feature requests to the author.

Chapter 2. Using Kid3

2.1. Kid3 features

  • Edit ID3v1.1 tags

  • Edit all ID3v2.3 and ID3v2.4 frames

  • Edit tags of multiple files

  • Convert between ID3v1 and ID3v2 tags

  • Edit MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack tags

  • Generate tags from filename

  • Generate filename from tags

  • Generate and change directory names from tags

  • Generate playlist file

  • Automatic case conversion and string translation

  • Import from gnudb.org, TrackType.org, MusicBrainz, Discogs and other data sources

  • Export as CSV, HTML (z.B. "artist"), string value Wert des Elementes);

Für Tag 2 (tagMask 2) gilt: Wenn kein Element mit name existiert, so wird ein neues Element hinzugefügt, wenn value leer ist, so wird das Element gelöscht. Um binäre Daten wie ein Bild einem Element hinzuzufügen, kann der Dateiname dem Elementnamen hinzugefügt werden, z.B. "Picture:/Pfad/zu/Datei".

Wenn OK wird true zurückgegeben.

B.2.29. Alle Elemente eines Tags

array of string getTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

Gibt eine Liste mit abwechselnd Elementnamen und -werten zurück.

B.2.30. Technische Informationen über Datei

array of string getInformation(void);

Eigenschaften sind Format, Bitrate, Samplerate, Channels, Duration, Channel Mode, VBR, Tag 1, Tag 2. Eigenschaften, welche nicht vorhanden sind, werden ausgelassen.

Gibt eine Liste mit abwechselnd Eigenschaftsnamen und -werten zurück.

B.2.31. Setze Tag aus Dateinamen

setTagFromFileName(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.32. Setze Tag aus anderem Tag

setTagFromOtherTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.33. Kopiere Tag

copyTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.34. Füge Tag ein

pasteTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.35. Entferne Tag

removeTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.36. Blende Tag im GUI aus oder zeige es an

hideTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2), boolean hide true um Tag auszublenden);

B.2.37. Lese die Konfiguration neu ein

reparseConfiguration(void);

Automatisierte Konfigurationsänderungen sind durch direktes Modifizieren der Konfigurationsdatei und anschliessendes Einlesen möglich.

./usr/share/doc/kid3-qt/NEWS.gz0000644000000000000000000000002510674255153014770 0ustar rootroot‹ã“×2./usr/share/doc/kid3-qt/AUTHORS0000644000000000000000000000005510674255152014724 0ustar rootrootUrs Fleisch ./usr/share/doc/kid3-qt/kid3_en.html0000644000000000000000000023237111005663346016063 0ustar rootroot The Kid3 Handbook

The Kid3 Handbook

Urs Fleisch

Copyright © 2008 Urs Fleisch

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. Also tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported. It is easy to set tags of multiple files to the same values (e.g. album, artist, year and genre in all files of the same album) and generate the tags from the file name or vice versa.

FDL

Table of Contents
1. Introduction
2. Using Kid3
2.1. Kid3 features
2.2. Example Usage
3. Command Reference
3.1. The Kid3 Window
3.1.1. The GUI Elements
3.1.2. The File Menu
3.1.3. The Edit Menu
3.1.4. The Tools Menu
3.1.5. The Settings Menu
3.1.6. The Help Menu
4. Credits and License
A. Installation
A.1. How to obtain Kid3
A.2. Requirements
A.3. Compilation and Installation
A.4. Configuration
B. D-Bus Interface
B.1. D-Bus Examples
B.2. D-Bus API
B.2.1. Open file or directory
B.2.2. Save all modified files
B.2.3. Get a detailed error message provided by some methods
B.2.4. Revert changes in the selected files
B.2.5. Import tags from a file
B.2.6. Export tags to a file
B.2.7. Create a playlist
B.2.8. Quit the application
B.2.9. Select all files
B.2.10. Deselect all files
B.2.11. Select the first file
B.2.12. Select the previous file
B.2.13. Select the next file
B.2.14. Expand or collapse the current file item if it is a directory
B.2.15. Apply the file name format
B.2.16. Apply the tag format
B.2.17. Set the directory name from the tags
B.2.18. Set subsequent track numbers in the selected files
B.2.19. Filter the files
B.2.20. Convert ID3v2.3 tags to ID3v2.4
B.2.21. Convert ID3v2.4 tags to ID3v2.3
B.2.22. Get path of directory
B.2.23. Get name of current file
B.2.24. Set name of selected file
B.2.25. Set format to use when setting the filename from the tags
B.2.26. Set the file names of the selected files from the tags
B.2.27. Get value of frame
B.2.28. Set value of frame
B.2.29. Get all frames of a tag
B.2.30. Get technical information about file
B.2.31. Set tag from file name
B.2.32. Set tag from other tag
B.2.33. Copy tag
B.2.34. Paste tag
B.2.35. Remove tag
B.2.36. Hide or show tag in GUI
B.2.37. Reparse the configuration

Chapter 1. Introduction

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. These tags can be edited by most MP3 players, but not in a very comfortable and efficient way. Moreover the tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported too.

Kid3 does not grab, encode nor play MP3 files, but it is targeted to edit the ID3 tags of all files of an album in an efficient way, i.e. with as few mouse clicks and key strokes as possible. Where most other programs can edit either ID3v1 or ID3v2 tags, Kid3 has full control over both versions, can convert tags between the two formats and has access to all ID3v2 tags. Tags of multiple files can be set to the same value, e.g. the artist, album, year and genre of all files of an album typically have the same values and can be set together. If the information for the tags is contained in the file name, the tags can be automatically set from the file name. It is also possible to set the file name according to the tags found in the file in arbitrary formats.

The editing task is further supported by automatic replacement of characters or substrings, for instance to remove illegal characters from filenames. Automatic control of upper and lower case characters makes it easy to use a consistent naming scheme in all tags.

The tag information for full albums can be taken from gnudb.org, TrackType.org, MusicBrainz, Discogs or other sources of track lists. The import format is freely configurable by regular expressions.

Please report any problems or feature requests to the author.

Chapter 2. Using Kid3

2.1. Kid3 features

  • Edit ID3v1.1 tags

  • Edit all ID3v2.3 and ID3v2.4 frames

  • Edit tags of multiple files

  • Convert between ID3v1 and ID3v2 tags

  • Edit MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack tags

  • Generate tags from filename

  • Generate filename from tags

  • Generate and change directory names from tags

  • Generate playlist file

  • Automatic case conversion and string translation

  • Import from gnudb.org, TrackType.org, MusicBrainz, Discogs and other data sources

  • Export as CSV, HTML (z.B. "artist"), string value Wert des Elementes);

Für Tag 2 (tagMask 2) gilt: Wenn kein Element mit name existiert, so wird ein neues Element hinzugefügt, wenn value leer ist, so wird das Element gelöscht. Um binäre Daten wie ein Bild einem Element hinzuzufügen, kann der Dateiname dem Elementnamen hinzugefügt werden, z.B. "Picture:/Pfad/zu/Datei".

Wenn OK wird true zurückgegeben.

B.2.29. Alle Elemente eines Tags

array of string getTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

Gibt eine Liste mit abwechselnd Elementnamen und -werten zurück.

B.2.30. Technische Informationen über Datei

array of string getInformation(void);

Eigenschaften sind Format, Bitrate, Samplerate, Channels, Duration, Channel Mode, VBR, Tag 1, Tag 2. Eigenschaften, welche nicht vorhanden sind, werden ausgelassen.

Gibt eine Liste mit abwechselnd Eigenschaftsnamen und -werten zurück.

B.2.31. Setze Tag aus Dateinamen

setTagFromFileName(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.32. Setze Tag aus anderem Tag

setTagFromOtherTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.33. Kopiere Tag

copyTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.34. Füge Tag ein

pasteTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.35. Entferne Tag

removeTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.36. Blende Tag im GUI aus oder zeige es an

hideTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2), boolean hide true um Tag auszublenden);

B.2.37. Lese die Konfiguration neu ein

reparseConfiguration(void);

Automatisierte Konfigurationsänderungen sind durch direktes Modifizieren der Konfigurationsdatei und anschliessendes Einlesen möglich.

./usr/share/doc/kid3-qt/NEWS.gz0000644000000000000000000000002510674255153014770 0ustar rootroot‹ã“×2./usr/share/doc/kid3-qt/AUTHORS0000644000000000000000000000005510674255152014724 0ustar rootrootUrs Fleisch ./usr/share/doc/kid3-qt/kid3_en.html0000644000000000000000000023237111005663346016063 0ustar rootroot The Kid3 Handbook

The Kid3 Handbook

Urs Fleisch

Copyright © 2008 Urs Fleisch

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. Also tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported. It is easy to set tags of multiple files to the same values (e.g. album, artist, year and genre in all files of the same album) and generate the tags from the file name or vice versa.

FDL

Table of Contents
1. Introduction
2. Using Kid3
2.1. Kid3 features
2.2. Example Usage
3. Command Reference
3.1. The Kid3 Window
3.1.1. The GUI Elements
3.1.2. The File Menu
3.1.3. The Edit Menu
3.1.4. The Tools Menu
3.1.5. The Settings Menu
3.1.6. The Help Menu
4. Credits and License
A. Installation
A.1. How to obtain Kid3
A.2. Requirements
A.3. Compilation and Installation
A.4. Configuration
B. D-Bus Interface
B.1. D-Bus Examples
B.2. D-Bus API
B.2.1. Open file or directory
B.2.2. Save all modified files
B.2.3. Get a detailed error message provided by some methods
B.2.4. Revert changes in the selected files
B.2.5. Import tags from a file
B.2.6. Export tags to a file
B.2.7. Create a playlist
B.2.8. Quit the application
B.2.9. Select all files
B.2.10. Deselect all files
B.2.11. Select the first file
B.2.12. Select the previous file
B.2.13. Select the next file
B.2.14. Expand or collapse the current file item if it is a directory
B.2.15. Apply the file name format
B.2.16. Apply the tag format
B.2.17. Set the directory name from the tags
B.2.18. Set subsequent track numbers in the selected files
B.2.19. Filter the files
B.2.20. Convert ID3v2.3 tags to ID3v2.4
B.2.21. Convert ID3v2.4 tags to ID3v2.3
B.2.22. Get path of directory
B.2.23. Get name of current file
B.2.24. Set name of selected file
B.2.25. Set format to use when setting the filename from the tags
B.2.26. Set the file names of the selected files from the tags
B.2.27. Get value of frame
B.2.28. Set value of frame
B.2.29. Get all frames of a tag
B.2.30. Get technical information about file
B.2.31. Set tag from file name
B.2.32. Set tag from other tag
B.2.33. Copy tag
B.2.34. Paste tag
B.2.35. Remove tag
B.2.36. Hide or show tag in GUI
B.2.37. Reparse the configuration

Chapter 1. Introduction

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. These tags can be edited by most MP3 players, but not in a very comfortable and efficient way. Moreover the tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported too.

Kid3 does not grab, encode nor play MP3 files, but it is targeted to edit the ID3 tags of all files of an album in an efficient way, i.e. with as few mouse clicks and key strokes as possible. Where most other programs can edit either ID3v1 or ID3v2 tags, Kid3 has full control over both versions, can convert tags between the two formats and has access to all ID3v2 tags. Tags of multiple files can be set to the same value, e.g. the artist, album, year and genre of all files of an album typically have the same values and can be set together. If the information for the tags is contained in the file name, the tags can be automatically set from the file name. It is also possible to set the file name according to the tags found in the file in arbitrary formats.

The editing task is further supported by automatic replacement of characters or substrings, for instance to remove illegal characters from filenames. Automatic control of upper and lower case characters makes it easy to use a consistent naming scheme in all tags.

The tag information for full albums can be taken from gnudb.org, TrackType.org, MusicBrainz, Discogs or other sources of track lists. The import format is freely configurable by regular expressions.

Please report any problems or feature requests to the author.

Chapter 2. Using Kid3

2.1. Kid3 features

  • Edit ID3v1.1 tags

  • Edit all ID3v2.3 and ID3v2.4 frames

  • Edit tags of multiple files

  • Convert between ID3v1 and ID3v2 tags

  • Edit MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack tags

  • Generate tags from filename

  • Generate filename from tags

  • Generate and change directory names from tags

  • Generate playlist file

  • Automatic case conversion and string translation

  • Import from gnudb.org, TrackType.org, MusicBrainz, Discogs and other data sources

  • Export as CSV, HTML (z.B. "artist"), string value Wert des Elementes);

Für Tag 2 (tagMask 2) gilt: Wenn kein Element mit name existiert, so wird ein neues Element hinzugefügt, wenn value leer ist, so wird das Element gelöscht. Um binäre Daten wie ein Bild einem Element hinzuzufügen, kann der Dateiname dem Elementnamen hinzugefügt werden, z.B. "Picture:/Pfad/zu/Datei".

Wenn OK wird true zurückgegeben.

B.2.29. Alle Elemente eines Tags

array of string getTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

Gibt eine Liste mit abwechselnd Elementnamen und -werten zurück.

B.2.30. Technische Informationen über Datei

array of string getInformation(void);

Eigenschaften sind Format, Bitrate, Samplerate, Channels, Duration, Channel Mode, VBR, Tag 1, Tag 2. Eigenschaften, welche nicht vorhanden sind, werden ausgelassen.

Gibt eine Liste mit abwechselnd Eigenschaftsnamen und -werten zurück.

B.2.31. Setze Tag aus Dateinamen

setTagFromFileName(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.32. Setze Tag aus anderem Tag

setTagFromOtherTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.33. Kopiere Tag

copyTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.34. Füge Tag ein

pasteTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.35. Entferne Tag

removeTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.36. Blende Tag im GUI aus oder zeige es an

hideTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2), boolean hide true um Tag auszublenden);

B.2.37. Lese die Konfiguration neu ein

reparseConfiguration(void);

Automatisierte Konfigurationsänderungen sind durch direktes Modifizieren der Konfigurationsdatei und anschliessendes Einlesen möglich.

./usr/share/doc/kid3-qt/NEWS.gz0000644000000000000000000000002510674255153014770 0ustar rootroot‹ã“×2./usr/share/doc/kid3-qt/AUTHORS0000644000000000000000000000005510674255152014724 0ustar rootrootUrs Fleisch ./usr/share/doc/kid3-qt/kid3_en.html0000644000000000000000000023237111005663346016063 0ustar rootroot The Kid3 Handbook

The Kid3 Handbook

Urs Fleisch

Copyright © 2008 Urs Fleisch

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. Also tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported. It is easy to set tags of multiple files to the same values (e.g. album, artist, year and genre in all files of the same album) and generate the tags from the file name or vice versa.

FDL

Table of Contents
1. Introduction
2. Using Kid3
2.1. Kid3 features
2.2. Example Usage
3. Command Reference
3.1. The Kid3 Window
3.1.1. The GUI Elements
3.1.2. The File Menu
3.1.3. The Edit Menu
3.1.4. The Tools Menu
3.1.5. The Settings Menu
3.1.6. The Help Menu
4. Credits and License
A. Installation
A.1. How to obtain Kid3
A.2. Requirements
A.3. Compilation and Installation
A.4. Configuration
B. D-Bus Interface
B.1. D-Bus Examples
B.2. D-Bus API
B.2.1. Open file or directory
B.2.2. Save all modified files
B.2.3. Get a detailed error message provided by some methods
B.2.4. Revert changes in the selected files
B.2.5. Import tags from a file
B.2.6. Export tags to a file
B.2.7. Create a playlist
B.2.8. Quit the application
B.2.9. Select all files
B.2.10. Deselect all files
B.2.11. Select the first file
B.2.12. Select the previous file
B.2.13. Select the next file
B.2.14. Expand or collapse the current file item if it is a directory
B.2.15. Apply the file name format
B.2.16. Apply the tag format
B.2.17. Set the directory name from the tags
B.2.18. Set subsequent track numbers in the selected files
B.2.19. Filter the files
B.2.20. Convert ID3v2.3 tags to ID3v2.4
B.2.21. Convert ID3v2.4 tags to ID3v2.3
B.2.22. Get path of directory
B.2.23. Get name of current file
B.2.24. Set name of selected file
B.2.25. Set format to use when setting the filename from the tags
B.2.26. Set the file names of the selected files from the tags
B.2.27. Get value of frame
B.2.28. Set value of frame
B.2.29. Get all frames of a tag
B.2.30. Get technical information about file
B.2.31. Set tag from file name
B.2.32. Set tag from other tag
B.2.33. Copy tag
B.2.34. Paste tag
B.2.35. Remove tag
B.2.36. Hide or show tag in GUI
B.2.37. Reparse the configuration

Chapter 1. Introduction

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. These tags can be edited by most MP3 players, but not in a very comfortable and efficient way. Moreover the tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported too.

Kid3 does not grab, encode nor play MP3 files, but it is targeted to edit the ID3 tags of all files of an album in an efficient way, i.e. with as few mouse clicks and key strokes as possible. Where most other programs can edit either ID3v1 or ID3v2 tags, Kid3 has full control over both versions, can convert tags between the two formats and has access to all ID3v2 tags. Tags of multiple files can be set to the same value, e.g. the artist, album, year and genre of all files of an album typically have the same values and can be set together. If the information for the tags is contained in the file name, the tags can be automatically set from the file name. It is also possible to set the file name according to the tags found in the file in arbitrary formats.

The editing task is further supported by automatic replacement of characters or substrings, for instance to remove illegal characters from filenames. Automatic control of upper and lower case characters makes it easy to use a consistent naming scheme in all tags.

The tag information for full albums can be taken from gnudb.org, TrackType.org, MusicBrainz, Discogs or other sources of track lists. The import format is freely configurable by regular expressions.

Please report any problems or feature requests to the author.

Chapter 2. Using Kid3

2.1. Kid3 features

  • Edit ID3v1.1 tags

  • Edit all ID3v2.3 and ID3v2.4 frames

  • Edit tags of multiple files

  • Convert between ID3v1 and ID3v2 tags

  • Edit MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack tags

  • Generate tags from filename

  • Generate filename from tags

  • Generate and change directory names from tags

  • Generate playlist file

  • Automatic case conversion and string translation

  • Import from gnudb.org, TrackType.org, MusicBrainz, Discogs and other data sources

  • Export as CSV, HTML (z.B. "artist"), string value Wert des Elementes);

Für Tag 2 (tagMask 2) gilt: Wenn kein Element mit name existiert, so wird ein neues Element hinzugefügt, wenn value leer ist, so wird das Element gelöscht. Um binäre Daten wie ein Bild einem Element hinzuzufügen, kann der Dateiname dem Elementnamen hinzugefügt werden, z.B. "Picture:/Pfad/zu/Datei".

Wenn OK wird true zurückgegeben.

B.2.29. Alle Elemente eines Tags

array of string getTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

Gibt eine Liste mit abwechselnd Elementnamen und -werten zurück.

B.2.30. Technische Informationen über Datei

array of string getInformation(void);

Eigenschaften sind Format, Bitrate, Samplerate, Channels, Duration, Channel Mode, VBR, Tag 1, Tag 2. Eigenschaften, welche nicht vorhanden sind, werden ausgelassen.

Gibt eine Liste mit abwechselnd Eigenschaftsnamen und -werten zurück.

B.2.31. Setze Tag aus Dateinamen

setTagFromFileName(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.32. Setze Tag aus anderem Tag

setTagFromOtherTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.33. Kopiere Tag

copyTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.34. Füge Tag ein

pasteTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.35. Entferne Tag

removeTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.36. Blende Tag im GUI aus oder zeige es an

hideTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2), boolean hide true um Tag auszublenden);

B.2.37. Lese die Konfiguration neu ein

reparseConfiguration(void);

Automatisierte Konfigurationsänderungen sind durch direktes Modifizieren der Konfigurationsdatei und anschliessendes Einlesen möglich.

./usr/share/doc/kid3-qt/NEWS.gz0000644000000000000000000000002510674255153014770 0ustar rootroot‹ã“×2./usr/share/doc/kid3-qt/AUTHORS0000644000000000000000000000005510674255152014724 0ustar rootrootUrs Fleisch ./usr/share/doc/kid3-qt/kid3_en.html0000644000000000000000000023237111005663346016063 0ustar rootroot The Kid3 Handbook

The Kid3 Handbook

Urs Fleisch

Copyright © 2008 Urs Fleisch

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. Also tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported. It is easy to set tags of multiple files to the same values (e.g. album, artist, year and genre in all files of the same album) and generate the tags from the file name or vice versa.

FDL

Table of Contents
1. Introduction
2. Using Kid3
2.1. Kid3 features
2.2. Example Usage
3. Command Reference
3.1. The Kid3 Window
3.1.1. The GUI Elements
3.1.2. The File Menu
3.1.3. The Edit Menu
3.1.4. The Tools Menu
3.1.5. The Settings Menu
3.1.6. The Help Menu
4. Credits and License
A. Installation
A.1. How to obtain Kid3
A.2. Requirements
A.3. Compilation and Installation
A.4. Configuration
B. D-Bus Interface
B.1. D-Bus Examples
B.2. D-Bus API
B.2.1. Open file or directory
B.2.2. Save all modified files
B.2.3. Get a detailed error message provided by some methods
B.2.4. Revert changes in the selected files
B.2.5. Import tags from a file
B.2.6. Export tags to a file
B.2.7. Create a playlist
B.2.8. Quit the application
B.2.9. Select all files
B.2.10. Deselect all files
B.2.11. Select the first file
B.2.12. Select the previous file
B.2.13. Select the next file
B.2.14. Expand or collapse the current file item if it is a directory
B.2.15. Apply the file name format
B.2.16. Apply the tag format
B.2.17. Set the directory name from the tags
B.2.18. Set subsequent track numbers in the selected files
B.2.19. Filter the files
B.2.20. Convert ID3v2.3 tags to ID3v2.4
B.2.21. Convert ID3v2.4 tags to ID3v2.3
B.2.22. Get path of directory
B.2.23. Get name of current file
B.2.24. Set name of selected file
B.2.25. Set format to use when setting the filename from the tags
B.2.26. Set the file names of the selected files from the tags
B.2.27. Get value of frame
B.2.28. Set value of frame
B.2.29. Get all frames of a tag
B.2.30. Get technical information about file
B.2.31. Set tag from file name
B.2.32. Set tag from other tag
B.2.33. Copy tag
B.2.34. Paste tag
B.2.35. Remove tag
B.2.36. Hide or show tag in GUI
B.2.37. Reparse the configuration

Chapter 1. Introduction

Kid3 is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an efficient way. These tags can be edited by most MP3 players, but not in a very comfortable and efficient way. Moreover the tags in Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack files are supported too.

Kid3 does not grab, encode nor play MP3 files, but it is targeted to edit the ID3 tags of all files of an album in an efficient way, i.e. with as few mouse clicks and key strokes as possible. Where most other programs can edit either ID3v1 or ID3v2 tags, Kid3 has full control over both versions, can convert tags between the two formats and has access to all ID3v2 tags. Tags of multiple files can be set to the same value, e.g. the artist, album, year and genre of all files of an album typically have the same values and can be set together. If the information for the tags is contained in the file name, the tags can be automatically set from the file name. It is also possible to set the file name according to the tags found in the file in arbitrary formats.

The editing task is further supported by automatic replacement of characters or substrings, for instance to remove illegal characters from filenames. Automatic control of upper and lower case characters makes it easy to use a consistent naming scheme in all tags.

The tag information for full albums can be taken from gnudb.org, TrackType.org, MusicBrainz, Discogs or other sources of track lists. The import format is freely configurable by regular expressions.

Please report any problems or feature requests to the author.

Chapter 2. Using Kid3

2.1. Kid3 features

  • Edit ID3v1.1 tags

  • Edit all ID3v2.3 and ID3v2.4 frames

  • Edit tags of multiple files

  • Convert between ID3v1 and ID3v2 tags

  • Edit MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio and WavPack tags

  • Generate tags from filename

  • Generate filename from tags

  • Generate and change directory names from tags

  • Generate playlist file

  • Automatic case conversion and string translation

  • Import from gnudb.org, TrackType.org, MusicBrainz, Discogs and other data sources

  • Export as CSV, HTML (z.B. "artist"), string value Wert des Elementes);

Für Tag 2 (tagMask 2) gilt: Wenn kein Element mit name existiert, so wird ein neues Element hinzugefügt, wenn value leer ist, so wird das Element gelöscht. Um binäre Daten wie ein Bild einem Element hinzuzufügen, kann der Dateiname dem Elementnamen hinzugefügt werden, z.B. "Picture:/Pfad/zu/Datei".

Wenn OK wird true zurückgegeben.

B.2.29. Alle Elemente eines Tags

array of string getTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

Gibt eine Liste mit abwechselnd Elementnamen und -werten zurück.

B.2.30. Technische Informationen über Datei

array of string getInformation(void);

Eigenschaften sind Format, Bitrate, Samplerate, Channels, Duration, Channel Mode, VBR, Tag 1, Tag 2. Eigenschaften, welche nicht vorhanden sind, werden ausgelassen.

Gibt eine Liste mit abwechselnd Eigenschaftsnamen und -werten zurück.

B.2.31. Setze Tag aus Dateinamen

setTagFromFileName(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.32. Setze Tag aus anderem Tag

setTagFromOtherTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.33. Kopiere Tag

copyTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.34. Füge Tag ein

pasteTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.35. Entferne Tag

removeTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2));

B.2.36. Blende Tag im GUI aus oder zeige es an

hideTag(int32 tagMask Tag Bit (1 für Tag 1, 2 für Tag 2), boolean hide true um Tag auszublenden);

B.2.37. Lese die Konfiguration neu ein

reparseConfiguration(void);

Automatisierte Konfigurationsänderungen sind durch direktes Modifizieren der Konfigurationsdatei