Ziyatron EEG Annotator

Clinical-grade EEG annotation for neurophysiologists — fast, free, and runs on any laptop.

Load any EDF file, navigate the trace, and mark regions with 49 clinical labels — all without a hospital workstation. Streams data on demand so 100 MB+ files open in seconds and use under 50 MB of RAM. Built for teams: labelers mark regions and experts verify them, with full provenance on every annotation.

---

Download

No installation required — just unzip and run.

Download the latest release — pre-built executables for Windows and macOS.

---

Features

Viewing

• Load EDF / EDF+ files of any size (tested up to 1 GB+)
• Bipolar Double Banana, Bipolar Transverse, and Average montages
• Adjustable scale (1–1000 µV/mm), high-pass / low-pass filtering
• Smooth pan with A/D keys or mouse drag; zoom with scroll wheel
• Jump to any time with the Goto field

Annotation

• Draw rectangles across any time range and channel selection
• 49 pre-defined clinical labels (SEIZ, ARTF, AR, MUSC, EYBL, …)
• Sub-second time precision; vertical edges snap to whole channels
• Move, resize, copy/paste, and delete annotations
• Ctrl+Z undo

Review & verification

• Labeler / expert roles (honor-system identity, no login)
• Experts verify, reject, or request changes on each label
• Border colors show review status at a glance (draft, submitted, verified, rejected, needs-changes)
• Every annotation records its author, reviewer, and timestamps

File I/O

• Annotations save to one JSON file next to the EDF ({edf}.ziyatron.json)
• Auto-loads existing annotations on open
• All montages in one file; saving one montage never touches another

---

User Manual

Full usage instructions, keyboard shortcuts, and label reference: MANUAL.md

---

Quick Start (from source)

git clone https://github.com/warptengood/eeg_annotator.git
cd eeg_annotator
uv sync
python main.py

Always run python main.py from the project root — not python src/main.py.

---

Built With

• MNE-Python — EEG data I/O
• PyQt6 — GUI framework
• PyQtGraph — high-performance time-series rendering

---

Contributing

See CONTRIBUTING.md for dev setup, architecture, and how to add montages or labels.

---

Support

• Bug reports & feature requests: GitHub Issues
• Email: kenesyerassyl@gmail.com

---

Author & License

Ziyatron EEG Annotator is created and maintained by Kenes Yerassyl.

• Original repository: github.com/warptengood/eeg_annotator
• Contact: kenesyerassyl@gmail.com

This project is licensed under the GNU General Public License v3.0 — see LICENSE for details.

Copyright © 2024–2026 Kenes Yerassyl. All source files carry the full GPL-3.0 copyright header.

If you encounter a copy of this software without proper attribution, it is in violation of the license terms.