Movie Metadata 使い方ガイド
Movie Metadata 0.2.5 の使い方です。画面は作業の順に、左から「① 動画ファイル」「② 映画を検索」「③ 書き込む内容」と並んでいます。
はじめに
Movie Metadata は、手元の動画ファイル(MP4・M4V・MOV)に、映画や番組の情報(メタデータ)を書き込むアプリです。書き込んだ動画は、元の動画とは別の MP4 として保存するか、元のファイルに上書きするかを選べます。映像と音声は再圧縮しないので、画質と音質は変わりません。
入れかたはダウンロードのページにあります。特別な許可は要りません。
ふみ迷ったら、左から右へ。①②③の順に進めてくださいね。
動画を開く
- 左の「① 動画ファイル」の欄に、Finder から動画をドラッグ&ドロップします。
- 欄の下の「ファイルを追加…」か、メニューの「ファイル」→「動画ファイルを開く…」(⌘O)でも選べます。複数のファイルを一度に開けます。
- Finder で動画を右クリックし、「このアプリケーションで開く」→「Movie Metadata」を選ぶこともできます。既定の再生アプリは変わりません。
開いたファイルは一覧に並び、ファイル名・書き込むタイトル・状態(未設定・編集中・保存済み など)が出ます。クリックしたファイルが、書き込みの対象になります。MP4・M4V・MOV 以外のファイルを開くと、対応していない形式であることを知らせます。
一覧から外すときは、動画を選んで欄の下の「外す」を押すか、Delete キーを押します。右クリックの「リストから外す」でも外せます。「すべて外す…」を押すと、確かめてから全部を外します。外すのは一覧からだけで、動画ファイル自体は削除しません。まだ書き込んでいない編集内容は消えます。
映画を検索する
動画を開くと、中央の「② 映画を検索」に検索語と公開年が入り、自動で検索が始まります。
- 検索語は、動画に埋め込み済みのタイトルと公開年から作ります。なければファイル名から作ります。
- ファイル名の「(字幕版)」「[YTS.MX]」のようなかっこ書きと、「1080p」「BluRay」「x264」などの部分は除きます。
.と_は空白とみなします。 - 候補は公開年の新しい順に並びます。題名・公開年・取得元が出るので、目当ての作品かどうか確かめてクリックします。
- 見つからないときは、検索語・公開年・取得元・言語を変えて、「検索」か Return で検索し直します。
候補が同じ作品かどうかは、ご自身で確かめてください。Movie Metadata は候補を自動でまとめたり、決めたりしません。
取得元の違い
| 取得元 | 取りかた | 主に取れる情報 |
|---|---|---|
| TMDB | 公式の API(認証情報が必要) | 原題・公開日・ポスター・ジャンル・スタジオ・監督・脚本・製作・出演者と役名。日本語と英語 |
| 映画.com | 公開の検索ページ | 画像・あらすじ・監督・脚本・製作・出演者と役名(日本語)。製作年を優先します |
| Prime Video・Hulu | 公開の検索ページと作品のページ | 題名・あらすじ・画像など、ページに載っている情報 |
| Netflix・U-NEXT・Disney+・Apple TV+ | Wikipedia で作品を探し、記事のリンク(英語版 Wikipedia・映画.com・Wikidata)から作品のページへ | 作品のページに載っている情報。リンクが複数あるときは自動で決めません |
| TVer | tver.jp の Web 画面が使うデータ | 番組名・話数・放送日・放送局・あらすじ・サムネイル(横長)。出演者は取りません |
| ABEMA | abema.tv の公開の検索ページを、アプリの中のブラウザーの窓で読み取ります(ログインや再生はしません) | 題名・あらすじ・画像・ジャンル。話のページからは、載っている出演者・役名・スタッフ |
| Wikipedia | 記事 | 原題・監督・製作・出演者など、記事にある情報 |
TMDB 以外は公開の API がなく、Web ページを読み取っています。サイトの仕組みの変更、掲載されている情報の不足、リンクの欠けなどで取得できないことがあります。画像を取得できたことは、再利用の許可を意味しません。
TMDB の設定
取得元の初期設定は TMDB です。TMDB で検索するには、TMDB の API Read Access Token が必要です。設定するまでは、取得元の下に赤い字で案内が出ます(ほかの取得元はそのまま使えます)。
- TMDB のアカウントを作り、ログインします。
- API の設定のページで API の利用を申請し、「API Read Access Token」をコピーします(非商用は無料)。
- Movie Metadata の右上の設定(歯車)メニューから「TMDBの設定…」を開き、貼り付けて「保存して完了」を押します。
認証情報は Mac のキーチェーンに保存し、次に起動したときに読み込みます。プロジェクトの JSON や動画には入れません。欄を空にして保存すると、キーチェーンから削除します。TMDB の利用条件と出典の表示については、TMDB の FAQ をご覧ください。
内容を確かめて直す
候補をクリックすると、右の「③ 書き込む内容」に作品の情報が入ります。別の候補をクリックすると、内容は置き換わります。
- 題名(邦題)・原題・公開年・公開日・監督・脚本・製作・スタジオ・ジャンル・短い説明・カバー画像の URL・出演者と役名・あらすじを、どれも書き換えられます。
- 「カバー画像を選ぶ…」で、手元の画像(PNG・JPEG など)をカバーにできます。
- 「取得元を開く」で、情報を取ったページをブラウザーで開けます。
動画ファイルを選んでいないときに候補を選ぶと、内容は表示だけになります。書き込むときは、左で動画を選んでから候補を選び直してください。
動画に書き込む
- 右下の「動画に書き込む…」を押します。
- 「別の場所へ保存…」を選び、保存先を選びます。名前には、書き込むタイトル+「.mp4」が最初から入ります(
/と:は全角に置き換えます)。タイトルが空か、元のファイル名と同じときは「元のファイル名.tagged.mp4」になります。 - 書き出しが終わると、画面の下に「保存完了」と出ます。
複数の動画にまとめて書き込む
ドラマのシリーズなど、何本もの動画に同じ内容を書き込みたいときに使います。
- 1 本目の動画で検索し、候補を選んで、右の内容を確かめます。
- 左の一覧で、⌘ キーを押しながらクリックして、ほかの動画を選び足します。Shift キーを押しながらクリックすると、間の動画をまとめて選べます。選び足しても、右に出ている内容は変わりません。
- 右下のボタンが「3本に書き込む…」のように本数入りになるので、押します。
- 「別の場所へ保存…」を選び、保存先のフォルダを選びます。それぞれの動画は元のファイル名のまま(元の動画と同じフォルダなら「元のファイル名.tagged.mp4」で)保存します。同じ名前のファイルがあるときは、置き換えてよいかを確かめます。
元のファイルに上書きする
「動画に書き込む…」(複数なら「3本に書き込む…」)を押すと、保存のしかたを選ぶ画面が出ます。「元のファイルに上書き」を選ぶと、元の動画を書き込み後の動画に置き換えます。MP4 はファイル名が変わりません。M4V は拡張子が MP4 に変わります(「録画.m4v」は「録画.mp4」になり、元の M4V は削除します。同じ名前の MP4 がすでにあるときは上書きしません)。置き換えた動画は元に戻せないので、心配なときは先にコピーを取っておいてください。MOV 形式の動画は、書き込み後が MP4 形式になるため上書きしません(「別の場所へ保存…」を使います)。
書き出しはまず一時ファイルに行い、タイトル・カバー・再生時間・トラックの構成を読み戻して確かめてから、指定した場所に置きます。途中で失敗したときは、元の動画や保存先にあったファイルはそのまま残ります。「別の場所へ保存…」では、元の動画と同じ場所・同じ名前には保存できません。
MP4 に書き込むのは、タイトル・説明(あらすじ)・出演者・監督・ジャンル・公開日・スタジオ(発行者の欄。TVer の番組は放送局を TV ネットワークの欄)・カバーです。脚本・製作などを含む全項目は、出力した動画の隣の 動画の名前.mp4.metadata.json に保存します。どの項目を表示するかは、プレーヤーによって違います。
ふみ「別の場所へ保存…」なら元の動画はそのまま残るので、何度でもやり直せますよ。
録画した番組(TVer)
ファイル名に「10月23日 放送分」「第1話」「#16」のような放送日や話数があると、番組の録画とみなします。取得元を自動で TVer にして、番組名だけで検索し、ファイル名と同じ話を一番上に並べます。映画のファイルを選び直すと、元の取得元に戻ります。
- 検索欄に番組名を入れて検索できます。
https://tver.jp/episodes/ep…のリンクやエピソード ID(ep+8 文字)を貼ると、その回を直接取得します。 - 放送日に年がないときは、今日より前で最も近い日付として年を補います。
- TVer には公開の API がなく、tver.jp の Web 画面が使うデータを読んでいます。TVer の変更で取得できなくなることがあります。動画の取得(ダウンロード)の機能はありません。
ABEMA の番組
取得元で「ABEMA」を選んで検索すると、アプリの中に小さなブラウザーの窓が開き、abema.tv の公開の検索ページを読み取ります。シリーズと話の候補がそろうと、窓は自動で閉じます。窓を閉じると検索を取り消します。ログインや再生はしません。
https://abema.tv/video/title/…やhttps://abema.tv/video/episode/…のリンクを検索欄に貼ると、その作品や回を直接取得します。- 候補は、検索結果の最初に表示される分だけです。
- 題名・あらすじ・画像・ジャンルを取得します。話のページでは、載っている出演者・役名・スタッフも取得します。製作年やスタッフが載っていないときは、推測せずに空のままにします。配信が始まった日は公開日として扱いません。
- ABEMA にも公開の API はなく、Web ページを読み取っています。ABEMA の変更で取得できなくなることがあります。動画の取得(ダウンロード)の機能はありません。
作業を保存する
右上の設定(歯車)メニューの「作業を保存…」で、開いているすべてのファイルの編集中の状態を JSON に保存できます。「保存した作業を開く…」で続きから再開できます。これは動画への書き込みとは別のものです。
メニューと設定
| このアプリについて | アプリメニュー(画面左上の「Movie Metadata」)。バージョン・著作権表示・公式サイトへのリンク |
|---|---|
| アップデートを確認… | アプリメニュー。新しい版があれば、すぐに更新できます |
| アップデートを自動で確認 | アプリメニュー。1 日 1 回の確認(初期設定はオン) |
| アップデートを自動でインストール | アプリメニュー。見つかった版を裏で用意して、終了したときに入れ替えます(初期設定はオン) |
| TMDBの設定… | 右上の設定(歯車)メニュー。TMDB の API Read Access Token |
| 保存した作業を開く… / 作業を保存… | 右上の設定(歯車)メニュー。編集中の状態の JSON |
困ったとき
- 候補が出ない
- 検索語を短くする、公開年を消す、取得元を変える、言語を変える、を試してください。邦題で見つからないときは原題でも試せます。
- TMDB で検索できない
- 「TMDBの設定…」で API Read Access Token(長い文字列)が入っているか確かめてください。「API キー」(短い文字列)ではなく「API Read Access Token」を使います。
- 取得元のサイトで急に取れなくなった
- サイトの仕組みが変わった可能性があります。別の取得元で試し、対応した版の公開をお待ちください。
- 「書き出し失敗」と出る
- 保存先の空き容量と、書き込みの権限を確かめてください。カバー画像を取得できないときは、カバー画像の欄を空にするか、手元の画像を選んでから書き出し直してください。一部のコーデックやトラックの構成では、MP4 へ書き出せないことがあります。
- 書き込んだ情報がプレーヤーに出ない
- 表示する項目はプレーヤーによって違います。Finder の「情報を見る」や、ミュージック・TV など別のアプリでも確かめてください。
- 自動で更新されない
- アプリをアプリケーションフォルダーに入れて開いているか確かめてください。ディスクイメージの中から開いていると入れ替えられません。アプリメニューの「アップデートを確認…」で、その場で確かめることもできます。
解決しないときは、info@k386.sub.jp までご連絡ください。
用語
- メタデータ
- 動画ファイルに入れておく、題名・あらすじ・出演者・カバー画像などの情報。
- 取得元
- 作品の情報を探しに行くサイトやサービス。中央の欄で選びます。
- API Read Access Token
- TMDB の API を使うための認証情報。TMDB のアカウントの API の設定のページで取得します。
- 再圧縮しない書き出し
- 映像と音声のデータをそのまま新しいファイルに入れ直すこと。画質と音質が変わらず、短い時間で終わります。