本文へ移動
User guide

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)から作品のページへ作品のページに載っている情報。リンクが複数あるときは自動で決めません
TVertver.jp の Web 画面が使うデータ番組名・話数・放送日・放送局・あらすじ・サムネイル(横長)。出演者は取りません
ABEMAabema.tv の公開の検索ページを、アプリの中のブラウザーの窓で読み取ります(ログインや再生はしません)題名・あらすじ・画像・ジャンル。話のページからは、載っている出演者・役名・スタッフ
Wikipedia記事原題・監督・製作・出演者など、記事にある情報

TMDB 以外は公開の API がなく、Web ページを読み取っています。サイトの仕組みの変更、掲載されている情報の不足、リンクの欠けなどで取得できないことがあります。画像を取得できたことは、再利用の許可を意味しません。

TMDB の設定

取得元の初期設定は TMDB です。TMDB で検索するには、TMDB の API Read Access Token が必要です。設定するまでは、取得元の下に赤い字で案内が出ます(ほかの取得元はそのまま使えます)。

  1. TMDB のアカウントを作り、ログインします。
  2. API の設定のページで API の利用を申請し、「API Read Access Token」をコピーします(非商用は無料)。
  3. Movie Metadata の右上の設定(歯車)メニューから「TMDBの設定…」を開き、貼り付けて「保存して完了」を押します。

認証情報は Mac のキーチェーンに保存し、次に起動したときに読み込みます。プロジェクトの JSON や動画には入れません。欄を空にして保存すると、キーチェーンから削除します。TMDB の利用条件と出典の表示については、TMDB の FAQ をご覧ください。

内容を確かめて直す

候補をクリックすると、右の「③ 書き込む内容」に作品の情報が入ります。別の候補をクリックすると、内容は置き換わります。

  • 題名(邦題)・原題・公開年・公開日・監督・脚本・製作・スタジオ・ジャンル・短い説明・カバー画像の URL・出演者と役名・あらすじを、どれも書き換えられます。
  • 「カバー画像を選ぶ…」で、手元の画像(PNG・JPEG など)をカバーにできます。
  • 「取得元を開く」で、情報を取ったページをブラウザーで開けます。

動画ファイルを選んでいないときに候補を選ぶと、内容は表示だけになります。書き込むときは、左で動画を選んでから候補を選び直してください。

動画に書き込む

  1. 右下の「動画に書き込む…」を押します。
  2. 「別の場所へ保存…」を選び、保存先を選びます。名前には、書き込むタイトル+「.mp4」が最初から入ります(/ と : は全角に置き換えます)。タイトルが空か、元のファイル名と同じときは「元のファイル名.tagged.mp4」になります。
  3. 書き出しが終わると、画面の下に「保存完了」と出ます。

複数の動画にまとめて書き込む

ドラマのシリーズなど、何本もの動画に同じ内容を書き込みたいときに使います。

  1. 1 本目の動画で検索し、候補を選んで、右の内容を確かめます。
  2. 左の一覧で、⌘ キーを押しながらクリックして、ほかの動画を選び足します。Shift キーを押しながらクリックすると、間の動画をまとめて選べます。選び足しても、右に出ている内容は変わりません。
  3. 右下のボタンが「3本に書き込む…」のように本数入りになるので、押します。
  4. 「別の場所へ保存…」を選び、保存先のフォルダを選びます。それぞれの動画は元のファイル名のまま(元の動画と同じフォルダなら「元のファイル名.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 の設定のページで取得します。
再圧縮しない書き出し
映像と音声のデータをそのまま新しいファイルに入れ直すこと。画質と音質が変わらず、短い時間で終わります。