ErgoMoCap Tutorial: How to run your first Ergo assessment
Follow these steps to check the ergonomics of a lifting task using the REBA method.
IMPORTANT! You must have already all the FreeMoCap data of a recording session.
If you don't have an existing recording session click on the 💀 RUN FREEMOCAP button to open the FreeMoCap software so you can record a new session.
If you don't know how to use FreeMoCap you can read a guick guide here: Simple FMC tutorial or read the full detailed official docs FreeMoCap Documentation.
Step 1: Get your data in
- Open the app.
-
Click 📂 SELECT FREEMOCAP ROOT and pick the folder where you keep all your recordings. IMPORTANT NOTE: Select the main 'freemocap_data' folder created by your FreeMoCap installation or the one you are using with freemocap.
-
Use the Select Recording Session list to pick the specific folder you want to study.

- From the Select Video list, pick a file. You should see the video and the skeleton appear on the right.

Step 2: Choose your method
- Go to the Select Ergonomic Method list.
- Pick REBA (or RULA if you are just looking at upper body).

- Click 🏃 RUN ANALYSIS. Wait for the status bar at the bottom to say it's finished.

NOTE: Video playback will stutter while an analysis is running. We recommend waiting for the calculation to finish before playing the video.
The status bar will show a confirmation message when the processing finishes:

Step 3: Check the video
- Click ▶ PLAY / PAUSE.
- Watch the video to make sure the skeleton is actually on top of the person.

- If the skeleton is jumping around or "shaky," you might need better lighting or a different camera angle next time.
Step 4: See the results and save
- Click 📊 OPEN REPORT DASHBOARD. A new window will pop up.
- Look at the Risk Pie Charts to see if the person spent too much time in the "High Risk" (red) zones.

- If you need a file for your records:
- Click 📜 EXPORT TO PDF for a clean shareable report.
- Click 📄 EXPORT TO DOCX if you need a Word file you can type in later.
💡 Tips for better results
- Use FreeMoCap Calibration: FreeMoCap provides a built-in calibration tool that uses ChArUco boards, using it improves accuracy of MoCap data collection.
- Clear view: Make sure no boxes or chairs are blocking the camera's view of the person's joints. If the camera can't see the knees or elbows, the score will be wrong.
- Lighting: If the room is too dark, the tracking will be "noisy" (the skeleton will twitch).
- Double Check: Computers make mistakes. Always look at the video yourself to see if a "High Risk" score actually looks like a dangerous movement.
For better detailed info about Video Recording, Calibration with ChArUco boards and MoCap data collection you can read the official FreeMoCap Documentation.
© 2026 medlav. Distributed under the AGPL-3.0 License.