# Getting Started
Welcome to Pupil Core! The first thing you need to do is download the latest Pupil Core software.
Follow the steps below to get up and running and become familiar with the workflow.
# 1. Put on Pupil Core
Put on Pupil Core headset and plug it in to your computer.
Make sure there is space between the headset frame and your forehead. Headsets are adjustable and shipped with additional parts. For more information head over to the Hardware section of the docs.
# 2. Launch Pupil Capture
Start Pupil Capture on your computer. Once the program has initalized, a world video window and eye video windows will appear.
# 3. Check Pupil Detection
Capturing good raw videos of the eyes is essential for successful eye tracking with Pupil Core.
You will need to physically adjust the eye cameras on your Pupil Core headset to get good images of the eyes.
Take a look at the eye window(s).
Pupil Core uses a 3D model of the eye to improve the pupil detection. Adjust the eye cameras such that your pupil is always visible, even when looking at extreme angles.
Slowly move your eyes around until the eye model (green circle) adjusted to fit your eye ball. If everything is set up properly, you should see a green circle around the eye ball and a red circle around the pupil with a red dot in the center.
Next, check the world window.
You will see confidence graphs in the top for each eye. 1.0 = high confidence pupil detection. 0.0 = no confidence.
Tip - move your head around while looking at a fixed position. This enables you to check that your pupil is visible in the video even at extreme angles.
# 4. Calibration
In order to know what someone is looking at, we must establish a mapping between pupil and gaze positions. This is what we call calibration. The calibration process establishes a mapping from pupil to gaze coordinates.
# Screen Marker Calibration Method
c on the world screen or press
c on the keyboard to start calibrate.
Follow the marker on the screen with your eyes and try to keep your head stationary.
Tip - Want to calibrate with a physical marker? Check out alternative calibration choreographies here.
# 5. Start Recording
Start capturing data!
Pupil Capture will save the world video stream and all the corresponding gaze data in a folder in your main user directory named
Start/Stop recording: Press the
r key on your keyboard or press the circular
R button on the left hand side of the world window. The elapsed recording time will appear next to the
# 6. Locate Saved Recording
By default, each recording will live in its own unique data folder contained in the recordings folder.
The default recordings directory will organize all recordings by date. Each time you press record a new folder will be created. Below we show an example of 3 recordings that have been made on the same date
recordings/ 2019-09-30/ 001/ 002/ 003/
# 7. Visualize in Pupil Player
Launch Pupil Player. Then drag and drop the recording folder (e.g
001) onto the Pupil Player window.
Player comes with a number of plugins. Plugins are classified by their use-case. Visualization plugins can be additive. This means that you can add multiple instances of a plugin to build up a visualization.
# 8. Export Data
You can export videos and data by pressing
e on your keyboard or the down arrow button in the Pupil Player window.
Exports are saved within a dedicated folder named exports within the original recording folder.
Read more about the recording format