SoulGears requires Java 1.7 or higher!
To run on Mac OS X:
Open Applications/Utilities/Terminal. Use "cd" command to change directory to the folder containing soulgears. Type
java -XstartOnFirstThread -jar SoulGears.jar
To run on Linux
Open Terminal. Use "cd" command to change directory to the folder containing soulgears. Type
java -jar SoulGears.jar
Note: You must have execution permissions on fpcalc for automatic song lookup to be enabled.
How to use SoulGears
Step 1: Load mp3 files
Either drag and drop the files onto the program or use any of the open buttons.
Step 2: Set tag information
Using either the manual tagging box or the automatic tagging box, set tag information for the songs. The automatic field allows you to either scan the songs to automatically detect their tags, or to use a pattern to extract tag information from the song's filename.
For example:
The format "%a - %t" represents a file name formatted as "Artist - Title" and when applied to the song "Nujabes - Winter Lane (Remix)" will set that song's artist to "Nujabes" and title to "Winter Lane (Remix)"
For the song "Beowulf track 01 - Main Theme - Alan Silvestri" a good choice of format would be "Beowulf track %# - %t - %a" would set the song's track number to "1", the song's title to "Main Theme", and the song's artist to "Alan Silvestri"
Asterisks can also be used to ignore certain information.
For example:
If you wished to only extract the title from "Nujabes - Winter Lane (Remix)" you could use the format "* - %t"
To see all of the tag characters you can use, simply mouse over the format text box. You can also enable automatic capitalization when extracting tag information from filenames. Simply check the box for automatic capitalization and choose the type you wish to use. Mousing over the different types shows how they differ from one another.
Step 3: Apply new tags
Applying manual or automatic tag information will result in pending changes. This is what the tag information in the file will be set to when you decide to save.
Step 4: Set output options
Set the output format and location. The output location is the base directory will the files will be saved. The output format is the directory structure and filenaming convention that will be used when saving.
For example:
An output format of "%a%t" will create a folder with the artist name of each song being saved, and will save each song
with the filename "title.mp3".
Mousing over any of the options will yield a clearer explanation as to what it does.
Step 5: Save the songs
When you click any of the save buttons a window will pop up showing the progress of the songs being saved. Any song that saves succesfully will show what it's been renamed to and what its tags have been changed to. Any songs that are unable to save will show an error and will stay in the program for you to fix.
Hotkeys
On song table:
Ctrl+a: Select all songs Del: Remove selected songs
On text boxes:
Ctrl+a: Select all text in box Alt+Arrow keys: Move cursor to text box in given direction Ctrl+Arrow keys: Move song table selection up or down Ctrl+Shift+Arrow keys: Add to selection of song table up or down
On manual text boxes:
Enter: Apply manual fields to selected songs Alt+Enter: Apply manual fields to all songs currently visible in song table*
On automatic text box:
Enter: Apply automatic format to selected songs Alt+Enter: Apply automatic format to all songs currently visible in song table*
On save text boxes:
Enter: Save songs with pending changes Alt+Enter: Save all songs currently visible in song table*
Special characters
For automatic format text box:
t - Title a - Artist A - Album g - Genre y - Year c - Comment # - Track number * - Wildcard
For save format text box:
t - Title a - Artist A - Album g - Genre y - Year c - Comment # - Track number * - Sequential numbering / or \ - Path separator
All special characters excpt for * and / must be preceded by a % sign