I built a free, open-source EEG annotation tool that runs on any laptop (Windows/macOS) — no hospital workstation needed

I’m a developer working with neurophysiologists, and the main frustration I kept hearing was: “EDF viewers either cost money, require a powerful machine, or are painful to install.”

So I built Ziyatron EEG Annotator — a desktop app for annotating EEG recordings from EDF files. It’s free, open source (GPL-3), and ships as a ready-to-run executable.

What it does:

  • Load EDF files of any size — streams data on demand, uses <50 MB RAM even on 1 GB+ files

  • Three standard montages: Bipolar Double Banana, Bipolar Transverse, Average

  • Draw annotation rectangles across any time/channel range

  • 44 clinical labels (SEIZ, ARTF, MUSC, EYBL, and all seizure subtypes)

  • Move, resize, copy/paste, undo annotations

  • Saves as CSV next to the EDF file, loads automatically on next open

Built with Python + PyQt6 + MNE. No cloud, no subscription, no sign-up.

Download (no install needed): github.com/warptengood/eeg_annotator/

Would love feedback from anyone who works with EEG data — especially on missing montages, label sets, or workflow pain points.