Splatwright を初めて使うときは、一度だけ「セットアップ」が必要です。途中で黒い画面(ターミナル)が開いて英語の文字がたくさん流れますが、あなたがコマンドを打つ必要はありません。このページでは、画面に何が出て、どこで何をすればいいかを順番に説明します。
Before you use Splatwright for the first time, you run its setup once. A Terminal window will open and a lot of text will scroll by, but you never have to type a command. This page shows what appears on screen and exactly when you need to do something.
Splatwright フォルダの中の セットアップ.command を右クリック(または control を押しながらクリック)して 開く を選びます。確認の画面が出たら、もう一度 開く を押します。
In the Splatwright folder, right-click (or control-click) Setup.command and choose Open. If a confirmation appears, click Open again.
ふつうにダブルクリックすると「開発元を確認できないため開けません」と止められることがあります。これはインターネットから入手したアプリに対する Mac の安全確認で、故障ではありません。
A plain double-click may be stopped with “cannot be opened because the developer cannot be verified”. That is the Mac's standard safety check for downloaded software, not an error.
「ターミナル」という、文字だけでやりとりする画面が開きます。セットアップは自動で進むので、何も打たずに見ていて大丈夫です。このウインドウは最後まで閉じないでください。
Terminal is a text-only window. The setup runs on its own, so you can just watch. Keep this window open until the end.
=============================================== Splatwright セットアップ(10〜30分ほどかかります) =============================================== ▶ Homebrew をインストールします。 Mac のログインパスワードを聞かれたら入力して Enter(入力中の文字は表示されません)。 「Press RETURN」と出たら Enter を押してください。
=============================================== Splatwright setup (takes about 10–30 minutes) =============================================== ▶ Installing Homebrew. If asked, type your Mac login password and press Enter (nothing is shown while typing). When it says "Press RETURN", press Enter.
英語版(Setup.command)では同じ内容が英語で表示されます。
“セットアップ.command” shows the same messages in Japanese.
「デスクトップ(または書類・ダウンロード)フォルダ内のファイルにアクセスしようとしています」と聞かれたら 許可 を押してください。
If you're asked whether Terminal may access files in your Desktop, Documents or Downloads folder, click Allow.
Password: と出て止まったら、Mac のログインパスワードを打って return を押します。
When it stops at Password:, type your Mac login password and press return.
==> Checking for `sudo` access (which may request your password)...
Password:
Sorry, try again. と出て、もう一度入力できます。
For security, Terminal shows no characters, no dots, and the cursor doesn't move. Nothing is broken: finish typing and press return. If you think you made a typo, just press return; you'll see Sorry, try again. and can type it again.
ここでは Touch ID は使えません。キーボードで入力してください。途中でもう一度パスワードを聞かれることがあります。そのときも同じように入力します。
Touch ID doesn't work here, so use the keyboard. You may be asked for the password again later; do the same thing.
これからインストールするものの一覧が英語で表示され、確認を求められます。return(Enter)キーを1回押せば進みます。
You'll see a list of what will be installed and a request to confirm. Press return once to continue.
==> This script will install: /opt/homebrew/bin/brew /opt/homebrew/share/doc/homebrew ... ==> The Xcode Command Line Tools will be installed. Press RETURN/ENTER to continue or any other key to abort:
ほかのキーを押すと中止になります。うっかり止めてしまったら、手順1からやり直せば大丈夫です。
Any other key cancels. If that happens, start again from step 1.
ここから先は自動です。英語の文字が大量に流れたり、数分間まったく動かないように見えたりしますが、裏でダウンロードやインストールが進んでいます。特に最初の「Command Line Tools」は 10分以上かかることがあります。
Everything from here is automatic. Lots of text will scroll, or nothing may change for minutes while downloads run in the background. The “Command Line Tools” step alone can take more than 10 minutes.
流れてくる文字のうち、次のものは気にしなくて大丈夫です。
You can safely ignore these:
Warning: で始まる黄色い行==> Next steps: の後に出る「次のコマンドを実行してください」という案内。Splatwright のセットアップが代わりに処理するので、何も打つ必要はありませんWarning:==> Next steps: section asking you to run commands. Splatwright's setup handles that for you, so don't type anythingWarning: /opt/homebrew/bin is not in your PATH. ==> Next steps: - Run these commands in your terminal to add Homebrew to your PATH: ... ▶ COLMAP / FFmpeg / Python などをインストール▶ Installing COLMAP / FFmpeg / Python and more ==> Fetching dependencies for colmap: ... ==> Pouring ... ... ▶ Python 環境を作成▶ Creating the Python environment ▶ 背景切り抜き用の AI モデルをダウンロード(約 180MB)▶ Downloading the background removal AI model (about 180 MB)
グレーの部分は読み飛ばしてかまいません。「▶」で始まる行が今の作業です。
Skip the grey lines. Lines starting with “▶” tell you the current stage.
=============================================== ✔ セットアップ完了 ✔ Setup complete Splatwright.app をダブルクリックで起動できます(Dock に入れておくと便利です)。 Double-click Splatwright.app to start (you can drag it to the Dock). =============================================== Enter キーで閉じますPress Enter to close
Finder が開いて Splatwright.app が選ばれた状態になります。ターミナルで return を押してから、ウインドウを閉じてください(⌘W または左上の赤いボタン)。「[プロセスが完了しました]」と出ていれば、閉じて問題ありません。
Finder opens with Splatwright.app selected. Press return in Terminal, then close the window (⌘W or the red button). Once it says “[Process completed]”, it's safe to close.
Splatwright.app を Dock にドラッグしておくと、次から簡単に起動できます。初めて起動するときに手順1と同じ確認が出たら、同じように 開く(または「このまま開く」)で許可してください。
Drag Splatwright.app to the Dock for easy access. If the first launch shows the same warning as step 1, allow it the same way with Open or Open Anyway.
セットアップは、Splatwright が使う無料の部品を自動で集めてきます。どれも広く使われているオープンソースのソフトです。
Setup gathers the free components Splatwright relies on. All are widely used open-source tools.
| 名前 | Name | 役割 | What it's for |
|---|---|---|---|
| Homebrew | Mac 用のソフトをまとめて入れる道具。パスワードが必要なのはこれを入れるときですA package manager for Mac. It's the reason for the password prompt | ||
| Command Line Tools | Apple 公式の開発用部品。Homebrew が自動で入れますApple's developer components, installed by Homebrew | ||
| COLMAP / GLOMAP | 写真からカメラの位置を推定しますWork out where each photo was taken | ||
| FFmpeg | 動画を写真(フレーム)に切り出しますTurns video into still frames | ||
| Python / Node | Splatwright 本体を動かす土台ですRun Splatwright itself | ||
| Brush | 3D Gaussian Splatting の学習を行いますTrains the 3D Gaussian Splat | ||
| AI モデルAI model | 背景の自動切り抜き用(約 180MB)For automatic background removal (about 180 MB) | ||
| Three.js / Spark | 3D ビューアの表示用Power the 3D viewer |
Python の部品と AI モデルは Splatwright フォルダの中(見えない「.venv」フォルダ)に入るので、Mac のほかの部分は散らかりません。
Python components and the AI model live inside the Splatwright folder (in a hidden “.venv” folder), so the rest of your Mac stays tidy.
Splatwright がどの国・地域で、どのくらい使われているかを作者が知り、今後の改良に役立てるために、匿名の利用回数を送る機能があります(Beta11 から)。最初に起動したときに「送ってよいか」をおたずねし、「はい」と答えた場合だけ送ります。メイン画面の「設定」にある「匿名の利用回数を作者に送る」のチェックで、いつでも変えられます。
So that the author can learn in which countries and regions, and how much, Splatwright is used, and improve it, the app can send anonymous usage counts (from Beta11). It asks on first launch and sends only if you answer “Yes”. You can change this at any time with the usage-count checkbox under Settings in the main window.
| 送るもの | Sent | 「起動した」「作品ができた」という出来事、アプリの版、この Mac に割り当てたランダムな番号。 番号は同じ Mac の起動をまとめて数えるためのもので、ここから個人や Mac を特定することはできません。チェックを外すと、この番号も消えます。 |
The event (launched, or a work finished), the app version, and a random number assigned to this Mac. The number only groups launches from the same Mac; it cannot identify you or your Mac, and it is deleted when you untick the box. |
|---|---|---|---|
| 送らないもの | Not sent | 作品の内容、動画や写真、ファイル名、フォルダ名、お名前、メールアドレス、Mac の名前。 | Your work, videos or photos, file names, folder names, your name, e-mail address, your Mac's name. |
| 国・地域 | Country or region | 接続元から自動で判定します。IP アドレスは保存しません。 | Worked out automatically from the connection. The IP address is not stored. |
| 送り先と使いみち | Where it goes | 作者のサイト(splat.radiancefields.net)です。作者が利用状況を知る目的だけに使い、第三者に渡したり、広告に使ったりすることはありません。 | The author's own site (splat.radiancefields.net). The counts are used only to understand how the app is used; they are not passed to anyone else or used for advertising. |
インターネットにつながっていないときは何も送らず、アプリはそのまま使えます。なお、このセットアップガイドのページ自体は、利用回数を数えていません。
When you are offline nothing is sent, and the app works as usual. This Setup Guide page itself does not count visits.
Splatwright は、個人の制作・学習・作品発表の目的で、無料でご利用いただけます。広告、クライアントワーク、販売を目的とした作品など、商用でのご利用をお考えの方は、お問い合わせフォームからご連絡ください。なお、今後一部の機能を有料とする場合があります。
Splatwright is free for personal projects, learning, and sharing your work. If you plan to use it commercially, such as for advertising, client work, or products for sale, please get in touch via the inquiry form. Some features may become paid in the future.
ベータ版のため、動作や結果は保証できません。大切なデータはバックアップを取ってからお使いください。
This is a beta, so its operation and results are not guaranteed. Please back up important data before use.
不具合のご報告やご質問も、お問い合わせフォームからどうぞ。くわしい利用条件とライセンスは、同梱の「マニュアル.pdf」の 9 章にあります。
Bug reports and questions are also welcome via the inquiry form. Full terms and licences are in chapter 9 of the included “Manual.pdf”.