Skip to content

README.md

Latest commit

 

History

History
200 lines (133 loc) · 8.16 KB

README.md

File metadata and controls

200 lines (133 loc) · 8.16 KB

DualSense Manager Icon DualSense Manager

Unofficial DualSense Manager for Windows
Advanced customization and control of your PS5 DualSense controller with real-time monitoring and custom profiles.

Platform License Build Status

Latest Release Pre-Release

Support me on Ko-fi

Program Screenshot

🧾 Overview

DualSense Manager is a comprehensive open-source management tool for the PlayStation 5 DualSense Controller on Windows. It delivers deep customization, real-time monitoring, and advanced virtual controller emulation capabilities to enhance your gaming experience. Built with modern .NET technology and a sleek Avalonia UI, it provides an intuitive interface for full control of your DualSense controller's features.

🎮 Supported Controllers

Controller Supported Notes
DualSense ✅ Full support with all features
DualSense (Revision 5) ✅ Full support with all features
NOTE: This revision has Player Lights (1+5) and (2+4) wired together, which may cause incorrect battery indicator display
DualSense Edge ⚠️ Limited support, works as standard DualSense
Edge-specific features not implemented due to lack of hardware

🌟 Features

🎨 Light Control

  • Full RGB lightbar control with presets and custom colors
  • Player LED control (1-5) with brightness options
  • Microphone LED configuration (off/on/pulse)
  • Quick light presets and reset functions

🕹️ Virtual Controller Emulation

  • Xbox 360 and DualShock 4 controller emulation using ViGEmBus
  • Advanced haptic feedback with custom rumble configuration
  • Adjustable trigger thresholds for adaptive responses
  • DS4 lightbar handling and management options

🔒 Controller Hiding

  • HidHide integration to hide physical controller from other applications
  • Advanced driver status monitoring and configuration

📁 Profile Management

  • Create, edit, and manage multiple controller profiles
  • Import/export profiles (JSON format)
  • Profile renaming and duplication
  • Assign profiles to specific controllers

⚡ Special Actions

  • Custom button combinations for special functions
  • Battery level indicators (via lightbar/LEDs)
  • Controller disconnection via button combos

📊 Real-time Monitoring

  • Monitor all controller inputs and states
  • View touchpad, motion sensor, and battery data
  • Track connection status and LED states

🎮 Device Management

  • Support for multiple DualSense controllers
  • Automatic MAC address-based identification
  • Connection type detection (USB/Bluetooth)

⚙️ Settings & Configuration

  • Theme selection and UI customization
  • Minimize to tray and start minimized options
  • Adjustable logging levels
  • Tray battery tracking

📚 Libraries Used

🖥️ User Interface

⚙️ Functionality

  • HidSharp — Cross-platform HID device access
  • NLog — Flexible and high-performance logging library
  • ViGEm.Client — Interaction with ViGEmBus Driver for Virtual Controller Emulation

🚀 Getting Started

Prerequisites

  • Windows 10 version 1909 or later (Windows 11 recommended)
  • .NET 9.0 Desktop Runtime or later Download here
  • PlayStation 5 DualSense controller (wired USB or Bluetooth connection)

Installation

  1. Download the latest release from the releases page
  2. Extract the archive to your preferred location and open DualSenseClient.exe
  3. Connect your DualSense controller and start customizing

Run as Administrator (right-click DualSenseClient.exe → "Run as administrator") for full functionality (required for HidHide integration only)

Quick Start

  1. Connect your DualSense controller to your PC (via USB or Bluetooth)
  2. Navigate to the Profile page to customize your settings
  3. Create and apply your first profile or adjust individual settings

🛠️ Troubleshooting

Common Issues

  • Controller not detected: Ensure you have the latest Sony DualSense firmware and try connecting via USB instead of Bluetooth
  • Virtual controller not working: Make sure ViGEmBus driver is installed
  • HidHide not functioning: Run the application as administrator and ensure HidHide service is properly installed
  • Missing .NET dependencies: Install the required .NET Desktop Runtime from Microsoft's website
  • Bluetooth connection issues: Restart the Bluetooth service or pair the controller again through Windows settings

Driver Installation

For virtual controller emulation to work properly, you may need to manually install these drivers:

  • ViGEmBus: Required for virtual Xbox 360/DualShock 4 controller emulation
  • HidHide: Required for hiding the physical controller from certain applications (Steam)

Both drivers require administrator privileges for installation and operation.

🙌 Credits

⚠️ Disclaimer

This project is not affiliated with or endorsed by Sony Interactive Entertainment. "PlayStation", "DualSense", and related marks are trademarks of their respective owners.

🛠️ Contributing

Pull requests are welcome! If you'd like to improve this tool or report bugs, feel free to open an issue or start a discussion.

To contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a pull request

📄 License

Released under the BSD-3 License.

Made with ❤️ for DualSense fans worldwide