FileDocCategorySizeDatePackage
JID3Tagger.javaAPI Docjid3 0.4611968Sun Feb 06 18:11:24 GMT 2005org.blinkenlights.jid3.exe

JID3Tagger

public class JID3Tagger extends Object
Command line utility which can be used to set tag values in individual files.
author
paul

Fields Summary
private Map
m_oCmdLineMap
Constructors Summary
private JID3Tagger(Map oCmdLineMap)
Creates a new instance of JID3Tagger

    
           
      
    
        m_oCmdLineMap = oCmdLineMap;
Methods Summary
private voiddisplay()

        String[] asFilename = (String[])m_oCmdLineMap.get("filenames");
        
        for (int i=0; i < asFilename.length; i++)
        {
            System.out.println("\n[" + asFilename[i] + "]");
            File oSourceFile = new File(asFilename[i]);
            MP3File oMP3File = new MP3File(oSourceFile);
            
            ID3Tag[] aoTag = oMP3File.getTags();
            for (int j=0; j < aoTag.length; j++)
            {
                if (aoTag[j] instanceof ID3V1_0Tag)
                {
                    System.out.println("\nV1.0:");
                }
                else if (aoTag[j] instanceof ID3V1_1Tag)
                {
                    System.out.println("\nV1.1:");
                }
                else if (aoTag[j] instanceof ID3V2_3_0Tag)
                {
                    System.out.println("\nV2.3.0:");
                }
                System.out.println(aoTag[j].toString());
            }
        }
public static voidmain(java.lang.String[] args)

param
args the command line arguments

        if (args.length == 0)
        {
            System.out.println("JID3 library version " + ID3Util.getVersion() + "\n\n" + ID3Util.getLicense());            
            String sHelp = "Usage: java -jar jid3.jar <options> filename [filename...]\n" +
                           "\n" +
                           " Options:\n\n" +
                           "  --display                 Display tags contained in specified file(s)\n" +
                           "  --1                       Write V1.1 tag to file (default)\n" +
                           "  --2                       Write V2.3.0 tag to file\n" +
                           "  --album=<album>           Set album value\n" +
                           "  --artist=<artist>         Set artist value\n" +
                           "  --comment=<comment>       Set comment value\n" +
                           "  --genre=<genre>           Set genre value (specify as string)\n" +
                           "  --title=<title>           Set title value\n" +
                           "  --track=<track>[/<total>] Set track value (total tracks optional for v2.3.0)\n" +
                           "  --year=<year>             Set year value";
            System.out.println("\n\n" + sHelp);
        }
        else
        {
            try
            {
                Map oCmdLineMap = parseCommandLineArgs(args);

                JID3Tagger oJID3Tagger = new JID3Tagger(oCmdLineMap);

                if ((oCmdLineMap.get("display") != null) && oCmdLineMap.get("display").equals(Boolean.TRUE))
                {
                    oJID3Tagger.display();
                }
                else
                {
                    oJID3Tagger.tag();
                }
            }
            catch (Exception e)
            {
                System.err.println("Tag failed: " + ID3Exception.getStackTrace(e));
            }
        }
private static java.util.MapparseCommandLineArgs(java.lang.String[] args)

        Map oMap = new HashMap();
        
        List oFilenameList = new ArrayList();
        
        int i = 0;
        while (i < args.length)
        {
            if (args[i].startsWith("--album="))
            {
                oMap.put("album", args[i].replaceFirst("--album=", ""));
            }
            else if (args[i].startsWith("--artist="))
            {
                oMap.put("artist", args[i].replaceFirst("--artist=", ""));
            }
            else if (args[i].startsWith("--comment="))
            {
                oMap.put("comment", args[i].replaceFirst("--comment=", ""));
            }
            else if (args[i].startsWith("--genre="))
            {
                oMap.put("genre", args[i].replaceFirst("--genre=", ""));
            }
            else if (args[i].startsWith("--title="))
            {
                oMap.put("title", args[i].replaceFirst("--title=", ""));
            }
            else if (args[i].startsWith("--year="))
            {
                try
                {
                    oMap.put("year", Integer.valueOf(args[i].replaceFirst("--year=", "")));
                }
                catch (Exception e)
                {
                    throw new ID3Exception("Invalid year value specified.");
                }
            }
            else if (args[i].startsWith("--track="))
            {
                try
                {
                    String sTrack = args[i].replaceFirst("--track=", "");
                    int iTrackNumber;
                    int iTotalTracks;
                    if (sTrack.indexOf('/") > 0)
                    {
                        String[] asParts = sTrack.split("/", 2);
                        oMap.put("track", Integer.valueOf(asParts[0]));
                        oMap.put("total", Integer.valueOf(asParts[1]));
                    }
                    else
                    {
                        oMap.put("track", Integer.valueOf(sTrack));
                    }
                }
                catch (Exception e)
                {
                    throw new ID3Exception("Invalid track value specified.");
                }
            }
            else if (args[i].equals("--display"))
            {
                oMap.put("display", Boolean.TRUE);
            }
            else if (args[i].equals("--1"))
            {
                oMap.put("1", Boolean.TRUE);
            }
            else if (args[i].equals("--2"))
            {
                oMap.put("2", Boolean.TRUE);
            }
            else
            {
                oFilenameList.add(args[i]);
            }
            
            i++;
        }
        
        // add filenames
        if (oFilenameList.size() == 0)
        {
            throw new ID3Exception("At least one filename must be specified.");
        }
        oMap.put("filenames", oFilenameList.toArray(new String[0]));
        
        // if not version has been chosen, we will just do a v1.1 tag
        if ((!oMap.containsKey("1")) && (!oMap.containsKey("2")))
        {
            oMap.put("1", Boolean.TRUE);
        }
        
        return oMap;
private voidtag()

        String[] asFilename = (String[])m_oCmdLineMap.get("filenames");
        
        for (int i=0; i < asFilename.length; i++)
        {
            File oSourceFile = new File(asFilename[i]);
            MP3File oMP3File = new MP3File(oSourceFile);
            
            if (m_oCmdLineMap.containsKey("1"))
            {
                ID3V1_1Tag oID3V1_1Tag = new ID3V1_1Tag();
                if (m_oCmdLineMap.containsKey("album"))
                {
                    oID3V1_1Tag.setAlbum((String)m_oCmdLineMap.get("album"));
                }
                if (m_oCmdLineMap.containsKey("artist"))
                {
                    oID3V1_1Tag.setArtist((String)m_oCmdLineMap.get("artist"));
                }
                if (m_oCmdLineMap.containsKey("comment"))
                {
                    oID3V1_1Tag.setComment((String)m_oCmdLineMap.get("comment"));
                }
                if (m_oCmdLineMap.containsKey("genre"))
                {
                    String sGenre = (String)m_oCmdLineMap.get("genre");
                    oID3V1_1Tag.setGenre(ID3V1Tag.Genre.lookupGenre(sGenre));
                }
                if (m_oCmdLineMap.containsKey("title"))
                {
                    oID3V1_1Tag.setTitle((String)m_oCmdLineMap.get("title"));
                }
                if (m_oCmdLineMap.containsKey("year"))
                {
                    oID3V1_1Tag.setYear(((Integer)m_oCmdLineMap.get("year")).toString());
                }
                if (m_oCmdLineMap.containsKey("track"))
                {
                    oID3V1_1Tag.setAlbumTrack(((Integer)m_oCmdLineMap.get("track")).intValue());
                }
                oMP3File.setID3Tag(oID3V1_1Tag);
            }
            if (m_oCmdLineMap.containsKey("2"))
            {
                ID3V2_3_0Tag oID3V2_3_0Tag = new ID3V2_3_0Tag();
                //HACK: Need to have padding at the end of the tag, or Winamp won't see the last frame (at least 6 bytes seem to be required).
                oID3V2_3_0Tag.setPaddingLength(16);
                if (m_oCmdLineMap.containsKey("album"))
                {
                    oID3V2_3_0Tag.setAlbum((String)m_oCmdLineMap.get("album"));
                }
                if (m_oCmdLineMap.containsKey("artist"))
                {
                    oID3V2_3_0Tag.setArtist((String)m_oCmdLineMap.get("artist"));
                }
                if (m_oCmdLineMap.containsKey("comment"))
                {
                    oID3V2_3_0Tag.setComment((String)m_oCmdLineMap.get("comment"));
                }
                if (m_oCmdLineMap.containsKey("genre"))
                {
                    oID3V2_3_0Tag.setGenre((String)m_oCmdLineMap.get("genre"));
                }
                oMP3File.setID3Tag(oID3V2_3_0Tag);
                if (m_oCmdLineMap.containsKey("title"))
                {
                    oID3V2_3_0Tag.setTitle((String)m_oCmdLineMap.get("title"));
                }
                if (m_oCmdLineMap.containsKey("year"))
                {
                    oID3V2_3_0Tag.setYear(((Integer)m_oCmdLineMap.get("year")).intValue());
                }
                if (m_oCmdLineMap.containsKey("track"))
                {
                    if (m_oCmdLineMap.containsKey("total"))
                    {
                        oID3V2_3_0Tag.setTrackNumber(((Integer)m_oCmdLineMap.get("track")).intValue(),
                                                     ((Integer)m_oCmdLineMap.get("total")).intValue());
                    }
                    else
                    {
                        oID3V2_3_0Tag.setTrackNumber(((Integer)m_oCmdLineMap.get("track")).intValue());
                    }
                }
            }
            
            oMP3File.sync();
        }