◆aacのアートワーク存在チェックツール（m4a解析ソース付き）

 アートワーク一括チェックツール

フォルダ下の全てのaac/alac楽曲ファイル(.m4a)をチェックし、アートワークを持たない楽曲をリストアップするツールを作成しました。

minidlaのCソースをJavaにしたものです。

m4aのタグに関する仕様はまだ調べつくしていませんので、今回はソースのコンバートで対処しました。

実際にツールを動かした結果を示します。行が多いので省略しています。

Check G:\MUSIC
...........................................................
B-    >Beethoven >チェロ・ソナタ全曲、「魔笛」の主題による変奏曲;Anner Bylsma, Jos Van Immerseel >Beethoven: Cello Sonata #3 In A, Op. 69 - 2. Scherzo: Allegro Molto  has no image
B-    >Beethoven >チェロ・ソナタ全曲、「魔笛」の主題による変奏曲;Anner Bylsma, Jos Van Immerseel >Beethoven: Cello Sonata #3 In A, Op. 69 - 3. Adagio Cantibile  has no image
・・・省略　・・・
B-    >Beethoven >チェロ・ソナタ全曲、「魔笛」の主題による変奏曲;Anner Bylsma, Jos Van Immerseel >Beethoven: Cello Sonata #5 In D, Op. 102/2 - 3. Allegro Fugato  has no image
B-    >Beethoven >チェロ・ソナタ全曲、「魔笛」の主題による変奏曲;Anner Bylsma, Jos Van Immerseel >Beethoven: 12 Variations On "Ein Madchen Oder Weibchen" In F, Op. 66  has no image
.................
V-    >Vivaldi >Classic On Bossa　＊Vivaldi＊ >ヴァイオリン協奏曲”四季”より(春)第2楽章  has no image
V-    >Vivaldi >Classic On Bossa　＊Vivaldi＊ >ヴァイオリン協奏曲”四季”より(春)第3楽章  has no image
・・・省略　・・・
V-    >Vivaldi >Classic On Bossa　＊Vivaldi＊ >ヴァイオリン協奏曲”四季”より(冬)第3楽章  has no image
........................
H-    >Haydn >弦楽四重奏曲集 op.33 (全6曲) & op.42 < Buchberger Quartet > ;Buchberger Quartet >Haydn / SQ 39 C-dur op.33 - 3 1. Allegro moderato  has no image
・・・省略　・・・
H-    >Haydn >弦楽四重奏曲集 op.33 (全6曲) & op.42 < Buchberger Quartet > ;Buchberger Quartet >Haydn / SQ 43 d-moll op.42 4. Finale : presto  has no image
........
S-    >Schubert >交響曲　５番、６番;Colin Davis; Staatskapelle Dresden >Schubert: Symphony #5 In B Flat, D 485 - 2. Andante Con Moto  has no image
・・・省略　・・・
S-    >Schubert >交響曲　５番、６番;Colin Davis; Staatskapelle Dresden >Schubert: Symphony #6 In C, D 589 - 4. Allegro Moderato  has no image
................................
・・・省略　・・・
.............
file-count   : 15156
image-lacked : 255
total-length : 5774749770 bytes 5507 MB
続行するには何かキーを押してください . . .

少しはあると思っていたのですが想像以上でした。
これらはアルバムの先頭にのみアートワークが設定されていて、アルバム一覧では気が付きませんでした。

 発見された楽曲の対処

アルバムの情報-「アートワーク」で画像を選択し、コントロールＣ、その場でコントロールＶ，[OK]で先頭以外の楽曲にも大概の場合アートワークが設定されます。

しかしながら、アルバム設定ではだめな場合もあり、その場合は、複数の曲情報を選択し、アートワークを一括設定する必要があります。
アートワークが先頭のファイル以外にも入っている場合、入っていないファイルは「あえて入れていない」と判断されるのかも知れません。

 タグチェック・ツールのソース

ソースを示します。
汎用AACタグ解析クラス(AacTagUtil.java)とそれを使ってimage(covr:カバーアートタグ)を持たない楽曲の情報を表示するmainクラス（AudipTagChk.java)です。
画像部のチェック(JPEG-BASE_LINEまたはPNGか)も ◆JPEGのbaseline判定ツール（jpeg構造解析ソース付き）のJpgBLineChkクラスを用いて行っています。

// AacTagUtil.java
//   minidlnaのCソースをJavaに置き換えたものです。
// 使い方
//      File                    _file = new File("ファイルパス");
//      AacTagUtil.SongMetaData _psong=new AacTagUtil.SongMetaData();
//      AacTagUtil.get_aactags(file_,_psong,AacTagUtil.OMIT_IMAGE_DATA);
//   _psongにタグ情報が得られる。OMIT_IMAGE_DATAを指定しなければ
//   _psong.image_dataにイメージデータがセットされる。
//   AACタグフォーマットと異なるファイルの場合titleがnullになる。
//   (AACフォーマットだがタイトルが無い場合はtitleに"-"が入る）
import java.io.*;
import java.util.*;
public class AacTagUtil {
   public static class SongMetaData {
      String  file_path;
      String  title;
      String  album;
      String  comment;
      String  grouping;
      String  genre;
      int     year;
      int     bpm;
      int     track;
      int     total_tracks;
      int     disc;
      int     total_discs;
      boolean compilation;
      String  artist;
      String  album_artist;
      String  conductor;
      String  composer;
      int    image_size;
      byte[] image_data;
      }

   public static int OMIT_IMAGE_DATA=0x01;// イメージデータを読みこまない
   //
   final static boolean D=false;// デバグフラグ

   final static String winamp_genre[] = {
      "Blues","Classic Rock","Country","Dance",//00
      "Disco","Funk","Grunge","Hip-Hop",
      "Jazz","Metal","New Age","Oldies",//08
      "Other","Pop","R&B","Rap",
      "Reggae","Rock","Techno","Industrial",//10
      "Alternative","Ska","Death Metal","Pranks",
      "Soundtrack","Euro-Techno","Ambient","Trip-Hop",//18
      "Vocal","Jazz+Funk","Fusion","Trance",
      "Classical","Instrumental","Acid","House",//20
      "Game","Sound Clip","Gospel","Noise",
      "AlternRock","Bass","Soul","Punk",//28
      "Space","Meditative","Instrumental Pop","Instrumental Rock",
      "Ethnic","Gothic","Darkwave","Techno-Industrial",//30
      "Electronic","Pop-Folk","Eurodance","Dream",
      "Southern Rock","Comedy","Cult","Gangsta",//38
      "Top 40","Christian Rap","Pop/Funk","Jungle",
      "Native American","Cabaret","New Wave","Psychedelic",//40
      "Rave","Showtunes","Trailer","Lo-Fi",
      "Tribal","Acid Punk","Acid Jazz","Polka",//48
      "Retro","Musical","Rock & Roll","Hard Rock",
      "Folk","Folk/Rock","National folk","Swing",//50
      "Fast-fusion","Bebob","Latin","Revival",
      "Celtic", "Bluegrass","Avantgarde","Gothic Rock",//58
      "Progressive Rock","Psychedelic Rock","Symphonic Rock","Slow Rock",
      "Big Band","Chorus","Easy Listening","Acoustic",//60
      "Humour","Speech","Chanson","Opera",
      "Chamber Music","Sonata", "Symphony","Booty Bass",//68
      "Primus","Porn Groove","Satire","Slow Jam",
      "Club","Tango","Samba","Folklore",//70
      "Ballad","Powder Ballad","Rhythmic Soul","Freestyle",
      "Duet","Punk Rock","Drum Solo","A Capella",//78
      "Euro-House","Dance Hall","Goa","Drum & Bass",
      "Club House","Hardcore","Terror","Indie",//80
      "BritPop","NegerPunk","Polsk Punk","Beat",
      "Christian Gangsta","Heavy Metal","Black Metal","Crossover",//88
      "Contemporary C","Christian Rock", "Merengue","Salsa",
      "Thrash Metal","Anime","JPop","SynthPop",//90
      "Unknown"
      };

   static class LongBox{
      public long value;
      }
   public static void skip(RandomAccessFile raf_,long len_)throws Exception{
      // skiptByteの引数がintという謎の仕様のため
      long _rem=len_;
      while( _rem>0 ){
         if( _rem<0x7FFFFFFF ){
            _rem -= raf_.skipBytes((int)_rem);
            }
         else{
            _rem -= raf_.skipBytes(0x7FFFFFFF);
            }
         }
      }
   static int toInt2(byte[] buf_,int index_){
      // &0xFFはbyteが符号付きという謎の仕様のため
      // 括弧は"<<"の連結が弱いという謎の仕様のため
      return ((buf_[index_]&0xFF) << 8) | (buf_[index_+1]&0xFF);
      }
   static long toInt4(byte[] buf_){
      // unsigned intがないという謎の仕様のためlong使う
      return (((long)(buf_[0]&0xFF))<<24L)|((buf_[1]&0xFF)<<16)
             |((buf_[2]&0xFF)<<8)         |(buf_[3]&0xFF);
      }
   static long aac_findatom(RandomAccessFile raf_
                                  ,long             max_offset_
                                  ,String           which_atom_
                                  ,LongBox          atom_size_
                                  )throws Exception{
      long _current_offset = 0;
      byte _cbuf[]={0,0,0,0};
      while(_current_offset < max_offset_){
         if( raf_.read(_cbuf)!=4 ) return -1;
         long _size= toInt4(_cbuf);
         if(_size<8) return -1;
         if( raf_.read(_cbuf)!=4 ) return -1;
         String _atom= new String(_cbuf);
         if( _atom.equals(which_atom_) ){
            atom_size_.value= _size;
            return _current_offset;
            }
         skip(raf_,_size-8);
         _current_offset += _size;
         }
      return -1;
      }
   static long aac_lookforatom(File             aac_file_
                               ,RandomAccessFile aac_fp_
                               ,String           atom_path_
                               ,LongBox          atom_length_
                               )throws Exception{
      String _atom_path_list[]= atom_path_.split("\\:");
      long _file_size= aac_fp_.length();
      aac_fp_.seek(0L);
      long _atom_offset;
      for(int _idx=0;_idx<_atom_path_list.length;++_idx){
         String _atom_name= _atom_path_list[_idx];
         _atom_offset = aac_findatom(aac_fp_,_file_size
                                    ,_atom_name,atom_length_);
         if( _idx<(_atom_path_list.length-1) ){
            // 次がある
            switch(_atom_name){
            case "meta":
               aac_fp_.skipBytes(4);
               break;
            case "stsd":
               aac_fp_.skipBytes(8);
               break;
            case "mp4a":
               aac_fp_.skipBytes(28);
               break;
               }
            }
         }
      return aac_fp_.getFilePointer()-8;
      }
   static long get_aactags(File          file_
                          ,SongMetaData song_
                          )throws Exception{
      return get_aactags(file_,song_,0);
      }

   static long get_aactags(File         file_
                          ,SongMetaData song_
                          ,int          option_
                          )throws Exception{
      long _current_offset = 0;
      song_.file_path= file_.getAbsolutePath();
      try(RandomAccessFile _raf= new RandomAccessFile(file_,"r");){
         // 先頭のタグ"ftyp"のみ別途チェックする
         byte _hbuf[]={0,0,0,0, 0,0,0,0};
         if( _raf.read(_hbuf)!=8 ) return -1;
         if( _hbuf[4]!=0x66||_hbuf[5]!=0x74||_hbuf[6]!=0x79||_hbuf[7]!=0x70 ){
            if(D)System.out.println("not aac-tag format");
            song_.comment="not aac-tag format";
            return -1;
            }
         song_.title="-";// 「aac-tagとして解釈はした」ということを表す
         //
         _raf.seek(0L);
         byte _cbuf[]={0,0,0,0};
         LongBox _atom_length=new LongBox();
         long _atom_offset=aac_lookforatom(file_,_raf
                                          ,"moov:udta:meta:ilst",_atom_length);
         if(D)System.out.println(file_.getName()
                                +" "+_atom_offset+" "+_atom_length.value);
         if( _atom_offset != -1 ){
            while( _current_offset < _atom_length.value){
               if( _raf.read(_cbuf)!=4 ) break;
               long _current_size = toInt4(_cbuf);
               if( _current_size <= 7 || _current_size > (1<<24) ){ 
                  break;
                  }
               byte _current_atom_buf[]={0,0,0,0};
               if( _raf.read(_current_atom_buf)!=4 ) break;
               String _current_atom=new String(_current_atom_buf);
               String _current_atom2=new String(_current_atom_buf,1,3);
               int _len= (int)_current_size - 7;
               if( _len<22 ) _len=22;
               byte _data[]=new byte[_len];
               long _rlen= _current_size - 8;
               if( _raf.read(_data,0,(int)_rlen)!=_rlen ){
                  break;
                  }
               _data[(int)((long)_current_size - 8L)] = 0;
               if( (_current_atom_buf[0]&0xFF)==0xA9 ){// &FFに注意
                  String _text=new String(_data,16,_len-16,"utf-8");
                  switch(_current_atom2){
                  case "nam":
                     song_.title=_text;
                     break;
                  case "ART":
                     song_.artist=_text;
                     break;
                  case "alb":
                     song_.album =_text;
                     break;
                  case "cmt":
                     song_.comment =_text;
                     break;
                  case "dir":
                     song_.conductor=_text;
                     break;
                  case "wrt":
                     song_.composer=_text;
                     break;
                  case "grp":
                     song_.grouping=_text;
                     break;
                  case "gen":
                     song_.genre=_text;
                     break;
                  case "day":
                     song_.year=Integer.parseInt(_text.trim());
                     break;
                     }
                  }
               else{
                  switch(_current_atom){
                  case "aART":
                     String _text=new String(_data,16,_len-16,"utf-8");
                     song_.album_artist= _text;
                     break;
                  case "tmpo":
                     song_.bpm          = toInt2(_data,16);
                     break;
                  case "trkn":
                     song_.track        = toInt2(_data,18);
                     song_.total_tracks = toInt2(_data,20);
                     break;
                  case "disk":
                     song_.disc         = toInt2(_data,18);
                     song_.total_discs  = toInt2(_data,20);
                     break;
                  case "gnre":
                     int _genre = _data[17] - 1;
                     if((_genre < 0) || (_genre >= winamp_genre.length)){
                        _genre = winamp_genre.length-1;
                        }
                     song_.genre = winamp_genre[_genre];
                     break;
                  case "cpil":
                     song_.compilation = _data[16]!=0;
                     break;
                  case "covr":
                     song_.image_size  = (int)_current_size - 8 - 16;
                     if( (option_&OMIT_IMAGE_DATA)==0 ){
                        song_.image_data= Arrays.copyOfRange(_data,16
                                                          ,song_.image_size);
                        }
                     break;
                     }
                  }
               _current_offset += _current_size;
               }
            }
         }
      return _current_offset;
      }
   }

// AudioTagChk.java
import java.io.*;
import otsu.hiNote.*;
public class AudioTagChk {
   final static boolean D=false;
   static int     file_count;
   static int     file_count_image_lacked;
   static int     file_count_artist_lacked;
   static int     file_count_not_baseline;
   static long    total_length;
   static int     count;
   static boolean need_NL;
   final static int A_OPTION=0x01;
   final static int P_OPTION=0x02;
   final static int B_OPTION=0x04;
   public static boolean hasArtWork(File file_
                                   ,int  option_)throws Exception{
      AacTagUtil.SongMetaData _song=new AacTagUtil.SongMetaData();
      int _option=((option_&B_OPTION)==0)?AacTagUtil.OMIT_IMAGE_DATA:0;
      AacTagUtil.get_aactags(file_,_song,_option);
      if( _song.title!=null ){
         if(D)System.out.println("song="+hiU.str(_song,hiU.WITH_INDENT));
         if( (_option&A_OPTION)!=0 ){
            // アーティスト/アルバム・アーティストの欠落をチェックする
            if( _song.album_artist==null || _song.artist==null ){
               String _name= _song.genre
                          +">"+_song.album+">"+_song.title;
               System.out.print("\n"+_name+" artist or album-artist lacked");
               ++file_count_artist_lacked;
               need_NL=true;
               }
            }
         ++file_count;
         if( _song.image_size==0 ){
            String _name= _song.genre+">"
                          +_song.album_artist
                          +">"+_song.album+">"+_song.title;
            System.out.print("\n"+_name+" has no image");
            file_count_image_lacked++;
            need_NL=true;
            }
         else{
            if( (option_&B_OPTION)!=0 ){
               BufferedInputStream _bis=new BufferedInputStream(
                               new ByteArrayInputStream(_song.image_data)
                               );
               JpgBLineChk.Type _type=JpgBLineChk.getType(_bis);
               if(D)System.out.println(_type);
               if( _type!=JpgBLineChk.Type.BASE_LINE ){
                  if( (_type!=JpgBLineChk.Type.PNG)||(option_&P_OPTION)==0 ){
                     String _name= _song.genre+">"
                               +_song.album_artist
                              +">"+_song.album+">"+_song.title;
                     System.out.print("\n"+_name+" image type "+_type);
                     file_count_not_baseline++;
                     need_NL=true;
                     }
                  }
               }
            total_length += _song.image_size;
            if( (++count%10)==0 ){
               if( need_NL ) System.out.println();
               System.out.print(".");
               System.out.flush();
               need_NL=false;
               }
            }
         return true; // AAC
         }
      return false; // NOT AAC
      }
   public static void checkNestedFolder(File file_
                                       ,int  option_)throws Exception{
      File[] _files= file_.listFiles();
      if( _files!=null ){
         for(File _file:_files){
            if( _file.isDirectory() ){
               checkNestedFolder(_file,option_);
               }
            else {
               hasArtWork(_file,option_);
               }
            }
         }
      }
   public static void help(){
      System.out.println("options");
      System.out.println("  -a:check both artist and album-artist exist");
      System.out.println("  -b:check image jpeg/base_line");
      System.out.println("  -p:check image jpeg/base_line or png");
      System.exit(0);
      }
   public static void main(String[] args_){
      int    _option=0;
      String _option_str="";
      for(String _arg:args_){
         switch( _arg ){
         case "-help":help();
         case "-a":
            _option|=A_OPTION;
            _option_str+=" -a";
            break;
         case "-b":
            _option|=B_OPTION;
            _option_str+=" -b";
            break;
         case "-p":
            _option|=(B_OPTION|P_OPTION);
            _option_str+=" -p";
            break;
            }
         }
      for(String _arg:args_){
         if( _arg.startsWith("-") ) continue;
         try{
            System.out.println("Check "+_arg+_option_str);
            checkNestedFolder(new File(_arg),_option);
            }
         catch(Exception _ex){
            _ex.printStackTrace(System.err);
            }
         }
      System.out.println("\nfile-count   : "+file_count);
      System.out.println("image-lacked : "+file_count_image_lacked);
      System.out.println("total-length : "+total_length+" bytes "+(total_length/(1024*1024))+" MB");
      }
   }

mp3も解析するつもりです。ただ現時点ではiTunes管理の膨大なaac(m4a)の検証が必要で、この段階で提示（メモ書き？）することにしました。

このツールは起動引数としてフォルダを指定すると階層を追って全ファイルをチェックするようになっています。
aac以外のファイルが混ざっていてもはじくようにはしてあるます。

AacTagUtil.get_aactags()はタイトルを始めとして多くの情報を返します。
AudioTagChk.hasArtWork()では情報の中のimage_sizeが0のものをアートワーク欠落としてレポートしています。
レポートの形式はグループ＞アルバム・アーティスト＞アルバム＞タイトルの順としていますが、 必要に応じソースを変更してください。

 ソースのダウンロードとビルド/起動

checkAudioTag.zip には実行可能jarと実行用のバッチ、ソースコード、ビルド用のバッチを入れてあります。

Java8環境が必要です。

A05_run.batのDIR変数にチェックしたいフォルダをセットし実行してください。
オプションの-aはartistタグとalbum artistタグの両方を持っているかをチェックし、-pは画像がjpeg:base_lineかpngであるかをチェックします。

:: A05_run.bat
@echo off
set DIR=G:\MUSIC
set OPTION=-a -p
set MAIN=AudioTagChk
set JAVA=java.exe
"%JAVA%" -jar %MAIN%.jar %OPTION% %DIR%
pause

プログラムを変更した場合は、 A01_build.batを動かすとりビルドされます。