TagReplc (music Tag Replacer) 取扱説明書

【概要】

【本ソフトウェア利用の対象】

• TagReplc 1.02 で扱うことができる圧縮音声ファイル形式(Compressed Audio File Format)とその構成は下表のとおりです。
  

  表1. TagReplc で扱う圧縮音声ファイル形式

  Audio file format	Extension	Audio coding format	Metadata (Tag)
  MP3	.mp3	MP3	ID3v2
  MP4	.m4a,.mp4	AAC	MP4
  FLAC	.flac	FLAC	VorbisComment

  • それぞれの圧縮音声ファイル（コンテナファイル）には、音声コーデック(Audio coding format)で圧縮された音声データとメタデータ（タグ）とが格納されており、一般には複数種のコーデックやメタデータ形式に対応していることが多いですが、TagReplc で扱うことができる形式は表1に限られています。
  • 例えば、TagReplc で扱える MP3（拡張子.mp3）のタグ形式は ID3v2 のみで ID3v1 は非対象です。
    なお、TagReplc 1.01 では ID3v2.3タグのみでしたが、TagReplc 1.02 では ID3v2.2, ID3v2.4 タグも対象となりました。
• ID3v2などのタグの中で引き継ぎの対象となるのは表3に記載のフレームだけです。
• 本ソフトウェアの実行により、対象外のタグやタグ中の対象外のフレームは引き継がれませんので、少なくとも置換されたMP3/MP4/FLACファイルがユーザーの想定どおりになっていることを確認できるまでは、必ずバックアップを取るようにしてください。
• TagReplc で扱う圧縮音声ファイルのファイル名は先頭文字列（通常は半角２文字）がアルバム内のトラック番号を示す十進数字になっている必要があります。
• TagReplc には、リッピング、タグ編集などの機能はありません。
• v.1.01 からは、既に再エンコードされたMP3ファイルの利用だけではなくイメージファイルから外部エンコーダ(lame_enc.dll)を使って再エンコードする機能が加わりました。v.1.02 からは、lame_enc.dll のほかに libFLAC.dll や qaac.exe も利用可能になりました。

【基本機能】

1. 既にタグ編集されフォルダAに格納されているMP3ファイルと、それとは異なるエンコーダもしくはエンコード条件で（リッピングソフトによって）再エンコードされフォルダBに格納されているMP3ファイルを用いて、フォルダAのMP3ファイルのタグ情報とフォルダBのMP3ファイルの音声データを組み合わせたMP3ファイルを生成します。(表2の#1)
2. フォルダAに格納されたMP3ファイルとそれらの圧縮元のCDイメージファイルについて、そのCDイメージファイルを外部エンコーダ(lame_enc.dll)で再エンコードしてMP3ファイルを生成します。その際に生成されるMP3ファイルにフォルダAのMP3ファイルのタグ情報を継承させます。(表2の#2)
3. フォルダAに格納されたMP3/MP4/FLACファイルとそれらの圧縮元のCDイメージファイルについて、そのCDイメージファイルを外部エンコーダ(qaac.exe)で再エンコードしてMP4(AAC)ファイルを生成します。その際に生成されるMP4(AAC)ファイルにフォルダAのMP3/MP4/FLACファイルのタグ情報を継承させます。(表2の#3)
4. フォルダAに格納されたMP3/MP4/FLACファイルとそれらの圧縮元のCDイメージファイルについて、そのCDイメージファイルを外部エンコーダ(libFLAC.dll)で再エンコードしてFLACファイルを生成します。その際に生成されるFLACファイルにフォルダAのMP3/MP4/FLACファイルのタグ情報を継承させます。(表2の#4)
5. 上記の2〜4については、一括再エンコード処理(Batch Re-encoding)することができます。

【対象とするタグフレーム】

• "TENC"、"TSSE"、"TLEN"、"MCDI" はエンコーディングの方法や対象データの情報なのでフォルダＢのファイルのフレーム情報が継承され、それら以外はフォルダＡのファイルのフレーム情報が継承されます。
• MP3→MP3（表2 の #1 と #2）の場合、それぞれのフレームの継承は、フレームまるごと（すなわちバイナリレベルで変更なく）継承されます。
  よって、フレーム内の文字列の文字コードもそのまま継承されます。
  

【基本操作】（表2の#1）

• 実行ファイル(TagReplc.exe)もしくはそのショートカットをクリックして起動します。
• 必要に応じて、 Bkup Folder   backup_folder_path_name  の右側のアイコン をクリックして、バックアップ(Backup)フォルダを変更します。
  
• 必要に応じて、 Temp Folder   temporary_folder_path_name  の右側のアイコン をクリックして、一時(Temporary)フォルダを変更します。
  
•  Folder A   folder_A_path_name  の右側のアイコン をクリックして「以前にエンコードしてタグを編集したMP3ファイルが格納されているアルバムフォルダ」を選択します。（こちらのMP3ファイルのタグが活用されます。）
  さらにその右側にある「フォルダを開く」アイコン をクリックすれば、エクスプローラー(Windows Explorer)でフォルダを閲覧できます。
•  Folder B   folder_B_path_name  の右側のアイコン をクリックして、新たにエンコードし直されたMP3ファイルが格納されているアルバムフォルダを選択します。（こちらのMP3ファイルのオーディオデータが活用されます。）
  既に再エンコードされたMP3ファイルではなくイメージファイルから再エンコードする場合には、後述する【イメージファイルの再エンコード】を参照してください。
• 次に、  Compare A/B  ボタンをクリックすると、下の一覧表にフォルダＡとフォルダＢのなかのMP3ファイルのタグ情報などが交互に表示されます。
  • 4〜18列めには、表3の【対象とするフレーム】の情報が表示されます。
  • 右6列（"codec","bits/sample","bitrate(kbps)","fs(Hz)","duration","dataSize"）はフレーム情報ではなくエンコード情報です。
  奇数行には Folder A のMP3ファイルの情報が、偶数行には Folder B のMP3ファイルの情報が表示されます。
  奇数行と偶数行のそれぞれの順番はファイル名（通常、先頭がトラック番号の数字）でソートされています。（タグの TRCK フレームの文字列でソートされてはいません。）
  奇数行と偶数行がペアになっているはずです。
  奇数行の各セルの文字列がひとつ下の偶数行の文字列と一致している場合、偶数行のセルが  Pale turquoise色  に、一致していない場合には  Bisque色  に表示されます。
  奇数行と偶数行の各ペアの情報が想定しているとおりになっていることを確認して下さい。
• 全ペア確認後に、  Replace Tags  ボタンをクリックすると、「フォルダＡの各ファイルのID3v2タグ(metadata)などから再構成されたID3v2タグ」と「フォルダＢの各ファイルのオーディオデータ(MP3 frames)部分」が組み合わされたMP3ファイルが一時フォルダに生成されます。
  
  • 上記の「フォルダＡの各ファイルのID3v2タグ(metadata)などから再構成されたID3v2タグ」は、表3の【対象とするフレーム】のフレームのみ抽出されて構成されます。そのため、【対象とするフレーム】以外のフレームは生成されたMP3ファイルには引き継がれません。
  • 一時フォルダに生成されるファイル名はフォルダＡの各ファイルと同じファイル名です。既に一時フォルダに同一ファイル名が存在する場合は上書きされます。
• さらに、  Move Files  ボタンをクリックすると、
  1. バックアップ(BKUP)フォルダの下にフォルダＡと同名のフォルダが作成され、フォルダＡのMP3ファイル(*.mp3)は作成されたフォルダの下に移動されます。
     ※ *.mp3 以外の *.jpg, *.lrc, *.m3u 等は移動されません。
     ※ バックアップフォルダの下に既に同名のフォルダが存在する場合には、末尾に連番が付けられたフォルダ名で作成されます。
  2. 次に、一時フォルダに生成されたMP3ファイルが（空になった）フォルダＡに移動されます。
  以上により、フォルダＡのMP3ファイルは、新たにエンコードし直されたオーディオデータ(MP3 frames)にタグが引き継がれたMP3ファイルに置換されます。
  ※ [Replace Tags] を実行後に [Move Files] を行わないと、生成されたMP3ファイルが一時フォルダに残ったままになります。
• なお、 Bkup Folder  をクリックすると、 Output Folder  に変わり、「Outputフォルダモード」になります。この状態で  Replace Tags  ボタンをクリックすると、生成ファイルは一時フォルダではなく、Outputフォルダに生成され、 Move Files  ボタンは無効になります。Folder A のファイルをそのままに残して、生成ファイルを別フォルダに生成したい場合には「Outputフォルダモード」にして下さい。

【イメージファイルの再エンコード】（表2の#2,#3,#4）

• 表6に記された外部エンコーダの DLL(Dynamic Link Library)もしくは EXE(Executable) が TagReplc で使用できる状態にあるときは、フォルダＢの代わりに CDイメージファイルを指定することができます。
  
  • 表6のMP3エンコーダのうち、TagReplc 実行時にこの機能を使用できるのは LAME の DLL版の lame_enc.dll だけで、libmp3lame.dll には対応していません。
• 使用できる「CDイメージファイル」
  • 音楽CD(CD-DA:LinearPCM,44.1kHz,2channel,16bit,Little endian,2352bytes/sector)のデータ形式をもつCDイメージで、１つのCUEシート(.cue)と１つのバイナリファイル(.bin, .img, .wav)から構成されます。（.iso には対応していません。）
    CD１枚まるごとがひとつのバイナリファイルになっている構成（単一ファイル形式）で、曲ごとに分割されている複数のバイナリファイル構成（複数ファイル形式）には対応していません。
  • BIN+CUE形式、IMG+CUE形式、WAV+CUE形式のいずれかです。（表7参照）
  • CUEシートはテキストファイルで、TagReplc は「FILE」行、「TRACK xx AUDIO」行、「INDEX 01」行のみ認識します。「INDEX 00」「TITLE」「PERFORMER」行などは無視されます。
  • CUEシートのFILE行の第２引数(BINARY/WAVE)に拘わらず、第１引数のバイナリファイルの拡張子(.bin, .img, .wav)でフォーマットを判別しています。（.bin と .img は同様に読み込まれます。.wav のヘッダ44バイトは読み飛ばされます。）
  • CUEシートファイルはデフォルトで文字コードを ANSI（ロケールが ja-JP の場合は CP932≒Shift_JIS）として読み込まれます。UTF-8 の場合には上部のメニューの Setting ⇒ Cue Sheet Charset で変更して下さい。（FILE行の第１引数（パス名）が半角英数など US-ASCII コードだけの場合は ANSI/UTF-8 のどちらでも同じです。）
• TagReplc.exe は起動時に lame_enc.dll や libFLAC.dll を下記の「検索順序」に従って探し、もしあった場合には動的ロード(Dynamic Loading)します。
  
  [lame_enc.dll, libFLAC.dll の検索順序]

  1. TagReplc.exe が存在するフォルダ（ディレクトリ）
  2. 32bit版Windowsの場合は C:\Windows\System32、64bit版Windowsの場合は C:\Windows\SysWOW64
  3. C:\Windows フォルダ
  4. カレントフォルダ（TagReplc.exe をショートカットから起動する場合はそのショートカットの「作業フォルダー」に指定したフォルダ）
  5. 環境変数(Path)に登録されているフォルダ
     （環境変数は、Windows の 設定⇒詳細情報⇒システムの詳細設定⇒環境変数 で閲覧できます。）
     （TagReplc.exe 起動時に設定ファイル "TagReplc.ini" の EnvVarPATH パラメータに記述されているパスが環境変数(Path)に追記されます。）
• lame_enc.dll が使用できる状態にあるときは、下段のステータスバーに LAMEx.xxx という表示が現れます。
  libFLAC.dll が使用できる状態にあるときは、下段のステータスバーに FLAC x.y.z という表示が現れます。
  qaac.exe もしくは qaac64.exe が使用できる状態にあるときは、下段のステータスバーに qaac x.xx という表示が現れます。
  また、上部の  Folder B  のテキスト表示が  Folder B  ボタンになり、そのボタンをクリックすると  CD image  に切り替わり、右側のアイコンも から に切り替わります。
•  Folder A  には【基本操作】と同様に「以前にエンコードしてタグを編集したMP3/MP4/FLACファイルが格納されているアルバムフォルダ」を選択します。
•  Folder B  ボタンをクリックして、  CD image  に切り替えたのちに、右側のアイコン をクリックして、新たにMP3/MP4/FLACにエンコードし直すCDイメージのCUEシートファイル(.cue)を選択します。
• 上部のメニューの Setting ⇒ Select Encoder で使用するエンコーダを選択します。下段のステータスバーの選択されたエンコーダ文字列の先頭に'＊'マークが付きます。
• LAME の場合、上部のメニューの Setting ⇒ Encoder option を選び、ダイアログボックスで LAME エンコーダの設定を行います。
  

  表4. LAME での Preset option

  Preset	相当コマンド	Bitrate方式	kbps
  (No preset)		VBR/ABR/CBR
  --preset medium	-V 4	VBR	165
  --preset fast medium	-V 4 --vbr-new
  --r3mix	-V 3		175
  --preset standard	-V 2		190
  --preset fast standard	-V 2 --vbr-new
  --preset extreme	-V 0		245
  --preset fast extreme	-V 0 --vbr-new
  --preset insane	-b 320	CBR	320
  ABR	--abr num	ABR	num
  CBR	-b num	CBR	num
  Low Quality(q9)	-q 9	VBR/ABR/CBR
  Normal Quality(q3)	-q 3
  High Quality(q2)	-q 2
  Very High Quality(q0)	-q 0

  • 上記の表は The LAME Project のページ からリンクされている Guide to command line options および Detailed command line switches などの説明をもとに本取扱説明書の著者(KinJ)が類推したものですので、不正確な点があるかもしれません。
  • 「相当コマンド」列は lame.exe のコマンドラインでのオプションの相当値を示します。
  • 「kbps」列は VBR では「結果としてのビットレート平均値の目安」、ABR では「平均ビットレートの目標値」、CBR では「ビットレート固定値」を示します。
  • LAME 3.98 以降では、--vbr-new がVBRのデフォルトになったようなので、例えば --preset standard と --preset fast standard は同じ機能のようです。
  • 例えば lame_enc.dll を用いている CDex では --preset fast standard が初期設定になっているようです。
  • CDex などでは Normal Quality は -q 5 とされていますが、LAME 3.100 では -q 3 になっているようです。
  • Preset に「(No preset)」や「.... Quality(qn)」を選択した場合は、さらに VBR/ABR/CBR のいずれかを選択し、ビットレート(kbps)を指定する必要があります。
  • VBR および ABR では可変ビットレートの許容範囲を Bitrate Min. と Bitrate Max. で設定できますが、エンコード結果に与える影響は僅かなようなので、デフォルト（Min.=32kbps, Max.=320kbps）のままが無難かと思われます。
• FLAC では下記のオプション項目を TagReplc の設定ファイル "TagReplc.ini" で設定できます。
  • Flac_Comp_Level：Compression level (0-8, default=5)
  • Flac_Block_Size：Block size (default=4096)
  • Flac_Meta_Pad：Metadata padding length (default=256)
• qaac でオプションを追加する場合は、上部のメニューの Setting ⇒ Encoder option を選び、追加するオプション文字列をキーボード入力します。
  • オプション文字列は Command Line Options を参照。
  • 空欄の場合はデフォルトで infiles, -o, -R, --start, --end, Tagging options 等がコマンドラインに引き渡される。
  • 例えば入力欄が "-A" の場合は AAC ではなく ALAC にエンコードされる。
  • qaac のデフォルトでのエンコード品質は "TVBR q91, Quality 96"
• 【基本操作】と同様に  Compare A/B  ボタンをクリックします。
•  Encoding B  ボタンをクリックするとエンコードが開始されます。 下段のステータスバーの％表示で進行を確認して、「Encoding....」が「Encoding completed」に替わるのを待ちます。
  このとき、TagReplc のステータスバーのカウンタが途中で停止し上部のタイトルバーに「（応答なし）」の表示が現れフリーズのような状態になることがありますが、エンコードはバックグラウンドで進行しており、少し待つと「Encoding completed」が表示されます。
• 【基本操作】と同様に Backup モードの場合は、 Move Files  ボタンをクリックすると、フォルダＡの圧縮音声ファイルが新たにエンコードし直された圧縮音声ファイルに置換されます。

【一括再エンコード処理】

• STEP-1：MP3格納フォルダとイメージファイルのマッチング
  
  • [Input A] 以下のアルバムフォルダに格納されているMP3ファイルにエンコードされた元の CD-DA と同等のイメージファイルを [Input B] の中から探し出します。
  • [Input A] MP3 Folder (including subfolders)：
    MP3ファイルが格納されているアルバムフォルダの上位フォルダ（ライブラリ）を指定します。このフォルダ以下のサブフォルダが対象になります。
  • [Input B] Cue Folders (excluding subfolders)：
    イメージファイル（.cue, .img, .bin, .wav など）が格納されているフォルダを指定します。複数のフォルダを指定できます。サブフォルダは対象とされません。
  • [Option] MP3s encoded by these are excluded：
    ここに記載した文字列を含むエンコーダでエンコードされた[Input A]の圧縮音声ファイルは一括再エンコード処理の対象から除かれます。複数指定の場合はセミコロン(;)で区切ります。
    （例）LAME3.99;LAME3.100
  • [Option] Allowances in Matching：
    マッチングの際の許容値
    CUEシートに記された値やエンコードの際のサンプル数などは、必ずしも CD-DA のリードインに記録されている TOC(Table Of Contents) の値に従っているとは限りません。例えば、リッピングソフトで「正しいTOCとギャップ情報の取得」などを指定してリッピングを行った場合にはデータ領域のサブコード（サブチャンネル）を解析して得られたトラックの位置情報が用いられるため、各トラックの開始位置やCUEシートの INDEX01 の値は CD-DA の TOC に記録されている値とは数セクタ（フレーム）ずれていることがあります。これらの差をマッチングの際に許容する値です。
  • [Output] MP3-Cue Match List File：
    マッチングした結果を記述するテキストファイルを指定します。このテキストファイルの記述によって一括再エンコード処理が実施されます。
  • [Output] MP3-Cue Log File (option)：
    デバッグ用ですので通常は無視（空白）
  • 以上を設定して  OK  ボタンをクリックします。（マッチング探索には少々時間がかかります。）
    なお、ここでマッチング探索を行わずに、STEP-2 で既存の MP3-Cue Match List File を用いる場合は、[Output] MP3-Cue Match List File 欄にそのファイルを指定して  Skip  をクリックします。
• STEP-2：
  • MP3-Cue Match List File の内容について
    • 'A' で指定されたアルバムフォルダは実際に存在しているか？
    • 'M' で指定されたCUEシートファイルは実際に存在しているか？
      複数のCUEシートファイルが指定されていないか？
      CUEシートファイルのFILE行に記されたイメージファイルは実際に存在しているか？
    • 'T' で指定したトラックの対応は整合しているか？
    などを事前チェックした結果が表示されます。
  • 事前チェックでエラー等が無かった場合は、ダイアログボックスのタイトルバーに "STEP-2 : Pre-check Ok" と表示されますので、最下段の  Next  ボタンをクリックして STEP-3 に進みます。
  • 事前チェックでエラーが検出された場合は、ダイアログボックスにエラーの内容が表示され、それと同時にテキストエディタが起動され MP3-Cue Match List File が開かれテキスト編集可能な状態になります。
    このとき使用されるテキストエディタは"TagReplc.ini" の "TextEditor" エントリで指定されたアプリケーションです。"TextEditor" エントリに指定されていない場合は、OS の「既定のアプリ」に登録されているテキストエディタ（「メモ帳」notepad.exe など）が起動されます。
    「メモ帳」では行番号表示ができません。ダイアログボックスに表示されたエラー発生行（実際にはエラーが発生したブロックの区切りの空白行）の位置が分かるように行番号表示ができるテキストエディタの使用をお勧めします。
  • テキストエディタで MP3-Cue Match List File のエラー行の修正を行ったのちに上書き保存して、ダイアログボックスの最下段の  Retry  ボタンをクリックします。 再度、事前チェックが行われますので、エラーが無くなるまで STEP-2 を繰り返します。
• STEP-3：エンコード設定
  • Audio Format / Encoder：使用するエンコーダを選択します
  • Backup | Output Folder：Backup モードか Output モードかを選択し、そのフォルダを指定します。
  • The number of the levels of higher folder created：
    アルバムフォルダを基準(Level-0)として遡って生成するフォルダレベルを指定します。
    例えば Genre\Artist\Album_title\01_track.mp3 の場合 "2" と指定する。
  • When the specified folder already exists：指定されたフォルダが既に存在する場合、
    ・Save to THE folder：既存の指定したフォルダにセーブする
    ・Create NEW folder：追番を付加した新規フォルダを作成してそのフォルダにセーブする
    
  • 以上を設定して  OK  ボタンをクリックすると一括再エンコード処理が開始されます。
• マッチングについて
  • マッチングは [Input A] のMP3などのファイルのタグ情報やファイル名等と [Input B] のCUEシートに記載されたTOC情報やファイル名等から紐づけを行います。
  • おもには、[Input A] のMCDIフレームに記載されたTOC情報に依存しているため、TOCが無いことが多いMP4や、CDTOCが用意されているがあまり用いられていないFLACなどではマッチング確度が低い。
  • ID3v2タグのMCDIの書式仕様はリッピングソフトに依存している

    表5. MCDIの書式仕様

    	CD ripper	TOC data in MCDI of ID3v2		TagReplc
    		data	structure
    1	CDex	Binary	uint32LE ※1	対応可
    2	fre:ac	Binary	uint32BE	対応可
    3	Exact Audio Copy	Binary	uint32BE	対応可
    4	Windows Media Player 12	Text(UTF16LE)	Hexadecimal LBAs concatenated by '+'	対応可
    5	Windows Media Player 2022	MCDI,UFID 無し		非対応
    6	iTunes	MCI(MCDI)無し ※2		非対応
    7	Music Center for PC	MCDI無し。UFIDはある		非対応

    • ※1 MusicBrainz の記事 の "Basic format in pseudo-C code" を参照
    • ※2 iTunes では COMM フレームの content descriptor が 'iTunes_CDDB_1' であるとき actual comment にTOC情報が「Text(ASCII), Decimal LBAs concatenated by '+'」形式で記述されている場合がある。content descriptor が 'iTunes_CDDB_IDs' であるときはアルバムのトラック数だけでTOC情報は無いが、UFID フレームはあるようである。
  • TagReplc は UFID（Gracenote MusicID など）の利用はできない
  • MCDI が無い圧縮音声ファイルについては、フォルダ名、ファイル名、TALB, TPE1, TPE2 などのタグフレームのデータから抽出されたキーワードと CUEシートファイル名から関連性を推定するが、マッチング確度は低い。マッチングリストには '*' or 's' or 'W' or '?' の行を出力する。
• マッチングリストの書式
  • マッチングリスト(MP3-Cue Match List File)はプレーンテキストファイル(UTF-8)で下記の書式規則です。
  • ひとつのマッチングは複数行のブロックに記述され、その区切りは空白行
  • 行の最初の１文字は
    • 'A'：MP3ファイルが格納されたアルバムフォルダ（'A' の次の数字はフォルダに格納されているトラック数）
    • 'M' or '*' or 's' or 'W' or '?'：アルバムフォルダに対応するCDイメージのCUEシートファイル（CUEシートファイル名の前の数字はオーディオトラック数）
      • 'M'：MP3ファイルのID3v2タグの MCDI により対応していると判断された
      • '*'：単一のCUEシートが対応
      • 's'：CUEシートの一部のトラックが対応
      • 'W'：複数のCUEシートから構成される
      • '?'：CUEシートとのトラック対応が不明
    • 'T'：アルバムフォルダのMP3ファイル名の接頭数字(m)とCUEシートのTRACK番号(n)の対応を "m:n" で示す。
      
      ひとつのMP3ファイルが連結された複数のTRACKに対応している場合は "m:n1-n2" と表記される。
      TRACK ではなく LBA(frame or sector) で示す場合は "m:n1-n2f" と表記できる。(75frames/second, 588samples/frame)
      sample で示す場合は "m:n1-n2s" と表記できる。(44100samples/second)
    • 例1：CDの全トラックがひとつのMP3ファイルに対応
      
      A 1 "C:\user\music\classical\Bach\Goldberg_Variations"
      M 32 "C:\user\cd_img\Bach_Goldberg_Variations_Glenn_Gould_SMK-52619.cue"
      T 1:1-32
      
      例2：CDの TRACK 09 と TRACK 10 がひとつのMP3ファイルに対応
      
      A 9 "C:\user\music\rock\Jackson_Browne\Running_on_Empty"
      M 10 "C:\user\cd_img\Asylum_6E-113-2.cue"
      T 1:1 2:2 3:3 4:4 5:5 6:6 7:7 8:8 9:9-10
      
      例3：２枚組の Disc2 の TRACK 14 に２分間の無音部分を挟み収録されている２曲をMP3では分離
      
      A 15 "C:\user\music\rock\Oasis\Time_Flies"
      M 14 "C:\user\cd_img\Oasis_Time_Flies_1994-2009_disc2_SICP-2765.cue"
      T 14:1 15:2 16:3 17:4 18:5 19:6 20:7 21:8 22:9 23:10 24:11 25:12 26:13 27:297513-319173f 28:328173-351765f
      
  • 行末の '#' 以降はコメントであり、'##' はエラー、'###' は重大エラーを示す。
  • 行中に '$' がある場合は、この行全体がコメントアウト（無視）される。
  • ブロック内に複数の 'M' がある場合、２行め以降には " ##Select ONE" のエラーコメントが付く。テキストエディタでの修正は、不要な行を削除するか、不要な行の行末に '$' を付けてこの行をコメントアウトさせる。

【その他の操作】

• 音声ファイル簡易再生
   Compare A/B  ボタンをクリックして一覧表が表示されている状態で、任意の一行をクリックして選択したうえで、  Audio play  ボタンをクリックすると、選択された MP3/MP4/FLAC/WAV ファイルが音楽再生されます。
   pause  ボタンで一時停止、  resume  ボタンで一時停止解除、  stop  で停止（再生終了）します。
   Album repeat  ボタンが表示されている状態では、例えば奇数行の１曲目(A1)が再生されたあとは奇数行の２曲目(A2)が再生されます。
  一方、  Track repeat  ボタンが表示されている状態では、同じ楽曲(Track)が繰り返し再生されます。
  
  • Setting メニューの "Audio Play API" で "MF (Media Foundation)" にチェックされている場合、AAC や FLAC も再生できます。但し、MP4(.m4a) であっても ALAC は再生できないようです。
  • "MCI (Media Control Interface)" にチェックされている場合、AAC や FLAC の再生はできません。Codec Pack がインストールされている環境では AAC の再生は可能なようですが、Micosoft の Support ページには Codec Pack のインストールは勧められていません。
• 音声ファイルのプロパティ表示
   Compare A/B  ボタンをクリックして一覧表が表示されている状態で、任意の一行をクリックして選択したうえで、  Prop  ボタンをクリックすると、選択されたMP3/MP4/FLACファイルのプロパティが表示されます。

【ユーティリティ】

• 副次ファイルコピーユーティリティ (Misc File Copy Utility)
  このユーティリティは、コピー元フォルダとそのサブフォルダに保存されている音声ファイルを除くファイルをコピー先フォルダとそのサブフォルダにコピーします。
  具体的にはコピーの対象は、プレイリストファイル(.m3u)、同期テキストファイル(.lrc)、埋め込まれていないアルバムアートワークファイル(.jpg など)などです。
  コピー対象外の「音声ファイル」とは、拡張子が .mp3, .m4a, .mp4, .flac, .wav のファイルです。
  コピー先のフォルダが存在しない場合には、ファイルはコピーされません。
  Output モードで圧縮音声ファイルを生成したフォルダに参照元のフォルダＡにある圧縮音声ファイル以外をコピーすることが想定されています。
  
• プレイリスト拡張子置換ユーティリティ (Playlist Extension Replacement Utility)
  ベースフォルダとそのサブフォルダに格納されているプレイリストファイル(.m3u)に記述されたテキスト中のメディアファイルの拡張子を置換します。
  元々の拡張子をもつ音声ファイルが存在する場合は、拡張子は置換されません。
  

【インストール】

• インストールアーカイブ TagReplc_10??.zip をダブルクリックします。
• 展開して現れる TagReplc フォルダを「適当なフォルダ」にフォルダごとコピーします。
  
  • 格納先である「適当なフォルダ」はユーザーがその権限で管理できるフォルダであればどこでも構いませんが、セキュリティソフトが動作している環境では、除外フォルダ等にプログラムを格納する必要があります。
  • "C:\Program Files (x86)" や "C:\Program Files" への格納は管理者権限が必要になることがあるので本プログラムでは避けたほうが良いと思われますが、もしどうしてもこれらのフォルダに格納する場合は、TagReplc.exe は32bitアプリケーションですので、64bit Windows の場合は "C:\Program Files (x86)" の下に格納することになります。
• コピー先の TagReplc フォルダの中に下記のファイルがあることを確認します。

  TagReplc.exe	：実行ファイル
  TagReplc_help.htm	：このソフトウェア取扱説明書
  readme.txt	：はじめにお読みください
  LICENSE_oss.txt	：利用オープンソースソフトウェアのライセンス条項
  LICENSE_unbundled.txt	：インストールアーカイブには同梱されていないバイナリコードのライセンス条項

• 必要に応じて、実行ファイル(TagReplc.exe)のショートカットを作成します。

【エンコーダのインストール】

• 上表のエンコーダのバイナリコード(.dll や .exe)はインストールアーカイブ TagReplc_10??.zip には同梱（バンドル）されていません。これらのエンコーダおよびエンコーダが用いるDLL等の使用に関するライセンス等については利用者が確認し、利用者の責任において使用されるものとします。
• 上表のエンコーダのバイナリコードが既に前記の[検索順序]のフォルダに存在する場合は TagReplc.exe 起動時にロードされ、ステータスバーに "LAMEx.xxx" "FLAC x.x.x" "qaac x.xx" などの表示が現れます。もし、使用予定のエンコーダについてこれらの表示が現れない場合は、
  - 既にインストールされている場合は、設定ファイル "TagReplc.ini" の EnvVarPATH パラメータに格納されているパスを追記
  - インストールされていない場合は、上表のDownload欄などからそれぞれのバイナリコードを入手して前記の[検索順序]のフォルダに格納
  して TagReplc.exe を再起動して下さい。
  
  • TagReplc.exe は32bitアプリケーションですので、上記のバイナリコードがDLLの場合には、PCが64bit版Windowsであっても32bit版(x86)のDLLが必要です。
  • DLLの場合、 ファイル名（"lame_enc.dll" や "libFLAC.dll"）だけではそれが 32bit版(x86)か64bit版(x64)か判別できません。
  • 上記のバイナリコードがEXEの場合、32bit OS では32bit版のEXEしか選択できませんが、64bit OS では EXE は32bit版でも64bit版でも構いません。但し qaac は Apple Application Support (AAS) を必要としますが、その組み合わせは32bit版/64bit版を一致させる必要があります。即ち、qaac.exe には AAS(32bit)、qaac64.exe には AAS(64bit) を組合せます。
• LAME
  • lame_enc.dll の入手方法
    RareWares のページ から32bit版(win32)の LAME Bundle をダウンロードして展開し、lame_enc.dll を前記の [検索順序] のいずれかのフォルダにコピーします。
    
    • lame_enc.dll を用いている他のソフトウェアがインストールされている場合は、既に lame_enc.dll もインストールされている可能性があります。もしコピー先フォルダに既に lame_enc.dll が存在している場合にはそのフォルダへの上書きを避けて、[検索順序] の「1.TagReplc.exe が存在するフォルダ」にコピーするようにして下さい。（既に存在している lame_enc.dll は64bit版かもしれず、またバージョンが異なるかもしれないので、上書きすると既に使用している他のソフトウェアに影響する可能性があります。）
    • 上記の「RareWares のページ」は、The LAME Project のホームページ から Links ⇒ LAME Binaries: ⇒ Windows: でリンクされています。
  • LAME は The LAME Project が開発したアプリケーションソフトウェアで、このホームページの冒頭に次行が記されています。
    "LAME is a high quality MPEG Audio Layer III (MP3) encoder licensed under the LGPL."
  • lame_enc.dll の使用(use)に関するライセンスは The LAME Project のページ に説明があります。
    
    • この説明文中のウェブサイト www.mp3dev.org は上記の「The LAME Project のホームページ」に移動しています。
    • この説明文中の LGPL とは "GNU Lesser General Public License" のことです。
• FLAC
  • libFLAC.dll の入手方法
    開発元である Xiph.Org Foundation の FLAC の Downloads ページの「・Windows: FLAC for Windows」から入手できます。このリストの "flac-X.Y.Z-win.zip" の最新版をダウンロードして解凍し、Win32 サブフォルダの中の libFLAC.dll を前記の [検索順序] のいずれかのフォルダにコピーします。
    • libFLAC.dll を用いている他のソフトウェアがインストールされている場合は、既に libFLAC.dll もインストールされている可能性があります。もしコピー先フォルダに既に libFLAC.dll が存在している場合にはそのフォルダへの上書きを避けて、[検索順序] の「1.TagReplc.exe が存在するフォルダ」にコピーするようにして下さい。（既に存在している libFLAC.dll は64bit版かもしれず、またバージョンが異なるかもしれないので、上書きすると既に使用している他のソフトウェアに影響する可能性があります。）
  • libFLAC.dll の使用に関するライセンスは Xiph.Org Foundation のページ に説明があります。
    
• qaac
  • 既に qaac.exe もしくは qaac64.exe を使用している環境であれば、後述の「インストール後の TagReplc での設定」を行えば TagReplc で使用できるはずです。
  • qaac.exe, qaac64.exe の入手方法
    nu774 の Releases ページの「最新(Latest)」の Assets から qaac_x.xx.zip をダウンロードし解凍して、そのなかの qaac.exe もしくは qaac64.exe をコピーします。 32bit OS では32bit版の qaac.exe を選択することになりますが、64bit OS では qaac.exe でも aac64.exe でも構いません。但し qaac は Apple Application Support (AAS) を必要としますが、その組み合わせは32bit版/64bit版を一致させる必要があります。即ち、qaac.exe には AAS(32bit)、qaac64.exe には AAS(64bit) を組合せます。
  • インストール方法　（日本語訳が 日本語版qaacマニュアル にあります。）
  • qaac は Apple Application Support (AAS) を必要とします。iTunes がインストールされている環境であればパスを通せば使用できるかもしれません。iTunes がインストールされていない場合は AAS を入手する必要があります。「qaacの導入」などのキーワードで検索されるページを参照してみてください。
  • qaac のライセンスに関しては nu774/qaac のページの下方の License タブに記述があります。
  • qaac が用いる Apple Application Support 等のDLLの使用に関するライセンスやAACにエンコード（音声圧縮）する際のライセンス等については利用者が確認願います。
  • qaac インストール後の TagReplc での設定
    qaac.exe もしくは qaac64.exe インストール後に、TagReplc.exe のプログラムフォルダにある設定ファイル"TagReplc.ini" の "Qaac_Exe" という名前（キー）のパラメタ（エントリ）の値として、qaac.exe もしくは qaac64.exe のパス（フルパス）を記載します。
    （例）Qaac_Exe=C:\user\app\qaac\qaac64.exe
    また、"TagReplc.ini" の "EnvVarPATH" エントリに AAS(CoreAudioToolbox.dll など) のパスを追記します。（それぞれのパスはセミコロン(;)で区切ります。）
    （例）EnvVarPATH=C:\user\app\flac32;C:\user\app\qaac\aas64_dll
    

【その他】

• 設定ファイル：TagReplc.exe 終了時にはそのときの設定がプログラムフォルダにある設定ファイル "TagReplc.ini" に書き込まれ、次回の起動時に初期設定されます。
  "TagReplc.ini" をテキストエディタで編集できますが、フォルダ名などに US-ASCII 以外の文字（全角文字など）を使用した場合には UTF-8 で保存して下さい。（半角英数字だけの場合は Shift_JIS でも UTF-8 でも同じです。）
• バックアップ(Backup)フォルダ：処理で参照されたフォルダＡの圧縮音声ファイルを処理後に移動する先のフォルダです。
• 一時(Temporary)フォルダ：処理のときに作成されるファイルを格納するフォルダです。
  インストール直後など、プログラムフォルダに設定ファイル("TagReplc.ini")が無い状態で TagReplc.exe を起動すると、プログラムフォルダにバックアップフォルダ(bkup)と一時フォルダ(temp)が作成されます。これらのフォルダを使わずに、他のフォルダを使う場合には、TagReplc.exe 起動後にそれぞれのアイコンで開かれるダイアログボックスでフォルダを指定します。ダイアログボックスで「新しいフォルダーの作成」も可能です。
• アウトプット(Output)フォルダ：アウトプットモードにおいて、処理で生成された圧縮音声ファイルを（一時フォルダにではなく）保存するフォルダです。（参照ファイルのフォルダＡ⇒バックアップフォルダの移動、生成ファイルの一時フォルダ⇒フォルダＡ の移動の処理は行われません。）
• 「ID3 block size」と「Min. padding」
  生成するMP3ファイルのID3v2領域の最後に付加するゼロパディングを定義します。
  「ID3 block size」は ID3v2領域のバイト数が「ID3 block size」の整数倍になるようにゼロパディングを付加します。 「ID3 block size」がゼロの場合はこの調整は考慮されません。
  「Min. padding」は付加するゼロパディングの最小バイト数を定義します。
  「パディング」はタグ編集ソフトなどで再編集した際に ID3v2領域に後続するMP3オーディオデータ領域の再書込みを最小に抑えるなどのために設けますのでファイルシステムのクラスタサイズなどを考慮して決めます。NTFS のクラスタサイズは4096byte程度ですが、exFAT などでは32k〜256kByteで使われることが多いので、実際には「ID3 block size」の効果的な設定は困難と思われます。
• TagReplc は ID3v1 タグを無視します。再エンコードされたMP3ファイルに、MP3オーディオ領域のあとにおかれる ID3v1 タグがあった場合、ID3v1 タグ(128bytes)は継承されません。

【本プログラムのアップデート（更新）】

• アーカイブファイル(TagReplc_10??.zip)を展開してTagReplcフォルダを現在のTagReplcフォルダに上書きコピー
• TagReplc.ini（設定ファイル）はアーカイブファイルには無いので上書きされません。

【本プログラムのアンインストール】

• アンインストールは、TagReplcフォルダをまるごと削除します。
  但し、TagReplcフォルダの下に作成したバックアップ(bkup)フォルダを使っていた場合には、予め退避させて下さい。
• TagReplc はレジストリを使っていません。
  C:\Users\(user_name)\AppData\Roaming フォルダなども使っていません。
• 不要であれば TagReplc用に作成した一時フォルダやバックアップフォルダも削除します。

【本プログラムについて】

• 本プログラムは Win32 API を用いた 32bitアプリケーションです。
• Microsoft Visual Studio Express 2017 for Windows Desktop に添付されている
  • rc.exe (Microsoft ® Windows ® Resource Compiler)
  • cl.exe (Microsoft ® C/C++ Optimizing Compiler & Incremental Linker)
  • mt.exe (Microsoft ® Manifest Tool)
  • Windows SDK のヘッダファイル(.h)とインポートライブラリ(.lib)
  を使ってビルドしております。
  
• Win32 API を使っているだけなので Windows デスクトップ環境で動作するはずです。
  （当然ですが、64bit Windows でも WOW64 で問題なく動作します。）
  
• なお、実際の動作確認は Windows 10 (64bit) と Windows 11 (64bit) だけで、それ以外の環境では行っておりません。
  
• 上記での「Windows デスクトップアプリケーション」とは UWP (Universal Windows Platform) に対比させた呼称で「Windows PC 向けの従来型アプリケーション」のことを指します。Notebook PC に対する Desktop PC用という意味ではありません。もちろん Notebook PC でも動作します。
  
• 本プログラムでは文字列の扱いを基本的には UNICODE で行っています。
  
• 本プログラムの動作確認の際に使用したデータ（イメージファイル、MP3ファイルなど）の生成には下記のソフトウェアを用いております。
  

  表7. 動作確認用データの生成に使用したソフトウェア

  	イメージファイル形式	MP3 encoding	FLAC encoding	AAC encoding
  CDex	.wav + .cue	lame_enc.dll	libFLAC_dynamic.dll	libfaac.dll
  fre:ac	.wav + .cue	(LAME.dll)	(FLAC.dll)	(FAAC.dll,FDK-AAC.dll)
  Exact Audio Copy	.wav + .cue	lame.exe	flac.exe
  ImgBurn	.bin + .cue	N.A.
  CD Manipulator	.img + .cue	N.A.

【本ソフトウェアで利用しているオープンソースソフトウェア】

【著作権および免責事項】

• 本ソフトウェアおよび本取扱説明書に関する著作権はすべて作者(KinJ)が保有します。
• 本ソフトウェアを使用した上で生じた如何なる損害（一次的、二次的に関わらず）について作者(KinJ)は一切の責任を負いません。
• 本ソフトウェアを使用する際に発生する、本ソフトウェアのインストールアーカイブに同梱（バンドル）されていないバイナリコード(.dll や .exe)の使用に関するライセンス等については利用者が確認し、利用者の責任において使用されるものとします。
• 本ソフトウェアの保守を行う義務を作者(KinJ)は負いません。
• 利用者からのバグ報告、要望、質問等について、受信、確認、検討、回答する義務を作者(KinJ)は負いません。
• 本ソフトウェアはフリーウェアです。個人・法人に限らず利用者は無料で使用することができます。
• 本ソフトウェアの配布や導入による対価で利益を得る行為（商用利用）は禁じます。
• 製品名などは（商標マーク・登録商標マークの有無にかかわらず）各社の商標・登録商標です。
• この文書の内容およびソフトウェアの意匠、仕様は、予告なしに変更されることがあります。

【更新履歴】

1.02 (2024/07/23)

・対象とする圧縮音声ファイルに FLAC(.flac) と MP4(.m4a) を追加

・イメージファイルのエンコードに使用できるバイナリコードに libFLAC.dll と qaac.exe を追加

・一括再エンコード機能の追加

・Backup モードに加え Output モードを追加

・Misc File Copy Utility と Playlist Extension Replacement Utility を追加

・音声ファイル簡易再生するための API として MCI(Media Control Interface) のほかに MF(Media Foundation) の利用を追加した

・ツールヒント(Tooltip)表示

1.01 (2021/04/21)

・イメージファイルのエンコード機能追加

・表示、更新の対象とするフレームに TENC を追加

・プロパティ表示

・フォルダ名表示幅をメインウィンドウのリサイズに連動

1.00 (2021/02/17)

・初版公開

Copyright © 2021-2024 Kinjo-no-Jijii (KinJ).