Home

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*

• Operations that affect all visible songs affect everything except for songs that have been filtered out.

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