Pupil

Neon Player is an offline desktop application for Neon users to examine, visualize, and export eyetracking data.

To connect with us and our community, chat with us on Discord.

Users

To get started

• Download the latest release and launch the Neon Player application
• Transfer your recordings from your Neon Companion Device to your computer
• Drag-and-drop a recording folder onto the Neon Player window

Developers

Installing Dependencies and Code

To run the source code, you will need Python 3.7 or newer! We target Python 3.11 in our newer bundles and we recommend you to do the same.

Note: It is recommended to install the requirements into a virtual environment.

Note: On arm64 macs (e.g. M1 MacBook Air), use the python3.*-intel64 binary to create the virtual environment. We do not yet provide arm64-native wheels for the Pupil Core dependencies.

git clone https://github.com/pupil-labs/neon-player.git
cd neon-player
python -m pip install -r requirements.txt

If you have trouble installing any of the dependencies, please see the corresponding code repository for manual installation steps and troubleshooting.

Linux

Audio Playback

The sounddevice package depends on the libportaudio2 library:

sudo apt install libportaudio2

Run Neon Player

cd pupil_src
python main.py

Command Line Arguments

The following arguments are supported:

Flag	Description
-h, --help	Show help message and exit.
--version	Show version and exit.
--debug	Display debug log messages.
--profile	Profile the app's CPU time.
<recording>	(Player) Path to recording.

License

All source code written by Pupil Labs is open for use in compliance with the GNU Lesser General Public License (LGPL v3.0). We want you to change and improve the code -- make a fork! Make sure to share your work with the community!