Splatwright セットアップガイドSetup Guide
Splatwright はベータ版で、テスト運用中です Splatwright is a beta, still being tested 動作が不安定なことがあります。また、アプリの仕様は随時更新されます。個人的な用途でお試しください。仕事や納品など、それ以外の用途でのご利用はおすすめしません。商用でのご利用をお考えの方は、お問い合わせフォームからご連絡ください(利用条件)。 It may be unstable, and the app is updated continually, so how it works may change. Please try it for personal use; we don't recommend it for client work, deliveries, or anything beyond that. If you are thinking of commercial use, please get in touch via the inquiry form (terms of use).
Splatwright — Forge memories in light. 光の粒になって散っていくカマキリの 3D Gaussian Splat / A 3D Gaussian Splat of a mantis dissolving into points of light

ターミナルを使ったことがなくても、大丈夫。

Never used Terminal? That's fine.

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 Beta13 をダウンロードDownload Splatwright Beta13 Dropbox のページが開きます。「Splatwright_Beta13.zip」を選んで、ダウンロードしてください(zip・約 8.9 MB・Apple シリコンの Mac 用)。Dropbox のアカウントは要りません。 This opens a Dropbox page. Choose “Splatwright_Beta13.zip” there and download it (zip, about 8.9 MB, for Macs with Apple silicon). You don't need a Dropbox account.
Beta13 の新機能:メイン画面を見やすく New in Beta13: a clearer main window 左右 2 列にして、左で素材・保存先・設定を決め、右で処理の進み具合・特徴点や照合の絵・SSIM のメーターとグラフを見られるようにしました。設定は「基本」「詳細」の切り替え、ログはふだん畳んで最新の 1 行だけ(エラーのときは自動で開く)、ボタンは色分けしています。 It now has two columns: choose the source, output and settings on the left, and watch progress, the feature / matching pictures and the SSIM meter and graph on the right. Settings switch between “Basic” and “Advanced”, the log is folded to its latest line (it opens by itself on an error), and the buttons are colour-coded. Beta12 から:カメラ位置の推定に Solv3R(実験的・非商用) Since Beta12: Solv3R for camera estimation (experimental, non-commercial) 設定の「詳細」にある「カメラ推定」で選べます。Solv3R は写真をまとめて見てカメラの位置を出すモデルで、前へ歩くだけの路地の動画など、COLMAP がつまずく動画でも位置を出せます(仕上げは COLMAP。360° 素材には使いません)。推定の途中は、3D ビューでカメラと点群がなめらかに動きながら形が整っていく様子を見られます。モデルは研究・評価目的のみ(非商用)のライセンスで、初めて使うときに PyTorch(約 1 GB)とモデル(約 470 MB)をダウンロードします。標準は今までどおり COLMAP(商用 OK)です。 Choose it under “Camera estimation” in the “Advanced” settings. Solv3R looks at all the photos together to place the cameras, so it copes with videos COLMAP struggles with, such as walking straight down an alley (COLMAP still does the refinement; 360° material is not used with it). While it solves, the 3D view shows the cameras and point cloud moving smoothly as the shape settles. The model is licensed for research or evaluation only (non-commercial); PyTorch (about 1 GB) and the model (about 470 MB) are downloaded on first use. The default is still COLMAP (commercial use OK).
あなたがすることWhat you do パスワードを打つ・return を押す・待つ。この3つだけです。 Type your password, press return, and wait. That's all.
かかる時間How long 10〜30分ほど。初めての Mac では 40分以上かかることもあります。 About 10–30 minutes, sometimes 40+ on a Mac that has never installed developer tools.
やり直しは安全Safe to rerun 途中で止まっても、もう一度実行すれば続きから進みます。作品や設定は消えません。 If it stops, run it again. It picks up where it left off, and your projects and settings stay.

始める前に確認すること

Before you start

セットアップの流れ

Step by step

  1. 「セットアップ.command」を開く

    Open “Setup.command”

    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.

    「開く」が出てこない場合(macOS Sequoia 15 以降) No “Open” button? (macOS Sequoia 15 or later) 新しい macOS では右クリックでも開けず、「完了」と「ゴミ箱に入れる」しか出ないことがあります。その場合は「完了」を押してから、Apple メニュー →「システム設定」→「プライバシーとセキュリティ」を開き、いちばん下までスクロールします。「“セットアップ.command”は Mac を保護するためにブロックされました」の横の このまま開く を押し、パスワード(または Touch ID)で許可して、もう一度 開く を押してください。 On newer macOS, even right-click may only offer “Done” and “Move to Trash”. Click Done, then open Apple menu → System Settings → Privacy & Security and scroll to the bottom. Next to “Setup.command was blocked to protect your Mac”, click Open Anyway, confirm with your password or Touch ID, then click Open.
  2. ターミナルの画面が開く

    A Terminal window opens

    「ターミナル」という、文字だけでやりとりする画面が開きます。セットアップは自動で進むので、何も打たずに見ていて大丈夫です。このウインドウは最後まで閉じないでください。

    Terminal is a text-only window. The setup runs on its own, so you can just watch. Keep this window open until the end.

    セットアップ.command — bashSetup.command — bash
    ===============================================
      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.

  3. パスワードを入力する(いちばん戸惑うところ)

    Type your password (the part that surprises people)

    Password: と出て止まったら、Mac のログインパスワードを打って return を押します。

    When it stops at Password:, type your Mac login password and press return.

    Terminal
    ==> Checking for `sudo` access (which may request your password)...
    Password:
    打っても何も表示されませんが、ちゃんと入力されています Nothing appears as you type, but it is being entered ターミナルでは、のぞき見防止のためにパスワードの文字も「●」も表示されず、カーソルも動きません。壊れているわけではないので、そのまま最後まで打って return を押してください。打ち間違えたと思ったら、return を押せば 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.

  4. 「Press RETURN」と出たら return

    At “Press RETURN”, press return

    これからインストールするものの一覧が英語で表示され、確認を求められます。return(Enter)キーを1回押せば進みます。

    You'll see a list of what will be installed and a request to confirm. Press return once to continue.

    Terminal
    ==> 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.

  5. あとは待つだけ

    Now wait

    ここから先は自動です。英語の文字が大量に流れたり、数分間まったく動かないように見えたりしますが、裏でダウンロードやインストールが進んでいます。特に最初の「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 のセットアップが代わりに処理するので、何も打つ必要はありません
    • 「GLOMAP は入りませんでした」「モデルの事前ダウンロードに失敗しました」などの ⚠ や( )付きの注意。必要なときに自動で補われるので、そのまま進んで大丈夫です
    • Yellow lines starting with Warning:
    • The ==> Next steps: section asking you to run commands. Splatwright's setup handles that for you, so don't type anything
    • Notes marked ⚠ or in parentheses, such as “GLOMAP was not installed”. Splatwright fills these in later on its own
    Terminal
    Warning: /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.

  6. 「セットアップ完了」と出たら終わり

    “Setup complete” means you're done

    Terminal
    ===============================================
      ✔ セットアップ完了  ✔ 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.

    初めて起動すると「匿名の利用回数を送ってよいか」をおたずねします On first launch the app asks whether it may send anonymous usage counts 「はい」「いいえ」のどちらを選んでも、アプリは同じように使えます。あとから「設定」でいつでも変えられます。何を送って何を送らないかは、下の「匿名の利用回数について」にまとめています。 The app works the same whether you answer Yes or No, and you can change it later under Settings. What is and isn't sent is listed in “About anonymous usage counts” below.

困ったときは

If something goes wrong

「✖ …に失敗しました」と出て止まったIt stopped with “✖ … could not be installed”
まずは一度ウインドウを閉じて、セットアップ.command をもう一度開いてください。ネットワークが一時的に不安定だっただけなら、これで通ります。それでも同じところで止まるときは、ターミナルの画面をスクリーンショット(⌘shift5)して、お問い合わせフォームからご連絡ください。フォームには画像を添付できないので、スクリーンショットは作者からの返信のメールに添えてお送りください。
Close the window and open Setup.command again. Temporary network trouble usually clears on a second run. If it stops at the same place, take a screenshot of the Terminal window (⌘shift5) and get in touch via the inquiry form. The form can't take attachments, so send the screenshot in reply to the author's e-mail.
「Need sudo access」「Administrator」と出たIt says “Need sudo access” or “Administrator”
今のユーザーが管理者ではありません。Apple メニュー →「システム設定」→「ユーザとグループ」で、自分のアカウントが「管理者」になっているか確認してください。会社の Mac などで変更できない場合は、管理している人に相談してください。
Your user account isn't an administrator. Check Apple menu → System Settings → Users & Groups. On a work Mac you may need to ask your IT administrator.
パスワードを3回まちがえて止まったI got the password wrong three times
ウインドウを閉じて、手順1からやり直してください。キーボードが英数入力になっているか(かな入力になっていないか)、caps lock が点いていないかも確認してください。
Close the window and start again from step 1. Check that caps lock is off and that your keyboard input source is the one you normally use for your password.
何十分も止まっているように見えるNothing seems to happen for a long time
大きなファイルのダウンロード中は、表示が長く変わらないことがあります。30分以上まったく変化がなければ、ウインドウを閉じてもう一度実行してください。終わった部分は飛ばして続きから始まります。
Large downloads can leave the screen unchanged for a while. If nothing changes for 30 minutes, close the window and run setup again. Finished parts are skipped.
うっかりウインドウを閉じてしまったI closed the window by accident
もう一度 セットアップ.command を開けば大丈夫です。何度実行しても問題ありません。
Just open Setup.command again. Running it more than once is fine.
新しいバージョンに更新したときAfter updating to a new version
新しい Splatwright フォルダの中身を上書きしたら、セットアップをもう一度実行してください。新しく必要になった部品だけが追加されるので、初回よりずっと短く終わります。作品や設定はそのまま引き継がれます。
After replacing the Splatwright files with the new version, run setup again. Only newly needed parts are added, so it's much quicker than the first time. Your projects and settings carry over.

何がインストールされるの?

What gets installed?

セットアップは、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.

匿名の利用回数について

About anonymous usage counts

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.

利用条件とお問い合わせ

Terms of use and contact

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.

「写っている人」の除外と、カメラ推定の Solv3R は、非商用でのみ使えます Removing people and Solv3R camera estimation are for non-commercial use only これらの機能に使うモデル(SegFormer、NVIDIA/Solv3R)は、配布元のライセンス(NVIDIA Source Code License)により、研究・評価の目的(非商用)でのみ利用できます。商用の制作では、設定の「写っている人」を「除外しない」に、詳細設定の「カメラ推定」を「COLMAP(標準・商用 OK)」にしてください。Solv3R を使ったかは、作品のフォルダの sfm_method.json に記録されます。 The models used for these (SegFormer, by NVIDIA; Solv3R) may be used only for research or evaluation (non-commercial) under their licence (NVIDIA Source Code License). For commercial work, set “People in the shot” to “Keep” and Advanced → “Camera estimation” to “COLMAP (standard, commercial use OK)”. Whether Solv3R was used is recorded in sfm_method.json in the work folder.

不具合のご報告やご質問も、お問い合わせフォームからどうぞ。くわしい利用条件とライセンスは、同梱の「マニュアル.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”.