Ryan 9dcd03b6ca Set `BOOTLOADER = stm32-dfu` for all applicable STM32 boards (#12956) 5 lat temu
..
astar e8b65d0170 Cleanup rules.mk for 32U4 keyboards, A-F (#6804) 6 lat temu
astar_mirrored 6ca00c2152 [Keyboard] PDBDOWN should be PCBDOWN. (#9192) 6 lat temu
feather 817de51c12 Add config for Atreus based on Adafruit Feather BLE (#9140) 6 lat temu
keymaps 9dcd03b6ca Set `BOOTLOADER = stm32-dfu` for all applicable STM32 boards (#12956) 5 lat temu
promicro fb980cf032 [Keyboard] Added Atreus Pro Micro variant (#8059) 6 lat temu
teensy2 e8b65d0170 Cleanup rules.mk for 32U4 keyboards, A-F (#6804) 6 lat temu
atreus.c 75ee8df19e Update Atreus to current code conventions (#5849) 7 lat temu
atreus.h 817de51c12 Add config for Atreus based on Adafruit Feather BLE (#9140) 6 lat temu
config.h d8b9825a8b Remove `DESCRIPTION`, 0-A (#11369) 5 lat temu
info.json eed6ef0999 Configurator updates for Atreus/Atreus62 (#3065) 8 lat temu
readme.md fb980cf032 [Keyboard] Added Atreus Pro Micro variant (#8059) 6 lat temu
rules.mk 7161d65070 Remove FAUXCLICKY feature (deprecated) (#11829) 5 lat temu

readme.md

Atreus

Atreus

A small mechanical keyboard that is based around the shape of the human hand.

Keyboard Maintainer: Phil Hagelberg
Hardware Supported: Atreus, PCB-based or hand-wired
Hardware Availability: https://atreus.technomancy.us

These configuration files are specifically for the Atreus keyboards created by Phil Hagelberg (@technomancy). This keyboard is available in two variants: one powered by a Teensy 2 (usually hand-wired), one powered by an A-Star (usually using a PCB). You will need to use different make commands depending on the variant you have; see examples below.

Make example for this keyboard (after setting up your build environment):

make atreus:default:avrdude

If you would like to use one of the alternative controllers:

make atreus/astar:default:flash
make atreus/teensy2:default:flash
make atreus/promicro:default:flash

If your keyboard layout is a mirror image of what you expected (i.e. you do not get QWERTY on the left but YTREWQ on the right), then you have an A-Star powered Atreus (older than March 2016) with PCB labels facing down instead of up. Specify that by adding PCBDOWN=yes to your make commands, e.g.

make PCBDOWN=yes atreus:default:avrdude

Unlike the TMK firmware, these commands should be run from the root of the repository, not the directory containing this readme.

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.