Skip to content
 
 

Repository files navigation

Display Profile Manager

Platform .NET License: MIT + Commons Clause

A lightweight Windows desktop application for managing display profiles — save the desktop layout, monitor settings, current wallpaper, audio devices, and helper scripts. Then, switch between presets on demand!

Main Window


✨ Features

🖥️ Display Profiles

  • 🗂️ Unlimited display profiles — save, edit, and switch desktop presets
  • 📺 Full per-monitor control — configure enable/disable state, primary display, resolution, refresh rate, rotation, DPI, HDR/ACM, and color profile
  • 🪞 Flexible monitor layouts — extend or clone displays in any combination
  • 🛡️ Apply failure recovery — stop on display-configuration failure and safely roll back to the previous profile or a desktop snapshot
  • 🖼️ Custom profile icons — assign a .ico icon to profiles, displayed in profile lists and menus

🖼️ Wallpaper

  • 📷 Wallpaper capture and apply — save and restore Solid Color, per-monitor Pictures, Slideshow settings, and Windows Spotlight
  • 🎛️ Picture options — adjust wallpaper fitment and background color
  • ⚙️ Slideshow options — customize the source folder, interval, and shuffle/order
  • 🔎 Windows Spotlight — capture and restore Spotlight wallpaper state

🔊 Audio & Scripts

  • 🔊 Audio device switching — switch default playback and recording devices
  • 📜 Script execution — run .exe, .lnk, .ps1, .bat/.cmd, .vbs/.js, .py, or .ahk scripts, with configurable launch arguments

🎨 Themes

  • 🌗 Built-in themes — pick Light, Dark, and Black themes that follow the Windows accent color
  • 🖌️ Custom themes — import compatible .xaml theme files with their own colors and accents

🛠️ DPM Theme Builder — included standalone Python tool for generating compatible .xaml themes from the tinted-theming database

⚙️ Automation & Integration

  • ⌨️ Global hotkeys — assign a keyboard shortcut to any profile for quick switching
  • 📌 System tray — open the profile list from the taskbar to switch profiles
  • 🖱️ Desktop context menu — apply profiles directly from the desktop classic right-click menu
  • 💻 CLI support — automate profile switching and application control with scripts or external tools
  • 🔔 Optional update checking — check GitHub for newer releases; no direct downloads or installation, and off by default

🎮 DPM Shortcut Builder — included standalone Python tool for creating game/app launch shortcuts that switch display profiles before launch and restore a selected profile on exit, with guided launcher integration for Steam, Epic Games, GOG Galaxy, Heroic, and Playnite


🔗 Check Out


🚀 Installation

  • Installer — use the latest installer from the Releases page
  • Portable — extract the portable archive from the Releases page

Requirements

HDR support requires Windows 10 version 1709+
ACM support on supported displays requires Windows 11 22H2+
Dedicated HDR/ACM API support requires Windows 11 24H2+


📖 Documentation


📝 License

MIT + Commons Clause — see LICENSE for details. Third-party licenses: THIRD-PARTY-LICENSES.md.

🙏 Acknowledgments

🤝 Contributors

This Project

  • @vivittel (PR #1) — Partial HDR and advanced color state detection fixes

Upstream

Community

  • @Catriks (#1) — Requested audio device switching
  • @anodynos (#2) — Requested global hotkeys for profile switching
  • @xtrilla (#4) — Requested monitor enable/disable configuration
  • @ffgtthr (#2) — Requested custom profile icons

🛠️ Development

See AGENTS.md for architecture, display engine details, project structure, and development guidelines.

Prerequisites

  • Visual Studio 2022 or later
  • .NET 10 SDK
  • Desktop development with C++ workload for the shell extension

Building

git clone https://github.com/exytral/DisplayProfileManager.git
cd DisplayProfileManager
powershell -File dev-build.ps1

About

Quickly switch between custom display profiles. Configure display settings, desktop layout, and audio. Features system tray, hotkeys, CLI, and custom script & theme support. Built for multi-monitor, gaming, or content creator setups.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages