Repository navigation
Releases: warptengood/eeg_annotator
Releases · warptengood/eeg_annotator
Release list
v2.3.0
Ziyatron EEG Annotator v2.3.0
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
This release introduces a two-person annotation workflow — labelers mark regions, experts verify them — and replaces the old CSV storage with a single validated JSON file per recording. Annotations now keep full sub-second timing.
✨ Highlights
Review & verification
- Labeler / Expert roles — pick a name and role on first run (honor-system, no login); edit anytime from the toolbar.
- Expert review panel — experts toggle Review mode, select a label, and Verify, Reject, or request Needs changes with an optional note.
- Status at a glance — annotation borders are color-coded: ⚪ draft · 🔵 submitted · 🟢 verified · 🔴 rejected · 🟣 needs-changes.
- Full provenance — every annotation records its author, reviewer, and timestamps. Editing an already-reviewed label automatically sends it back for re-review.
Annotation precision
- Sub-second time — start/stop times are no longer rounded to whole seconds; downstream analysis gets exact boundaries.
- Channel snapping — vertical edges snap to whole channel borders, so a box always covers exactly the channels it lists (single-channel annotations are now fully visible).
Storage
- One JSON file per recording (
{edf}.ziyatron.json) holding every montage's annotations plus review metadata. - Safe saves — saving one montage never touches another's labels, and a labeler's save can't overwrite an expert's verdict.
- Validation — a hand-corrupted file is reported with a warning instead of silently losing data.
🐛 Fixes
- Switching montage after deleting all annotations now correctly persists the empty state instead of keeping the old labels.
- Annotations no longer drift up by one channel on each move/resize.
⚠️ Notes
- CSV is gone. Existing
*_<montage>.csvfiles are not read by the app — migrate them separately if needed. - Closing the window still discards unsaved annotations without a prompt — remember to Ctrl+S.
Full usage guide: MANUAL.md
Full Changelog: v2.2.1...v2.3.0
v2.2.1
Ziyatron EEG Annotator v2.2.1
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.2.0...v2.2.1
v2.2.0
Ziyatron EEG Annotator v2.2.0
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.1.2...v2.2.0
v2.1.2
Ziyatron EEG Annotator v2.1.2
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.1.1...v2.1.2
v2.1.1
Ziyatron EEG Annotator v2.1.1
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.1.0...v2.1.1
v2.1.0
Ziyatron EEG Annotator v2.1.0
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.0.3...v2.1.0
v2.0.3
Ziyatron EEG Annotator v2.0.3
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.0.2...v2.0.3
v2.0.2
Ziyatron EEG Annotator v2.0.2
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: Unzip, then right-click
eeg_annotator.app→ Open (first launch only, to bypass Gatekeeper). Move to Applications folder if desired.
Full Changelog: v2.0.1...v2.0.2
v2.0.1
Ziyatron EEG Annotator v2.0.1
Downloads
| Platform | File |
|---|---|
| Windows | eeg_annotator-Windows.zip |
| macOS | eeg_annotator-macOS.zip |
Installation
- Download the ZIP file for your platform
- Extract the archive
- Run the
eeg_annotatorexecutable - macOS users: If you see a security warning, right-click the app and select "Open"
Full Changelog: https://github.com/KenesYerassyl/eeg_annotator/commits/v2.0.1