Display Reinitializer for Raycast
A Raycast extension to force re-detection and reinitialization of connected displays on macOS using multiple methods.
Features
- 📺 List all connected displays (built-in and external)
- 🔄 Multiple reinitialization methods to choose from
- 🎯 Smart auto-selection of best method per display
- 📊 Shows display resolution, type, refresh rate capability, and recommended method
- ⚡ Fast native Swift implementation using CoreGraphics APIs
- ⌨️ Assign global hotkeys to reinitialize specific displays via Quicklinks
Reinitialization Methods
The extension offers 5 different methods to reinitialize displays, each with different characteristics:
1. Auto-Select (Default) ⭐
- Automatically chooses the best method for each display
- Tries methods in order of effectiveness
- Recommended for most users
Selection logic:
- External displays → DDC Power Cycle
- Multiple refresh rates available → Refresh Rate Toggle
- Otherwise → Resolution Cycle
- Last resort → Soft Reset
2. DDC Power Cycle (Most Effective)
- Hardware-level power off/on via DDC/CI protocol
- External displays only (doesn't work on built-in screens)
- Requires
m1ddc tool: brew install m1ddc
- Disruption: Low (1-2 second black screen on target display)
3. Refresh Rate Toggle (Less Disruptive)
- Temporarily changes refresh rate then restores original
- Only available if display supports multiple refresh rates
- Disruption: Low (brief flicker)
4. Resolution Cycle (Most Compatible)
- Temporarily changes resolution then restores original
- Works on all displays (built-in and external)
- Disruption: Medium (visible screen flash, may briefly rearrange windows)
5. Soft Reset (Minimal)
- Triggers display reconfiguration without mode changes
- Least disruptive but may not fix all issues
- Disruption: Very Low (may have no visible effect)
Usage
Basic Usage (Auto-Select)
- Open Raycast (default:
Cmd + Space)
- Type "Reinitialize Displays"
- Select a display from the list
- Press
Enter to reinitialize using the recommended method
The extension will automatically choose the best method for that specific display.
Advanced Usage (Choose Method)
- Select a display from the list
- Press
Cmd + K to open the action menu
- Under "Choose Reinitialization Method", select your preferred method
- Available methods are shown based on display compatibility
View Display Details
- Press
Cmd + K → "View Display Details" to see:
- All available reinitialization methods
- Method descriptions and disruption levels
- Display capabilities (resolution, refresh rates, etc.)
Quick Reinitialize with Hotkeys
You can assign global hotkeys to instantly reinitialize specific displays using the Quick Reinitialize Display command with Raycast Quicklinks:
- Open Raycast and search for "Quick Reinitialize Display"
- Enter your display name (e.g.,
LG or Dell U2723QE)
- Matching is flexible: partial names, case-insensitive, or display ID
- Press
Cmd + K and select "Copy Deeplink"
- Open Raycast and run the "Create Quicklink" command
- Paste the deeplink and give it a name (e.g., "Reinit LG Monitor")
- Go to Raycast Settings > Extensions > Quicklinks
- Find your quicklink and assign a hotkey (e.g.,
Cmd + Shift + 1)
Now pressing that hotkey will instantly reinitialize that specific display without opening any UI.
Display Matching:
"LG" matches "LG 27UK850-W" (partial match)"dell" matches "Dell U2723QE" (case-insensitive)"2" matches display with ID 2
Display Information
For each display, the extension shows:
- Name: Human-readable display name (or "Main Display", "Built-in Display", etc.)
- Resolution: Current width x height
- Type: Built-in or External
- Main: Blue badge if this is the main display
- Recommended Method: Suggested reinitialization approach
- Display ID: System identifier
How It Works
The extension uses macOS CoreGraphics APIs to reinitialize displays:
- DDC Method: Uses
m1ddc to send hardware power commands
- Refresh Rate Method:
CGConfigureDisplayWithDisplayMode() to cycle refresh rates
- Resolution Method:
CGConfigureDisplayWithDisplayMode() to cycle resolutions
- Soft Reset:
CGCompleteDisplayConfiguration() to trigger reconfiguration
These methods can fix issues like:
- Display not waking from sleep
- Incorrect color profile
- Resolution problems
- Connection detection issues
- HDMI/DisplayPort signal dropout
Requirements
Required
- macOS (this extension only works on macOS)
- Raycast app installed
- Xcode (for Swift compilation during build)
Optional
- m1ddc (for DDC power cycle on external displays)
brew install m1ddc
Without m1ddc, the extension will fall back to other methods automatically.
Development
Prerequisites
- macOS
- Node.js 20+
- Xcode
- Raycast app
Setup
-
Clone this repository
-
Install dependencies:
npm install
-
Run in development mode:
npm run dev
Swift code is automatically compiled by Raycast's build system.
Build
npm run build
The build process automatically compiles the Swift package using Raycast's Swift Tools integration.
Technical Details
The extension consists of two integrated parts:
1. Swift Package (swift/display-helper/)
A Swift package using Raycast's Swift Tools that provides:
Exported Functions:
getAllDisplays() - Returns array of all displays with metadatareinitializeDisplay(displayId, method) - Reinitializes a specific display
- Methods:
auto, ddc, refresh, resolution, soft
Display Metadata:
- Available reinitialization methods
- Recommended method
- Whether display has multiple refresh rates
- Standard display info (ID, name, resolution, etc.)
Implementation:
- Uses macOS CoreGraphics and IOKit frameworks
- Compiled automatically during build via Raycast's Swift plugin system
- Functions are marked with
@raycast macro for TypeScript integration
2. Raycast Extension
src/reinitialize-displays.tsx - Main UI command
- TypeScript/React UI
- Direct Swift function imports using
swift: module specifier
- Type-safe integration with auto-generated TypeScript definitions
- Handles user interaction and feedback
- Provides method selection interface
src/quick-reinitialize.ts - Background command for hotkeys
- No-view command that accepts display name argument
- Flexible display matching (partial, case-insensitive, by ID)
- Designed for use with Raycast Quicklinks and hotkeys
Troubleshooting
"m1ddc not found" Error
- Install m1ddc:
brew install m1ddc
- Or use other methods (refresh rate, resolution cycle)
"No alternate refresh rate available"
- Your display only supports one refresh rate
- Try resolution cycle or DDC method instead
"Failed to apply temporary mode"
- macOS denied the display mode change
- Try a different method or restart your Mac
Display Doesn't Actually Reinitialize
- Some methods are less effective than others
- Try DDC power cycle if you have an external display
- Resolution cycle is the most reliable fallback
Built-in Display Methods Limited
- Built-in displays don't support DDC
- Only refresh rate toggle, resolution cycle, and soft reset available
- This is a hardware limitation
Quick Reinitialize "Display not found"
- The display name didn't match any connected display
- Try a more specific name, or check available displays with the main command
- You can also use the display ID number instead of name
Keyboard Shortcuts
Reinitialize Displays (Main Command)
Enter - Reinitialize with auto-selected methodCmd + K - Open action menu1-4 - Quick select specific method (when action menu is open)Cmd + R - Refresh display list
Quick Reinitialize Display
License
MIT
Credits
Built using:
Development Note
While I (the human) did the driving and direction, this code was generated with AI assistance to solve a display reinitialization problem I couldn't allocate time to fix manually. The AI helped implement the Swift display management logic, multiple reinitialization methods, and the Raycast UI integration.
