OmenCore

A modern, lightweight, and fully independent control center for HP OMEN & Victus gaming laptops.

OmenCore is a complete replacement for HP OMEN Gaming Hub - no OGH services required, no bloatware, no telemetry, no ads. Built with WPF on .NET 8, it provides professional-grade hardware control using native WMI BIOS commands that work directly with your laptop's firmware.

🎯 Key Differentiators:

✅ 100% OGH-Independent - Works without OMEN Gaming Hub installed
✅ No Bloatware - Single 70MB self-contained executable
✅ No Telemetry - Your data stays on your machine
✅ No Ads - Clean, focused interface
✅ No Sign-In Required - Full offline operation
🐧 Cross-Platform - Windows GUI + Linux CLI & Avalonia GUI

🆕 What's New in v2.0.1-beta

🐧 Linux Support (Experimental)

Cross-Platform Avalonia GUI

Full fan control with visual curve editor
Temperature monitoring via hwmon/EC
Performance profiles (Quiet/Balanced/Performance)
Keyboard RGB color and brightness control
Native look with dark/light theme support
Battery-aware fan profiles - auto-quiet when on battery

Linux CLI (`omencore-cli`)

# Fan control
omencore-cli fan --profile auto|silent|gaming|max
omencore-cli fan --speed 80
omencore-cli fan --battery-aware    # Auto-adjust for power source

# Battery management
omencore-cli battery status
omencore-cli battery profile quiet  # Set battery-specific profile
omencore-cli battery threshold 80   # Stop charging at 80%

# Keyboard RGB
omencore-cli keyboard --color FF0000 --brightness 100

# System monitoring
omencore-cli status --json
omencore-cli monitor --interval 500

# Background daemon
omencore-cli daemon --start

Supported Distros

Ubuntu 22.04/24.04 LTS
Fedora 38+
Arch Linux (AUR coming soon)
Pop!_OS 22.04+

Requirements: ec_sys kernel module with write_support=1

🗑️ Bloatware Manager

New comprehensive bloatware management:

AppX Package Scanner - Detects HP, Xbox, social media bloatware
Win32 App Detection - Registry-based installed program scanning
Startup Item Manager - Control what runs at boot
Scheduled Task Cleaner - Find and disable telemetry tasks
Risk Assessment - Low/Medium/High indicators for safe removal
Restore Function - Can restore previously removed AppX packages

🎨 UI/UX Polish

Fixed duplicate converter warnings in BoolToVisibilityConverter
Enabled deferred scrolling for smoother fan curve dragging
Fixed async void issues - Proper exception handling for commands
Vector-based icons - Replaced emoji with scalable geometries
Improved text contrast - Better readability in dark theme
Accessibility improvements - AutomationProperties for screen readers
Keyboard shortcuts - Ctrl+1-6 for tab navigation

🆕 What's New in v2.0.0 (Beta)

🎛️ System Optimizer

Complete Windows gaming optimization suite:

Power: Ultimate Performance plan, GPU scheduling, Game Mode, foreground priority
Services: Telemetry, SysMain/Superfetch, Search Indexing, DiagTrack toggles
Network: TCP NoDelay, ACK frequency, Nagle algorithm, P2P updates
Input: Mouse acceleration, Game DVR, Game Bar, fullscreen optimizations
Visual: Transparency, animations, shadows, performance presets
Storage: TRIM, last access timestamps, 8.3 names, SSD detection
Safety: Registry backup and system restore point creation before changes
Risk indicators (Low/Medium/High) for each optimization

🌈 RGB Provider Framework

Multi-brand peripheral control without vendor software:

Corsair Direct HID - K70/K95/K100 keyboards, Dark Core RGB PRO mouse (0x1BF0), HS70 headset
20+ Corsair mice supported - Full color and DPI control via direct HID
Logitech G HUB - Brightness and breathing effects (color:#RRGGBB@<brightness>)
Razer Chroma SDK - Static, Breathing, Spectrum, Wave, Reactive, Custom effects
"Apply to System" - Sync colors across all connected RGB devices

🐧 Linux CLI (Experimental)

Cross-platform support via command-line:

omencore-cli fan --mode auto|max|custom
omencore-cli keyboard --color #RRGGBB --brightness 0-100
omencore-cli status - Display all hardware info
EC register access via /sys/kernel/debug/ec/ec0/io

🔧 Architecture Improvements

Out-of-process hardware worker - NVML crashes no longer crash the main app
Self-contained deployment - .NET runtime embedded in both executables
Log rotation - Auto-cleanup of old log files (>1MB or >7 days)

🐞 Bug Fixes (Latest)

Corsair Dark Core RGB PRO - Fixed color control for PID 0x1BF0
Duplicate UI elements - Removed 9x repeated "Apply Colors on Startup" toggle
Fan preset restoration - Fixed settings not applying after reboot
System tray crashes - Fixed context menu and icon update issues
Auto-start --minimized - Command line args now properly processed

See CHANGELOG_v2.0.0.md for full details.

🆕 What's New in v1.5.0 (Beta)

⚡ Major Features (v1.5.0-beta1)

🖥️ OSD Performance Overlay

In-game overlay showing CPU/GPU temps, usage, FPS, and fan speeds
Customizable position (corners) and metrics display
Toggle via hotkey or system tray
Works alongside other overlays (MSI Afterburner, etc.)

⌨️ OMEN Key Interception

Custom actions when pressing the OMEN key
Options: Open OmenCore, Toggle OSD, Show System Info, or Custom Command
No more accidentally launching OMEN Gaming Hub

🎨 RGB Keyboard Persistence

Colors survive restarts - No more resetting to white after reboot
Settings saved to config and reapplied on startup
Per-zone colors maintained across sessions

🔄 Closed-Loop Fan Verification

RPM readback confirms fan commands actually applied
Automatic retry if BIOS rejected the command
Visual indicator shows verification status

✨ HP Spectre Dynamic Branding

App detects HP Spectre laptops and adjusts branding
"OMEN" references become "HP Spectre" where appropriate
Spectre-specific feature availability messaging

🛡️ Safety Improvements

Thermal protection properly returns fans to BIOS auto control
Max cooling no longer forces GPU to max power (counterproductive)
Better WinRing0 removal - PawnIO preferred for driver operations

🔧 Bug Fixes (v1.5.0-beta2)

Auto-update file locking - Fixed "file in use" errors with retry logic
AC/Battery crash - Fixed crash when unplugging power adapter
AC status indicator - Now updates live when plugging/unplugging
CPU overhead option - Low overhead mode now properly hides charts
S0 Modern Standby - Fans no longer rev during standby/sleep
Preset swap delay - 50-100% faster transitions between presets
Installer text - Fixed truncated welcome screen
Window focus - Reliable focus when restoring from tray

💻 HP Spectre Support (beta2)

Spectre-specific messaging - Clear guidance about power limit limitations
Helpful suggestions - Recommends Intel XTU or ThrottleStop for CPU power control
What works on Spectre: Fan control, monitoring, power plans, presets
What doesn't: Direct CPU/GPU power limits (EC registers differ from OMEN)

✨ Tester Feedback

"Fan hysteresis seems to be improved, it is much more smoother than 1.4"

See CHANGELOG_v1.5.0-beta.md and CHANGELOG_v1.5.0-beta2.md for full details.

🆕 What's New in v1.4.0

🗑️ HP Bloatware Removal Tool

One-click scanner detects HP pre-installed bloatware (AD2F1837.HP* packages)
Safe removal with confirmation dialog and warnings
Preserves HP Support Assistant for driver updates
Located in Settings tab → HP Bloatware Removal

⚡ Performance Optimizations

WMI query caching - 80% reduction in WMI calls, faster startup
Adaptive process polling - 2s when gaming, 10s when idle (saves battery)
Fan curve fix - Auto mode now properly applies software fan curves

🎨 RGB Keyboard Improvements

Success rate telemetry - Tracks WMI vs EC success rates
Desktop PC support - OMEN 25L/30L/40L/45L models
ColorTable format fix - Proper 128-byte structure for color data

🛡️ Stability & Safety

Fan curve validation - Prevents invalid curves (min 2 points, proper temp coverage)
Command exception handling - Graceful error dialogs instead of crashes
XTU detection fix - Properly checks Windows services, not just processes

🖱️ Corsair Device Detection

WirelessDongle type for USB receivers
Dark Core RGB PRO - Fixed mouse vs receiver detection
Better logging with device type icons

See CHANGELOG_v1.4.0.md for full details.

🆕 What's New in v1.2

📈 Visual Fan Curve Editor

Interactive drag-and-drop editor - Visual graph with temperature (X) and fan speed % (Y)
Drag points to adjust, click to add, right-click to remove
Live current temperature indicator with color-coded gradient
Save custom curves as named presets

🔋 Power Automation (AC/Battery Switching)

Automatic profile switching based on power source
Configure separate presets for AC and battery
Instant switching when plugging/unplugging

🌡️ Dynamic Tray Icon

Temperature display with color-coded background
🟢 Green (<60°C) | 🟡 Yellow (60-75°C) | 🔴 Red (>75°C)
See thermal state at a glance without opening app

⚠️ Throttling Detection

Real-time throttling indicator in dashboard header
Detects CPU/GPU thermal and power throttling
Warning badge shows specific throttling reasons

🖥️ Display Control

Quick refresh rate toggle from tray menu (165Hz ↔ 60Hz)
Turn Off Display - screen off while system runs (for downloads, music)

📌 Quality of Life

Stay on Top - keep window always visible
Single instance enforcement - prevents multiple copies
Fan countdown extension - auto re-applies settings every 90s to prevent BIOS reset
External undervolt detection - warns about XTU/ThrottleStop conflicts

🛡️ Extended AMD Support

Hawk Point CPUs - Ryzen 9 8940HX, 8940H, Ryzen 7 8845H, 8840H
AMD hybrid GPU detection - Radeon 610M/680M/780M + NVIDIA systems
Generic H-series - All mobile Ryzen H/HX processors

🐛 v1.2.1 Hotfixes

Fixed fan stuck on Max speed after profile change
Fixed preset name TextBox not accepting input
Improved shutdown stability and reduced log spam

See CHANGELOG_v1.2.0.md and CHANGELOG_v1.2.1.md for full details.

🔧 Core Features

🌡️ Thermal & Fan Management

Custom fan curves with temperature breakpoints (e.g., 40°C→30%, 60°C→55%, 80°C→85%)
WMI BIOS control - No driver required! Works on AMD and Intel laptops
EC-backed presets (Max, Auto, Manual) for instant fan control
Real-time monitoring with live CPU/GPU temperature charts
Per-fan telemetry displays RPM and duty cycle for each cooling zone
System tray badge overlays live CPU temperature on the notification icon
CPU Temperature Limit - Set max CPU temp via TCC offset (Intel only)

⚡ Performance Control

CPU undervolting via Intel MSR with separate core/cache offset sliders (typical: -100mV to -150mV)
Performance modes (Balanced, Performance, Turbo) manage CPU/GPU wattage envelopes
GPU Power Boost - +15W Dynamic Boost control like Omen Gaming Hub
GPU mux switching between Hybrid, Discrete (dGPU), and Integrated (iGPU) modes
External tool detection - respects ThrottleStop/Intel XTU and defers control when detected

💡 RGB Lighting

Keyboard lighting profiles with effects: Static, Breathing, Wave, Reactive (multi-zone support)
4-zone OMEN keyboards with per-zone color and intensity control
Peripheral sync - apply laptop themes to Corsair/Logitech devices
Profile preview with live color swatches before applying

🖱️ Peripheral Integration

Corsair iCUE devices - lighting presets, DPI stages, macro profiles
- Direct HID access (no iCUE required) - Dark Core RGB PRO, HS70 PRO, Scimitar, M65, K70, etc.
Logitech G HUB devices - static color control, DPI readout, battery status
- Hardware detection ready, SDK stub implementation
Razer Chroma devices - preliminary support (v1.5+)
- Detects Razer Synapse, basic color control UI
- Full Chroma SDK integration planned for v1.6
Device discovery via USB HID enumeration with connection status

📊 Hardware Monitoring

Real-time telemetry - CPU/GPU temp, load, clock speeds, RAM, SSD temp
History charts with 60-sample rolling window and smart change detection (0.5° threshold reduces UI updates)
Low overhead mode disables charts to reduce CPU usage from ~2% to <0.5%
Detailed metrics - per-core clocks, VRAM usage, disk activity

🧹 System Optimization

HP OMEN Gaming Hub removal - guided cleanup with dry-run mode
- Removes Store packages (AD2F1837.*, HPInc.HPGamingHub)
- Cleans registry keys, scheduled tasks, startup entries
- Deletes residual files from Program Files and AppData
- Creates system restore point before destructive operations
Gaming Mode - one-click optimization (disables animations, toggles services)
Service management - control Windows Game Bar, Xbox services, telemetry

🔄 Auto-Update

In-app update checker polls GitHub releases every 6 hours
SHA256 verification required for security (updates rejected without hash)
One-click install with download progress and integrity validation
Manual fallback if automated install blocked (hash missing)

🎯 HP Gaming Hub Feature Parity

OmenCore is designed to completely replace OMEN Gaming Hub. You can safely uninstall OGH.

HP Gaming Hub Feature	OmenCore Status	Notes
Fan Control	✅ Full support	Custom curves + WMI BIOS presets (no OGH needed)
Performance Modes	✅ Full support	CPU/GPU power limits via WMI
CPU Undervolting	✅ Full support	Intel MSR access with safety
GPU Power Boost	✅ Full support	+15W Dynamic Boost (PPAB)
Keyboard RGB	✅ Profiles	Per-zone control with effects
Hardware Monitoring	✅ Full support	LibreHardwareMonitor integration
Gaming Mode	✅ Service toggles	One-click optimization
Battery Care	✅ Full support	80% charge limit
Peripheral Control	⚠️ Beta (stub)	Hardware detection ready
Hub Cleanup	✅ Exclusive	Safe Gaming Hub removal
Per-Game Profiles	✅ Full support	Auto-switch on game detect
In-Game Overlay	✅ Full support	Click-through OSD
Network Booster	❌ Out of scope	Use router/Windows QoS
Game Library	❌ Out of scope	Use Steam/Epic/Xbox app
Omen Oasis	❌ Out of scope	Cloud gaming elsewhere

Verdict: OmenCore covers 100% of essential Gaming Hub features with better performance, no telemetry, no ads, and complete offline operation.

📋 Requirements

System

OS: Windows 10 (build 19041+) or Windows 11
Runtime: Self-contained (.NET 8 embedded) - no separate installation needed
Privileges: Administrator for WMI BIOS/EC/MSR operations
Disk: 100 MB for app + 50 MB for logs/config
OGH: ❌ NOT REQUIRED - OmenCore works without OMEN Gaming Hub

Hardware

CPU: Intel 6th-gen+ (Skylake or newer) for undervolting/TCC offset; AMD Ryzen supported for monitoring/fan control
Laptop: HP OMEN 15/16/17 series and HP Victus (2019-2024 models)
- ✅ Tested: OMEN 15-dh, 16-b, 16-k, 17-ck (2023), Victus 15/16
- ✅ OMEN Transcend 14/16: Supported via WMI BIOS
- ✅ 2023+ models: Full WMI BIOS support, no OGH needed
Desktop: HP OMEN 25L/30L/40L/45L (limited support)
- ⚠️ Desktop PCs use different EC registers - fan control may not work
- Monitoring, game profiles, and OGH cleanup still functional
- Auto-detected via chassis type with warning message

Fan Control Methods (Priority Order)

WMI BIOS (default) - No driver needed, works on all OMEN laptops
EC Direct via PawnIO - For advanced EC access (Secure Boot compatible)
EC Direct via WinRing0 - Legacy driver (may need Secure Boot disabled)
OGH Proxy - Last resort fallback only if WMI fails (rare)

Optional Drivers

PawnIO (recommended for advanced features) - Secure Boot compatible EC access
WinRing0 v1.2 - Legacy kernel driver for EC/MSR access (may be blocked by Secure Boot)

⚠️ Windows Defender False Positive: WinRing0 is flagged as HackTool:Win64/WinRing0 by antivirus. This is a known false positive for kernel hardware drivers. Add exclusion for C:\Windows\System32\drivers\WinRing0x64.sys and verify signature. See WINRING0_SETUP.md.

Compatibility Notes:

HP Spectre laptops: Partial support - fan control and monitoring work, but CPU/GPU power limits unavailable (different EC layout). Use Intel XTU or ThrottleStop for power control.
Non-OMEN HP laptops: Partial (monitoring yes, fan/RGB no due to different EC layout)
Other brands: Not supported (EC registers are vendor-specific)
Virtual machines: Monitoring-only mode (no hardware access)

🚀 Installation

Windows

Option 1: Installer (Recommended)

Download OmenCoreSetup-2.0.1-beta.exe from Releases
Run installer as Administrator
(Optional) Select "Install PawnIO driver" for advanced EC features
Launch OmenCore from Start Menu or Desktop
(Optional) Use OGH Cleanup in Settings to remove OMEN Gaming Hub
(Optional) Use HP Bloatware Removal to clean pre-installed apps

Option 2: Portable ZIP

Download OmenCore-2.0.1-beta-win-x64.zip from Releases
Extract to C:\OmenCore (or preferred location)
Right-click OmenCore.exe → Run as Administrator

🐧 Linux

Prerequisites

# Enable EC write access (required for fan control)
sudo modprobe ec_sys write_support=1

# Make it permanent (add to /etc/modules-load.d/)
echo "ec_sys" | sudo tee /etc/modules-load.d/ec_sys.conf
echo "options ec_sys write_support=1" | sudo tee /etc/modprobe.d/ec_sys.conf

Option 1: CLI Only (Recommended)

# Download and extract
wget https://github.com/theantipopau/omencore/releases/download/v2.0.1-beta/OmenCore-2.0.1-beta-linux-x64.zip
unzip OmenCore-2.0.1-beta-linux-x64.zip

# Install
sudo cp omencore-cli /usr/local/bin/
sudo chmod +x /usr/local/bin/omencore-cli

# Test
omencore-cli status

Option 2: systemd Daemon (Background Service)

# Install the CLI first (see above), then:
sudo omencore-cli daemon --install   # Creates systemd service
sudo systemctl enable omencore       # Start on boot
sudo systemctl start omencore        # Start now

# Manage
sudo systemctl status omencore       # Check status
sudo systemctl stop omencore         # Stop service
journalctl -u omencore -f            # View logs

Configuration (Linux)

Config file: /etc/omencore/config.toml (daemon) or ~/.config/omencore/config.toml (user)
Generate default config: omencore-cli daemon --generate-config > config.toml

Linux Notes

Requires root/sudo for EC access
Fan control uses /sys/kernel/debug/ec/ec0/io
Temperature reading via hwmon/sysfs
Tested on Ubuntu 22.04+, Fedora 38+, Arch Linux

First Launch (Windows)

OmenCore auto-detects your model and selects the best fan control method
WMI BIOS is used by default (no drivers needed for basic fan control)
Config saved to %APPDATA%\OmenCore\config.json
Logs written to %LOCALAPPDATA%\OmenCore\OmenCore_<timestamp>.log

Uninstalling OMEN Gaming Hub

OmenCore includes a built-in OGH Cleanup tool (Settings tab):

Creates a System Restore point (safety)
Removes HP Gaming Hub Store packages
Cleans registry entries and scheduled tasks
Deletes residual files from Program Files/AppData

After cleanup, OmenCore provides full fan control without OGH.

⚠️ Antivirus False Positives

Windows Defender and other antivirus software may flag OmenCore as suspicious. This is a false positive caused by:

Kernel drivers (PawnIO, WinRing0) required for hardware access
Low-level hardware control similar to how some malware operates

OmenCore is safe and fully open-source. To whitelist:

Windows Defender: Settings → Virus & threat protection → Exclusions → Add C:\Program Files\OmenCore
Windows SmartScreen: Click "More info" → "Run anyway" (installer is not EV code-signed)

See ANTIVIRUS_FAQ.md for detailed instructions for all antivirus programs.

🏗️ Architecture

Technology Stack:

.NET 8.0 (Windows 10.0.19041.0+) with nullable reference types
WPF with hardware-accelerated rendering
LibreHardwareMonitor for sensor polling (WinRing0 kernel driver)
EC Direct Access for fan/LED control via Embedded Controller
Intel MSR for CPU undervolting (Model-Specific Registers)

Project Structure:

OmenCore/
├── src/OmenCoreApp/
│   ├── ViewModels/          # MVVM pattern with sub-ViewModels
│   │   ├── MainViewModel.cs       (Main window, DI hub)
│   │   ├── FanControlViewModel    (Fan curves + presets)
│   │   ├── DashboardViewModel     (Telemetry aggregation)
│   │   └── SystemControlViewModel (Perf + undervolt + cleanup)
│   ├── Services/            # Business logic
│   │   ├── FanService             (EC writes, curve application)
│   │   ├── UndervoltService       (MSR writes, probe loop)
│   │   ├── HardwareMonitoringService (telemetry + change detect)
│   │   ├── AutoUpdateService      (GitHub API, SHA256 verify)
│   │   └── CorsairDeviceService   (iCUE SDK abstraction)
│   ├── Hardware/            # Low-level drivers
│   │   ├── WinRing0EcAccess       (EC I/O with safety allowlist)
│   │   ├── LibreHardwareMonitorImpl (sensor bridge)
│   │   └── IntelUndervoltProvider (MSR 0x150 writes)
│   ├── Views/               # UI layer
│   │   ├── MainWindow.xaml        (Tab host, 1000+ lines)
│   │   ├── FanControlView.xaml    (Fan UI)
│   │   └── DashboardView.xaml     (Telemetry cards)
│   ├── Controls/            # Custom WPF controls
│   │   ├── ThermalChart.xaml      (Temperature line chart)
│   │   └── LoadChart.xaml         (CPU/GPU load chart)
│   └── Utils/
│       ├── TrayIconService        (32px badge renderer)
│       └── LoggingService         (Async file writer)
├── installer/
│   └── OmenCoreInstaller.iss (Inno Setup script)
├── config/
│   └── default_config.json   (Preset definitions)
├── docs/
│   ├── CHANGELOG.md
│   ├── UPDATE_SUMMARY_2025-12-10.md
│   └── WINRING0_SETUP.md
└── VERSION.txt              (Semantic version)

Design Principles:

Safety First: EC write allowlist blocks dangerous registers (battery, VRM, charger)
Async by Default: All I/O uses async/await for UI responsiveness
Change Detection: UI updates only when telemetry changes >0.5° or >0.5%
Graceful Degradation: Services fail independently (no driver? disable fan control only)
Testability: Unit tests for hardware access, services, and ViewModels

🛠️ Development

Build Requirements

Visual Studio 2022 (Community/Professional/Enterprise)
- Workload: .NET Desktop Development
- Optional: C++ Desktop Development (for driver projects)
.NET 8 SDK - Download
Inno Setup (for installer) - Download

Build from Source

# Clone repository
git clone https://github.com/theantipopau/omencore.git
cd omencore

# Restore NuGet packages
dotnet restore OmenCore.sln

# Build Debug (for development)
dotnet build OmenCore.sln --configuration Debug

# Build Release (for distribution)
dotnet build OmenCore.sln --configuration Release

# Run from Visual Studio (F5) or command line
cd src\OmenCoreApp\bin\Release\net8.0-windows10.0.19041.0
.\OmenCore.exe

⚠️ Must run as Administrator for EC/MSR/driver access.

Build Installer

# Requires Inno Setup installed and 'iscc' on PATH
pwsh ./build-installer.ps1 -Configuration Release -Runtime win-x64 -SingleFile

# Outputs:
# - artifacts/OmenCore-1.0.0.7-win-x64.zip
# - artifacts/OmenCoreSetup-1.0.0.7.exe

Run Tests

# Run all unit tests
dotnet test OmenCore.sln

# Run tests with coverage
dotnet test OmenCore.sln --collect:"XPlat Code Coverage"

# Test specific project
dotnet test src/OmenCoreApp.Tests/OmenCoreApp.Tests.csproj

📦 Release Process

Update version in VERSION.txt:

1.0.0.7

Create changelog entry in CHANGELOG.md:

## [1.0.0.7] - 2025-12-11
### Added
- New feature description
### Fixed
- Bug fix description

Commit and tag:

git add VERSION.txt CHANGELOG.md
git commit -m "Bump version to 1.0.0.7"
git tag v1.0.0.7
git push origin main
git push origin v1.0.0.7

GitHub Actions automatically:
- Builds Release configuration
- Runs tests
- Creates ZIP and installer
- Publishes to GitHub Releases

Manual release notes (required for auto-updater):

## What's New
- Feature 1
- Feature 2

## Bug Fixes
- Fixed issue 1
- Fixed issue 2

SHA256: 54323D1F2F92086988A95EA7BD3D85CFDCC2F2F9348DA294443C7B6EB8AB6B23

**⚠️ Include SHA256 hash** or in-app updater will require manual download.

---

## ⚙️ Configuration

### Config File Location
- **User config**: `%APPDATA%\OmenCore\config.json`
- **Default template**: `config/default_config.json` (in installation folder)
- **Open folder**: Click "Open Config Folder" in Settings tab

### Key Configuration Sections

**EC Device Path** (Hardware Access):
```json
{
"ecDevicePath": "\\\\.\\WinRing0_1_2",
"ecFanRegisterMap": {
 "fan1DutyCycle": 68,    // 0x44
 "fan2DutyCycle": 69,    // 0x45
 "fanMode": 70           // 0x46
}
}

Fan Presets:

{
  "fanPresets": [
    {
      "name": "Quiet",
      "curve": [
        { "temperatureC": 40, "fanPercent": 25 },
        { "temperatureC": 60, "fanPercent": 40 },
        { "temperatureC": 80, "fanPercent": 65 }
      ]
    }
  ]
}

Performance Modes:

{
  "performanceModes": [
    {
      "name": "Balanced",
      "cpuPowerLimitWatts": 45,
      "gpuPowerLimitWatts": 80,
      "windowsPowerPlanGuid": "381b4222-f694-41f0-9685-ff5bb260df2e"
    }
  ]
}

Lighting Profiles:

{
  "lightingProfiles": [
    {
      "name": "Red Wave",
      "effect": "Wave",
      "primaryColor": "#FF0000",
      "secondaryColor": "#8B0000",
      "zones": [
        { "id": "WASD", "color": "#FF0000", "brightness": 100 }
      ]
    }
  ]
}

Reload Configuration

Click "Reload Config" in Settings tab
Or restart OmenCore
Changes take effect immediately (no restart needed for most settings)

🔧 Advanced Usage

EC Register Customization

If your HP OMEN model uses different EC registers:

Use RWEverything or similar tool to dump EC
Locate fan duty cycle registers (usually 0x44-0x46 range)
Update ecFanRegisterMap in config.json
Test on sacrificial hardware first!

Safety allowlist in WinRing0EcAccess.cs blocks writes to:

Battery charger (0xFF range)
VRM control (0x10-0x20 range)
Unknown registers

Custom Fan Curves

Create advanced curves in config.json:

{
  "name": "Gaming",
  "curve": [
    { "temperatureC": 30, "fanPercent": 20 },
    { "temperatureC": 50, "fanPercent": 35 },
    { "temperatureC": 65, "fanPercent": 55 },
    { "temperatureC": 75, "fanPercent": 75 },
    { "temperatureC": 85, "fanPercent": 95 },
    { "temperatureC": 95, "fanPercent": 100 }
  ]
}

Undervolt Tuning

⚠️ Start conservative, test with stress tests (Prime95, OCCT)

Start with -50mV core / -50mV cache
Run stress test for 30 minutes
If stable, decrease by -10mV
Repeat until unstable, then back off +10mV
Typical safe range: -80mV to -125mV (varies per CPU)

Signs of instability:

Blue screen (CLOCK_WATCHDOG_TIMEOUT)
Immediate reboot
Application crashes
Throttling to 800 MHz

🐛 Troubleshooting

"WinRing0 driver not detected"

Cause: Kernel driver not installed or failed to load

Solutions:

Run installer with "Install WinRing0" task selected
OR install LibreHardwareMonitor and run once
Check for driver conflicts (AI Suite, other hardware tools)
Disable Secure Boot if driver won't load
Verify driver: Get-Service WinRing0_1_2_0 in PowerShell

"Access Denied" errors

Cause: OmenCore not running as Administrator

Solution: Right-click OmenCore.exe → "Run as administrator"

Fan control not working

Possible causes:

WinRing0 driver not loaded
Incorrect EC register addresses for your model
BIOS fan control override enabled
Conflicting software (HP Command Center, other fan tools)

Debug steps:

Check logs in %LOCALAPPDATA%\OmenCore\
Verify EC device opens: Look for "EC bridge ready" in logs
Try Max preset (simplest test)
Check BIOS settings for fan control options

Undervolting doesn't work

Possible causes:

CPU doesn't support undervolting (10th-gen+ may have locked MSR)
BIOS setting "Undervolting Lock" enabled
ThrottleStop/Intel XTU conflicting
Wrong CPU architecture (AMD not supported)

Solutions:

Check BIOS for "Overclocking" or "Undervolting" settings
Exit other undervolting tools
Try Intel XTU to verify MSR accessibility
Some laptops have undervolting permanently locked

Auto-update fails

Cause: Missing SHA256 hash in release notes

Solution: Download manually from Releases page

High CPU usage

Cause: Monitoring polling too aggressive

Solutions:

Enable "Low Overhead Mode" in Dashboard tab
Increase polling interval in config.json:
```
{ "pollIntervalMs": 2000 }
```
Disable history charts if not needed

📚 Documentation

CHANGELOG.md - Version history and release notes
UPDATE_SUMMARY_2025-12-10.md - Detailed v1.0.0.4 changes
WINRING0_SETUP.md - Driver installation and antivirus exclusions
SDK_INTEGRATION_GUIDE.md - Corsair/Logitech SDK integration
PERFORMANCE_GUIDE.md - Undervolting and performance tuning

🤝 Contributing

Contributions welcome! Please read our Contributing Guidelines first.

Areas needing help:

Corsair iCUE SDK integration (replace stub)
Logitech G HUB SDK integration (replace stub)
Per-game profile switching
In-game overlay (FPS/temps)
EC register database for more OMEN models
Localization (translations)

Testing needed:

OMEN 15-en, 16-n, 17-ck models
Desktop OMEN 25L/30L/40L/45L
Windows 11 24H2

📄 License

This project is licensed under the MIT License - see LICENSE file for details.

Third-party components:

LibreHardwareMonitor - MPL 2.0
Hardcodet.NotifyIcon.Wpf - Code Project Open License
WinRing0 driver - OpenLibSys license

⚠️ Disclaimer

THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.

Modifying EC registers, undervolting, and mux switching can potentially damage hardware
Always test on non-production hardware first
Create system restore points before destructive operations
The developers are not responsible for any hardware damage, data loss, or warranty voids
HP does not endorse this project; use at your own risk

Recommended precautions:

Backup important data before first use
Monitor temperatures closely during initial testing
Start with conservative settings (lower undervolt, gentle fan curves)
Keep HP OMEN Gaming Hub installer for quick rollback if needed

🔗 Links

GitHub Repository: https://github.com/theantipopau/omencore
Latest Release: https://github.com/theantipopau/omencore/releases/latest
Issue Tracker: https://github.com/theantipopau/omencore/issues
Discussions: https://github.com/theantipopau/omencore/discussions
Discord Server: https://discord.gg/ahcUC2Un
Subreddit: https://reddit.com/r/omencore
Donate (PayPal): https://www.paypal.com/donate/?business=XH8CKYF8T7EBU&no_recurring=0&item_name=Thank+you+for+your+generous+donation%2C+this+will+allow+me+to+continue+developing+my+programs.&currency_code=AUD

💖 Support Development

If OmenCore has helped you get more out of your OMEN laptop, consider supporting development:

Your support helps cover development time and testing hardware. Thank you! 🙏

🙏 Acknowledgments

LibreHardwareMonitor team for sensor framework
RWEverything for EC exploration tools
ThrottleStop community for undervolting knowledge
HP OMEN laptop owners who tested early builds
Discord community for feedback and bug reports

Made with ❤️ for the HP OMEN community

Name		Name	Last commit message	Last commit date
Latest commit History 123 Commits
.github/workflows		.github/workflows
config		config
docs		docs
drivers		drivers
format-report		format-report
installer		installer
src		src
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
Omen.code-workspace		Omen.code-workspace
OmenCore.sln		OmenCore.sln
README.md		README.md
README_OLD.md		README_OLD.md
VERSION.txt		VERSION.txt
VIEWS_COMPLETE.md		VIEWS_COMPLETE.md
build-installer.ps1		build-installer.ps1
fix-omencore-issues.ps1		fix-omencore-issues.ps1
query		query
upload-to-github.bat		upload-to-github.bat
upload-to-github.sh		upload-to-github.sh

terratrax/omencore

Folders and files

Latest commit

History

Repository files navigation

OmenCore

🆕 What's New in v2.0.1-beta

🐧 Linux Support (Experimental)

Cross-Platform Avalonia GUI

Linux CLI (omencore-cli)

Supported Distros

🗑️ Bloatware Manager

🎨 UI/UX Polish

🆕 What's New in v2.0.0 (Beta)

🎛️ System Optimizer

🌈 RGB Provider Framework

🐧 Linux CLI (Experimental)

🔧 Architecture Improvements

🐞 Bug Fixes (Latest)

🆕 What's New in v1.5.0 (Beta)

⚡ Major Features (v1.5.0-beta1)

🖥️ OSD Performance Overlay

⌨️ OMEN Key Interception

🎨 RGB Keyboard Persistence

🔄 Closed-Loop Fan Verification

✨ HP Spectre Dynamic Branding

🛡️ Safety Improvements

🔧 Bug Fixes (v1.5.0-beta2)

💻 HP Spectre Support (beta2)

✨ Tester Feedback

🆕 What's New in v1.4.0

🗑️ HP Bloatware Removal Tool

⚡ Performance Optimizations

🎨 RGB Keyboard Improvements

🛡️ Stability & Safety

🖱️ Corsair Device Detection

🆕 What's New in v1.2

📈 Visual Fan Curve Editor

🔋 Power Automation (AC/Battery Switching)

🌡️ Dynamic Tray Icon

⚠️ Throttling Detection

🖥️ Display Control

📌 Quality of Life

🛡️ Extended AMD Support

🐛 v1.2.1 Hotfixes

🔧 Core Features

🌡️ Thermal & Fan Management

⚡ Performance Control

💡 RGB Lighting

🖱️ Peripheral Integration

📊 Hardware Monitoring

🧹 System Optimization

🔄 Auto-Update

🎯 HP Gaming Hub Feature Parity

📋 Requirements

System

Hardware

Fan Control Methods (Priority Order)

Optional Drivers

🚀 Installation

Windows

Option 1: Installer (Recommended)

Option 2: Portable ZIP

🐧 Linux

Prerequisites

Option 1: CLI Only (Recommended)

Option 2: systemd Daemon (Background Service)

Configuration (Linux)

Linux Notes

First Launch (Windows)

Uninstalling OMEN Gaming Hub

⚠️ Antivirus False Positives

🏗️ Architecture

🛠️ Development

Build Requirements

Build from Source

Build Installer

Run Tests

📦 Release Process

Reload Configuration

Linux CLI (`omencore-cli`)

Packages