Skip to content

Repository files navigation

🎹 OLED Customizer

The ultimate music and system dashboard for your SteelSeries Keyboard.

Version License Platform

OLED Customizer transforms your keyboard's small screen into a powerful, high-contrast information hub. Whether it's tracking your rhythm on Spotify/YouTube or monitoring your PC's vitals during a gaming session, OLED Customizer does it with style and zero flicker.


📋 Table of Contents


🚀 Key Highlights

🎵 Dynamic Media Dashboard

  • Spotify & YouTube Support: Real-time integration with Spotify (via API) and Windows media (via SMTC).
  • Intelligent Switching: Seamlessly transitions between music info and the clock.
  • Pixel-Perfect Icons: Custom YouTube and Media icons designed specifically for the 128x40 display.
Spotify YouTube Generic Media
Spotify YouTube Generic

🌡️ Ghost-Monitor (Hardware Stats)

  • Instant Peek: Tap INS (Insert) to summon your system stats over any screen.
  • Thermal Guard: High-accuracy monitoring for CPU & GPU (Usage & Temps).
  • Memory Tracking: See exactly how much RAM you have left at a glance.
  • 🎮 Game FPS: Live FPS counter when a game is running (requires Admin).
  • GPU Selection: Choose which GPU to monitor in settings.
  • Custom Art: Unique 12x12 pixel art icons for a premium look.

HW Monitor Demo

🔊 Reimagined Volume Control

  • Adaptive Icons: Visual feedback changes with your volume level.
  • Discord Sync: A microphone icon appears automatically when you're in Discord.
  • Global Mute: Press your mute hotkey to toggle mic — supports keyboard keys and mouse side buttons (Mouse 4/5).
  • Nuclear Mute: If Windows can't find a default mic, it mutes all active capture devices at once.
  • Dual Hotkeys: Set a primary and optional secondary mute key in settings.

Volume Demo

🖩 Calculator

  • Quick Access: Hold Ctrl + Insert to toggle a calculator overlay on your OLED.
  • Numpad Input: Type with your numpad — keys are captured so games don't see them.
  • Parentheses: Full support for ( and ) on any keyboard layout.

⌨️ Hotkeys

Action Default Key Notes
Show System Stats Insert Quick peek at CPU/GPU/RAM
Mute Microphone (Primary) Pause Supports keyboard & mouse buttons
Mute Microphone (Optional) Not set Bind a second key in settings
Toggle Calculator Ctrl + Insert Numpad input, Esc to close

All hotkeys work globally — even inside fullscreen games.


🎨 Advanced Customization

Access %APPDATA%/OLED Customizer/config.json or use the Settings GUI to adjust:

  • Clock Designs: Analog, Big Timer, Date Focused, and more.
  • Scrollbar Margin: Adjusts the horizontal width and padding.
  • Text Indentation: Shifts titles to avoid overlapping app icons.

🕰️ Clock Gallery

Style Preview
Standard Standard
Analog Analog
Big Timer Big
Date Focused Date

🛠️ Quick Setup

Important

Admin Access Required: The application must be run as Administrator to read hardware sensors (CPU/GPU temperatures).

1. Requirements

  • SteelSeries GG: Ensure Engine 3 or GG is running (can auto-launch via settings).
  • Windows 10/11: Fully optimized for modern Windows environments.
  • Spotify Account: Only needed if you want Spotify-specific features.

2. Getting Started

  1. Download the latest OLED-Customizer.exe from Releases.
  2. Run the application (it will sit quietly in your System Tray).
  3. Right-Click the Tray Icon to access settings.

🎵 Spotify API Setup

To sync with Spotify, you need to create a free application on the Spotify Developer portal.

Tip

This only takes 2 minutes and is much more stable than standard Windows media detection.

Step 1: Create Your App

  1. Visit the Spotify Developer Dashboard.
  2. Click "Create app" and use these settings:
    • Redirect URIs: http://127.0.0.1:2408/callback
    • API/SDK: Select "Web API".

Step 2: Configure Credentials

  1. Copy your Client ID and Client Secret.
  2. In the OLED Customizer Settings:
    • Enable "Spotify Integration".
    • Paste your credentials and set the port to 2408.
  3. Click SAVE and restart the app.

📚 Acknowledgments

OLED Customizer is a highly evolved rebrand, inspired by the foundations of SteelSeries-Spotify-Linker.

  • Backend: GameSense™ SDK
  • Sensors: LibreHardwareMonitor
  • UI: Hand-crafted 128x40 iconography

Crafted for enthusiasts. Rebranded and Enhanced by 0z-zy.

About

     The ultimate music and system dashboard for SteelSeries OLED Keyboards.                                                                          Featuring Spotify/YouTube sync, a high-precision browser extension, and real-time hardware monitoring.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages