Fix Monitor Scaling & Layout on Omarchy OS – Simple Hyprland Monitor Manager Script

In this video, I introduce a simple monitor manager script for Omarchy OS, built as a direct side effect of working on GameScope and Steam Deck–style gaming sessions

the script is now public you can find it here

https://www.no-signal.uk

While fixing monitor and GPU detection for gaming, it became very clear that monitor management in Hyprland can be confusing — especially if you’re coming from macOS or Windows.

So instead of expecting people to learn Hyprland’s config syntax on day one, I wrote a small tool to make monitor setup, scaling, and positioning much easier.

⸻

🔹 Why This Exists

If you’re new to Omarchy or Hyprland:
• Monitor scaling can feel unintuitive
• 4K displays are often unusable without scaling
• Laptop and older hardware can behave strangely
• Reloading configs manually is intimidating

This script is designed to give you quick, visual control over your monitors without needing to edit config files by hand.

⸻

🔹 What the Script Does

As shown in the video, the monitor manager:
• Automatically detects connected monitors
• Shows resolution, refresh rate, and scaling info
• Lets you change resolution per monitor
• Applies safe, Hyprland-supported scaling values
• Helps position monitors (center, left, right, above, below)
• Backs up your current monitor configuration
• Lets you restore from backup if something goes wrong
• Reloads Hyprland cleanly after changes

It’s designed to be interactive and forgiving, even if you make a mistake.

⸻

🔹 Scaling Explained

The video also highlights an important Hyprland detail:
• Hyprland only supports specific scaling values
• Unsupported values (like 1.4) will throw errors
• The script helps prevent that by showing valid options

This is especially useful on:
• 4K monitors
• Mixed-resolution setups
• Older laptops where scaling never quite looks right

⸻

🔹 Multi-Monitor Notes

Multi-monitor setups work well, but positioning matters:
• Your main display should be at position 0,0
• Other monitors are positioned relative to that
• Large resolution changes can temporarily shift layout
• The script makes it easy to correct this quickly

Some brief visual glitches during reconfiguration are normal — the displays are re-syncing.

⸻

🔹 Who This Is For

This is ideal if you:
• Are new to Omarchy or Hyprland
• Are moving from macOS or Windows
• Use 4K or mixed-resolution monitors
• Don’t want to manually edit config files
• Want a faster way to fix monitor issues

⸻

🔹 Laptop Support

This script has not yet been fully tested on laptops.

Laptop display switching (internal screen, HDMI, USB-C, DisplayPort) behaves very differently, and proper testing is ongoing. More work is planned once laptop hardware testing is complete.

⸻

💬 Final Thoughts

This started as a side quest, but turned into something genuinely useful.

Monitor setup is one of the first friction points for new users, and this script removes a lot of that pain without hiding how things work underneath.

If you’ve ever struggled to get scaling or layout “just right” on Omarchy — this should make life much easier.

⸻

🔔 Subscribe to Linux Out of the Box for more Omarchy tools, Hyprland tips, GameScope development, and real-world Linux workflows.