日本語のREADMEはこちらです: README.ja.md
A simple macOS app for creating USDZ 3D models from videos or photo folders using Apple's Object Capture API.
Just drag and drop a video file or a folder of images. The app handles the conversion and opens the resulting 3D model automatically.
- Drag & Drop Interface: Simply drop a video file (MOV, MP4, AVI) or a folder of photos to start processing.
- Video to Photo Conversion: Automatically extracts frames from video files using
ffmpeg. - Customizable Processing: Fine-tune the 3D model generation with several options:
- Video FPS: Set the number of frames per second to extract from video input (0.1 to 60).
- Model Detail: Choose the output quality (
preview,reduced,medium,full,raw). - Feature Sensitivity: Adjust the feature detection sensitivity (
normal,high). - Photo Ordering: Specify if the input images are
sequentialorunordered.
- Automatic Output: Generates a USDZ file and opens it in Preview upon completion.
- macOS: Monterey (12.1) or later.
- Homebrew: The Missing Package Manager for macOS.
- ffmpeg: A command-line tool for handling video and audio.
-
Install Dependencies: Open Terminal and install
ffmpegusing Homebrew.brew install ffmpeg
-
Download the App: Download the
photogra-method.appfrom the repository. -
Run the App: Drag the video file or photo folder onto the app window. The conversion will start, and the final
.usdzmodel will open when finished.
On the first launch, macOS may prevent the app from opening due to security restrictions. To resolve this:
- Go to System Settings → Privacy & Security.
- Scroll down to the security section.
- You will see a message about "photogra-method" being blocked. Click "Open Anyway".
Alternatively, you can right-click the app icon and select Open from the context menu.
This application is a wrapper around Apple's Object Capture API, which is part of the RealityKit framework. It is built with SwiftUI.
Read more about the project and see it in action: