Skip to content
/ ggoled Public

Put graphics on your SteelSeries Arctis Nova Pro Base Station 128x64 OLED screen

License

Notifications You must be signed in to change notification settings

JerwuQu/ggoled

Repository files navigation

ggoled

Put custom graphics on your SteelSeries Arctis Nova Pro Base Station 128x64 OLED screen.

This utility implements the USB protocol, so you don't need SteelSeries GG/Engine Apps/GameSense, and it works on linux.

For Windows there is also a desktop application that shows the current time and currently playing media.

Animation showcase

Bad Apple at 60 fps. This also showcases the burn-in you will get if not careful with OLEDs. The flickering is due to bad camera settings and not actually shown on the display.

Bad Apple on the Base Station

Supported Devices

Device Supported
SteelSeries Arctis Nova Pro Wired
SteelSeries Arctis Nova Pro Wireless
SteelSeries Arctis Pro Wired 🧐 #2
SteelSeries Arctis Pro Wireless 🧐 #2

PRs and issues for similar devices are welcome!

Install

For Windows you can download the latest builds either from GitHub Actions or from nightly.link (direct download).

Otherwise, install the Rust toolchain and run: cargo install --git https://github.com/JerwuQu/ggoled.git ggoled

To run ggoled without requiring root on linux you first need to copy 11-steelseries-arctis-nova.rules into /etc/udev/rules.d/ and run udevadm control --reload and udevadm trigger as root.

CLI usage examples

See ggoled --help for all commands and flags.

  • ggoled brightness 1: set the brightness to low.
  • ggoled text "Hello, World!": draw some text onto the display.
  • ggoled img cool_image.png: draw an image onto the display.
  • ggoled anim -r 10 -l 20 frame1.png frame2.png frame3.png: play an animation at 10 fps, looped 20 times.
  • ggoled anim animation.gif: play a gif animation.

You also can play video animations by first extracting frames with ffmpeg:

ffmpeg -i YOURVIDEO.mp4 -r 20 -vf "scale=w=128:h=64:force_original_aspect_ratio=1" frames/%05d.png
ggoled anim -r 20 frames/*  # bash
ggoled anim -r 20 $(Get-ChildItem frames | % { $_.FullName })  # powershell

Desktop application

Currently Windows only.

The application puts itself as an icon in the system tray that you can right-click to configure.

It gets media information from the Windows API which makes it work with almost all applications (with some limitations).

There are also features to avoid OLED burn-in that is otherwise unavoidable when using the official software, such as the screensaver function which will turn off the OLED display when away from the computer, or the OLED shifter which will infrequently move things around slightly. To extend the lifespan of your display, both of these are strongly recommended to use, along with using a low screen brightness.

Custom font

It's recommended to use bitmap fonts to avoid weird artifacting, but any TTF or OTF font should work.

Modify the %appdata%\ggoled_app.toml file and add:

[font]
path = 'C:\Path\To\Font.ttf'
size = 16.0

Then restart the application.

About

Put graphics on your SteelSeries Arctis Nova Pro Base Station 128x64 OLED screen

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published