Documentation
Resources to help you learn and use PEBL effectively.
PEBL Manual
Official PEBL Manual (Version 2.2)
The comprehensive guide to PEBL programming, covering language syntax, functions, and experiment design.
Complete reference manual updated for PEBL 2.2 with all new features and functions.
Online Function Reference
Searchable online reference for all PEBL functions, including built-in functions and library utilities. Browse by namespace or search for specific functions.
Covers all 400+ functions organized by namespace with examples and cross-references.
C++ API Documentation
For developers interested in PEBL's C++ internals, the complete API documentation generated from source code is available. Useful for understanding how PEBL functions are implemented or for contributing to PEBL development.
Auto-generated from PEBL 2.2 source code using Doxygen.
Getting Started
Video Tutorials
Watch video tutorials on the homepage to learn installation and basic usage.
Test Library
Browse 100+ ready-to-use psychological tests at PEBL Hub. Each test includes source code you can examine and modify.
Frequently Asked Questions
Where is my data saved?
When you install PEBL, a folder is created in your Documents folder called pebl-exp.2.2 (for version 2.2). Each test from the test battery is located in a subfolder within the battery folder.
Data files are saved within the script's folder, in a data subfolder. For example, for the ANT task, look in:
Documents\pebl-exp.2.2\battery\ANT\data\
Normally, each participant will have their own subfolder in the data directory.
How do I launch a PEBL script?
The easiest way is to start the launcher from:
- Windows: Start Menu → PEBL
- macOS: Applications folder → PEBL
From the launcher, you can select and run any script from the test battery or your own experiments.
How do I launch a script from the command line?
You can run PEBL scripts directly from the command line or a batch file:
Windows:
"c:\Program Files (x86)\PEBL\bin\pebl.exe" experiment.pbl
With options:
"c:\Program Files (x86)\PEBL\bin\pebl.exe" experiment.pbl -v sub1 --fullscreen --display 800x600
Common command-line options:
-v VALUE- Pass values to the script-s IDENTIFIER- Set subject ID--fullscreen- Run in fullscreen mode--display WIDTHxHEIGHT- Set screen resolution (e.g., 1024x768)--driver DRIVER- Set video driver (Linux)
What if a script doesn't launch?
Check the 'Error Messages' window at the bottom of the launcher. Scroll to the bottom for error messages that can help diagnose the problem.
The same error information is saved in a file called stderr.txt in the directory where the script is located.
Programming & Development
GitHub Repository
Access source code, report issues, and contribute to development:
Example Scripts
The best way to learn PEBL programming is to examine existing scripts. The test battery includes 100+ complete, working experiments you can study and modify.
After installing PEBL, find examples in:
Documents\pebl-exp.2.2\battery\
Community Support
Get Help
Need help with PEBL? Connect with the community:
- Discord: Join our Discord community for real-time chat and support
- Mailing List: Join pebl-list for questions and discussions
- GitHub Issues: Report bugs and request features on GitHub
- SourceForge: Visit the project page for additional resources