開発者向けドキュメント

歌詞ファイル形式 — ALRC / LRC

同期歌詞(音楽に合わせて流れる歌詞)のファイル形式についての解説です。Think Songs が定めた .alrc(ALRC 1.0)を中心に、従来から広く使われている .lrc の文法も、凡例つきの実例で示します。自作のプレイヤーやタイミング作成ツールを書く方、手で歌詞ファイルを書きたい方に向けた内容です。

仕様の正本は機械可読な JSON で公開しています。パーサを書くときはこちらを参照してください。

GET /api/spec

1. 2 つの形式

Think Songs は 2 つの形式を扱います。拡張子ではなく中身で判別するため、.txt で保存されていても正しく読み込めます。

.alrc

標準

ALRC 1.0(Advanced Lyrics File Format)。Think Songs が定めた刷新形式で、こちらが標準です。旧 LRC とは非互換なので拡張子を分けています(.lrc を名乗らない=既存プレイヤーが誤読しない)。

.lrc

従来・互換用

従来の LRC / Enhanced-LRC。1990 年代から音楽プレイヤーで使われてきた事実上の標準で、1 行ごと(拡張すると 1 文字ごと)にタイムタグを置くだけの素朴な形式です。読み込み・書き出しに対応していますが、新しく作るなら .alrc をおすすめします。

判別は 1 行目で行います。1 行目が ALRC の識別行(# Advanced Lyrics File Format …)なら ALRC、それ以外は LRC として扱います。

2. ALRC 1.0 形式(本サービスの標準)

Think Songs が標準として使う形式です。ファイルは「識別行 → ヘッダ(key: value)→ 本文」の3 段構成で、本文は行頭の絶対時刻と、文字の左に置く相対秒でできています。従来の LRC で書けなかったことを書けるようにしたもので、その中身は 4 章で比べます。

# Advanced Lyrics File Format (version: 1.0)

title: 星の雫
artist: サンプル
lyricist: 作詞者名
rights: free  // jasrac / nextone / self / free
audio.leadin: 309  // ms
audio.duration: 328848  // ms
style.background-color: #0b1020

[00:04.000]<♥>{星|<0.30>ほ<0.55>し}<0.85>の<1.20>ひかり<1.90><2.60>よ<3.10>
  • # / //コメント。# は行頭にあるときだけ行コメント(色 #0b1020 と衝突しません)、// は行のどこでも以降がコメントです。1 行目の識別行は削除できません。
  • key: valueヘッダ。本文の最初の [ より前にすべて置きます。title / artist が必須で、album・lyricist・composer・arranger・taggedby・tags・rights・jasrac・nextone を任意で書けます(tags は歌詞のタグをカンマで並べたもの。例 tags: autogenerated, corrected)。
  • audio.*音源の頭(仕様 2.7.0)。タイミングを付けた音源の音が鳴り始める時刻 audio.leadin と、その音源の長さ audio.duration を、整数の ms で書きます(どちらも任意)。ふつうは手で書かず、ツール・エディタ・サーバーが音から測って書きます。置く場所は taggedby・tags より後ろ、style.* より前です。
  • style.*作者の推奨スタイル。プロパティ名は CSS3 に準拠します(background-color / background-image / font-family / text-align / color など)。視聴者側の表示設定があればそちらが優先され、これはフォールバックになります。
  • [mm:ss.xxx]行の絶対開始時刻。長尺向けに [hh:mm:ss.xxx] も書けます(コロンの数で解釈)。本文の行はこれで始まります。別の行と同じ時刻でも構いません(ハモリでパートごとに行を分けるときなど。5 章)。
  • <♥>パート(声)タグ。行頭に置けばその行ぜんたい、行の途中に置けばそこから先に効きます。1 つのタグに記号を重ねると【ユニゾン】(同じ旋律を複数パートで)で、色を混ぜて 1 色にします:<♥♦>。タグを続けて 2 つ以上書くと【ハモリ】(別旋律を同時に)で、左から順に上・下(3 つなら上・中・下)に文字が塗り分けられます:<♥><♦>。両者は組み合わせられます:<♥♦><★> なら上の帯が ♥♦ のユニゾン、下の帯が ★ です。記号は ♥ ♠ ♣ ♦ ★ ● が組み込みですが、これは上限ではなく、作者が決めた記号も使えます。
  • <秒>相対タグ。行頭の時刻からの相対秒で、すぐ右の文字が歌い始める時刻を表します。終わりは次のタグ。行の最後の文字には終わりを示す末尾タグを置きます。1 行の中では、左から右へ同じか大きい値にします(減らすと検証エラー。5 章)。
  • {基底|よみ}ふりがな。よみの中にも相対タグを置けるので、モーラ単位でタイミングを付けられます。表示は基底文字の上によみが乗り、スイープは基底のブロック単位で進みます。
  • タグ 2 連続「切る」。タグが 2 つ続いて間に文字が無いとき、前側は直前の文字の終わりになります。上の例では「ひかり」が 1.90 秒で切れ、次の「よ」は 2.60 秒から始まります。

声が重なる掛け合い — 行頭の <&> で 1 段に並べる

1 行の中では相対タグを戻せないので、掛け合いや追っかけのように声が時間的に重なる歌詞は、声ごとに行を分けて書きます。分けた行の行頭([mm:ss] の直後)に <&> を置くと、その行は前の行の右へ続けて 1 段に表示されます(改行しない)。時刻・パート・ふりがなは行ごとに独立で、それぞれ自分の時刻で塗られます。

[00:12.00]<♥>きみが <1.20>
[00:12.80]<&><♠>わらう<1.40>

画面では 1 段「♥きみが ♠わらう」になり、♥ は 12.00〜13.20 秒、♠ は 12.80〜14.20 秒に塗られます(12.80〜13.20 秒は 2 か所が同時に進みます)。区切りの空白は前の行の末尾(終端タグの前)に書きます。本文の 1 行目と空行の直後には置けません。

音源の頭 — audio.leadin・audio.duration で版の違いを合わせる

同じ曲でも、配信の版・CD からの取り込み・リマスターで、頭の無音の長さが違うことがあります。2026 年 11 月 3 日に測ったところ、Apple Music の版は手元の音源より「眠り姫」で +0.94 秒、「高嶺の花子さん」で −1.15 秒ずれていました。タイミングを付けた音源の頭を書いておけば、聴く人の音源の頭と比べて、その差を自動で合わせられます。

audio.leadin: 309
audio.duration: 328848
  • audio.leadinタイミングを付けた音源(作者の音源)の音が鳴り始める時刻。整数の ms で、本文と同じ時間軸です(負になることもあります)。値の形: ^-?\d{1,7}$
  • audio.durationその音源の長さ。正の整数の ms です。値の形: ^[1-9]\d{0,7}$

作者が手で書くものではありません(書いても構いません)。自動タイムタグ付けツール(alrc-align)・アプリのエディタ・サーバーが、音から測って書きます。サーバーは、投稿・編集で作者の音源(自作曲・著作権フリーの曲の音楽ファイル)が付いたとき、本文にまだ audio.* が無ければ、アップロードされた元のファイルから測って 2 行を書きます。すでに値があれば書き換えず、音源を外しても値は残ります。形の違う値は、投稿・更新のときにエラーになります。

読む側(アプリ)は、聴く人の音源を同じ測り方で測り、c = 聴く人の leadin − audio.leadin(ms)だけ歌詞を遅らせます。|c| が 20 ms 未満なら誤差として 0、|c| が 5000 ms を超えるか、長さが 15000 ms を超えて違えば、別の編集・別の曲とみなして合わせません。測れるのは手元の復号できる音源ファイルだけで、Apple Music・Spotify などのストリーミングや音楽アプリとの連携では合わせません。

測り方 — どの実装でも同じ数が出るように決めてあります

  1. 再生と同じ時間軸で、曲の最後まで復号する(再生と同じ復号器を使い、先頭の encoder delay の扱いも再生と同じにする)
  2. 全チャンネルを平均して、モノラルにする
  3. 約 10 ms の区間(frame = 標本化周波数 ÷ 100 の切り捨て)に区切り、区間ごとの平均二乗を出す(最後の半端な区間は捨てる)
  4. しきい値は、いちばん大きい区間の 1/10000(−40 dB)
  5. しきい値以上になる最初の区間の頭が leadin(ms・切り捨て)。全部が無音なら audio.* は書かない
  6. duration は 標本数 × 1000 ÷ 標本化周波数(ms・切り捨て)

参照実装は、仕様 JSON(GET /api/spec の alrc.audio.measurement)と、サーバーの backend/app/utils/audio_leadin.py です。同じマスターを AAC・MP3・FLAC にしたものや、頭の無音だけが違う版どうしでは、誤差は中央値 4 ms・最大 13 ms でした。片方にだけフェードインがあると、最大 0.7 秒ほど外れます。

作成者の署名 — signedby・signature・signedat

Think Songs のアプリは、歌詞を保存するたびに、ヘッダへ作成者の署名を付けます(2026 年 11 月から)。分かるのは「誰が最後にこの本文を保存したか」で、本文が書き換えられていないことも確かめられます。読む側が確かめる必要はなく、知らなければ未知のヘッダとして読み飛ばして構いません。

signedby: U12AB34
signature: v1.<公開鍵>.<鍵の証明>.<本文の署名>
signedat: v1.<UNIX 秒>.<時刻の証明>
  • signedby署名した人の公開 ID。U… はアカウント、D… はログインしていない端末(サーバーが、登録済みの端末から作る公開用の ID)、K… はサーバーの証明がまだ無い端末の鍵だけ。メールアドレスなどは入れません。
  • signaturev1 と、base64url(パディング無し)の 3 つをドットでつないだもの。公開鍵は保存した端末の Ed25519 の鍵、鍵の証明はその鍵が signedby の人のものだというサーバーの署名、本文の署名はその鍵で本文のハッシュに付けた署名です。K… のときは鍵の証明が空になります。
  • signedat任意。サーバーが「この時刻にこの本文があった」と付けた証明です(本文そのものはサーバーに送りません)。

署名する文字列 — どの実装でも同じバイト列になるように決めてあります

  • 鍵の証明: サーバーの鍵で "thinksongs-author-cert-v1\n" + signedby + "\n" + 公開鍵(base64url)
  • 本文の署名: 端末の鍵で "thinksongs-author-v1\n" + signedby + "\n" + 本文のハッシュ(SHA-256 の小文字 16 進)
  • 時刻の証明: サーバーの鍵で "thinksongs-author-time-v1\n" + signedby + "\n" + 本文のハッシュ + "\n" + 秒

本文のハッシュの揃え方

  1. Unicode の NFC に揃え、改行を LF にする
  2. 次の鍵の行を除く: signedby・signature・signedat・userid・songid・protectedtag・offset(行の最初の「:」より前を、前後の空白を除いて小文字にしたもの)
  3. 各行の行末の空白を除く(空白は Python の str.isspace と同じ。全角の空白も含みます)
  4. 末尾の空行を数えず、LF でつないだ UTF-8 の SHA-256 を取る

確かめるときは、サーバーの公開鍵(GET /api/spec/protected-key)で鍵の証明を、signature の中の公開鍵で本文の署名を確かめます。どちらかが合わなければ「署名なし」として扱い、表示は止めません(ほかのエディタで本文を直すと署名は合わなくなります)。本文が変わっていなければ、アプリは前の人の署名を残します。

署名の 3 つのキーは、仕様 JSON(GET /api/spec)のヘッダの一覧に、次の版で入る予定です。

3. LRC 形式(従来・互換のため対応)

行の先頭に [分:秒.小数秒] を書くだけの形式です。仕様書を発行する団体は存在せず、各社の実装が事実上の仕様になっています。日本語の一次情報としては、ソニーがウォークマン向けに「同期テキスト」として書式を公開しています。

[ti:星の雫]
[ar:サンプル]

[00:04.00]星の雫
[00:08.50]夜をわたる風
  • [ti:…]メタタグ。曲名 ti / アーティスト ar / アルバム al / 作詞 au / 制作者 by / 全体補正 offset など。
  • [mm:ss.xx]その行を表示し始める時刻。行の先頭に置きます。

📖 一次情報:ソニー ウォークマンの「同期テキスト」

ソニーのサポートページに、LRC ファイルの作りかたと書式が説明されています。

同ページによると、書式と制約は次のとおりです。

  • 時間情報は「分:秒:1/100秒」。秒と 1/100 秒の区切りは「:」でも「.」でもよい。
  • 1/100 秒は省略できる。
  • ファイル名は音声ファイルと同じ名前にして拡張子 .lrc を付ける。
  • 文字コードは UTF-8。ファイルサイズの上限は 512 KB。

※ 歌詞配信サービス「歌詞ピタ」は 2018 年 7 月末で終了しており、現在は自分で LRC を用意する形になっています。

文字単位のタイミング(カラオケ表示)

行の途中にも同じ書式のタグを置くと、1 文字ずつ色が変わるカラオケ表示になります。Think Songs はこの書き方に加えて、ふりがな {漢字|かんじ} とパート指定 [♥] にも対応しています(いずれも LRC の標準ではなく独自拡張です)。

[00:04.00]星[00:04.30]の[00:04.60]雫[00:05.20]

末尾の、文字を伴わないタグは「最後の文字の終わり」を表します。これがないと最後の 1 文字だけ終わりの時刻が分からず、塗り終わりを推測するしかありません。

⚠️ LRC で困ること

  • 文字ごとにフルの絶対時刻を書くので長い。行を 0.5 秒ずらしたいだけでも、その行のタグを全部書き直すことになります。
  • 「ここで声が止まる」を表せません。ある文字は次の文字が始まるまで塗られ続けるので、歌っていない無音区間をスイープが進んでしまいます。
  • メタ情報がタグの寄せ集めで、作曲者・編曲者・権利関係などを書く場所が決まっていません。
  • 見た目(色・背景・書体)を作者が指定できません。ALRC ならパートごとの文字色まで指定できます。
  • コメントが書けず、制作メモを残せません。

4. ALRC で何ができるようになったか

見た目の派手さではなく、「LRC では書けなかったこと」が書けるようになった点が本質です。

① 相対タグ — 行をずらすのが 1 か所で済む

文字のタイミングを行頭からの相対秒で持つので、行全体を 0.5 秒後ろにずらしたいとき、書き換えるのは行頭の [mm:ss] だけです。絶対時刻を全文字に書く LRC では、その行のタグをすべて計算し直す必要がありました。タグ自体も短くなり、本文が目で追えます。

② 「切る」 — 声が止まる場所を書ける

LRC では、ある文字は次の文字が始まるまで塗られ続けます。歌が途切れる箇所ではスイープだけが無音の上を進み続け、見ていて音とズレます。ALRC はタグを 2 つ続けて置くことで「ここで終わり」を明示できます。この記法を知らない実装は 2 つ目のタグで上書きするだけなので、従来どおりに描画されます(=後方互換)。

③ ふりがな・パートが仕様の一部

ルビとパート(デュエット/ユニゾン)は独自拡張ではなく仕様に含まれます。ルビはモーラ単位でタイミングを持てるので、漢字 1 文字を読みの長さに合わせて塗ることができます。

④ 権利情報と見た目を 1 ファイルに持てる

作詞・作曲・編曲・権利区分・作品コードを決まったキーで書けるので、アップロード時にそのまま取り込めます。style.* で作者の推奨する配色・背景・書体も持ち運べます。

項目.alrc.lrc
行タイミング○○
文字タイミング○(行頭からの相対秒で短い)○(毎回フルの絶対時刻)
声が止まる場所○ タグ 2 連続で「切る」✕
ふりがな○ 仕様・モーラ単位のタイミング可△ 独自拡張
パート/ユニゾン/ハモリ○ 仕様(記号は自由)△ 独自拡張
声が重なる掛け合いを 1 段に○ 行頭の <&> でつなぐ✕
メタ情報key: value(作詞・作曲・編曲・権利・作品コード…)[ti:] など数個のタグ
見た目の指定○ style.*(CSS3 準拠)✕
コメント○ # 行頭 / // 行内✕
長尺(1 時間超)○ [hh:mm:ss.xxx]△ 実装依存
改ざん検知・コピー防止○ protectedtag(Ed25519・端末バインド)✕
再生位置の補正○ offset:(利用者の申告平均をサーバーが注入)△ [offset:] 全体のみ
音源の版の違いを自動で合わせる○ audio.leadin・audio.duration(音源の頭と長さ)✕

5. パーサを書くときの注意

互換性のために決めてあることです。

  • 未知の style.* は無視する。 前方互換のための決まりです。将来プロパティが増えても古い実装が壊れません。
  • タグ 2 連続を知らなくてよい。 実装しない場合は 2 つ目のタグで開始時刻を上書きするだけにしてください。従来と同じ描画になります。
  • <&> を知らなくてよい。 実装しない場合は不正なタグとして無視してください。つないだ行が別々の行として出るだけで、時刻は保たれます。実装するときは、段の中の行ごとに塗ってください。時刻は左から右へ増えるとは限りません(後ろの行が先に歌い出すこともあります)。
  • 行の中の相対タグは、左から右へ減らさない。 右のタグが左のタグより小さい(時刻が逆戻りする)と、描画が複雑になるため検証でエラーにしています(規則 alrc_rel_tag_order)。同じ値が続くのは構いません。ルビ { } の中のタグも、本文に書かれた順に数えます。
  • 複数の行が、同じ時刻に始まってよい。 ハモリなどで、パートごとに行を分けて同時に歌わせるためです。行頭の時刻が「必ず増えていく」ことを前提にしないでください。二分探索で現在の行を探すと、同じ時刻の行で表示が飛んだり戻ったりします。
  • ヘッダは本文より前。 最初の [mm:ss] 行が現れた時点でヘッダ領域は終わりです。それ以降の key: value は歌詞本文として扱います。
  • 形式は中身で判別する。 拡張子ではなく 1 行目の識別行で ALRC かどうかを決めます。
  • 配信時にサーバーが足すヘッダがある。 songid / userid / protectedtag / offset は配信のたびにサーバーが注入します。作者は書きません。再アップロードする前に取り除いてください。
  • 署名の行は読み飛ばしてよい。 signedby / signature / signedat は、知らなければ未知のヘッダとして捨ててください。本文を直して保存すると署名は合わなくなります。行を残しても消しても構いませんが、署名を付け直すのは Think Songs のアプリだけです(2 章)。
  • audio.* は作者側の値。 上の songid / userid / protectedtag / offset と違い、配信のたびに足されるものではありません。編集して上げ直すときも消さないでください。
  • audio.leadin は「載せ替え」のときだけ動かす。 同じ本文を、頭の位置が違う別の版の音源に合わせ直す一括のずらし(例: 以前 publish.py が上げていた「Apple Music 版(+200ms)」を元に戻すずらし、alrc-align の fix_am_offset.py)では、audio.leadin も同じだけ動かします。0 で止めず、負になっても構いません。同じ音源のままタイミングの誤りを直すずらし(作者の音ズレ補正の書き込み・エディタの「全行をずらす」・行ごとの手直し)では動かしません。動かすと、作者と同じ音源で聴く人に自動の補正がかかり、直しを打ち消してしまいます。audio.duration は、どちらでも動かしません。
  • audio.* は形が違えば無視する。 読む側は、値が 2 章の形に合わなければ、その行は無いものとして扱ってください(エラーにしない)。知らない audio.* キーも捨てます(前方互換)。形の違う値を断るのは、投稿・更新のときだけです。
  • .lrc に変換するときは audio.* を落とす。 [offset:] にも写しません。補正の量ではなく、音源の頭の位置だからです。
  • 本文を取るときは仕様の版を名乗る。 audio.* を読むアプリは、本文を取る要求に見出し ThinkSongs-Lrc-Spec: 2.7.0 を付けてください。サーバーは、2.7.0 より前の版を名乗る取得と名乗りの無い取得には、audio.* を外して配ります(知らないヘッダで取得を止めてしまう古いアプリを守るためです)。

文字コードは UTF-8 を推奨(Shift-JIS も読み込めます)。改行は LF / CRLF のどちらでも構いません。

6. ライブラリのパッケージ(.thinksongs)

Think Songs のアプリ(iPhone・Mac・Android・Windows)は、自分で取り込んだ音源と、自分の歌詞・画像を、1 つのファイルにまとめて書き出し・読み込みできます。中身は普通の ZIP なので、ほかのツールでも開けます。

  • 入るのは自分のファイルだけ。 取り込んだ音源・自分で作った歌詞・画像は中身ごと入ります。Think Songs から届いた曲(配信の音源と、songid: や protectedtag: の付いた配信の歌詞)は中身を入れず、曲の公開 ID だけを入れます。読み込むと、そのときのルール(購読・無料枠)でサーバーから取り直します。
  • 拡張子と種類。 拡張子は .thinksongs、MIME は application/vnd.thinksongs.library+zip、Apple の UTI は jp.sane.thinksongs.library(public.zip-archive の一種)です。
  • 手で作れる。 manifest.json は任意です。下の並べ方のフォルダー(Music フォルダー、またはアーティスト・アルバムのフォルダー)を Finder やエクスプローラーで ZIP にするだけで、アプリの「ライブラリを読み込む…」で読み込めます。拡張子は .thinksongs でも .zip でも構いません。

中の並べ方

Music/<Artist>/<Album>/01 - Title.m4a
Music/<Artist>/<Album>/01 - Title.alrc        // 同じ名前の歌詞
Music/<Artist>/<Album>/cover.jpg              // 任意・アートワーク
Music/<Artist>/<Album>/Backgrounds/01 - Title.jpg  // 任意・この曲の背景
Music/<Artist>/<Album>/Pictures/1.jpg         // 任意・ブックレットの画像(歌詞カード・解説など)
Music/<Artist>/artist.jpg                     // 任意・アーティストの写真
Lyrics/<Artist>/<Title>.alrc                  // 音源をファイルで持たない曲の歌詞
manifest.json                                 // 任意・アプリが書き出すときは最後に置く
  • 歌詞は、音源と同じフォルダーの同じ名前(拡張子を除く)。.alrc を先に、無ければ .lrc を読みます。名前は NFC に揃え、大文字と小文字を区別せずに比べます。
  • アプリが書く ZIP の名前は UTF-8(フラグ 0x0800)。音源と画像は無圧縮、テキストは deflate。4 GB を超えるときは ZIP64。暗号化はしません。読むときは、フラグの無い名前を UTF-8 として読み、読めなければ CP932(日本語の Windows のエクスプローラーが書く形)として読みます。
  • 中の順番は「音源・画像 → 歌詞 → manifest.json」。歌詞を書き換えるときに、後ろだけを書き直せるようにするためです。 手で作るときは、順番を気にしなくて構いません。

manifest.json

{
  "format": "thinksongs",
  "version": 1,
  "created_at": "2026-11-05T10:19:00Z",
  "app": "Think Songs 1.1.6 (53)",
  "platform": "iOS",
  "contents": "everything",
  "files":  [{ "path": "Music/Artist/Album/01 - Title.alrc", "size": 485, "sha256": "…" }],
  "tracks": [{ "title": "Title", "artist": "Artist", "album": "Album",
               "path": "Music/Artist/Album/01 - Title.m4a",
               "lyrics": "Music/Artist/Album/01 - Title.alrc" }],
  "links":  [{ "publicID": "S12AB34", "title": "…", "artist": "…", "album": "…" }]
}
  • manifest.json が無いときは、ZIP の中を見て取り込みます。歌詞(.alrc、無ければ .lrc)ごとに 1 曲とし、同じフォルダーの同じ名前の音源と組にします。曲名とアーティストは、歌詞のヘッダ → ファイル名(先頭の番号を外す)→ フォルダー名の順に取ります。
  • manifest.json が無いと、links(Think Songs の曲)は戻りません。Think Songs の曲とのつながりは、歌詞がその曲のいまの版と全く同じときだけ、下の照合でつながり直します。
  • format が "thinksongs" でなければ読みません。version が上がっても、知らない欄は無視して読み、書き直すときも残してください。
  • contents は everything(音源も)・noAudio(歌詞と画像)・lyricsOnly(歌詞だけ)。
  • files はファイルの一覧(テキストと画像には sha256)。tracks は曲ごとの音源と歌詞の置き場所(音源を入れないときも path を書きます)。links は Think Songs の曲で、公開 ID だけです。
  • tracks と links の行には、曲ごとの設定も入ります。Think Songs の曲とのつながり(linkedSongID)、「この歌詞だけ」の音ズレ(lyricsOffsetMs)、「この曲だけ」の背景(background)です。lyricsOffsetMs はタイムタグに足す量(アプリの画面の値と同じ。マイナスで歌詞が早くなる)の整数 ms です。

読み書きするときに守ること

  • 取り出すとき、名前に「..」「.」の段・先頭の「/」・「\」・NUL がある中身は取り出さないでください(取り出し先のフォルダーの外へ書かせないため)。CRC と大きさも確かめます。
  • __MACOSX/ の下、「.」で始まる名前(._* や .DS_Store)、Thumbs.db、desktop.ini は飛ばします。残りの一番上がフォルダー 1 つだけなら(Music と Lyrics を除く)、包みのフォルダーとみて、その中を読みます。manifest.json も、その中の一番上にあるものだけを読みます。
  • 中の歌詞を書き換えるときは、差し替える中身から後ろだけを書き直し、manifest の files のその行(size と sha256)も直します。新しい版を末尾に足すだけにはしないでください。頭から順に読むツール(macOS の Finder での展開など)は最初に出会った目次で止まり、古い歌詞を取り出してしまいます。
  • manifest.json の無いパッケージの歌詞を書き換えても、manifest.json は足さないでください。
  • アプリは、読み込んだパッケージの歌詞を編集して保存するとき、「上書き保存しますか?」と確かめてから、パッケージの中の歌詞も書き換えます。
  • サーバーの曲と同じ歌詞はリンクになる。 アプリは読み込むとき、歌詞ごとに時刻とテキストだけのハッシュをサーバーに送り(本文は送りません)、Think Songs の曲のいまの版と全く同じなら、ファイルではなくその曲につなぎます。作者本人の曲は置き換えません。