この記事で分かること
- Rust製のNeoUtlをmacOSでビルド・動作させるために変更した層(VideoToolbox、日本語IME、wgpu共有など)
- .appとして配布するまでのパッケージング手順(dylib収集と
@rpath書き換え、ad-hoc署名) - AGPLフォークを公開するときのライセンス対応の実務(Rustクレート508件分の帰属表示と、ネイティブライブラリのライセンス全文の同梱)
はじめに
AviUtl ExEdit 風の動画編集ソフト「NeoUtl」(Rust 製、開発:taisho-guy さん、Codeberg で公開)を macOS に移植し、「MacUtl」という名前の非公式フォークとして GitHub で公開しました。
- MacUtl: https://github.com/Ren9618/MacUtl
- ベース: NeoUtl v0.8.11(commit
0ead3935) - ライセンス: AGPL-3.0-or-later(上流を継承)
上流の README には「macOS も将来的にサポートする予定」とありましたが未着手で、作者さんは大学受験のため 2027 年度まで開発を休止されています。本記事では、移植で実際に行った変更をフェーズごとにまとめます。変更の全量はリポジトリの MACOS_CHANGES.md に記録してあります(AGPL の変更明示の実務も兼ねています)。
方針として、内部のクレート名(NeoUtl、neoutl-*)とプロジェクト形式(.npb)は互換性と上流追随のため変更していません。変えたのは「利用者から見える製品名」と「macOS で動かすための層」だけです。
技術スタック(上流のまま)
| 項目 | 採用技術 |
|---|---|
| 言語 | Rust |
| GUI | egui |
| プレビュー描画 | wgpu |
| シェーダ | Slang |
| ECS | Shipyard |
| 非同期 | tokio |
| デコード・エンコード | FFmpeg |
オブジェクト/エフェクトは動的ライブラリのプラグイン構成(オブジェクト 9 種、エフェクト 23 種)で、macOS ではこれらが .dylib になります。
Phase 0–3: ビルドと土台
- ワークスペースとプラグインクレートに macOS ビルド対応を追加(
aarch64-apple-darwin) - 実行時データの置き場を
.app対応に:バンドル内(Contents/MacOS)で動く場合は~/Library/Application Support/MacUtl、開発用バイナリは従来どおり実行ファイル隣接の配置 - VST3 プラグインの探索パスと、プラグインホストの参照先に macOS の既定値を追加
描画・メディアまわり:
- VideoToolbox のハードウェアデコードを追加(ソフトウェアデコードへのフォールバック付き)
- wgpu のデバイス/キューを共有する形にし、macOS 向けの制限値と NV12 の能力交渉を追加
- テキスト描画に Hiragino Sans のフォールバックを追加
- 日本語 IME の preedit/commit 処理と、プロパティエディタでの入力矩形通知に対応
- 書き出しダイアログで出力パスを直接編集可能にし、
avio_open失敗時の診断情報を追加
macOS で「無効化したもの」も重要な変更です。
- セルフアップデート:上流の更新機能はバイナリを自己差し替えする方式で、macOS ではコード署名が壊れます。無効化し、更新は GitHub Releases からの手動取得に切り替えました
- クラッシュレポート送信:上流の GlitchTip 向け DSN が macOS バイナリにコンパイルされないよう、コンパイル時に除外しました
Phase 4–5: .app パッケージングと配布
配布物は cargo xtask package --release(内部で scripts/package_macos.py 等)で生成します。やっていることは以下のとおりです。
- リリースバイナリと全プラグイン(オブジェクト/エフェクト/デコーダ)をバンドルへコピー
- Homebrew の dylib を
Contents/Frameworksへ再帰的に収集し、install name を@rpathに書き換え。Homebrew の絶対パスが残っていないことを検証 -
Info.plist、PkgInfo、.icnsアイコンを生成 -
LICENSE、THIRD_PARTY_NOTICES.md、MACOS_CHANGES.md、third_party/licenses/をContents/Resourcesへ同梱 - ad-hoc 署名(
codesign --sign -)を内側から順に適用 -
MacUtl-0.8.11-macos.dmgと.zipを生成
製品名は利用者向けの面だけ MacUtl に変更しています(.app 名、CFBundleName、バンドル ID は works.rayno.macutl、ウィンドウタイトル、データフォルダ)。
署名は ad-hoc のみで、公証はしていません。初回起動時に Finder で右クリック→「開く」が必要なのはこのためです。
ライセンス対応の実務
フォーク公開で一番地味に時間を取ったのがここです。
-
THIRD_PARTY_NOTICES.md:Rust クレート 508 件分のライセンス一覧+ネイティブライブラリと非コードアセット分。cargo about用のabout.tomlと生成スクリプトを用意し、再生成可能にしました -
third_party/licenses/:FFmpeg(GPLv3/LGPL)、x264、x265、SVT-AV1、dav1d、libvpx、libvmaf、OpenSSL、LAME、mpg123、Opus、XZ/liblzma の全文を同梱 - 同梱 FFmpeg は GPL-3.0-or-later のビルドで、この点は README とリリースノートに明記しています
-
LICENSE_AUDIT.md:ライセンス監査と公開ゲートの記録 -
MACOS_CHANGES.md:上流からの変更点の記録そのもの
「AGPL のフォークはソースを公開すればよい」で終わらせず、バイナリに同梱されるもの全部について帰属と全文を揃える、という形にしました。
Phase 7: 一画面レイアウト
公開後(v0.8.11-mac.2)の変更です。
-
egui_tiles0.17.1 を導入し、src/app/workspace.rsを新設。プレビュー・プロパティ・タイムラインを 1 ウィンドウに集約し、従来の別ウィンドウ(ビューポート)を廃止 - YMM4 風とクラシックの 2 プリセット、スプリッタでのサイズ変更、ペインヘッダのドラッグ/コンテキストメニューでの入れ替え、レイアウト初期化を用意
- レイアウトは
.npbプロジェクトの外に JSON で保存(~/Library/Application Support/MacUtl/settings/workspace-layout.json)。JSON が壊れていたら YMM4 風プリセットにフォールバック - 最小ウィンドウサイズ 800×600 と、狭いパネル向けの表示ガードを追加
書き出しハング(概要のみ)
Phase 4.5 では、動画オブジェクトと画像オブジェクトを同時に書き出すと止まる問題(lost-wakeup のデッドロック)を修正しました。画像デコーダの dylib が自前の wgpu/parking_lot を静的リンクしており、そのテクスチャアップロードがホスト側のキュー処理と競合する、という構図です。macOS でのみ、画像のテクスチャアップロード等をホストの共有 wgpu ロックで直列化して解決しました。検証では 720p・391 フレームの書き出しが完走し、1080p/60 秒の書き出しも約 37 秒で回帰なしを確認しています。
この件の詳細は別記事にまとめます。
残っている制約と未確認事項
正直に書くと、現状はこうです。
- Apple Silicon(arm64)のみ。Intel Mac は非対応
- macOS 27.0 以降が必要
- 書き出しは映像のみで、音声ストリームは含まれません(ベース側の既存仕様)
- VST3 はスキャンの確認のみで、実際の適用は未確認
- 物理的な音声出力も未確認(自分の耳での確認がまだです)
- ベースがプレアルファのため、仕様やプロジェクト形式は今後変わりえます
おわりに
移植の本体は「新機能」ではなく、「ビルドを通す」「macOS の作法に合わせる」「署名と依存ライブラリを配布可能な形にする」「ライセンスを揃える」という土台の積み重ねでした。変更を MACOS_CHANGES.md に全量記録してあるので、上流が 2027 年度に再開したときに、macOS 対応を取り込んでもらえる形で残せていると思います。
現在は Phase 8 として、VOICEVOX と連携した声入れ機能(セリフから音声と字幕をタイムラインに配置)を実装中です。
レイノワークスとして、Windows / macOS / Android 向けの個人開発をしています。
この記事はZennにも掲載しています:https://zenn.dev/ray_9618/articles/macutl-neoutl-macos-port