fSync

</div> <details> <summary>Table of Contents</summary>

• About
• Features
• Installation
  • Requirements
  • Maya Scipt Setup
• Usage
• Roadmap & Contributing
• Credits
• License

</details>

About

A tool to sync fSpy camera data and projections with Maya scenes.

Watch Demo Video Here: YouTube Video

Features

• Launch fSpy (Windows default installation required)
• Import fSpy JSON camera data
• Use an image or image sequence for projection mapping
• Use custom naming for camera and shader
• Create projection camera and shader
• Apply shader to selected objects
• Update image, camera, and shader settings

Installation

Requirements

• Autodesk Maya (version 2025+)
• fSpy

Maya Scipt Setup

1. Download or clone this repository.
2. Copy the script file to your Maya scripts directory:

Documents/maya/<version>/scripts/

3. In Maya, open the Script Editor and run:

import fSync
fSync.show_dockable_window()

Usage

1. (Optional) Click Launch fSpy (Windows only) to open fSpy directly.
2. Export camera data from fSpy as a JSON file.
3. Run fSync in Maya to open the UI.
4. Select the JSON file and your projection image or image sequence.
5. (Optional) Enter custom camera and shader names, and set a sequence offset if needed.
6. Click Create Scene to automatically generate the camera, projection setup, and shader.
7. Select objects and click Apply Shader to assign the shader.
8. Use Update to change camera or image settings at any time.

Watch the Demo here: YouTube Video

Roadmap & Contributing

See the open issues to track planned features, known bugs, and ongoing work.

If you encounter any bugs or have feature requests, please submit them as new issues there. Your feedback and contributions help improve RefUp!

Credits

• Script by Mats Valgaeren
• Powered by:
  • fSpy
  • PyQt6

License

GNU General Public License v3.0