VK01 Converter ― SZN-VK01 ビデオキーホルダー用 動画変換アプリ（Mac・Linux 用）

動画を、本体が再生できる形式（名前_24fps.mjpeg）に変換します。
くわしい使い方は、ユーザーマニュアルの「07 書き込みアプリについて」を見てください。
Windows では、同じ zip の「win」フォルダを使ってください。

  Mac     アプリの画面（VK01Converter.sh）と convert.sh のどちらでも変換できます。
  Linux   convert.sh を使ってください。


■ 入っているもの

  VK01Converter.sh    変換アプリ（画面つき・Mac 用）を起動するスクリプト。.NET 10 が必要です
  app フォルダ         アプリの本体。VK01Converter.sh と同じ場所に、フォルダごと置いてください
  convert.sh          画面なしで変換するスクリプト（Mac・Linux）。ffmpeg だけで動きます
  README.txt          この説明

  どちらを使っても、できあがる動画は同じです。


■ 準備（はじめに 1 回）

  1. ffmpeg を入れます。
       Mac:    brew install ffmpeg
       Linux:  お使いのディストリビューションの ffmpeg パッケージを入れます
  2. Mac でアプリの画面を使うときは、.NET 10 も入れます（convert.sh だけ使うなら不要です）。
       brew install --cask dotnet-sdk
       （https://dotnet.microsoft.com/download から「.NET 10」を入れても同じです）
  3. 入ったか確かめます。ターミナルで次を実行して、版が表示されれば準備完了です。
       ffmpeg -version
       dotnet --version        （Mac でアプリを使うときだけ。10. で始まる数字が出れば OK）


■ アプリの画面を使う（Mac）

  1. ターミナルで、このフォルダに移動して次を実行します。

       sh VK01Converter.sh

     （中身は dotnet app/VK01Converter.dll です。こちらを直接実行しても同じです）
  2. 動画をウィンドウにドラッグ＆ドロップします（いくつでも入れられます）。
  3. 「変換開始」を押します。元の動画と同じフォルダに 名前_24fps.mjpeg ができます。
  4. 本体を USB ドライブモードにして Mac につなぎ（電源を入れて USER ボタンを 3 回）、
     「microSD・本体の設定…」→ ドライブを選ぶ →「microSD の直下にコピー」を押します。
  5. Finder で「取り出し」をすると、本体が再起動して再生が始まります。

  ・ファイル名の最後の _24fps は再生速度です。消さないでください。
  ・変換後に「要確認」と出たら、その行の「画質 ○ で作り直す」を押してください
    （1 フレームが 64KB を超えると、本体が表示できません）。
  ・「microSD・本体の設定…」の「本体の設定（config.txt）」で、明るさやくり返しなどの
    本体の設定も編集できます。

  ・ウィンドウを閉じるとコマンドも終わります（何も表示されずに戻るのが正常です）。


■ 画面なしで変換する（convert.sh・Mac / Linux）

  ターミナルで、このフォルダに移動して次のように使います。

    sh convert.sh 入力.mp4                        縦横を自動で判定して変換（画面いっぱい）
    sh convert.sh 入力.mp4 --fit                  切り抜かずに全体を入れる（余白は黒）
    sh convert.sh 入力.mp4 --portrait             縦向き 128x160 にする（--landscape で横向き）
    sh convert.sh 入力.mp4 --rotate 90            時計回りに 90° 回してから変換（90 / 180 / 270）
    sh convert.sh 入力.mp4 --soft                 コントラスト・彩度を少し下げる
    sh convert.sh 入力.mp4 --fps 15 --quality 4   fps と画質（2 = 高画質 〜 10 = 低画質）
    sh convert.sh 入力.mp4 --start 00:00:10 --duration 30   10 秒目から 30 秒ぶんだけ

  元の動画と同じ場所に 名前_24fps.mjpeg ができます。microSD のいちばん上にコピーしてください。
  オプションは組み合わせて使えます。


■ 困ったとき

  dotnet: command not found と出る（Mac）
      .NET が入っていないか、入れたあとターミナルを開き直していません。
  「You must install or update .NET」と出る（Mac）
      入っている .NET が古いか、別の版です。.NET 10 を入れてください。
  「開発元を確認できないため開けません」などと出て起動しない（Mac）
      ダウンロードした zip に付く印が原因です。ターミナルでこのフォルダに移動して
      次を実行してから、もう一度起動します。
        xattr -dr com.apple.quarantine .
  画面の上に「ffmpeg が見つかりません」と出る（Mac）
      ffmpeg を入れてから「もう一度探す」を押します。
  ドライブが一覧に出ない（Mac）
      「更新」を押すか、「フォルダを選ぶ…」で microSD のいちばん上を直接選びます。
  convert.sh で ffmpeg: not found や ffprobe: not found と出る
      ffmpeg が入っていないか、入れたあとターミナルを開き直していません。
  本体で再生されない
      動画が microSD のいちばん上にあるか、拡張子が .mjpeg か確かめてください。


■ 確認できている環境

  Mac（Apple シリコン）で、アプリの起動と変換、convert.sh での変換を確認しています。


企画・設計: サークル さざなみ開発
