Skip to content

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

License

Notifications You must be signed in to change notification settings

0z-zy/OLED_Customizer

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.


☕ Support the Project

If you find OLED Customizer useful and want to support its development, you can buy me a coffee!

Buy Me A Coffee


📋 Table of Contents


🚀 Key Highlights

🎵 Dynamic Media Dashboard

  • Spotify & YouTube Support: Real-time integration with Spotify (via API) and Browser 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.
  • 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 PAUSE to mute your system mic and see status update instantly.

Volume Demo


🛠️ 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.
  • 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.

🌐 Browser Sync Installation

To get high-precision data from YouTube and other web players:

  1. Open your browser's Extensions page.
  2. Enable Developer mode.
  3. Click Load unpacked and select the extension folder from this repo.

Note

Browser Sync bypasses Windows SMTC limitations, providing accurate progress bars for YouTube videos.


🎨 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

📚 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

License

Stars

Watchers

Forks

Packages

No packages published