AEROSPACE-LIST-MONITORS(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-LIST-MONITORS(1)

okay so bestie, welcome to the AeroSpace Manual — this is the aerospace-list-monitors page and it's literally gonna tell you how to print out the monitors that satisfy your conditions. yep. that's the whole gig. let's get into it ✨

🌸 NAME

aerospace-list-monitors — prints out monitors that satisfy conditions 🖥️💖

🎀 SYNOPSIS

aerospace list-monitors [-h|--help] [--focused [no]] [--mouse [no]] [--format <output-format>] [--count] [--json]

🦋 DESCRIPTION

Print monitors that satisfy conditions. that's it, that's the vibe — you give it some filters, it gives you monitors. iconic behavior honestly 👑

✨ OPTIONS ✨

  • -h, --help — prints the help text. classic. the goat of "what does this even do" moments 🫶
  • --focused [no] — filters results so it only prints the focused monitor. and the [no] part? that inverts the condition, so you get everything except the focused one. no cap 🎯
  • --mouse [no] — filters results so it only prints the monitor that has the mouse. and again, [no] inverts the condition. mouse-havers only, or mouse-havers-not, your call 🖱️💅
  • --format <output-format> — tells it what output format you want. peek the Output Format section below for the deets. heads up bestie: this one is incompatible with --count 🚫
  • --count — outputs only the number of monitors. no list, just the digits. also: incompatible with --format 🚫
  • --json — outputs in JSON format. and yes you can use it in combination with --format to pick which data goes into the json 🧚‍♀️ but it's incompatible with --count 🚫

🌈 OUTPUT FORMAT

okay so this is the fun part. you can configure the output format with the optional [--format <output-format>] option, and <output-format> supports string interpolation (like, the Wikipedia kind: <https://en.wikipedia.org/wiki/String_interpolation>) ✨

if you don't specify anything, the default <output-format> is literally:

%{monitor-id}%{right-padding} | %{monitor-name}

and here are all the variables you can drop inside <output-format> 💖

  • %{monitor-id} — a 1-based number. it's the sequential number of the belonging monitor 🔢
  • %{monitor-appkit-nsscreen-screens-id} — a 1-based index of the belonging monitor in the NSScreen.screens array. super useful for integrating with other tools that might be using NSScreen.screens ordering — like sketchybar, iykyk 😌
  • %{monitor-name} — a string. the name of the belonging monitor 🏷️
  • %{monitor-is-main} — a boolean. True if the monitor is main 👑
  • %{right-padding} — a special variable that expands into the minimum number of spaces required to form a right padding in the appropriate column. it's giving formatting queen 💅
  • %{newline} — the Unicode U+000A newline symbol \n ⬇️
  • %{tab} — the Unicode U+0009 tab symbol \t ➡️

🔥 RESOURCES

go read them, they're lowkey essential 🫶

💀 BUGS

found a bug? bestie, report it here: <https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs>

and then: maintainers will move verified bugs over to <https://github.com/nikitabobko/AeroSpace/issues>

so don't panic if your bug report gets relocated — that's just the pipeline working 💜

📜 LICENSE

Copyright © 2023 Nikita Bobko

Free use of this software is granted under the terms of the MIT License.

you can find the full text of the AeroSpace license and its dependencies in the legal directory of the distributed zip archive 📁✨

🫶 AUTHOR

Nikita Bobko and contributors

that's the whole page bestie, go forth and list those monitors 💅🖥️

AeroSpace — 2026-07-16 — AEROSPACE-LIST-MONITORS(1) 🎀

📦 where this page comes from