OLED_Customizer

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

OLED_Customizer

★ 10 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎹 OLED Customizer

**The ultimate music and system dashboard for your SteelSeries Keyboard.**

![Version](https://img.shields.io/badge/version-1.7.0-blue?style=for-the-badge)
![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey?style=for-the-badge)

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](#-key-highlights)
- [⌨️ Hotkeys](#️-hotkeys)
- [🎨 Advanced Customization](#-advanced-customization)
- [🛠️ Quick Setup](#️-quick-setup)
- [🎵 Spotify API Setup](#-spotify-api-setup)
- [📚 Acknowledgments](#-acknowledgments)

---

## 🚀 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.

### 🌡️ 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](https://raw.githubusercontent.com/0z-zy/OLED_Customizer/main/content/demos/demo_hw_monitor.gif)

### 🔊 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](https://raw.githubusercontent.com/0z-zy/OLED_Customizer/main/content/demos/demo_volume.gif)

### 🖩 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

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

---

## 🛠️ 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](https://github.com/0z-zy/OLED_Customizer/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](https://developer.spotify.com/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](https://github.com/Firewee/SteelSeries-Spotify-Linker).

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

---

**Crafted for enthusiasts. Rebranded and Enhanced by [0z-zy](https://github.com/0z-zy).**

OLED_Customizer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README