Skip to content

stevenvelozo/AeroSpace

 
 

Repository files navigation

AeroSpace Beta Build

AeroSpace is an i3-like tiling window manager for macOS

Project status

Public Beta. Feedback is very much welcome

  • I encourage you to try AeroSpace and file GitHub issues if something doesn't work for you. In particular, I'm interested in issues that block you from using AeroSpace on daily basis.
  • I already use AeroSpace on daily basis and I'm happy with it
  • The documentation covers all major things you need to know
  • Expect minor breaking changes in the config format. Once the project reaches 1.0 the config is guaranteed to preserve backwards compatibility

Key features

Installation

Install via Homebrew to get autoupdates (Preferred)

brew install --no-quarantine --cask nikitabobko/tap/aerospace

Manual installation

Development notes

A notes on how to setup the project, build it, how to run the tests, etc. can be found here: docs/development.md

Values of the project

Values

  • AeroSpace is targeted at advanced users and developers
  • Keyboard centric
  • Breaking changes (configuration files, CLI, behavior) are avoided as much as possible, but it must not let the software stagnate. Thus breaking changes can happen, but with careful considerations and helpful message. Semver 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)
  • AeroSpace doesn't use GUI, unless necessarily
    • AeroSpace will never provide a GUI for configuration. For advanced users, it's easier to edit a configuration file in text editor rather than navigating through checkboxes in GUI.
    • Status menu icon is ok, because visual feedback is needed
  • Provide practical features. Fancy appearance features are not practical (e.g. window borders, transparency, etc)
  • If "dark magic" (aka "private APIs", "code injections", etc) can be avoided, it must be avoided

Non Values

  • Play nicely with existing macOS features. If limitations are imposed then AeroSpace won't play nicely with existing macOS features

Tip of the day

defaults write -g NSWindowShouldDragOnGesture YES

Now, you can move windows by holding ctrl+cmd and dragging any part of the window (not necessarily the window title)

Source: reddit

Related projects

About

AeroSpace is an i3-like tiling window manager for macOS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Swift 96.9%
  • Shell 2.8%
  • Objective-C 0.3%