https://github.com/perdian/mp3tagtiger

Comfortably edit tags in MP3 music files
https://github.com/perdian/mp3tagtiger

java javafx mp3-files

Last synced: 29 days ago
JSON representation

Comfortably edit tags in MP3 music files

• Host: GitHub
• URL: https://github.com/perdian/mp3tagtiger
• Owner: perdian
• License: apache-2.0
• Created: 2014-09-28T01:38:23.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-05-30T15:53:42.000Z (8 months ago)
• Last Synced: 2024-10-28T11:10:11.235Z (3 months ago)
• Topics: java, javafx, mp3-files
• Language: Java
• Size: 4.23 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MP3 TagTiger

[![License](http://img.shields.io/:license-apache-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)

[![Build](https://img.shields.io/github/actions/workflow/status/perdian/mp3tagtiger/main.yml)](https://github.com/perdian/mp3tagtiger/actions/workflows/main.yml)

The MP3 TagTiger aims to be one of the best applications to use for editing metadata on MP3 files.

Although many other applications are offering a similar functionality, I found their use to be rather cumbersome.

It took me too long to reach the result I wanted (for example quickly changing the genre of all files within a directory).

So, being a developer myself I started to implement my own solution.

I do not claim that that the user experience choices made are working for everyone but they definitely work for me - and that's my main objective.

If anyone else agrees then perfect!

The application itself is completely free of any spy- or adware and doesn't send any data to any system.

It works completely offline.

## User interface

The user interface is centered around files in a directory (or sub-directories):

![Main Window](docs/screenshots/main-window.png)

Within the editor screen on the right side a copy button is available for every textfield.

This copy button will copy the currently selected text value to all other files that have been selected in the top right file list.

![Multiple files selected](docs/screenshots/multiple-files-1.png)

In the example above four files have been selected.

The currently active file is "06. Backfire" which is indicated by the arrow icon in the table (1).

If you click on the copy icon (2) the text "What a nice comment" will be copied into all the "comment" fields for the four selected files.

After that all these four files are marked as *dirty*, meaning they have been changed and the changes need to be saved in order to become permanent.

Dirty files are always recognizable by the  flag on the left of the file name within the list.

![Multiple files selected](docs/screenshots/multiple-files-2.png)

## Building the application

### Generic build

The application is written in pure Java, using a JavaFX frontend.

It's therefore platform independent and can be built and run on every platform supporting Java.

For building it simply checkout the repository from GitHub and call the Maven `package` target on the command line:

    $ git clone https://github.com/perdian/mp3tagtiger.git

    $ cd mp3tagtiger

    $ mvn clean package

    $ java -jar target/tagtiger.jar

### macOS build

On macOS a simplified build that directly generates a DMG archive from which the application can be installed or distributed can be built using the following commands:

    $ git clone https://github.com/perdian/mp3tagtiger.git

    $ cd mp3tagtiger

    $ mvn clean package -Pmacos-bundle

    $ open target/MP3\ TagTiger.dmg

## Authors

- [**Christian Seifert**](http://www.perdian.de)

## License

This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.