Intall Java on your system, SUN J2SE version 1.4 or later. (http://java.sun.com)

Unzip MediaSort package in a directory and edit build.xml file.
That's it, you can go directly to Usage section.

MediaSort has been tested successfully on Linux and Windows platforms using SUN J2SE 1.4 and Ant 1.6.5. It does not work with Microsoft JVM neither GCJ Java JVM.

If you want to use MediaSort as an Ant FileMapper in your own Ant scripts, you should do the following intallation.

Intall Ant on your system, version 1.6.5 or later. (http://ant.apache.org)
You should have basic knowledge of Ant to get MediaSort FileMapper running.

Copy the following files :
- <MEDIA_SORT_HOME>/lib/mp3spi/*.jar
- <MEDIA_SORT_HOME>/lib/oggvorbis/*.jar
to <ANT_HOME>/lib directory.
(MEDIA_SORT_HOME is the home directory of MediaSort)

Add all <MEDIA_SORT_HOME>/lib libraries (excepted lib/ant) to a path in your and project and define the following mapper :
<typedef name="sortmapper" classname="com.starobject.mediasort.mapper.SortMapper" classpathref="project.classpath"/>
You can open <MEDIA_SORT_HOME>/build.xml to get an example.

Go to the directory where you unzipped MediaSort package.
Launch run.cmd on Windows Platform or run.sh on Linux Platform.
You should get the following Java Graphical User Interface :

• Select a Source directory where are located the files to be sorted.
  The list of file extensions and Metadata Attributes available should appear.
• In the filter field, you can remove file extensions to retrict the set of files.
  !!! File extensions are case sensitive and should be separated by semicolon ";" !!!
• Select a Target directory where the sorted files will be copied.
• Build a pattern to sort and rename your files.

  For example, the following pattern copies your mp3 files and sorts them by author and then title.

  [MP3 - author]/[MP3 - title].mp3

• Finally, click "Copy" and go the the Console Tab to see what's happenning.
  

This should result in the following sort :

You can build your own path with any metadata attributes available in your files.

Some more examples :

• Sort pictures by date:

  [Exif - Date/Time Original - Year]/[Exif - Date/Time Original - Year]_[Exif - Date/Time Original - Month]/[Exif - Date/Time Original - Year]_[Exif - Date/Time Original - Month]_[Exif - Date/Time Original - Date]_[Exif - Date/Time Original - Hour]_[Exif - Date/Time Original - Minute]_[Exif - Date/Time Original - Second]_[FS - Checksum].jpg
  

  The result is :
  |---2006 | |---2006_04 | | 2006_04_17_11_26_40_641350660.jpg | | 2006_04_17_11_28_01_1216942200.jpg | | 2006_04_16_02_38_22_1183690407.jpg | | | |---2006_05 | 2006_05_02_11_24_42_36923745.jpg | 2006_05_02_11_23_15_2259095105.jpg | 2006_05_02_11_18_39_269731681.jpg | |---2005 |---2005_06 2005_06_13_10_30_02_3864247544.jpg 2005_06_13_08_43_29_1534071413.jpg 2005_06_14_11_18_20_3179087531.jpg

• Sort pictures by camera model and then by width & height :

  [Exif - Model]/[Exif - Exif Image Width] X [Exif - Exif Image Height]/[FS - Name]_[FS - Checksum].jpg
  

  The result is :
  |---CYBERSHOT | |---2048 pixels X 1536 pixels | Picture 202.jpg_3997152079.jpg | Picture 195.jpg_782141148.jpg | Picture 207.jpg_2336736967.jpg | Picture 192.jpg_3864247544.jpg | |---Canon PowerShot S2 IS |---2592 pixels X 1944 pixels | IMG_1899.jpg_227831633.jpg | IMG_1903.jpg_3402713600.jpg | |---2048 pixels X 1536 pixels IMG_1996.jpg_269731681.jpg IMG_1998.jpg_36923745.jpg

There are three ways to use MediaSort :

1. Copy
   "Copy" copies your files from source to target. It sorts and rename them with the pattern you defined.
2. Move
   "Move" moves your files from source to target. It erases all files in source. BE CAREFULL that some files might have the same metadata. If your pattern is not explicit enough, you might lose some files. To be sure we suggest you to use [FS - Checksum] in your pattern so that destination file names are unique.
3. Index
   "Index" do not move neither copy your files. It creates a virtual tree to sort your files according to the pattern you defined. The index is stored in an XML file and rendered in an HTML javascript tree.

   You can create several indexes of the same files. For example you can have a tree view of your songs by year/author and another by album/author ! Or you can have a tree view of your pictures by year/month/date or by camera model/photo size/

   Indexes are saved in the config directory. See next section.

   Here is an example of two indexes of the same files :

   

   

   

You can open/save your configuration.

• Create a directory for your new config or index.
• Use File>Open, File>Save and File>Save As .. menu.

Index and config files are stored in that directory.

Edit build.xml file and add the <sortmapper/> Ant FileMapper to your tasks

The following task copies your mp3 files and sorts them by author and then title.
<target name="ExampleMusic"> <copy todir="D:\music\target"> <fileset dir="C:\music\source"> <include name="**/*.mp3" /> </fileset> <sortmapper from="C:\music\source" to="[MP3 - author]/[MP3 - title].mp3" /> </copy> </target>

It uses a Ant <copy/> with a custom mapper : <sortmapper/>

That mapper contains a pattern with the metadata attributes used for sorting and renaming :
<sortmapper from="C:\music\source" to="[MP3 - author]/[MP3 - title].mp3" />

Open a command or shell window and launch Ant task :

Here are some metadata attributes. Available attributes depends on the file type.
The following list is not complete, see below to know all attributes available for a specific file.

File System attributes:
FS - AbsolutePath FS - BaseName FS - CanonicalPath FS - Checksum FS - Extension FS - LastModified FS - LastModified - Date FS - LastModified - DayOfMonth FS - LastModified - DayOfWeek FS - LastModified - Hour FS - LastModified - MilliSecond FS - LastModified - Minute FS - LastModified - Month FS - LastModified - Second FS - LastModified - Year FS - Name FS - Parent FS - Path FS - Size

MP3 attributes:
MP3 - album MP3 - author MP3 - bitrate MP3 - comment MP3 - date MP3 - duration MP3 - title MP3 - vbr MP3 - mp3.bitrate.nominal.bps MP3 - mp3.channels MP3 - mp3.copyright MP3 - mp3.crc MP3 - mp3.framerate.fps MP3 - mp3.framesize.bytes MP3 - mp3.frequency.hz MP3 - mp3.header.pos MP3 - mp3.id3tag.track MP3 - mp3.id3tag.genre MP3 - mp3.id3tag.v2 MP3 - mp3.id3tag.v2.version MP3 - mp3.length.bytes MP3 - mp3.length.frames MP3 - mp3.mode MP3 - mp3.original MP3 - mp3.padding MP3 - mp3.vbr MP3 - mp3.vbr.scale MP3 - mp3.version.encoding MP3 - mp3.version.layer MP3 - mp3.version.mpeg

OGG attributes:
OGG - album OGG - author OGG - bitrate OGG - date OGG - duration OGG - ogg.bitrate.nominal.bps OGG - ogg.channels OGG - ogg.comment.encodedby OGG - ogg.comment.track OGG - ogg.frequency.hz OGG - ogg.length.bytes OGG - ogg.serial OGG - ogg.version OGG - title OGG - vbr

EXIF attributes:
Exif - Aperture Value Exif - Artist Exif - Brightness Value Exif - Color Space Exif - Components Configuration Exif - Compression Exif - Copyright Exif - Date/Time Exif - Date/Time Digitized Exif - Date/Time Original Exif - Date/Time Original - Date Exif - Date/Time Original - DayOfMonth Exif - Date/Time Original - DayOfWeek Exif - Date/Time Original - Hour Exif - Date/Time Original - MilliSecond Exif - Date/Time Original - Minute Exif - Date/Time Original - Month Exif - Date/Time Original - Second Exif - Date/Time Original - Year Exif - Exif Image Height Exif - Exif Image Width Exif - Exif Version Exif - Exposure Bias Value Exif - Exposure Program Exif - F-Number Exif - File Source Exif - Flash Exif - FlashPix Version Exif - Focal Length Exif - Focal Plane Resolution Unit Exif - Focal Plane X Resolution Exif - Focal Plane Y Resolution Exif - ISO Speed Ratings Exif - Image Description Exif - Make Exif - Metering Mode Exif - Model Exif - Orientation Exif - Reference Black/White Exif - Resolution Unit Exif - Scene Type Exif - Sensing Method Exif - Shutter Speed Value Exif - Software Exif - Thumbnail Data Exif - Thumbnail Length Exif - Thumbnail Offset Exif - X Resolution Exif - Y Resolution Exif - YCbCr Positioning

GPS attributes:
GPS - GPS Latitude GPS - GPS Latitude Ref GPS - GPS Longitude GPS - GPS Longitude Ref GPS - GPS Map Datum GPS - GPS Time-Stamp GPS - GPS Version ID

Iptc attributes:
Iptc - By-line Iptc - By-line Title Iptc - Caption/Abstract Iptc - Category Iptc - City Iptc - Copyright Notice Iptc - Country/Primary Location Iptc - Credit Iptc - Date Created Iptc - Directory Version Iptc - Headline Iptc - Keywords Iptc - Object Name Iptc - Province/State Iptc - Source Iptc - Supplemental Category(s) Iptc - Urgency Iptc - Writer/Editor

Jpeg attributes:
Jpeg - Component 1 Jpeg - Component 2 Jpeg - Component 3 Jpeg - Data Precision Jpeg - Image Height Jpeg - Image Width Jpeg - Number of Components

Avi attributes:
Avi - Duration

Other attributes:

• The Graphical User Interface shows you all known metadata attributes for the files located in the source directory.
  Just select them in the Metadata Attribute list, they are copied in the pattern field.
• For Ant FileMapper users, the previous list is not complete. If you want to know the metadata attributes available for your file, you can use the <fileattribute/> custom Ant task. It diplays the list of known attributes for a given file :
  <target name="ShowAttributes"> <fileattribute filename="D:\\MediaSort\\test\\test.jpg" /> <fileattribute filename="D:\\MediaSort\\test\\test.mp3" /> </target>

  Then launch Ant task : ant ShowAttributes

  A list of all attributes available appears in the console.

MediaSort is based on an Ant file mapper. The file mapper uses a set of metadata attribute parsers AttributeParser.
Parser implementations have been developped for Jpeg, Mp3, Ogg, Pdf and Avi files. MediaSort can be easily extended with new parsers if needed.
Parsers are based on the following libraries :

• Jpeg files : metadata-extractor (http://www.drewnoakes.com/code/exif/)
• Mp3 & Ogg Vorbis files : mp3spi & vorbisspi (http://www.javazoom.net/)
• Pdf files : Adobe Java Viewer (http://www.adobe.com)
• Avi files : Java Media Framework (http://java.sun.com)

Here is a link to the JavaDoc API documentation.