使い方

はじめての 1 本

素材を入れる → 並べる → 切る → テロップ → 書き出す

本編は 5 段、その前に「開く」が 1 つ。途中で迷いやすい所には ★ を付けました。

• 0. 開く

  デスクトップ版（.exe）は Windows 10 / 11（64bit）だけです。 配布物を作る設定に Windows の 64bit しか書いていないので、Mac 版・Linux 版は存在しません （「まだ無い」ではなく、作る設定そのものがありません）。 Mac・Linux の方は、下のブラウザ版を読んでください。

  デスクトップ版は、起動するとまず小さな窓が出ます。 「新しく始める」を押すと編集画面へ進みます。 この窓には「最近ひらいたもの」「更新の確認」「環境の状態」も出ます。 更新が無く、最近ひらいたものも無いときだけ、押さなくても自動で編集画面へ進みます。
  ブラウザ版は OS を問いません。手元で node server.js を走らせて http://localhost:5173 を開きます。 index.html のダブルクリックでは動きません（ES モジュールのため）。

• 1. 素材を入れる

  左の「メディア」欄へ、動画・音声・画像をドラッグ＆ドロップします。 欄の右上にある読み込みのボタン、またはメニュー「ファイル → 素材を読み込む…」でも同じです。 入れると、サムネイルと音声波形の解析が自動で走ります。 インターレースに見える素材には「縞」の印が付きます（推定なので、断定はしません）。

  落とす先は厳密でなくてかまいません。窓のどこへ落としても取り込みます。 メディア欄の「ドラッグ＆ドロップ」と書いてある所は、クリックするだけでも読み込みの画面が開きます。 どの入れ方でも、素材の置き場所を覚える鍵を一緒に受け取ります （これがあるので、開き直したときに繋ぎ直せます）。

  ★入る素材は、ブラウザが読める形だけです

  ファイル選択の窓が並べる拡張子は、動画 .mp4 .webm .mov .mkv .avi .m4v／ 音声 .mp3 .wav .m4a .aac .ogg .flac／画像 .png .jpg .jpeg .gif .webp .bmp です。
  ただし復号するのは TSUGIME ではなくブラウザで、TSUGIME 自身は復号器を持っていません。 上の拡張子でも、ブラウザが中身を読めなければ取り込めず、その場で断りが出ます。 ★どの拡張子がどの環境で読めるかは測っていませんので、 この頁では「この形式なら入ります」と言えません。手元のファイルで試してください。
  ★動画・音声・画像のどれでもないファイル（.pdf や .txt など）は、 何も言わずに無視します。落としたのに増えていないときは、これです。

• 2. 並べる

  メディア欄の素材を、下のタイムラインへドラッグして落とします。 落とした位置がクリップの開始時刻になります。 最初から映像トラックが V1・V2、音声トラックが A1 の 3 本あります。 映像と画像は映像トラック、音声は音声トラックへ。 違うトラックに落とすと、その場で断りが出ます。 画像は 5 秒のクリップになります。動画・音声は素材の長さそのままです。

  「スナップ」が入っていると、近く（画面上で 8px 相当）にあるクリップの端・再生ヘッド・先頭に吸い付きます。 どれも遠ければコマの境に吸います。切り目がコマの途中に来ないのはこのためです。

  ★ダブルクリックでは置かれません

  置く方法は今のところドラッグだけです。素材一覧でダブルクリックしても何も起きません （挿入の処理は書いてありますが、画面から呼ぶ配線が入っていません）。 複数選んで引いても、置かれるのは掴んだ 1 本だけです。

• 3. 切る

  ① 切りたいクリップをクリックして選び、② 再生ヘッドを切りたい位置へ動かし、 ③ S キー（またはツールバーの「分割」）を押します。 1 コマずつ動かすなら ← →、再生・停止は Space です。

  切ったあと、いらないほうを選んで Delete。 穴を残さず後ろを前へ詰めるなら Shift+Delete（詰めて削除）です。 できた隙間は G で 1 つ、Shift+G でそのトラック全部を詰められます。

  ★押しても切れないときは、たいてい 2 つのどちらかです

  分割が効くのは選んでいるクリップだけです。何も選んでいないと、 S を押しても何も起きません（断りも出ません）。
  もう 1 つは位置です。クリップの端から 0.05 秒以内では切れません。 0 秒のかけらを作らないための線引きです。

• 4. テロップを入れる

  再生ヘッドを出したい位置へ置いて、ツールバーの「テロップ」を押します。 4 秒のテロップがいちばん上の映像トラック（V1）に載り、 右のプロパティ欄がテロップの設定に変わります。

  設定は 13 区分（テンプレート／プリセット／文字／フォント・組み／塗り／縁取り／影／グロー／背景／ アニメーション／配置・自動縮小／ふりがな／日本語組版）。 プリセットは 50 件で、定番 9／強調 11／落ち着いた 9／字幕 7／タイトル 7／「手書き・ポップ」7 に分かれています。 登場・持続・退場のアニメーションは 51 種です。

  ★テロップは必ず V1 に載ります

  置き場所は選べません。V1 はいちばん手前に映るトラックなので、 映像を V2 に置いておくと重なりません。 V1 に映像を置いていると、同じトラックの同じ時刻にテロップが重なります （絵は出ますが、タイムラインの見た目が読みにくくなります）。

• 5. 書き出す

  ツールバーの「書き出し」（またはメニュー「ファイル → 動画を書き出す…」）。 プリセットを選ぶと、解像度・フレームレート・形式・ビットレート・キーフレーム間隔が一度に決まります。 プリセットは 52 件、12 の群（YouTube 11／確認 7／保存 5／縦動画 5／SNS 4／配信 4／ 「放送・納品」4／X 3／音声 3／Web 3／Instagram 2／TikTok 1）に分かれています。 最後に「書き出し開始」。終わるとブラウザのダウンロード先にファイルが落ちます。

  書き出したあと、TSUGIME はそのファイルを読み直して 尺・解像度・フレーム数・音の有無・絵の一致を照合し、結果を出します。

  音量の「ラウドネス正規化（-14 LUFS）」は、書き出しの窓に 1 つあるチェックで、 どのプリセットを選んでも初めから入っています（YouTube 用の設定ではありません）。 外すと、素材の音量のまま出ます。

  ★何も選ばないと WebM で出ます

  「形式」の初期値は WebM（VP9 / Opus）です。 どこでも再生できる MP4（H.264 / AAC）が要るなら、形式を選び直すか、 MP4 のプリセット（YouTube など）を選んでください。

逆引き

「〜したい」から引く

探している言葉で見出しを立てました。どれも 0.2.0 で実際に届く道だけを書いています。

先に言っておきます

つまずきやすい所

手順どおりにやっても引っかかる所を、理由ごと書きます。 できないことの頁もあわせてどうぞ。

• ページを再読み込みすると、素材が一度オフラインになります

  素材の実体をこの PC に置いたまま扱う設計の裏返しです。外へ送らない代わりに、 読み込み直すと参照が切れます。取り込んだ場所は覚えているので、 プロジェクトを開けば自動で繋ぎ直します。 ブラウザ版では権限の確認が要ることがあり、そのときはメニュー 「クリップ → オフラインの素材を繋ぎ直す…」から一度だけ許可してください （ブラウザの決まりで、この確認は利用者の操作からしか出せません）。

• 企画と書き出しのフレームレートが違うと、切り目がコマの境から外れます

  30p で組んだものを 29.97 で出すと、切り目はすべてコマの途中に来ます。 書き出しは成功し、見た目もほぼ同じなので、気づく手がかりがありません。 そこで書き出しの画面が、切り目が何箇所あって何箇所が乗らないか・最大何コマずれるかを数えて出します。 止めはしません（わざと違うレートで出す場面があるため）。 揃えるなら「企画」タブでフレームレートを直します。

• 書き出しに何分かかるかは、言えません

  方式が 2 つあります。初期値は高品質（フレーム単位）のほうです。 1 コマずつ符号化するのでコマ落ちしませんが、1 コマ作るたびに素材を頭出しして待ちます。 早送りで追いつける所は速く、飛ばして頭出しが要る所は 1 枚あたり最大 2.5 秒まで待つ作りです （待たずに進むと、その 1 コマが真っ黒で焼き込まれるためです）。 つまり所要時間は尺よりもコマ数と素材の頭出しの速さで決まります。
  ★「尺の何倍」という実測を、まだ取っていません。 素材の形式・本数・重ねたエフェクトで大きく変わるので、この頁では目安を書けません。 短いタイムラインで一度試して、手元の速さを測ってください。

  もう一方の実時間記録は実際に再生しながら録るので、 タイムラインが 10 分なら少なくとも 10 分かかります（仕組み上、それより速くはなりません）。 そのあいだタブを表示したままにする必要があります。 こちらは「尺ぶんは必ずかかる」とだけ言えます。上乗せぶんは測っていません。 WebCodecs に対応していない環境では、高品質を選んでも自動でこちらに落ちます（その旨が画面に出ます）。

• ツールバーの「開く」から開くと、Ctrl+S が「上書き」になりません

  この経路はブラウザの標準のファイル選択を使うので、書き戻す先が取れません。 Ctrl+S は名前を付けて保存に落ち、そのたびにダウンロード先へ 新しい .tsugime が落ちます（中身は同じものが何本も溜まります）。
  確実に上書きになるのは、デスクトップ版で .tsugime を 関連付けやドラッグから直接開いたときです。 ブラウザ版では、今の版に上書きの経路がありません。

• 動きのプリセット 49 件は、画面から選べません

  寄る・引く／パン／登場／退場／強調／持続／音量の 49 件は中身としてあり、 一覧を組み立てる関数もあります。ただしそれを呼ぶコードが 0 件で、 どの画面にも出ていません。 動きはプロパティ欄のキーフレームを手で打つ形になります。 繋がっていない機能は、利用者から見れば存在しないのと同じなので、ここに書きました。

• キーの割り当てを変えても、効きません

  「表示 → 設定… → ショートカット」で割り当てを変える画面があり、保存もされます。 しかしキー入力を受ける側がその設定を読んでいません（読み込む記述が 0 件）。 この頁に書いたキーは、どれも変えられないものとして読んでください。

• 音声認識には、下ごしらえが 2 つ要ります

  デスクトップ版だけの機能です。認識モデル（いちばん小さい tiny で 74MB、推奨の medium で 1.43GB）を 初回に入れること、そして Microsoft Visual C++ 再頒布可能パッケージ（x64）が入っていること。 どちらかが欠けると音声認識のボタンだけが押せなくなり、理由が画面に出ます。 他の編集機能は一切巻き添えになりません。

• 動作を確かめたブラウザは Chrome だけです

  記録が残っているのは Chrome 148 / Windows 10 のみ。Firefox・Safari では測っていません。 「Chrome / Edge を推奨」と書いていますが、Edge でも測ってはいません。

手が覚えるまで

キーの一覧

文字を入力している最中は、Ctrl+S を除いて効きません（入力の邪魔をしないため）。

★メニュー「ヘルプ → キーボードショートカット」にも一覧が出ますが、そちらは 9 行で、 Shift+Delete・G・A・M・Ctrl+Shift+S・Backspace が載っていません。 上の表は、編集画面でキーを受けている所をコードから読み出して書き直したものです。 ただし「これで全部だ」とは言いません。 画面ごとの窓（文字起こし編集、サムネイル、設定など）は、それぞれ自分でキーを受けています。 それらは上の表には入っていません。