# Getting started with Atreus

**URL:** <https://community.keyboard.io/t/getting-started-with-atreus/5137>\
**Category:** Help and Getting Started\
**Created:** [December 27, 2021, 6:52pm UTC](https://community.keyboard.io/t/getting-started-with-atreus/5137 "2021-12-27T18:52:35Z")\
**Posts on this page:** 1\
**Showing post:** 2

<div class="post-metadata">

**Author:** ![Rom1deTroyes](https://yyz1.discourse-cdn.com/flex031/user_avatar/community.keyboard.io/rom1detroyes/32/3352_2.png) [@Rom1deTroyes](https://community.keyboard.io/u/Rom1deTroyes)\
**Post date:** [December 28, 2021, 7:52am UTC](https://community.keyboard.io/t/getting-started-with-atreus/5137/2 "2021-12-28T07:52:24Z")

</div>

Frustration is the worst user experience !

I find the doc straight forward, and don’t get much trouble to flash my keyboard _without_ the Arduino IDE, so if the doc miss something, we must improve it 📝

> **[GitHub - keyboardio/Kaleidoscope: Firmware for Keyboardio keyboards and other...](https://github.com/keyboardio/Kaleidoscope#use-git-to-check-out-a-copy-of-kaleidoscope)**
>
> Firmware for Keyboardio keyboards and other keyboards with AVR or ARM MCUs. - GitHub - keyboardio/Kaleidoscope: Firmware for Keyboardio keyboards and other keyboards with AVR or ARM MCUs.

If something goes bad here, please report it so it can be investigate (M1 Mac seems to reserve some surprises for users)

```sh
$ cd ${HOME}/git
$ git clone https://github.com/keyboardio/Kaleidoscope
$ cd ${HOME}/git/Kaleidoscope
$ make setup
$ export KALEIDOSCOPE_DIR=${HOME}/git/Kaleidoscope
$ cd examples/Devices/Keyboardio/Atreus
$ ### Edit the .ino files ###
$ make compile
$ make flash # Pressing the prog key

```

The missing part may be the need to reset the eeprom if Chrysalis was used to modify the layouts 🤔

> [@Atreus Firmware Puzzle](https://community.keyboard.io/t/atreus-firmware-puzzle/5084/2):
>
> Yep, Chrysalis store the keymap in eeprom and kaléidoscope compile it in the binary file, so you have to either : tell your sketch to mot use the eeprom layouts (you can search here or in the github issues) reset the eeprom (there is a make command to do it, or use the «reset to factory» option from the Chrysalis firmware upgrade menu - don’t forget to export your layers as a backup, just in case…) Happy hacking slight_smile

For the Chrysalis unfriendly experience, feel free to write a word about what you like/dislike, this may just be a Graphical VS. Cli way of life, but things can eventually be improved at a point 🙂

Happy Hacking 🛠  
Romain

---

_[View the full topic](https://community.keyboard.io/t/getting-started-with-atreus/5137)._