komenagare（コメナガレ）
動画にニコニコ風の流れるコメントを付けて編集・書き出しするブラウザ用ツールです。
- 動画を開いて再生しながらコメントを投稿・編集（タイムライン / Vim 風エディタ）
- PC では画面の配置を選べる（標準・右にリスト・右にタイムライン。プレビュー・リスト・タイムラインはそれぞれ出す・隠すを切り替えられる）
- タイムラインにはタイムコード、イン点・アウト点（書き出しの範囲の初期値）、ループ再生、段の高さの切り替え
- 画面の言葉は日本語と英語（URL に
?lang=en で英語、?lang=ja で日本語。このブラウザで覚える）
- コメントは JSON / CSV / ニコニコ形式 XML で読み書き
- コメント付き動画を MP4 / MOV / WebM / MKV で書き出し（縦長の動画は縦長のまま、コメントも動画の範囲に流す）
- 解像度は元動画と同じ（8K なども）か、それより小さい大きさ。ビットレートは元動画と同じ（既定）か、解像度に合わせるか、数値で選ぶ
- Chrome / Edge などでは保存先を先に選び、そこへ少しずつ書き込む（長い動画もメモリをあまり使わない）。ほかのブラウザはダウンロードで、一度に 4 GB まで
- 8K などの大きな動画は
komenagare render（CLI）がおすすめ（ffmpeg で書き出すので、ブラウザのメモリやエンコーダーの制限を受けない）
使い方
index.html をブラウザで開きます（GitHub Pages での公開を想定。ファイルを直接開いても動きます）。
css/・js/・lib/ フォルダも同じ場所に置いてください。
みんなで編集する（komenagare CLI）
komenagare コマンドでホストすると、同じコメントを複数人で同時に編集できます。変更はすぐにほかの人の画面に反映され、
送られてくるたびに作業フォルダの comments.jsonl に書き込まれ、git のコミットとして残ります（作者は参加者の表示名）。
インストール
Linux / macOS / Android（Termux）/ FreeBSD / NetBSD / illumos:
curl -fsSL https://igarinpiano.github.io/komenagare/install.sh | sh
~/.local/bin/komenagare に入ります（KOMENAGARE_INSTALL_DIR で変更可）。OS と CPU から配布物を選びます（KOMENAGARE_TARGET で指定も可）。
Windows（PowerShell）:
irm https://raw.githubusercontent.com/igarinpiano/komenagare/main/install.ps1 | iex
%LOCALAPPDATA%\komenagare\bin\komenagare.exe に入り、ユーザーの PATH に足されます（新しく開いたターミナルから使えます）。
x64・Arm64・32 ビット（x86）の Windows に対応しています。
どちらも、履歴を残すには git が必要です。
配布物は リリース にあります（komenagare-<種類>.tar.gz、Windows は .zip）。
| OS | CPU |
|---|
| macOS | Apple シリコン（aarch64）、Intel（x86_64）、両方入り（universal） |
| Windows | x86_64、aarch64、i686（MSVC）、x86_64（GNU） |
| Linux（musl・静的リンク） | x86_64、aarch64、i686、armv7、arm（armv6） |
| Linux（glibc） | x86_64・aarch64（glibc 2.28 以降）、i686、armv7、arm、riscv64、powerpc64le、s390x、loongarch64 |
| Android（Termux） | aarch64、armv7、x86_64、i686 |
| FreeBSD / NetBSD / illumos | x86_64 |
更新
komenagare update # 最新版に更新する
komenagare update --check # 更新があるかを確かめるだけ
komenagare update --version v0.1.0 # 指定した版にする（前の版に戻すときにも）
ホストを起動したときにも新しい版があるかを確かめ、あれば知らせます（--no-update で確かめない）。
komenagare update は、リリースの署名（SHA256SUMS.minisig）を komenagare に埋め込んだ公開鍵で確かめ、署名した一覧と同じ中身のときだけ入れ替えます。
署名を付け始める前の版（v0.4.x まで）には komenagare update では戻せません。戻すときは KOMENAGARE_VERSION=v0.4.3 を付けて install.sh / install.ps1 で入れてください。
使い方
mkdir my-comments && cd my-comments
komenagare init # 作業フォルダにする（最初に1回。git があれば git の管理下にする）
komenagare # 始める（この PC だけで使う）
komenagare --host 0.0.0.0 # 同じネットワークの人と共有する
komenagare --import comments.json # 保存済みのコメントを取り込んでから始める
komenagare ~/projects/a ~/projects/b # 複数のプロジェクト（作業フォルダ）をまとめて共有する
作業フォルダ以外で komenagare を実行しても何も作らず、komenagare init を案内します。
komenagare init には --no-git（履歴を残さない）、--import（保存済みのコメントを取り込んで作る）も付けられます。
表示された URL（?k= の合言葉付き）を参加者に渡します。動画ファイルは各自の手元のものを開きます。
- 同じコメントの同じ項目を2人が別々に変えたときは、先にホストに届いた方が残ります（違う項目なら両方残ります）。
反映されなかった側には「衝突」の知らせが出て、自分の変更にする・相手のままにする・両方残すを選べます。
- 「変更履歴」タブで、誰がいつ何を変えたかを見られます。どの変更も「取り消す」で打ち消せます（git revert と同じ）。
- ホストとの接続が切れても編集を続けられます。変更はブラウザに保存され、つながり直したときに送られます。
ブラウザとホストは 20 秒ごとに確かめ合い、返事が無ければすぐにつなぎ直します（ネットワークが戻ったときやタブを前に出したときも、待たずに確かめます）。ホストも、2 分間何も届かない接続は切ります（回線が黙って切れた人を参加者の一覧に残さない）。
- 再生バーの 📣（ここ見て）で今の再生位置と選んでいるコメントをほかの人に知らせ、🔗 でその位置（コメント）へのリンク（
#t=秒&c=コメントの id）をコピーできます。電話やメッセージで作業するときに便利です。
- 動画は各自の手元のものを使うので、ほかの人と動画の長さが違えば知らせます（違う動画だと、コメントの出る場面がずれます）。
- ほかの人と共有している間（
--host 0.0.0.0・--tunnel・--public-url）は、終わるまでホストのパソコンをスリープさせません（macOS は caffeinate、Linux は systemd-inhibit、Windows は SetThreadExecutionState、Termux は termux-wake-lock）。止めるなら --allow-sleep。ノートパソコンはふたを閉じるとスリープすることがあります。
- 主なオプション:
--port、--no-git（履歴なし）、--require-git（git が無ければ起動しない）、--no-token（合言葉なし。IP アドレス・localhost・このパソコンの名前（mypc・mypc.local など）で開いてください。悪意のあるサイトから名前を切り替えて入られないよう、ほかのドメインの名前では入れません。使うときは --public-url で指定）、--otp（参加者ごとのワンタイムパスワード）、--tunnel / --public-url（ローカルネットワークの外から使う）、--remote（画面からホストでコマンドを打つ）、--log（画面の表示をファイルにも書く。裏で動かす）。一覧は komenagare --help。
- 画面（Web アプリ）は起動のたびに GitHub Pages の最新版を確かめて使います（
komenagare update-web で手動更新、--no-update で確かめない、--bundled-web で内蔵版）。
取れないときは前回取得した版、それも無ければ CLI に内蔵した版を使います。最新版が新しい取り決めになっていて CLI が対応していないときは、komenagare update を促します。
取ってきた Web アプリは署名（web.sums）を確かめてから使います。署名の合わないもの、手元の控えより古いものは使いません（GitHub Pages や途中の経路が差し替えられても、ホストが配信する画面は変わりません）。
複数のプロジェクト
1フォルダ1プロジェクトのまま、作業フォルダを複数渡すと1つのホストでまとめて共有できます（komenagare ~/projects/* でも可）。
画面右上の「📁」からプロジェクトの一覧を開き、このタブのまま切り替える（動画・再生位置・タイムラインの表示はプロジェクトごとに覚えていて、戻ってくると元に戻します）か、新しいタブで開けます。
一覧には、それぞれのプロジェクトに今いる人も出ます。同じプロジェクトや別のプロジェクトを複数のタブで並べて作業しても、変更・衝突はタブごとに正しく扱われます。
まとめフォルダ（いくつものプロジェクトを1つのリポジトリで）
プロジェクトごとにリポジトリを作らなくても、まとめフォルダにすると、いくつものプロジェクトを1つのフォルダ・1つの git リポジトリで扱えます。
GitHub に push するのも、別のパソコンや GitHub Codespaces で git clone して使うのも、リポジトリ1つで済みます。
komenagare init --collection kome # まとめフォルダを作る（git のリポジトリになる）
cd kome
komenagare init a b c # プロジェクトを作る（まとめフォルダの一覧 komenagare.json に載る）
komenagare # 一覧のプロジェクトを全部まとめて共有する（komenagare kome でも可）
komenagare remove c # 一覧とリポジトリから外す（フォルダとコメントは残る。komenagare init c で戻る）
komenagare split # まとめフォルダを解除して、プロジェクトごとの git リポジトリに分ける
This is the beginning of the README. Read the rest at the original. Read the full README ↗
