{"id":13469104,"url":"https://github.com/nikitabobko/AeroSpace","last_synced_at":"2025-03-26T05:31:33.554Z","repository":{"id":195160422,"uuid":"643647588","full_name":"nikitabobko/AeroSpace","owner":"nikitabobko","description":"AeroSpace is an i3-like tiling window manager for macOS","archived":false,"fork":false,"pushed_at":"2024-10-27T15:41:54.000Z","size":7952,"stargazers_count":6836,"open_issues_count":154,"forks_count":112,"subscribers_count":32,"default_branch":"main","last_synced_at":"2024-10-29T15:38:22.026Z","etag":null,"topics":["i3","i3wm","mac","macos","tiling","tiling-window-manager","window-manager"],"latest_commit_sha":null,"homepage":"https://nikitabobko.github.io/AeroSpace/guide","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nikitabobko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["nikitabobko"]}},"created_at":"2023-05-21T20:20:17.000Z","updated_at":"2024-10-29T15:03:55.000Z","dependencies_parsed_at":"2023-09-22T20:37:33.606Z","dependency_job_id":"f4795fc9-360f-45c6-926b-99a86dd458d1","html_url":"https://github.com/nikitabobko/AeroSpace","commit_stats":null,"previous_names":["nikitabobko/aerospace"],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikitabobko%2FAeroSpace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikitabobko%2FAeroSpace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikitabobko%2FAeroSpace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikitabobko%2FAeroSpace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nikitabobko","download_url":"https://codeload.github.com/nikitabobko/AeroSpace/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245556966,"owners_count":20634889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["i3","i3wm","mac","macos","tiling","tiling-window-manager","window-manager"],"created_at":"2024-07-31T15:01:26.535Z","updated_at":"2025-03-26T05:31:33.542Z","avatar_url":"https://github.com/nikitabobko.png","language":"Swift","funding_links":["https://github.com/sponsors/nikitabobko"],"categories":["Swift","By Language","Packages","Window Management","Recently Updated","Utilities","mac","ユーティリティ","📱 Mobile Development","Table of Contents","HarmonyOS"],"sub_categories":["Swift","window-managers","Text","[May 03, 2025](/content/2025/05/03/README.md)","Window Management","ウィンドウ管理","Windows Manager"],"readme":" \u003cimg src=\"./resources/Assets.xcassets/AppIcon.appiconset/icon.png\" width=\"40%\" height=\"40%\" align=\"right\"\u003e\n\n# AeroSpace Beta [![Build](https://github.com/nikitabobko/AeroSpace/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/nikitabobko/AeroSpace/actions/workflows/build.yml)\n\nAeroSpace is an i3-like tiling window manager for macOS\n\nVideos:\n- [YouTube 91 sec Demo](https://www.youtube.com/watch?v=UOl7ErqWbrk)\n- [YouTube Guide by Josean Martinez](https://www.youtube.com/watch?v=-FoWClVHG5g)\n\nDocs:\n- [AeroSpace Guide](https://nikitabobko.github.io/AeroSpace/guide)\n- [AeroSpace Commands](https://nikitabobko.github.io/AeroSpace/commands)\n- [AeroSpace Goodies](https://nikitabobko.github.io/AeroSpace/goodies)\n\n## Project status\n\nPublic Beta. AeroSpace can be used as a daily driver, but expect breaking changes until 1.0 is reached.\n\n## Key features\n\n- Tiling window manager based on a [tree paradigm](https://nikitabobko.github.io/AeroSpace/guide#tree)\n- [i3](https://i3wm.org/) inspired\n- Fast workspaces switching without animations and without the necessity to disable SIP\n- AeroSpace employs its [own emulation of virtual workspaces](https://nikitabobko.github.io/AeroSpace/guide#emulation-of-virtual-workspaces) instead of relying on native macOS Spaces due to [their considerable limitations](https://nikitabobko.github.io/AeroSpace/guide#emulation-of-virtual-workspaces)\n- Plain text configuration (dotfiles friendly). See: [default-config.toml](https://nikitabobko.github.io/AeroSpace/guide#default-config)\n- CLI first (manpages and shell completion included)\n- Doesn't require disabling SIP (System Integrity Protection)\n- [Proper multi-monitor support](https://nikitabobko.github.io/AeroSpace/guide#multiple-monitors) (i3-like paradigm)\n\n## Installation\n\nInstall via [Homebrew](https://brew.sh/) to get autoupdates (Preferred)\n\n```\nbrew install --cask nikitabobko/tap/aerospace\n```\n\nIn multi-monitor setup please make sure that monitors [are properly arranged](https://nikitabobko.github.io/AeroSpace/guide#proper-monitor-arrangement).\n\nOther installation options: https://nikitabobko.github.io/AeroSpace/guide#installation\n\n\u003e [!NOTE]\n\u003e By using AeroSpace, you acknowledge that it's not [notarized](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution).\n\u003e\n\u003e Notarization is a \"security\" feature by Apple.\n\u003e You send binaries to Apple, and they either approve them or not.\n\u003e In reality, notarization is about building binaries the way Apple likes it.\n\u003e\n\u003e I don't have anything against notarization as a concept.\n\u003e I specifically don't like the way Apple does notarization.\n\u003e I don't have time to deal with Apple.\n\u003e\n\u003e [Homebrew installation script](https://github.com/nikitabobko/homebrew-tap/blob/main/Casks/aerospace.rb) is configured to\n\u003e automatically delete `com.apple.quarantine` attribute, that's why the app should work out of the box, without any warnings that\n\u003e \"Apple cannot check AeroSpace for malicious software\"\n\n## Community, discussions, issues\n\nUnfortunately, AeroSpace project doesn't accept bug reports and feature requests from everyone.\nPlease read [CONTRIBUTING.md](./CONTRIBUTING.md) for more details.\n\nCommunity discussions happen at GitHub Discussions.\nThere you can discuss bugs, propose new features, ask your questions, show off your setup, or just chat.\n\nThere are 7 channels:\n-   [#all](https://github.com/nikitabobko/AeroSpace/discussions).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions.atom?discussions_q=sort%3Adate_created).\n    Feed with all discussions.\n-   [#announcements](https://github.com/nikitabobko/AeroSpace/discussions/categories/announcements).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions/categories/announcements.atom?discussions_q=category%3Aannouncements+sort%3Adate_created).\n    Only maintainers can post here.\n    Highly moderated traffic.\n-   [#announcements-releases](https://github.com/nikitabobko/AeroSpace/discussions/categories/announcements-releases).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions/categories/announcements-releases.atom?discussions_q=category%3Aannouncements-releases+sort%3Adate_created).\n    Announcements about non-patch releases.\n    Only maintainers can post here.\n-   [#feature-ideas](https://github.com/nikitabobko/AeroSpace/discussions/categories/feature-ideas).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions/categories/feature-ideas.atom?discussions_q=category%3Afeature-ideas+sort%3Adate_created).\n-   [#general](https://github.com/nikitabobko/AeroSpace/discussions/categories/general).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions/categories/general.atom?discussions_q=sort%3Adate_created+category%3Ageneral).\n-   [#potential-bugs](https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs.atom?discussions_q=category%3Apotential-bugs+sort%3Adate_created).\n    If you think that you have encountered a bug, you can discuss your bugs here.\n-   [#questions-and-answers](https://github.com/nikitabobko/AeroSpace/discussions/categories/questions-and-answers).\n    [RSS](https://github.com/nikitabobko/AeroSpace/discussions/categories/questions-and-answers.atom?discussions_q=category%3Aquestions-and-answers+sort%3Adate_created).\n    Everyone is welcome to ask questions.\n    Everyone is encouraged to answer other people's questions.\n\n## Development\n\nA notes on how to setup the project, build it, how to run the tests, etc. can be found here: [dev-docs/development.md](./dev-docs/development.md)\n\n## Project values\n\n**Values**\n- AeroSpace is targeted at advanced users and developers\n- Keyboard centric\n- Breaking changes (configuration files, CLI, behavior) are avoided as much as possible, but it must not let the software stagnate.\n  Thus breaking changes can happen, but with careful considerations and helpful message.\n  [Semver](https://semver.org/) major version is bumped in case of a breaking change (It's all guaranteed once AeroSpace reaches 1.0 version, until then breaking changes just happen)\n- AeroSpace doesn't use GUI, unless necessarily\n  - AeroSpace will never provide a GUI for configuration.\n    For advanced users, it's easier to edit a configuration file in text editor rather than navigating through checkboxes in GUI.\n  - Status menu icon is ok, because visual feedback is needed\n- Provide _practical_ features. Fancy appearance features are not _practical_ (e.g. window borders, transparency, animations, etc.)\n- \"dark magic\" (aka \"private APIs\", \"code injections\", etc.) must be avoided as much as possible\n  - Right now, AeroSpace uses only a single private API to get window ID of accessibility object `_AXUIElementGetWindow`.\n    Everything else is [macOS public accessibility API](https://developer.apple.com/documentation/applicationservices/axuielement_h).\n  - AeroSpace will never require you to disable SIP (System Integrity Protection).\n  - The goal is to make AeroSpace easily maintainable, and resistant to macOS updates.\n\n**Non Values**\n- Play nicely with existing macOS features.\n  If limitations are imposed then AeroSpace won't play nicely with existing macOS features\n  (For example, AeroSpace doesn't acknowledge the existence of macOS Spaces, and it uses [emulation of its own workspaces](https://nikitabobko.github.io/AeroSpace/guide#emulation-of-virtual-workspaces))\n- Ricing.\n  AeroSpace provides only a very minimal support for ricing - gaps and a few callbacks for integrations with bars.\n  The current maintainer doesn't care about ricing.\n  Ricing issues are not a priority, and they are mostly ignored.\n  The ricing stance can change only with the appearance of more maintainers.\n\n## Tip of the day\n\n```bash\ndefaults write -g NSWindowShouldDragOnGesture -bool true\n```\n\nNow, you can move windows by holding `ctrl`+`cmd` and dragging any part of the window (not necessarily the window title)\n\nSource: [reddit](https://www.reddit.com/r/MacOS/comments/k6hiwk/keyboard_modifier_to_simplify_click_drag_of/)\n\n## Related projects\n- [Amethyst](https://github.com/ianyh/Amethyst)\n- [yabai](https://github.com/koekeishiya/yabai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikitabobko%2FAeroSpace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikitabobko%2FAeroSpace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikitabobko%2FAeroSpace/lists"}