Skip to main content

fSpy Importer

Latest Version: 2.2

Introduction​

This addon allows you to import project files generated by the standalone fSpy application. fSpy is an open-source tool used to calculate camera parameters (focal length, orientation, position) from a single image. This is useful for camera matching and compositing 3D objects into 2D photos.

Key Takeaways​

Project Import

Imports .fspy project files, transferring all calculated camera data into Blender.

Background Setup

Automatically sets up the reference image as a camera background, ready for modeling.

Resolution Match

Sets the Blender render resolution to match the dimensions of the original image.

Installation & Usage​

Installation​

  1. Download the addon zip from the official GitHub repository.
  2. Go to Edit > Preferences > Add-ons.
  3. Click Install and select the zip file.
  4. Enable the addon.

Usage​

Go to File > Import > fSpy (.fspy) and select your project file. A new camera will be created with the correct settings.

Summary​

The fSpy importer is the bridge between the fSpy application and Blender. It is the standard workflow for single-image camera matching, making it easy to reconstruct scenes from photographs.