AEROSPACE-FULLSCREEN(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 NAME

aerospace-fullscreen — toggles the fullscreen mode for the focused window, bestie ✨

🦋 SYNOPSIS

aerospace fullscreen [-h|--help]     [--window-id <window-id>] [--no-outer-gaps]
aerospace fullscreen [-h|--help] on  [--window-id <window-id>] [--no-outer-gaps] [--fail-if-noop]
aerospace fullscreen [-h|--help] off [--window-id <window-id>] [--fail-if-noop]

🌸 DESCRIPTION

Okay so it literally just toggles the fullscreen mode for the focused window. That's the whole vibe. Fullscreen on, fullscreen off. Iconic behavior, no notes 💅

But here's the plot twist you need to know: if your current focused window is in fullscreen mode and you switch to a different tiling window within the same workspace, the fullscreen window is gonna exit fullscreen mode. Like, it just does. That's the rule, periodt. So don't come for me when it happens — it's giving expected behavior, not a bug 👑

🎀 OPTIONS

  • -h, --help — prints the help. classic. we love a helpful king 🫶
  • --no-outer-gaps — removes the outer gaps when you're in fullscreen mode. bye-bye margins, hello edge-to-edge slay ✨
  • --fail-if-noop — exits with a non-zero exit code if the window is already fullscreen or already not fullscreen. basically it refuses to do nothing quietly — very main character of it tbh 💀
  • --window-id <window-id> — acts on the specified window instead of the focused window. and listen, this flag takes precedence over the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables. so if you're passing both, the flag wins, no cap 👑

🦄 ARGUMENTS

  • on, off — on means enter fullscreen mode. off means exit fullscreen mode. and if you don't specify either one? it just toggles between the two. lowkey the most chill option 🌈

💖 RESOURCES

go read the guide bestie, it's giving essential lore 📚

🐛 BUGS

Found a bug? Report it to https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs 🙈

And then — the maintainers will move verified bugs over to https://github.com/nikitabobko/AeroSpace/issues. that's the whole pipeline, no extra steps, you're welcome 💜

👑 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 AeroSpace license and its dependencies in the 'legal' directory of the distributed zip archive. it's all in there, fr fr 🎀

🧚 AUTHOR

Nikita Bobko and contributors 💫

okay that's the whole page, you're officially educated on aerospace-fullscreen 🎓✨

This was brought to you by the AeroSpace Manual, dated 2026-07-16 — stay slay, stay tiled 💅💖

📦 where this page comes from