How to Import fSpy Camera Data into Blender

Updated 2026-10-02

Blender has an official fSpy importer add-on, so you don't have to copy camera values by hand. Install and enable the add-on, run fSpy on your still image, save the .fspy project, then use the add-on's import operator in Blender to set the camera parameters — and optionally the camera background image — in one step. This works for any Blender user who needs to match a 3D camera to a photo; if you use a different 3D application, you'll fall back to the manual copy-and-paste route described below.

What you need first

fSpy installed and running. It's open source, cross-platform (Mac, Windows, Linux), and free to download and use.
A still image with enough straight-line features (edges, rectangular shapes, architectural lines) for fSpy to solve the camera.
Blender installed, with permission to install add-ons.

Step 1: Solve the camera in fSpy

Open your image in fSpy.
Set the image dimensions and place the vanishing-point guides along lines in the photo until the calibration is consistent.
Confirm the estimated focal length and principal point look reasonable.
Save the project as an .fspy file. This file carries the camera parameters the Blender add-on reads.

The quality of the match depends on this step. If the guides are sloppy, the imported Blender camera will be wrong no matter how clean the import is.

Step 2: Install the official fSpy importer add-on

The fSpy site points Blender users to an official importer add-on and its instructions. Install it the normal Blender way:

Download the add-on.
In Blender, open Edit > Preferences > Add-ons.
Use Install… and select the add-on file.
Enable the checkbox next to the add-on so it loads.

The add-on is what sets the Blender camera parameters from the .fspy data, and it can optionally set the camera background image.

Step 3: Import the `.fspy` file

In Blender, select or create the camera object you want to drive.
Run the fSpy import operator provided by the add-on.
Choose the .fspy file you saved.
Decide whether to also set the camera background image. Enabling it loads your reference photo behind the camera so you can line up geometry against it.

Expected result: the Blender camera's field of view, position, orientation, and principal point are set to match the photo, and — if you enabled it — the image appears as the camera background.

Step 4: Verify the match

Look through the camera (numpad 0 by default) and check that the background image lines up with the scene.
If you placed geometry using the photo as reference, confirm edges that should be parallel in the real scene converge correctly.
If the framing is off, the usual cause is a bad fSpy solve, not the import. Re-check the vanishing-point guides and re-export.

If you're not using Blender

For applications without a dedicated importer, fSpy's own outline is to copy the parameter values one by one into the target application. The process:

Set the camera viewport to match the dimensions of the input image.
Use the input image as the camera background.
Set the camera field of view.
Set the camera position.
Set the camera orientation.
Set the principal point, unless it coincides with the image midpoint.

This is more error-prone than the Blender add-on because every value is transferred manually, but it works in any application that exposes those camera controls.

Common snags

Add-on not visible after install: make sure it's enabled in Preferences, not just installed.
Camera looks right but background is missing: the background image is optional; re-run the import with that option enabled.
Everything is skewed: almost always a calibration problem in fSpy. Re-solve before touching Blender.
Principal point ignored: in manual (non-Blender) workflows, the principal point only needs setting when it differs from the image midpoint.

fSpy is free and open source, with an optional donate button if you want to support it — paying is not required to download or use it.