← Back to course overview

Part VII — Control the System · Lesson 16 of 26 · 25 min read

Module 15: Audio, Bluetooth, Network, and Displays on Omarchy

In this module — 83 sections
  1. What You Will Learn
  2. 15.1 — Omarchy’s Hardware Control Philosophy
  3. 15.2 — Current Hardware Panel Shortcuts
  4. 15.3 — The Top-Bar Hardware Widgets Are Interactive
  5. 15.4 — Use the Panel First
  6. 15.5 — Audio Panel
  7. 15.6 — Master Volume
  8. 15.7 — Mute
  9. 15.8 — Microphone / Input
  10. 15.9 — Output Device Selection
  11. 15.10 — Per-Application Mixing
  12. 15.11 — Switching Output While Audio Is Playing
  13. 15.12 — Audio CLI
  14. 15.13 — Inspect Current Audio State
  15. 15.14 — Precise Volume Control
  16. 15.15 — Switch to the Next Audio Output
  17. 15.16 — Audio Restart Before Reboot
  18. 15.17 — Why Component Restart Is Better
  19. 15.18 — Laptop Speaker Tuning
  20. 15.19 — Do Not “Fix” Tuning That Is Working
  21. 15.20 — Bluetooth Panel
  22. 15.21 — Pairing a Device
  23. 15.22 — Connect and Disconnect
  24. 15.23 — Forget a Device
  25. 15.24 — Bluetooth Radio Toggle
  26. 15.25 — Bluetooth CLI
  27. 15.26 — Bluetooth Power State
  28. 15.27 — Bluetooth State Persists Across Reboots
  29. 15.28 — Restart Bluetooth Before Reboot
  30. 15.29 — Network Panel
  31. 15.30 — Connect to Wi-Fi
  32. 15.31 — Do Not Follow Old Omarchy Wi-Fi Tutorials Blindly
  33. 15.32 — Network CLI
  34. 15.33 — Network Status
  35. 15.34 — Network Status as a Troubleshooting Baseline
  36. 15.35 — Signal Strength
  37. 15.36 — Wi-Fi Band Selection
  38. 15.37 — When Band Selection Helps
  39. 15.38 — Wi-Fi QR Sharing
  40. 15.39 — Wi-Fi Password Display
  41. 15.40 — DNS Provider Selection
  42. 15.41 — Speed Test
  43. 15.42 — Ping
  44. 15.43 — Restart Wi-Fi Before Reboot
  45. 15.44 — Display Panel
  46. 15.45 — Brightness vs Monitor Configuration
  47. 15.46 — Hardware Brightness Keys
  48. 15.47 — Keyboard Backlight
  49. 15.48 — Brightness CLI
  50. 15.49 — External Monitor DDC Brightness
  51. 15.50 — Text Size
  52. 15.51 — Display Settings Hierarchy
  53. 15.52 — Persistent Monitor Configuration
  54. 15.53 — Verify Refresh Rate
  55. 15.54 — Display Panel vs monitors.lua
  56. 15.55 — Laptop Display Toggle
  57. 15.56 — Power Panel
  58. 15.57 — Power Profiles on Laptops
  59. 15.58 — Hardware Troubleshooting Principle
  60. 15.59 — The Hardware Recovery Ladder
  61. 15.60 — Why Rebooting First Is Bad Troubleshooting
  62. 15.61 — Audio Troubleshooting Flow
  63. 15.62 — Bluetooth Troubleshooting Flow
  64. 15.63 — Wi-Fi Troubleshooting Flow
  65. 15.64 — Display Troubleshooting Flow
  66. 15.65 — Trackpad Troubleshooting
  67. 15.66 — Practical Exercise: Audio Panel
  68. 15.67 — Practical Exercise: Audio Shortcut
  69. 15.68 — Practical Exercise: Audio CLI Discovery
  70. 15.69 — Practical Exercise: Bluetooth Panel
  71. 15.70 — Practical Exercise: Bluetooth CLI Discovery
  72. 15.71 — Practical Exercise: Network Panel
  73. 15.72 — Practical Exercise: Network Status
  74. 15.73 — Practical Exercise: Speed Test
  75. 15.74 — Practical Exercise: Wi-Fi QR
  76. 15.75 — Practical Exercise: Display Panel
  77. 15.76 — Practical Exercise: Verify Monitor Mode
  78. 15.77 — Practical Exercise: Text Size Discovery
  79. 15.78 — Practical Exercise: Restart One Subsystem
  80. 15.79 — Common Hardware-Control Mistakes
  81. 15.80 — Checkpoint
  82. 15.81 — What You Can Now Do
  83. Module 15 Summary

About This Module

A development workstation is only useful if the hardware layer is reliable.

You need:

  • working audio;
  • predictable Bluetooth;
  • stable Wi-Fi/networking;
  • correct monitor configuration;
  • usable brightness and scaling.

Current Omarchy 4 / Quattro has moved a large part of this day-to-day hardware control into the Omarchy Shell panels and corresponding CLI groups.

Current official documentation provides dedicated panels for:

Audio
Network
Bluetooth
Display
Power

with direct shortcuts such as:

Super + Ctrl + A
Super + Ctrl + W
Super + Ctrl + B
Super + Ctrl + D

The goal of this module is not to turn you into an audio-stack or NetworkManager expert.

The goal is:

Operate the hardware confidently, use the Omarchy layer first, restart only the affected subsystem when something breaks, and know when to inspect deeper.


What You Will Learn

By the end of Module 15, you will understand:

  • how the Omarchy Shell exposes hardware controls;
  • how to use the audio panel;
  • how to switch output devices;
  • how to control microphone/input;
  • how per-app volume works;
  • how to restart audio without rebooting;
  • how to inspect laptop speaker tuning;
  • how to use the Bluetooth panel;
  • how to pair, connect, disconnect, forget, and power Bluetooth;
  • how to restart Bluetooth;
  • how to use the network panel;
  • how to inspect Wi-Fi signal and status;
  • how to connect to networks;
  • how to use DNS selection;
  • how to use Wi-Fi QR sharing;
  • how to inspect/change Wi-Fi band behavior;
  • how to run network speed tests;
  • how to restart networking;
  • how to use the display panel;
  • how brightness controls differ from monitor configuration;
  • how to inspect text-size/display CLI controls;
  • how to verify monitor state with hyprctl;
  • how to distinguish display brightness, scale, resolution, refresh rate, and text size;
  • why subsystem restart should come before rebooting.

15.1 — Omarchy’s Hardware Control Philosophy

Current Omarchy 4 routes common desktop hardware tasks through the Omarchy Shell.

That includes:

Audio
Network
Bluetooth
Display
Power

This is intentional.

Instead of opening several separate TUIs or random vendor utilities, the workstation provides integrated shell panels.

Conceptually:

A top bar or hotkey opens an Omarchy Shell panel, which controls the underlying Linux subsystem

This gives you a consistent user experience while still leaving the underlying Linux tools available when deeper troubleshooting is required.


15.2 — Current Hardware Panel Shortcuts

Current official Omarchy hotkeys:

Super + Ctrl + A
→ Audio panel

Super + Ctrl + W
→ Network panel

Super + Ctrl + B
→ Bluetooth panel

Super + Ctrl + D
→ Display panel

Super + Ctrl + P
→ Power panel

These panels are also accessible by clicking their corresponding icons in the top bar.

Practice with Superkey

All five of these are the opening steps of Superkey’s Panels & tools lesson, which you may already have run in Module 3. If not, it is a quick way to get them into your hands. Click SK in the bar → Hyprland → Panels & tools, or launch it directly:

omarchy-shell shell summon stevinator.superkey '{"lesson":"hyprland.panels"}'

15.3 — The Top-Bar Hardware Widgets Are Interactive

Current official Omarchy top-bar documentation states that the hardware widgets are not just indicators.

They are controls.

Examples:

Audio icon
left-click
→ audio panel

right-click
→ mute

scroll
→ volume
Bluetooth icon
left-click
→ Bluetooth panel

right-click
→ toggle Bluetooth radio
Display icon
left-click
→ display panel

scroll
→ brightness

This is worth learning because it makes routine adjustments very fast.


15.4 — Use the Panel First

For normal daily tasks, prefer:

panel

over:

low-level command experimentation

Examples:

Need new audio output?
→ Audio panel

Need Wi-Fi network?
→ Network panel

Need to reconnect headphones?
→ Bluetooth panel

Need brightness?
→ Display panel

The lower-level tools remain valuable for diagnostics.


15.5 — Audio Panel

Open:

Super + Ctrl + A

Current official Omarchy documentation says the audio panel includes:

  • master volume;
  • output-device selection;
  • per-application mixer.

The real Omarchy audio panel, showing output at 40% and input at 100% on an Intel 82801AA-ICH device

This means you can control both:

global audio

and:

individual application streams

from one panel.


15.6 — Master Volume

The master volume changes the current output level.

You may also use hardware media keys.

Current official hotkeys document:

Alt + Volume Up/Down

for precise 1% volume changes.

Normal hardware volume keys can perform the usual larger-step adjustments.


15.7 — Mute

The current top-bar audio widget supports right-click mute.

Hardware mute keys can also work where present.

The important distinction is:

output mute
vs
microphone mute

Do not confuse the two.


15.8 — Microphone / Input

Current Omarchy shell includes microphone/input controls.

If the microphone widget is enabled on the bar, current official docs state that it supports:

left click
→ mute microphone

middle click
→ audio panel

scroll
→ input volume

Even when the microphone widget is not visible, input control is available through the audio subsystem/CLI.


15.9 — Output Device Selection

The most common audio problem on a multi-device workstation is:

sound is playing
but from the wrong device

Examples:

  • HDMI monitor;
  • USB headset;
  • Bluetooth headphones;
  • built-in speakers;
  • external speakers.

Current official troubleshooting guidance says the first thing to check is whether the correct output is selected in the audio panel.

Do that before assuming the audio stack is broken.


15.10 — Per-Application Mixing

Current Omarchy’s audio panel includes a per-app mixer.

This lets you do things like:

Browser
→ 20%

Music player
→ 60%

Game/dev tool
→ 40%

without changing master volume.

This is especially useful during development when:

  • a browser tab is noisy;
  • a meeting app needs to stay audible;
  • a local dev app produces media.

15.11 — Switching Output While Audio Is Playing

Current Quattro audio behavior is designed to preserve active playback when switching outputs.

This matters when moving between:

speakers
→ headset
→ monitor

The shell/CLI handles stream movement rather than forcing you to restart applications manually.


15.12 — Audio CLI

Current Omarchy CLI exposes an:

omarchy audio

group.

Inspect:

omarchy audio --help

This is the correct first discovery method because exact subcommands can evolve.

Current workstation behavior has included controls for:

  • output;
  • input;
  • mute;
  • source switching;
  • output switching;
  • tuning.

15.13 — Inspect Current Audio State

Start with:

omarchy audio --help

Then inspect relevant current subcommands.

Do not memorize old syntax if the installed help has changed.

The course rule remains:

Use current CLI discovery before guessing subcommands.


15.14 — Precise Volume Control

Current official Omarchy hotkeys include:

Alt + Volume Up
Alt + Volume Down

for 1% volume increments.

This is useful when:

normal volume steps feel too coarse

15.15 — Switch to the Next Audio Output

Current official hotkeys include:

Shift + Mute

to switch to the next audio output.

This is very convenient when you frequently alternate between:

headphones
speakers
monitor

15.16 — Audio Restart Before Reboot

Current official Omarchy troubleshooting guidance explicitly recommends restarting the affected subsystem before rebooting.

If sound suddenly stops:

do not reboot first

Use the Omarchy hardware restart workflow.

Current Omarchy restart commands include an audio restart helper.

Inspect:

omarchy restart --help

or:

omarchy restart audio

if supported on your installed version.


15.17 — Why Component Restart Is Better

A full reboot disrupts:

  • Tmux sessions;
  • development servers;
  • applications;
  • browser state;
  • running jobs.

If the problem is only the audio subsystem, restarting only audio is much cheaper.

Use escalation:

select correct output
↓
restart audio
↓
inspect deeper
↓
reboot only if needed

15.18 — Laptop Speaker Tuning

Current official troubleshooting documentation states that some laptops can receive Omarchy speaker tuning.

Inspect current state with:

omarchy audio tuning status

Turn tuning off if you intentionally want raw output:

omarchy audio tuning off

This is laptop-specific.

Desktop systems may not use tuning at all.


15.19 — Do Not “Fix” Tuning That Is Working

If laptop speakers sound correct:

leave tuning alone

Do not disable it simply because you discovered the command.

This course repeatedly follows the rule:

Do not change healthy settings for the sake of customization.


15.20 — Bluetooth Panel

Open:

Super + Ctrl + B

Current official Omarchy top-bar documentation says the Bluetooth panel can show:

  • known devices;
  • connection state;
  • battery levels where available;
  • connect/disconnect controls.

The real Omarchy Bluetooth panel on a machine with no Bluetooth adapter present, showing the “No adapter” state

This makes normal Bluetooth management a shell-level task.


15.21 — Pairing a Device

Typical workflow:

1. put device into pairing mode
2. open Bluetooth panel
3. select device
4. pair
5. connect

The exact UI labels may vary slightly across current releases.

Use the panel first.


15.22 — Connect and Disconnect

For a previously paired device:

open Bluetooth panel
→ select device
→ connect/disconnect

This is faster than re-pairing.

If a device refuses to reconnect, try:

disconnect
→ reconnect

before forgetting it.


15.23 — Forget a Device

Forget/removal is appropriate when:

  • pairing state is corrupted;
  • device changed identity/firmware;
  • you intentionally want to remove trust.

Do not forget a device every time it fails to connect once.

That creates extra pairing work unnecessarily.


15.24 — Bluetooth Radio Toggle

Current official top-bar behavior allows Bluetooth radio toggle from the Bluetooth widget.

Use this when you want:

Bluetooth fully off

rather than merely disconnecting one device.


15.25 — Bluetooth CLI

Current Omarchy CLI exposes:

omarchy bluetooth

Inspect:

omarchy bluetooth --help

Current workstation behavior has included controls for:

  • power;
  • pairing;
  • connect;
  • disconnect;
  • forget.

Exact subcommands should be taken from the installed help.


15.26 — Bluetooth Power State

Current Omarchy Bluetooth commands support power control.

Typical capabilities include:

on
off
toggle
status/is-on

Inspect:

omarchy bluetooth --help

for the current spelling.


15.27 — Bluetooth State Persists Across Reboots

Current Omarchy behavior remembers Bluetooth power state across reboots.

That means if you intentionally turn Bluetooth off, do not be surprised when it remains off after restarting.

Always check power state before debugging pairing.


15.28 — Restart Bluetooth Before Reboot

Current official troubleshooting guidance says Bluetooth is one of the subsystems that should be restarted independently first.

If a headset worked earlier and suddenly will not reconnect:

1. verify Bluetooth is on
2. disconnect/reconnect device
3. restart Bluetooth subsystem
4. retry
5. reboot only later if necessary

15.29 — Network Panel

Open:

Super + Ctrl + W

Current official Omarchy top-bar documentation states that the network panel can:

  • scan Wi-Fi networks;
  • show signal strength;
  • connect to networks;
  • select DNS providers.

The real Omarchy network panel, showing a live Ethernet connection with ping, download/upload totals, IP address, gateway, and DNS provider options

Current Quattro also includes additional network functionality such as:

  • live up/down statistics;
  • ping;
  • speed testing;
  • Wi-Fi QR sharing;
  • Wi-Fi band selection.

15.30 — Connect to Wi-Fi

Normal workflow:

open Network panel
→ choose network
→ enter password
→ connect

Current Omarchy 4 uses NetworkManager for Wi-Fi management.

This replaced older Omarchy generations that used a different stack.

That is a good example of why current-version documentation matters.


15.31 — Do Not Follow Old Omarchy Wi-Fi Tutorials Blindly

Older tutorials may mention tools that current Quattro no longer uses as the primary Wi-Fi interface.

Current Omarchy has moved network management into the Shell and NetworkManager-backed controls.

Therefore:

Use the current Network panel and current omarchy network CLI before following legacy instructions.


15.32 — Network CLI

Current Omarchy exposes:

omarchy network

Inspect:

omarchy network --help

Current workstation behavior includes capabilities such as:

  • status;
  • speed tests;
  • band selection;
  • Wi-Fi QR sharing;
  • password display.

Use the installed help as the authoritative command map.


15.33 — Network Status

A useful current command is:

omarchy network status --verbose

This is useful for inspecting:

  • connectivity;
  • interface state;
  • current network;
  • other relevant connection details.

This has been tested on the workstation used in this course.


15.34 — Network Status as a Troubleshooting Baseline

When something says:

"Internet doesn't work"

first distinguish:

Wi-Fi not connected
vs
connected but no internet
vs
DNS issue
vs
remote service issue

Start with:

omarchy network status --verbose

Then test deeper only as needed.


15.35 — Signal Strength

The current network panel shows signal information.

Poor Wi-Fi performance may simply be:

weak signal

not a Linux configuration problem.

Before changing DNS, kernel settings, or drivers:

check signal

15.36 — Wi-Fi Band Selection

Current Quattro includes Wi-Fi band controls.

Current workstation behavior has included modes such as:

auto
2.4 GHz
5 GHz
6 GHz

depending on adapter/router support.

Inspect:

omarchy network --help

and the Network panel for current options.


15.37 — When Band Selection Helps

Possible reasons:

2.4 GHz
→ longer range, lower throughput, more interference

5 GHz
→ shorter range, higher throughput

6 GHz
→ newer hardware, cleaner spectrum, shorter range

These are general wireless characteristics.

Your router and client hardware determine what is actually available.

For most users:

Auto

is the correct default.


15.38 — Wi-Fi QR Sharing

Current Omarchy includes Wi-Fi QR sharing from the network panel/CLI.

This is useful when you want to connect a phone or another device without manually typing the network password.

Use the current panel or:

omarchy network --help

to discover the exact QR subcommand on your installed version.


15.39 — Wi-Fi Password Display

Current Omarchy network commands can expose the current Wi-Fi password where available.

Treat that as sensitive information.

Do not:

  • paste it into public screenshots;
  • expose it during recordings;
  • include it in course assets.

When filming the course, blur/redact credentials.


15.40 — DNS Provider Selection

Current official top-bar documentation says the Network panel lets you choose a DNS provider.

DNS affects:

name resolution

not raw Wi-Fi signal strength.

If:

Wi-Fi signal is poor

changing DNS will not fix the radio link.

Use DNS settings for DNS-related reasons.


15.41 — Speed Test

Current Omarchy includes network speed-test capability.

Current workstation behavior has included separate:

download
upload

tests.

Inspect the current syntax:

omarchy network --help

Use this to distinguish:

network connected

from:

network performing well

15.42 — Ping

Current Quattro network panel includes ping information.

Ping helps evaluate:

  • reachability;
  • basic latency;
  • packet-path responsiveness.

Do not treat one ping result as a complete network diagnosis.

Use it as one signal.


15.43 — Restart Wi-Fi Before Reboot

Current official troubleshooting guidance includes Wi-Fi among the subsystems that should be restarted independently first.

Escalation:

check connected network
↓
check signal
↓
restart Wi-Fi/network subsystem
↓
reconnect
↓
inspect deeper
↓
reboot only if needed

15.44 — Display Panel

Open:

Super + Ctrl + D

The display panel handles normal display controls.

Current top-bar documentation also states:

scroll on Display widget
→ brightness

This is distinct from persistent monitor mode configuration in:

~/.config/hypr/monitors.lua

15.45 — Brightness vs Monitor Configuration

These are different.

Brightness

how much light the panel emits

Monitor Configuration

resolution
refresh rate
scale
position

Do not edit:

monitors.lua

to solve a brightness issue.


15.46 — Hardware Brightness Keys

Current official hotkeys include:

Shift + Brightness Up
→ maximum brightness

Shift + Brightness Down
→ minimum brightness

Alt + Brightness Up/Down
→ precise 1% changes

Normal hardware brightness keys can use regular step sizes.


15.47 — Keyboard Backlight

Current official hotkeys also include keyboard-backlight controls when hardware supports them:

Keyboard Brightness Up/Down
Keyboard Backlight

Hardware availability varies.

A desktop keyboard may manage lighting through its own firmware instead.


15.48 — Brightness CLI

Current Omarchy exposes:

omarchy brightness

Inspect:

omarchy brightness --help

Current workstation behavior includes display brightness functionality including DDC for compatible external displays.


15.49 — External Monitor DDC Brightness

Some external monitors support:

DDC/CI

which allows software brightness control over the display connection.

Current Omarchy includes DDC-related brightness commands.

Inspect:

omarchy brightness display --help

or the current command tree.

Support depends on:

  • monitor;
  • cable;
  • GPU;
  • DDC settings.

Do not assume every external display supports software brightness control.


15.50 — Text Size

Current workstation behavior exposes:

omarchy display text size

for text-size adjustment.

Inspect:

omarchy display text size --help

This is different from:

monitor scale

and:

resolution

15.51 — Display Settings Hierarchy

Use this decision tree:

Image too dark?
→ brightness

Everything physically too small?
→ monitor scale

Text specifically too small?
→ text size/font settings

Image blurry/wrong geometry?
→ resolution

Motion not smooth enough?
→ refresh rate

Windows on wrong screen?
→ monitor positioning/workspace rules

This prevents changing the wrong layer.


15.52 — Persistent Monitor Configuration

For:

resolution
refresh rate
scale
position

use:

~/.config/hypr/monitors.lua

and the Module 11 workflow.

Inspect reality:

hyprctl monitors all

before changing anything.


15.53 — Verify Refresh Rate

A monitor can display an image correctly while still running at the wrong refresh rate.

Example:

144 Hz monitor
running at 60 Hz

The desktop works.

But it is not configured optimally.

Run:

hyprctl monitors all

and confirm the active mode.

This was a real issue during the workstation setup used for this course.


15.54 — Display Panel vs monitors.lua

Use:

Display panel

for routine interactive controls.

Use:

monitors.lua

for persistent hardware layout configuration.

Examples:

brightness now
→ panel

make DP-2 always 2560x1440@144
→ monitors.lua

15.55 — Laptop Display Toggle

Current official hotkeys include:

Super + Ctrl + Delete

for toggling the laptop display on/off.

Current Quattro also includes mirroring behavior:

Super + Ctrl + Alt + Delete

for toggling laptop display mirroring.

These are laptop-specific.

Desktop users can ignore them.


15.56 — Power Panel

Although this module focuses on audio/Bluetooth/network/display, the Power panel belongs in the same hardware-control family.

Open:

Super + Ctrl + P

Current official documentation says it provides:

  • battery stats;
  • power-profile switching;
  • separate remembered AC/battery choices;
  • system information.

Power profiles can affect performance and battery life.


15.57 — Power Profiles on Laptops

Typical profile categories can include:

power saver
balanced
performance

depending on hardware/support.

Use:

balanced

as the safe general default unless your workload or battery goals justify another profile.


15.58 — Hardware Troubleshooting Principle

Current official Omarchy troubleshooting guidance explicitly says:

Before rebooting, restart only the offending subsystem.

This applies to:

Wi-Fi
Bluetooth
Audio
Trackpad

This should become your default mental model.


15.59 — The Hardware Recovery Ladder

Use:

1. verify current state
2. correct obvious selection/config
3. restart only affected subsystem
4. retry
5. inspect logs/services
6. reboot if needed

This is far better than:

problem
→ reboot

as the first response.


15.60 — Why Rebooting First Is Bad Troubleshooting

If you reboot immediately:

problem disappears

but you learned nothing.

You do not know whether the issue was:

  • Bluetooth daemon;
  • PipeWire/WirePlumber;
  • NetworkManager;
  • device state;
  • application stream;
  • compositor state.

A targeted restart teaches you which layer failed.


15.61 — Audio Troubleshooting Flow

If audio is missing:

1. check master mute
2. check correct output
3. check per-app stream volume
4. switch output away/back
5. restart audio subsystem
6. inspect deeper

For laptop speakers specifically:

check tuning state

if sound quality is the issue rather than total silence.


15.62 — Bluetooth Troubleshooting Flow

If a device will not connect:

1. confirm Bluetooth radio is on
2. verify device is paired
3. disconnect/reconnect
4. restart Bluetooth
5. forget/re-pair if necessary
6. inspect deeper

Do not start with re-pairing unless needed.


15.63 — Wi-Fi Troubleshooting Flow

If networking fails:

1. open network panel
2. check current SSID
3. check signal strength
4. run network status
5. reconnect
6. restart Wi-Fi/network
7. test connectivity
8. inspect deeper

Changing DNS should only happen when the symptoms support a DNS issue.


15.64 — Display Troubleshooting Flow

If display behavior looks wrong:

1. hyprctl monitors all
2. identify actual output
3. check mode/resolution/refresh
4. check scale
5. check monitors.lua
6. hyprctl configerrors
7. change one thing
8. verify again

Do not combine display configuration with unrelated theme/text-size changes.


15.65 — Trackpad Troubleshooting

Current official Omarchy troubleshooting also includes trackpad restart among common hardware restart actions.

Laptop users should remember:

trackpad stopped after suspend

does not necessarily mean:

reboot required

Try the current Omarchy trackpad restart helper first.


15.66 — Practical Exercise: Audio Panel

Open:

Super + Ctrl + A

Identify:

  • current output;
  • master volume;
  • application streams.

If you have two outputs, switch between them.

Return to your preferred output.


15.67 — Practical Exercise: Audio Shortcut

Test:

Alt + Volume Up
Alt + Volume Down

Observe 1% changes.

If your hardware supports multiple outputs, test:

Shift + Mute

and observe output switching.


15.68 — Practical Exercise: Audio CLI Discovery

Run:

omarchy audio --help

Write down the current subcommands on your installed version.

If your machine exposes tuning:

omarchy audio tuning status

Do not change tuning unless you actually want to.


15.69 — Practical Exercise: Bluetooth Panel

Open:

Super + Ctrl + B

Identify:

  • Bluetooth power state;
  • paired devices;
  • currently connected device;
  • battery percentage if available.

If you have a device, disconnect/reconnect it.


15.70 — Practical Exercise: Bluetooth CLI Discovery

Run:

omarchy bluetooth --help

Identify the current commands for:

  • power;
  • connect;
  • disconnect;
  • pair;
  • forget.

Do not forget a useful device just to complete the exercise.


15.71 — Practical Exercise: Network Panel

Open:

Super + Ctrl + W

Identify:

  • current network;
  • signal strength;
  • DNS selection;
  • any live network statistics;
  • band control if available.

Do not disconnect if you are in the middle of important online work.


15.72 — Practical Exercise: Network Status

Run:

omarchy network status --verbose

Record:

connection state
active network
interface information

Then compare the CLI result with the panel.


15.73 — Practical Exercise: Speed Test

Inspect:

omarchy network --help

Run the current documented speed-test command.

Record:

download
upload

Do not treat one result as a permanent measurement.

Wireless speed fluctuates.


15.74 — Practical Exercise: Wi-Fi QR

If your current network CLI/panel supports it:

generate the Wi-Fi QR code

Do not publish a screenshot containing real credentials.

This exercise is optional.


15.75 — Practical Exercise: Display Panel

Open:

Super + Ctrl + D

Adjust brightness slightly.

Return to your preferred level.

Observe that this did not change:

  • resolution;
  • refresh rate;
  • scale.

15.76 — Practical Exercise: Verify Monitor Mode

Run:

hyprctl monitors all

Record:

output
resolution
refresh
scale
position

Compare with:

bat ~/.config/hypr/monitors.lua

Confirm that persistent config and active reality make sense together.


15.77 — Practical Exercise: Text Size Discovery

Run:

omarchy display --help

Then:

omarchy display text size --help

Do not change it if your current text size is already correct.

The goal is knowing where the control lives.


15.78 — Practical Exercise: Restart One Subsystem

If one subsystem currently has a harmless issue, use that.

Otherwise simply inspect:

omarchy restart --help

Identify current helpers for:

  • audio;
  • Bluetooth;
  • Wi-Fi;
  • trackpad.

Do not restart hardware randomly in the middle of important work.


15.79 — Common Hardware-Control Mistakes


Mistake 1 — Rebooting First

Restart the affected subsystem first.


Mistake 2 — Assuming Audio Is Broken When the Wrong Output Is Selected

Check the audio panel.


Mistake 3 — Re-Pairing Bluetooth for Every Reconnect Failure

Try reconnect and subsystem restart first.


Mistake 4 — Changing DNS Because Wi-Fi Signal Is Weak

DNS does not improve radio strength.


Mistake 5 — Following Old Omarchy Networking Tutorials

Current Quattro uses the current shell/network stack and NetworkManager-backed controls.


Mistake 6 — Changing Monitor Scale to Fix Only Text Size

Use the correct display layer.


Mistake 7 — Assuming 144 Hz Is Active Because the Monitor Supports 144 Hz

Verify:

hyprctl monitors all

Mistake 8 — Assuming External Monitor Brightness Is Software-Controlled

DDC support varies by hardware.


Mistake 9 — Publishing Wi-Fi Password/QR Screenshots

Treat network credentials as secrets.


Mistake 10 — Treating Every Hardware Issue as a Kernel/driver problem

Start with current state, device selection, and subsystem restart.


15.80 — Checkpoint

Before moving on, you should be able to answer yes to the following.

Audio

  • I can open the audio panel.
  • I can select the correct output.
  • I understand per-app volume.
  • I can distinguish microphone input from output audio.
  • I know how to discover current audio CLI commands.
  • I know to restart audio before rebooting.
  • I know laptop speaker tuning may exist.

Bluetooth

  • I can open the Bluetooth panel.
  • I understand pair/connect/disconnect/forget.
  • I can verify Bluetooth power state.
  • I know to restart Bluetooth before rebooting.
  • I know Bluetooth power state can persist across reboots.

Network

  • I can open the Network panel.
  • I can check signal strength.
  • I can connect to Wi-Fi.
  • I can run omarchy network status --verbose.
  • I understand DNS vs Wi-Fi signal.
  • I understand Wi-Fi band selection at a high level.
  • I know about QR sharing and speed testing.
  • I know to restart networking before rebooting.

Display

  • I can open the Display panel.
  • I understand brightness vs monitor configuration.
  • I understand text size vs monitor scale.
  • I can verify active monitor mode with hyprctl monitors all.
  • I know where persistent monitor config lives.
  • I understand DDC brightness may depend on hardware.

Troubleshooting

  • I follow the subsystem-first restart model.
  • I verify current state before changing configuration.
  • I know when a full reboot is actually the later escalation step.

15.81 — What You Can Now Do

After completing Module 15, you can now:

  • operate audio confidently;
  • switch outputs without restarting applications;
  • control per-app audio;
  • manage microphones;
  • pair and reconnect Bluetooth devices;
  • troubleshoot Bluetooth without immediately re-pairing;
  • connect and inspect Wi-Fi;
  • use signal, DNS, band, speed, and QR features intelligently;
  • control brightness;
  • distinguish brightness, text size, scale, refresh rate, and resolution;
  • verify display hardware state;
  • restart individual hardware subsystems before rebooting;
  • approach hardware troubleshooting methodically.

Most importantly:

You can now treat hardware control as part of the Omarchy workflow instead of a collection of unrelated Linux utilities.


Module 15 Summary

Current panel shortcuts:

Super + Ctrl + A
→ Audio

Super + Ctrl + W
→ Network

Super + Ctrl + B
→ Bluetooth

Super + Ctrl + D
→ Display

Super + Ctrl + P
→ Power

Audio:

select output
per-app mixer
microphone/input
precise volume
output switching
subsystem restart

Bluetooth:

power
pair
connect
disconnect
forget
restart

Network:

Wi-Fi scan/connect
signal strength
DNS
band selection
QR sharing
speed test
status
restart

Display:

brightness
text size
persistent monitor mode
refresh rate
scale
position

Core verification:

omarchy audio --help
omarchy bluetooth --help
omarchy network --help
omarchy display --help
omarchy brightness --help
hyprctl monitors all

Hardware recovery ladder:

verify
↓
correct obvious selection
↓
restart affected subsystem
↓
retry
↓
inspect deeper
↓
reboot

And the most important rule:

If one subsystem breaks, restart one subsystem — not the whole workstation.