MP3 Tool Kit 是一组工具，用于编辑 ID3Tags、使用 Mp3Gain 调整音量_java_代码_下载

# MP3 Tool Kit MP3 Tool Kit is construction kit which allows to bundle components to manipulate audio files. Each component is per default independent but can also be dependent to other components. Some already existent components are for example an ID3Tag Editor and a graphical user interface for [Mp3Gain](http://mp3gain.sourceforge.net/). More components can be added too. This is a documentation about how to use this application. If you want a documentation from a more technical point of you and how to extend it take a look on the [technical description](https://github.com/cf86/MP3ToolKit/blob/master/TechnicalDescription.md). ## Introduction Guess all of you know the problem. You got some new audio files and some of them do not have an ID3Tag, the filename doesn't match your needs, the volume differs from your other audio files, so you always have to adjust the volume in your player for every track. Additionally you have to sort the audio files to your music collection. Another problem I had alot is I want to transfer some audio files to my smartphone, so copied them into the folder and thats it.The problem is I really like a special folder structure on my smartphne for example [artist]/[album]/[track].mp3. Of course there are some programs for windows and linux to solve this problems, but I really don't want to install a bunch programs on my system just to solve it. Additionally most of the programs are just available for either windows or linux. Thats why I decided to write my own application to solve this problems. The application is written in Java, so it should work on windows and linux based systems as well. ## Some Features Here are some features of the application. A more detailed description of all components comes later. * Has an **ID3 Tag** editor with some features like automatic ID3Tag, Cover Art and Lyrics search from the internet using some predefined collectors. * Includes a **Mp3Gain** wrapper to adjust the volume of all audio files so that adjusting the volume for every song is not neccessary anymore. Furthermore **Mp3Gain** does not re-encode the audio files, so the volume adjustment is completely undo-able. * Has a **Rename Tool** which can rename files using some special rules to make the files name fit your needs. * Has a **Folder Generator** to sort new audio files in your music collection or to generate a folder structure depending on your made rules out of a bunch of unsorted audio files. * Supports Drag&Drop of folders or files into the application folder or tree structure to load them instant. Which means folders or files can be dragged from the systems file system directly into the application. * Is easy extendable and customizable by offering a few interfaces to add more collectors or add some new tabs with new features for example an audio converter or playlist generator and so on. For more details about how to extend the application have a look into the [technical description](https://github.com/cf86/MP3ToolKit/blob/master/TechnicalDescription.md). ## Installation To run this application a java runtime environment is neccessary. **Windows**: Just download the *MP33ToolKit_Windows.zip* ([here](https://github.com/cf86/MP3ToolKit/blob/master/MP3ToolKit_Windows.zip?raw=true)) and extract it in a folder of your choice (it is recommended that this folder is empty). It is usuable out of the box and nothing needs to be installed. Mp3Gain is included in this bundle and does not need to be installed seperatly. **Linux/Mac OS X**: Download the *MP3ToolKit_Linux.zip* ([here](https://github.com/cf86/MP3ToolKit/blob/master/MP3ToolKit_Linux.zip?raw=true)) and extract it in a folder of your choice (it is recommended that this folder is empty). This zip file only contains the runnable \*.jar file which can be startet using any java runtime environment. In order to use the *Mp3Gain* function *Mp3Gain* needs to be installed. On the most linux derivatives like Ubuntu or Debian this can be done using ```shell apt-get install mp3gain ``` (I have no idea how to install this on Mac OS X, the shell command `mp3gain` needs to be available in order to use this.) ## Available Components In this section we will take a look on all available components and see how to use them. ### ID3Tag Editor  The ID3Tag editor is as the name says there to edit the ID3Tag. All ID3v2 tags will be read and can be updated. If no tag is set a new ID3v2.4 tag will be created. Additionally ID3v1 tags can be written to support older devices like pretty old car radios. If this is neccessary it can be enabled in the Preferences. To add files to the list you can use the buttons on the bottom side to add a file or a complete folder (if the recursive checkbox is checked all subfolders will be added too). Alternatively you can add folders using the tree on the left side. To add a folder just mark this folder and click the load button under the tree. If the auto add checkbox is enabled the folder will be loaded instantly after selecting it without the need to click the load button. To delete files you can use the delete buttons on the bottom side.  After selecting a file the ID3 data is shown and can be edited. If more than one file is selected the last one will be shown.  If more than one file is selected one tag can be copied to all other marked tags by pressing the small button next to the tag field on the right side. For example if the small button next to the cover art would be pressed this cover would be set to all selected audio files. The lyrics or cover art can be loaded from the harddrive or saved to the harddrive too. If a files ID3 data is changed the changed column will be selected. The ID3tag can be changed using some features which can be found directly under the ID3 data.  The first 3 buttons use the enabled collectors to try to find the ID3 data, the lyrics and the cover art from the internet using informations from websites e.g. from lastfm. For ID3 data this would for example looks like this:  In this example the collector found 5 values. Using the checkboxes next to the values you can decide which of them should be used and which shouldn't. To use the collector at least the artist and the song title needs to be given. To find the cover art the album name would be prefered too. Another feature the ID3Tag Editor brings with it is the auto generation of the ID3 data depending on the filename (the yellow symbol).  The generator needs a regular expression and extracts all data depending on this expression out of the filename. For example lets say the filename of our file is "Metallica-08-Nothing else matters". Now we need to tell the generator the syntax of this filename. Obviously the first part is the Artist follows by the track number and the song title. So lets pick the the expression "%a-%n-%t" and apply it on the filename. It would extract artist: Metallica, track#: 08 and title: Nothing else matters. All abbreviations for each tag can be found by clicking the question mark next to the combobox. Additionally some expressions are already defined and more can be added in the preferences. Using the radionbutton next to the close and apply button you can decide if the generator should apply the given expression on all loaded files, or just the selected ones. After applying all changes will be shown and have to be confirmed by you. The next mentionable feature is the