Quick answer:
Check resolution settings in both Luna Display and computer settings
Ensure strong connection (Wi-Fi, cable, or Ethernet)
Update Luna Display software on both devices
Restart both devices and reconnect
Lower resolution and refresh rate if experiencing performance issues
🔍 Blurry or Fuzzy Display
What causes this?
Usually, resolution mismatches between your devices or connection issues.
Try these steps:
Lower the Resolution
Go into your device's System Settings > Displays and adjust the resolution to a lower resolution and/or turn off retina. This will help provide a more stable experience if you have issues with quality.
Check your connection
For cable connections, verify the cable is registered in network settings and properly connected
Ensure both devices are on the same strong Wi-Fi network
Try moving closer to your router for wireless
Restart your router if needed
Update everything
Update Luna Display on both devices
Check for computer and secondary device updates
🔬 Everything Appears Too Tiny
What causes this?
Your computer is sending a resolution that's too high for comfortable viewing on your secondary device screen.
Try these steps:
Adjust display scaling
🍎Mac
System Preferences > Displays
Select your Luna Display
Choose "Scaled"
Select a lower resolution (try 1920 × 1080 or 1680 × 1050)
🖥️Windows
Settings > System > Display
Select your Luna Display monitor(s)
Adjust "Scale and layout" percentage
Try 100%, 125%, or 150% scaling
🎨 Pixelated or Grainy Display
What causes this?
Often related to resolution and refresh rate settings or a poor connection.
Try these steps:
Adjust quality settings
Open Luna Display settings
Lower resolution to reduce pixelation
Adjust refresh rate (try 30Hz vs 60Hz)
Check out our guide for more details:
Improve connection
Switch to cable connection (Thunderbolt, Ethernet, USB) instead of wireless
USB is only compatible with Computer-to-iPad or Mac-to-Mac (macos 10.15 or later) setups
Ensure strong Wi-Fi signal (move closer to router)
Close bandwidth-heavy apps on both devices
Reset Luna settings
Follow the instructions in the following guide based on your operating system:
🎬Can't Achieve Desired Resolution (4K/5K)
What causes this?
Hardware limitations, connection type, or software restrictions.
Try these solutions:
Use a cabled connection
Connect via Ethernet, Thunderbolt, or USB (macOS 10.15+ required). Using a cabled connection improves the latency for connections, making your experience smoother. With a cabled connection, you can expect between 1-4ms of latency.
Check Mac specifications
Older Macs may not support 4K/5K output to external displays
Check Apple's compatibility list for your Mac model
Close unnecessary apps
Free up system resources
Quit other display-intensive applications
Check Activity Monitor for high CPU/GPU usage
Adjust display settings
Turn off Retina mode in Luna Display on the main window
In your Display Settings, adjust the resolution until you find the desired quality
🍎 Issues After macOS Updates
What causes this?
macOS updates can sometimes change display drivers or reset preferences.
Try these steps:
Update Luna Display first
In the Luna menu, click Check for updates.
If an update is available, you can install it now.
Restart your device and try again.
Reset display preferences
System Preferences > Displays
Hold Option and click "Detect Displays"
Reconfigure your Luna Display settings here
⚡ Lag and Performance Issues
What causes this?
Connection issues, system resources, or suboptimal settings.
Try these steps:
Optimize your connection
Use 5GHz Wi-Fi instead of 2.4GHz
Connect via cable (Thunderbolt, Ethernet, USB) for best performance
Ensure both devices are close to your router
Adjust settings
Luna Display settings: Lower the resolution and adjust the refresh rate
Computer display settings: Match resolution and refresh rate to what you have in Luna Display
Free up system resources
Close unnecessary applications on both devices
Check system monitor for high CPU/memory usage
Restart both devices if they've been running for a long time
Test with different apps
Some apps are more resource-intensive than others
Try basic apps to test baseline performance
If you see an improvement with basic apps, it may be that your other applications are consuming too many resources