Skip to content
reminiscience edited this page Aug 13, 2026 · 2 revisions

AnaNeo wiki

AnaNeo implements the Neo keyboard layout and its relatives on Windows. This wiki documents what is on every layer and everything that can be configured – the reference material that would make the README unreadable.

For installation, the feature list and the developer notes, see the README.

AnaNeo is a fork of ReNeo by Rojetto and qwertfisch. Most of the code originates there and is licensed under GPL-3.0. AnaNeo keeps four of the Neo-family layouts and puts the work into one of them, AnNoted.

The layers

AnNoted has 21 layers: the four you know, five themed blocks and one modifier layer. Every layer below has a picture of its actual assignment.

Layers Reached by
Base 1–4 – / Shift / Mod3 / Mod4
Maths and logic 5–8 M3+F2, then +Shift / +Mod3 / +Mod4
Typography 9–12 M3+F3, then +Shift / +Mod3 / +Mod4
Ancient Greek 13–14 M3+F4, then +Shift
Cyrillic 15–16 M3+F5, then +Shift
Extra 17–20 M3+F6, then +Shift / +Mod3 / +Mod4
Compose modifiers 21 hold Mod3+Mod4

Start with Layers – it explains the scheme itself: why no key carries the block modifiers, what a lock does, and what happens when you ask for a combination that does not exist.

The other three layouts – Noted, Neo, NeoQwertz – keep their six published layers. See Layouts.

Configuration

Page Covers
Configuration the two files, how defaults are merged, the top-level options
Locks and triggers which modifiers lock, by which chord, and the fixed actions
On-screen keyboard theme, ISO/ANSI, what the display shows
Compose modules which sequence files load, in what order
Hotkeys and blacklist global shortcuts, automatic deactivation
One-handed mode mirror key and mirror map
Editing layouts layouts.json in full, and the traps in it

Compose

Page Covers
Compose the grammar, the six modifiers, sticky modes, special modes
Compose tool ananeo-tool – finding out what exists
Layout sheet the printable HTML sheet, and how to read it

Three things worth knowing early

M3+Esc releases every lock. If the keyboard is behaving strangely, that is the first thing to try.

Mod3+Tab starts a compose sequence in every lock state, and Mod3+F1 shows the on-screen keyboard – which tells you what layer you are on and what each key would do next.

After an update, new triggers and compose modules do not appear by themselves. Arrays are replaced whole when your settings are merged with the defaults. See how the merge works.


The pictures in this wiki are generated from the layout sheet with tools/wiki-screenshots.py in the main repository. If a picture and the program disagree, the program is right and the picture is stale – please open an issue.

Clone this wiki locally