Making raw-to-BIDS less painful.
What is BIDS Manager?
BIDS Manager is a desktop app that helps researchers turn raw MRI, EEG, and MEG recordings into BIDS-compliant datasets. It scans your raw data, lets you review and fix every conversion decision in a spreadsheet, runs the conversion, and then opens the result for metadata editing, volume inspection, and validation. All in one place, without writing scripts or editing JSON files by hand.
Get started
The fastest way to set things up is the one-click bootstrap installer for macOS, Linux, and Windows. It bundles a portable Python with every dependency and registers a native desktop launcher; no prior Python install required. See the install guide for a step-by-step walkthrough.
Once installed, launch the GUI with bidsmgr. Prefer the command line? Five
verbs cover the whole pipeline: bidsmgr-scan, bidsmgr-rebuild,
bidsmgr-convert, bidsmgr-metadata, and bidsmgr-validate. The
documentation covers the full GUI walkthrough and CLI reference.
The workflow
Each feature below maps to one of the stages above.
Features
1. See what you have
Point the app at a folder of DICOM, EEG, or MEG recordings, or all three at once. It walks the tree, classifies every series, and shows the proposed BIDS names in a spreadsheet you can sort, filter, and bulk-edit.
2. Convert with confidence
Override any cell before you commit. Subject names, sessions, tasks, runs:
everything updates the BIDS filename live. Hit Run and BIDS Manager handles
dcm2niix, mne-bids, and the physio backends behind the scenes, with atomic
staging so a failure never leaves your output tree half-converted.
3. Fix metadata visually
JSON sidecars become forms. Required fields appear in red, recommended in amber, and missing fields are listed for you with empty inputs ready to fill. TSVs open in an editable table. No more hand-editing files in a text editor.
4. Inspect your volumes
A built-in NIfTI viewer with single-slice and tri-view modes. Drag the crosshair across all three orientations at once. For 4D data, a time-series plot shows the signal at the crosshair voxel, with a scope grid for neighbouring voxels.
5. Validate in one click
Run the official BIDS validator against your dataset. Every error is clickable. It takes you straight to the offending file, scrolls to the broken field, and opens it for editing. Fix it, revalidate, done.
6. Provenance built in
Every action you take is recorded in your project file. Undo a mistake from
yesterday. See why a subject was renamed. Your dataset arrives with its history
attached in dataset_description.json, so anyone who picks it up can trace what
happened and when.
Authors
Karel López Vilaret and Jochem Rieger, ANCP Lab, Carl von Ossietzky Universität Oldenburg.
License
MIT.
Physio conversion code under bidsmgr/vendor/bidsphysio/ is derived
from bidsphysio by Pablo
Velasco and Chrysa Papadaniil (NYU Center for Brain Imaging), used
under the MIT License. See bidsmgr/vendor/bidsphysio/LICENSE and
bidsmgr/vendor/README.md for the full attribution and what
changed during vendoring.
Citation
López Vilaret, K. M. and Rieger, J.
BIDS Manager (v1.0.0). 2026. https://github.com/karellopez/BIDS-Manager
1 maintainer
Metadata
1 maintainer
Release files for bids-manager 1.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bids_manager-1.2.6.tar.gz | 2.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bids_manager-1.2.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.3 MB
Release files / bids_manager-1.2.6.tar.gz
| Download URL | bids_manager-1.2.6.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9a0a19a2e35289123b91e5b48fe5f135124259383a99a01e98503bec1aa0c2f3
|
|
BLAKE2b-256 checksum How to use checksums |
38d5d2913390d50832b2061e21c7903e0005cc447dd12662786ffdc936587f11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Release files / bids_manager-1.2.6-py3-none-any.whl
| Download URL | bids_manager-1.2.6-py3-none-any.whl |
|---|---|
| Size | 2.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e671734779351bdd89cd40e1643efb6d37b691fbea1f5d82527a3429bb49b974
|
|
BLAKE2b-256 checksum How to use checksums |
f06722107f45706eeef862b393c193430ce7a41c5fa5cb0b7969f35cb1df8fb8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
