Getting started with your new Atreus

As of June 26, 2020, this getting started documentation is a work in progress. We'll be updating it on the fly over the next several days. It's always ok to reach out to us at help@keyboard.io if you need a hand.

 

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

 Keyboardio Atreus keyboards produced before June 2020 shipped with an early firmware version. While the firmware does work, its key layout is slightly out of date and there are a few bugs that may cause frustration while typing. We strongly encourage you to update your keyboard's firmware to the latest available version before you start typing on it.

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

As of this writing, Chrysalis 0.77 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.

On recent versions of macOS, you may need to Command-click on the Chrysalis icon and then click "Open", as the software is not yet signed by Apple.

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.