1. What You Are Building

GyroCam turns real iPhone motion into cinematic camera animation for Roblox. The idea is simple: rotation comes from the phone, and position comes from you. The phone gives the camera a human feel, while you decide where the camera moves in the scene.

2. The Full Workflow

1. Capture motion on your iPhone.
2. Send the capture to Processing.
3. Preview the motion in the Visualizer.
4. Choose the preset that feels right.
5. Export the Roblox animation files.
6. Import the camera rig into Roblox Studio.
7. Run the Lua injector script.
8. Bring the animation into Moon Animator.
9. Animate the camera position manually.

3. Step One: Start on Your iPhone

1. Open the GyroCam website on your iPhone.
2. Tap Request Permission.
3. Allow motion access when iOS asks.
4. Tap Start Recording.
5. Move your phone the way you want the camera to feel.
6. Tap Stop when the capture is finished.
7. Tap Send Capture to Processing.

The live values are the raw gyroscope rotation rates: alpha, beta, and gamma. They are measured in degrees per second, not in absolute angles.

4. What the Axes Mean

• beta = pitch, up and down movement, mapped to X.
• alpha = yaw, left and right movement, mapped to Y.
• gamma = roll, tilt movement, mapped to Z.

5. Step Two: Process the Capture

1. The app smooths the gyro rates with EMA.
2. The smoothed rates are integrated into angles.
3. The angles are converted to radians.
4. The result is resampled to 24 FPS.

This is the technical core of the system. The output is now ready for Roblox instead of being just raw sensor noise.

6. Step Three: Check the Visualizer

Open the Visualizer tab to inspect the motion before export. The visualizer shows:

• RAW in orange/red.
• SMOOTH in blue/cyan.
• Live yaw, pitch, and roll values.
• A 3D preview of the camera motion.
• A graph comparing the curves.

Use the playback controls to decide whether the motion feels right. Switch between Handheld, Semi Stable, and Ultra Smooth to compare the look.

7. Picking the Right Preset

8. Step Four: Export the Animation

1. Open the Export tab.
2. Select the preset you want to use.
3. Download the Lua injection script.
4. Use the RBXMX fallback only if needed.

The Lua method is highly recommended because it is more reliable inside Roblox Studio.

9. Transfer the File to Your Computer

At this point, you are still on your phone. The exported file needs to be moved to your computer before you can use it in Roblox Studio.

There are multiple ways to do this. Use whatever works for you:

• Google Drive (recommended)
• AirDrop (Mac only)
• Email
• USB transfer

Using Google Drive

1. Download the .lua file on your phone.
2. Open Google Drive.
3. Tap Upload and select the file.
4. Wait for it to finish uploading.
5. On your PC, open Google Drive.
6. Download the same file to your computer.

10. Get the Camera Rig

Download the Camera Rig model from the Google Drive link below, then import it into Roblox Studio.

Download Camera Rig (.RBXM)

The rig should contain this structure:

CameraRig (Model)
└── CameraRoot (position)
    └── CameraRot (rotation)

11. Step Five: Import the Rig Into Roblox Studio

1. Download the .rbxm rig file from Google Drive.
2. Open it in Roblox Studio.
3. Verify that the model contains CameraRoot and CameraRot.
4. Keep the names exactly as written.

12. Step Six: Run the Lua Injector

1. Copy the Lua injection script from the Export tab.
2. Paste it into a Script inside ServerScriptService.
3. Do not use a LocalScript or ModuleScript.
4. Click Run in Roblox Studio.
5. The generated KeyframeSequence will appear in ServerStorage.

When the script runs, it creates the animation data directly in Roblox. This is the recommended path because it is more reliable than drag-and-drop import.

13. Step Seven: Copy the Generated KeyframeSequence

1. While the game is running, find the generated KeyframeSequence in ServerStorage.
2. Copy it from the Explorer.
3. Stop the simulation.
4. Paste it back into your project storage if needed.

This keeps the generated animation available even after you stop the test session.

14. Step Nine: Import Everything into Moon Animator

Now you are inside Roblox Studio. This is where the animation becomes usable.

1. Open Moon Animator.
2. Create a new animation (New Moon 2 File).
3. Select your CameraRig as the rig.

At this point, you should see this rig structure:

CameraRig
└── CameraRot

Then, import CameraRoot separately from the camera rig in Moon Animator.

Import the Rotation Animation

1. Click File → Import in Moon Animator.
2. Select the KeyframeSequence you generated earlier.
3. Confirm the import.

The animation will be applied to CameraRot.

Understand What Moves What

• CameraRot → handles rotation (DO NOT touch it manually)
• CameraRoot → handles position (this is what you animate)

You now control the camera like a real operator: you move CameraRoot for positioning, while CameraRot keeps the natural handheld motion.

15. Step Nine: Animate the Camera Position

This is where you become the camera operator. Use CameraRoot to control the camera’s movement through the scene:

• Move it forward for a push-in.
• Move it sideways for a truck or slide.
• Move it up or down for a tilt-like travel.
• Use it to frame the shot.

CameraRot stays responsible for the gyro-driven handheld feel. CameraRoot is the artistic movement layer.

16. Why This Works

Real camera operators never move in perfectly clean lines. The tiny imperfections in your hand make the shot feel real. GyroCam captures that feeling and lets you combine it with deliberate camera blocking.

17. Final Result

If everything is set up correctly, you get a camera that feels physically held, not mechanically animated. That is the whole point of GyroCam.