Getting started with your new Atreus

 Your Keyboardio Atreus works like any other USB keyboard. You don't need any special drivers to use your keyboard with a device running macOS, Windows, Linux, ChromeOS, iOS, iPadOS, or Android.

 We ship a 1.5 meter USB A to USB C cable in the box with the Keyboardio Atreus. If your device doesn't have a USB A port, you will need a cable or adapter to connect your new keyboard.

As soon as you plug in your Keyboardio Atreus, your computer should recognize it as a keyboard.

macOS keyboard identification

The first time you connect a Keyboardio Atreus to a computer running macOS, a window will pop up asking you to identify your keyboard.

First, you will be asked to press the key to the right of the left Shift key.

Press the letter "z"

Next, you will be asked to press the key to the left of the right Shift key.

Press the "/" key.

Your computer will then ask you to confirm what type of keyboard you have connected. You should make sure that your computer has identified your keyboard as an "ANSI" keyboard.  If it hasn't, click on the "ANSI" radio button. 

Click "Save".

Update your keyboard's firmware

The easiest way to update your keyboard's firmware is with Chrysalis, our graphical configuration tool.

As of this writing, Chrysalis 0.79 is the current release and ships with the recommended firmware for your keyboard.

Chrysalis is available for Windows 10, macOS, and Linux. You can download the latest release here: 

Once have downloaded and installed Chrysalis, connect your keyboard to your computer and start the application. 

 

On Windows, your antivirus software may tell you that you need to explicitly allow Chrysalis to run.

 

Once Chrysalis is running, you should see your Keyboardio Atreus listed on the welcome screen.

Click "Connect"

Click to open the menu on the left side of the window.

Click "Firmware Update"

Click the slider to restore the keyboard to factory defaults. If you don't do this, the keyboard's layout will not match the layout card after the update.

While holding down the Esc key on your Keyboardio Atreus, click the "Update firmware" button.

 

While continuing to hold down Esc, click "OK"

After the process completes, you should see the Chrysalis welcome screen again. Your Atreus is now running the latest firmware. It is now safe to quit Chrysalis.

 

Getting help

If you need a hand with your Atreus, please don't hesitate to email us at help@keyboard.io.