{"id":19252264,"url":"https://github.com/sccn/eeg-bids","last_synced_at":"2026-03-10T11:07:24.689Z","repository":{"id":39758152,"uuid":"164252215","full_name":"sccn/EEG-BIDS","owner":"sccn","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-13T00:30:28.000Z","size":67201,"stargazers_count":30,"open_issues_count":25,"forks_count":21,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-02-13T09:59:13.005Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"MATLAB","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sccn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-01-05T21:22:30.000Z","updated_at":"2026-02-13T00:30:32.000Z","dependencies_parsed_at":"2024-02-15T18:28:35.812Z","dependency_job_id":"5f87e24f-cf73-4290-a408-0951d9d0e0bd","html_url":"https://github.com/sccn/EEG-BIDS","commit_stats":null,"previous_names":["sccn/eeg-bids"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sccn/EEG-BIDS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sccn%2FEEG-BIDS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sccn%2FEEG-BIDS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sccn%2FEEG-BIDS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sccn%2FEEG-BIDS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sccn","download_url":"https://codeload.github.com/sccn/EEG-BIDS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sccn%2FEEG-BIDS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30331663,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T18:26:10.681Z","updated_at":"2026-03-10T11:07:24.684Z","avatar_url":"https://github.com/sccn.png","language":"MATLAB","funding_links":[],"categories":[],"sub_categories":[],"readme":"![EEG-BIDS](https://github.com/sccn/EEG-BIDS/assets/1872705/47675a55-6573-47d7-abec-48e364d5ad8a)\n\n# EEG-BIDS\n\nThe EEG-BIDS (formerly known as **BIDS-MATLAB-tools**) repository contains a collection of functions that import and export BIDS-formated experiments. The code is tailored for use as an [EEGLAB](http://eeglab.org) plugin but may also be used independently of EEGLAB. Conversion of data format from non-supported BIDS binary format requires that EEGLAB be installed (supported formats are EEGLAB .set files, EDF files, BDF files, and Brain Vision Exchange Format files).\n\n# Documentation\n\nRefer to the [wiki documentation](https://github.com/sccn/EEG-BIDS/wiki) or the submenus of this plugin if you are on the EEGLAB website.\n\n# EEG-BIDS vs other BIDS software\n\n[BIDS-MATLAB](https://bids-matlab.readthedocs.io/en/latest/) is a project to import BIDS data. BIDS-MATLAB maps the BIDS directory architectures to MATLAB structures but **does not import or convert data like EEG-BIDS**. In theory, EEG-BIDS could use BIDS-MATLAB to get the BIDS directory architectures into MATLAB and then convert it to an EEGLAB STUDY. However, in 2021, BIDS-MATLAB could not yet import all the relevant EEG, MEG, and iEEG files. \n\n[EEG2BIDS](https://github.com/aces/EEG2BIDS) is a Python-based executable that formats a collection of EDF files in BIDS format. EEG2BIDS requires users to create JSON files for metadata. It is a tool designed to archive data as part of a lab protocol where JSON files have been prepared in advance and are suited for technicians organizing data. EEG-BIDS export capabilities are more suited for researchers managing their data and are agnostic regarding the original data format.\n\n[ezBIDS](https://brainlife.io/ezbids/) is a data export tool for MRI and fMRI data. It does not allow exporting EEG data to our knowledge.\n\n[data2bids.m](https://www.fieldtriptoolbox.org/example/bids/) is a Fieldtrip function to export BIDS data. This includes EEG and maybe fMRI. This function can only be used from the command line.\n\n[EEG-BIDS](https://github.com/sccn/EEG-BIDS) (this program) is the most popular tool to export EEG data using both a graphical interface and/or command line (more than half of the BIDS datasets on OpenNeuro were exported using EEG-BIDS and it has more than 2200 installs in EEGLAB). A compiled, stand-alone version of EEG-BIDS with a graphic interface wizard is also available when you download the compiled version of EEGLAB.\n\n# Standalone version\n\nA standalone version of the plugin is available when [downloading EEGLAB](https://sccn.ucsd.edu/eeglab/download.php). The standalone version of EEG-BIDS is currently bundled with the compiled version of EEGLAB for user convenience; if user demand increases significantly, a separate distribution package will be made available. After downloading EEGLAB, use the EEGBIDS (Mac) or EEGBIDS.bat (Windows) executable. This version of EEG-BIDS does not require a paid MATLAB license.\n\n# EEG-BIDS export capabilities\n\nAccepted EEG input formats are all files that EEGLAB can read. \n\n* EEG export: ✔ (as .set, .edf, .bdf, or .vhmk files)\n* iEEG export: ✔ (as .set, .edf or .nwb)\n* Eye-tracking export: ✔ (beta)\n* HED export: ✔\n* BEH export: ✔\n* MRI export: ✔ (no conversion)\n* fMRI export: ✖\n* Motion-cap export: ✖ (upcoming)\n* EMG export: ✔ (as .edf and .bdf, beta import and export)\n* MEG export: ✖ (upcoming)\n\n# EEG-BIDS import capabilities for EEGLAB\n\nEEG-BIDS allows importing BIDS datasets into EEGLAB. This is the type of information that can be imported.\n\n* EEG import: ✔ (all formats)\n* iEEG import: ✔ (all formats)\n* MEG import: ✔ (.ds and .fif files supported, more formats upcoming)\n* Eye-tracking import: ✖ (upcoming)\n* HED import: ✔\n* BEH import: ✔\n* MRI import: n/a\n* fMRI import: n/a\n* Motion-cap import: ✔ (beta)\n* EMG import: ✖ (upcoming)\n\n# Cloning\n\nMake sure you clone with submodules\n\n```\ngit clone https://github.com/sccn/EEG-BIDS\n```\n\n# Testing \n\nUse the EEG-BIDS_testcases repository for testing\n\n```\ngit clone https://github.com/sccn/EEG-BIDS_testcases.git\n```\n\n# Use with EEGLAB\n\nSimply place the code in the EEGLAB plugin folder, and EEGLAB will automatically detect it. See documentation at [https://github.com/sccn/EEG-BIDS/wiki](https://github.com/sccn/EEG-BIDS/wiki).\n\n# Zip command to release plugin\n\n```\nzip -r EEG-BIDS8.0.zip EEG-BIDS/* -x /EEG-BIDS/testing/additionaltests/* /EEG-BIDS/testing/ds004117/* /EEG-BIDS/testing/hbn_eye_tracking_data/* /EEG-BIDS/testing/data/*\n```\n\n# Version history\n\nv1.0 - initial version\n\nv2.0 - add support for external channel location and fix minor bugs\n\nv3.0 - better export for multiple runs and allowing importing BIDS folder with multiple runs\n\nv3.1 - fix multiple issues at export time, including subject numbering\n\nv3.2 - fix menu conflict in EEGLAB with bids validator; check channel types; add option to choose EEG event field; minor bugs\n\nv3.3 - fix an issue for Windows and work on GUI\n\nv3.4 - fix the issue with saving datasets in memory. Allowing to anonymize participant ID or not. Fixed issue with looking up channel locations.\n\nv3.5 - fix issue with choosing event type in graphic interface; various fixes for GUI edit of BIDS info\n\nv4.0 - fix GUI and many minor export issues\n\nv4.1 - fix the issue with JSON\n\nv5.0 - major fixes to import all OpenNeuro EEG datasets\n\nv5.1 - allow calculating dataset meta-data quality\n\nv5.2 - fix the issue with history\n\nv5.3 - adding the capability to export stimuli\n\nv5.3.1 - update documentation for tInfo.HardwareFilters; fix bug defaults fields not filled for eInfo\n\nv5.4 - fix the issue with reading BIDS information when importing BIDS data to STUDY\n\nv6.0 - new examples and fixes for HED\n\nv6.1 - allow data with no events. Fix HED import/export. Fix history.\n\nv7.0 - split code into different functions. Support for behavioral data. Various bug fixes.\n\nv7.2 - fix the issue with the missing file.\n\nv7.3 - various minor fixes (EEG reference as string; add duration if not present; resave datasets)\n\nv7.4 - fix version issues for HED and BIDS. Export subjects in order. Remove unused columns in participants.tsv file\n\nv7.5 - adding support for coordsystem files, for loading specific runs, support for motion files\n\nv7.6 - adding export to non-EEGLAB formats, refactoring export\n\nv7.7 - fix importing MEG and MEF files. Better handling of runs. Now tracks tool version in BIDS.\n\nv8.0 - renamed files, separate file for task info, adding BIDS statistic output, handling EGI \u0026 BVA file better, channel types and units, adding eye-tracking and behavioral support\n\nv9.0 - update json import to conform to BIDS key-level inheritance principle. Support iEEG and MEG export. Support exporting multiple tasks. Fix issues with exporting channel locations. BIDS export wizard.\n\nv9.1 - better handling of behavioral data. Fix issue with task name and BIDS dataset with no README file.\n\nv10.0 - adding support for re-exporting datasets. Adding the the \"desc\" key. Fix some event export issues.\n\nv10.1 - fix export wizard.\n\nv10.2 - fix missing task when exporting study, fix bids subject (bug 860), better handling of descriptive tags.\n\nv10.3 - fix importing samples when both samples and latency are present.\n\nv10.4 - add EMG support for import.\n\nv10.5 - adds beta EMG export support, fixes session and run indexing and UI handling, improves subject validation, and prevents invalid channel values during export. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsccn%2Feeg-bids","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsccn%2Feeg-bids","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsccn%2Feeg-bids/lists"}