¶ Introduction
Artemis supports Wooting RGB keyboards through the official Wooting SDKs.
¶ Requirements
Assuming you have a supported Wooting keyboard; the Wooting Device Provider, Wooting Profile Module and Wooting Layer Brush Provider
features of the Wooting Device Plugin should work out of the box.
In order to use the Wooting Analog Module, you'll need to install the Wooting Analog SDK.
¶ Windows
On Windows the SDK & Wooting Plugin will be installed & updated automatically through Wootility (>= v3.4).
If you wish to install manually, download the latest .msi from the latest release
After installing, restart Artemis and the Analog Module should now work.
¶ Linux
On Debian-based distros of Linux, Wooting provides a .deb package which is an easy to install method of getting the Wooting SDK and Pl
ugin installed.
However if you aren't running a Debian-based distro, don't fret! It's not too difficult to get things working for your distro.
¶ Debian-based (Debian, Ubuntu, Pop! OS, etc.)
- You can simply install the
debpackage, which includes both the SDK and the Wooting Plugin, which can be found on the latest release page. - Restart Artemis and the Analog Module should now work.
Here is some helpful information for installing a deb package manually. For all (terminal instructions) and Ubuntu (GUI instructions)
¶ Manual (Fedora, Arch, etc.)
- Download and extract the latest release
unknown-linux-gnu.tar.gzarchive. - Copy
<extracted folder>/wrapper/sdk/libwooting_analog_sdk.soto/usr/lib. (Or to some directory and add that path to theLD_LIBRARY_PATHenvironment variable) - Copy
<extracted folder>/wrapper/sdk/libwooting_analog_sdk.soto/usr/lib. - Copy
<extracted folder>/wrapper/sdk/libwooting_analog_plugin.soto/usr/local/share/WootingAnalogPlugins/wooting-analog-plugin. - If the destination folder for the Wooting Analog Plugin does not exist, you can run the following (as root):
sudo mkdir -p /usr/local/share/WootingAnalogPlugins/wooting-analog-plugin
Restart Artemis and the Analog Module should now work.
¶ macOS
As of writing, note that macOS builds of Artemis are untested and may not work correctly.
¶ Homebrew (Recommended)
- Install Homebrew from their website
- Open the terminal and enter the command below:
brew install wootingkb/wooting/wooting-analog-sdk
Restart Artemis and the Analog Module should now work.
¶ Manual
- Download and extract the latest release
apple-darwin.tar.gzarchive. - Copy
<extracted folder>/wrapper/sdk/libwooting_analog_sdk.dylibto/usr/local/lib. (Or to some directory and add that path to theDYLD_LIBRARY_PATHenvironment variable) - Additionally, you may need to adjust security settings for macOS to let it run. See the following Apple Support Article (HT202491).
- Copy
<extracted folder>/wrapper/sdk/libwooting_analog_plugin.soto/usr/local/share/WootingAnalogPlugins/wooting-analog-plugin. - If the destination folder for the Wooting Analog Plugin does not exist, you can run the following:
sudo mkdir -p /usr/local/share/WootingAnalogPlugins/wooting-analog-plugin
Restart Artemis and the Analog Module should now work.
¶ Troubleshooting
¶ Plugin is not working
See Requirements above to install the Wooting Analog SDK on your Operating System.
¶ I'm using a Linux distro that runs SELinux (like Fedora) and after manually installing the Analog SDK the Analog Module still doesn't work
As the files that you manually installed haven't been labeled by SELinux, it will block them from being used.
To fix this you'll need to auto-relabel your system.
This sounds scary but is really a single command (and a reboot) away.
- Run
sudo touch /.autorelabelin a terminal - Reboot your system, it might take a few seconds/minutes for the process to be complete.
After this the Wooting Analog Module should work.
¶ Supported devices
All Wooting Devices running the V2 firmware should work out of the box.