psychopy-bids 2026.1.3

A PsychoPy plugin for using the Brain Imaging Data Structure (BIDS) to organize and describe data.

A PsychoPy plugin for creating valid Brain Imaging Data Structure (BIDS) datasets from behavioral and task-based experiments.

• Documentation
• Gitlab Repository
• Report Issues
• Contributing Guidelines
• Code of Conduct
• PyPI Package

---

Breaking Changes in Non-Patch Versions

Non-patch versions (e.g., v2025.1.0, v2026.0.0) may introduce substantial new features or changes that break compatibility with previously written experiments. It is strongly recommended to continue using the version of psychopy-bids that an experiment was originally created with. Only upgrade to a newer version for new experiments.

For details, see the Changelog.

---

Installation

Recommended: Install via PsychoPy Plugin Manager

1. Open PsychoPy.
2. Go to the Tools menu and select Plugin/packages manager.
3. Search for psychopy-bids in the list.
4. Click Install.

Alternative: Install via pip

pip install psychopy-bids

---

Usage

psychopy-bids supports two workflows:

• PsychoPy Builder — Add BIDS components directly to experiment routines without writing code.
• Python code — Use the BIDSHandler and event classes to construct and export BIDS datasets programmatically.

See the documentation for installation instructions, guides, and API reference.

---

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

---

License

psychopy-bids was created by Christoph Anzengruber, Florian Schöngaßner & Lukas Wiertz. It is licensed under the terms of the GNU General Public License v3.0 license.