All Projects → ianyh → Amethyst

ianyh / Amethyst

Licence: mit
Automatic tiling window manager for macOS à la xmonad.

Programming Languages

swift
15916 projects
objective c
16641 projects - #2 most used programming language
shell
77523 projects
ruby
36898 projects - #4 most used programming language
Rich Text Format
576 projects
c
50402 projects - #5 most used programming language

Projects that are alternatives of or similar to Amethyst

dotfiles
🏡 There's no place like ~/
Stars: ✭ 59 (-99.41%)
Mutual labels:  mac, window-manager
xmonad-extras
Various modules for xmonad that cannot be added to xmonad-contrib because of additional dependencies.
Stars: ✭ 48 (-99.52%)
Mutual labels:  xmonad, window-manager
Xmonad
The core of xmonad, a small but functional ICCCM-compliant tiling window manager
Stars: ✭ 2,253 (-77.52%)
Mutual labels:  window-manager, xmonad
axyl-iso
Axyl is a Linux distro centered on tiling window managers. Choose from i3, bspwm, dwm and more.
Stars: ✭ 348 (-96.53%)
Mutual labels:  xmonad, window-manager
Midisequencer
MIDI Sequencer that sends MIDI events to other apps.
Stars: ✭ 75 (-99.25%)
Mutual labels:  mac
Automator
Various Automator and AppleScript workflow and scripts for simplifying life
Stars: ✭ 68 (-99.32%)
Mutual labels:  mac
Polybar
A fast and easy-to-use status bar
Stars: ✭ 9,604 (-4.18%)
Mutual labels:  window-manager
Toaru Nih
NOTICE: The ToaruOS-NIH Project has been MERGED UPSTREAM. This repository is now archived.
Stars: ✭ 66 (-99.34%)
Mutual labels:  window-manager
Passwd
A beautiful, cross-platform, encrypted password manager 🔐
Stars: ✭ 82 (-99.18%)
Mutual labels:  mac
Qqmessageinvoke
👍QQ 防测回插件 🎁
Stars: ✭ 81 (-99.19%)
Mutual labels:  mac
Rhea
A Mac status bar app for quickly sharing files and links.
Stars: ✭ 73 (-99.27%)
Mutual labels:  mac
Reminders Cli
Command-line interface to interact with the Reminders.app
Stars: ✭ 67 (-99.33%)
Mutual labels:  mac
Macchanger
 Change your mac address, for macOS
Stars: ✭ 75 (-99.25%)
Mutual labels:  mac
M Cli
 Swiss Army Knife for macOS
Stars: ✭ 8,646 (-13.74%)
Mutual labels:  mac
Ship
A simple, handy network addressing multitool with plenty of features
Stars: ✭ 81 (-99.19%)
Mutual labels:  mac
Build Deep Learning Env With Tensorflow Python Opencv
Tutorial on how to build your own research envirorment for Deep Learning with OpenCV, Python, Tensorfow
Stars: ✭ 66 (-99.34%)
Mutual labels:  mac
Macimagesetgenerator
2个脚本文件,帮助你在Mac上,生成Xcode可使用的APP图标和启动图。
Stars: ✭ 73 (-99.27%)
Mutual labels:  mac
Mac Zsh Completions
macOS specific additional completion definitions for Zsh.
Stars: ✭ 79 (-99.21%)
Mutual labels:  mac
Subethaedit
General purpose plain text editor for macOS. Widely known for its live collaboration feature.
Stars: ✭ 1,183 (-88.2%)
Mutual labels:  mac
Macqq
mac版QQ,swift,macOS,仿QQ mac端
Stars: ✭ 72 (-99.28%)
Mutual labels:  mac

Amethyst

Join the chat at https://gitter.im/ianyh/Amethyst Build Status Open Source Helpers Reviewed by Hound Twitter Follow

Tiling window manager for macOS along the lines of xmonad.

Windows

A quick screencast of basic functionality can be found here. (It's rough, and I'd love to see a better one if someone has the skills and inclination to make one.)

Getting Amethyst

Amethyst is available for direct download on the releases page or using homebrew cask.

brew install --cask amethyst

Note: that Amethyst now is only supported on macOS 10.12+.

Using Amethyst

Amethyst must be given permissions to use the accessibility APIs under the Privacy tab of the Security & Privacy preferences pane as shown below.

Accessibility permissions

Important note: You will probably want to disable Automatically rearrange Spaces based on most recent use (found under Mission Control in System Preferences). This setting is enabled by default, and will cause your Spaces to swap places based on use. This makes keyboard navigation between Spaces unpredictable.

Keyboard Shortcuts

Amethyst uses two modifier combinations.

Default Shortcut Description
mod1 option + shift
mod2 ctrl + option + shift

And defines the following commands, mostly a mapping to xmonad key combinations.

Default Shortcut Description
mod1 + space Cycle layout forward
mod2 + space Cycle layout backwards
mod1 + h Shrink the main pane
mod1 + l Expand the main pane
mod1 + , Increase main pane count
mod1 + . Decrease main pane count
mod1 + j Move focus counter clockwise
mod1 + k Move focus clockwise
mod1 + p Move focus to counter clockwise screen
mod1 + n Move focus to clockwise screen
mod2 + h Swap focused window to counter clockwise screen
mod2 + l Swap focused window to clockwise screen
mod2 + j Swap focused window counter clockwise
mod2 + k Swap focused window clockwise
mod1 + enter Swap focused window with main window
mod1 + z Force windows to be reevalulated
mod2 + z Relaunch Amethyst
mod2 + left Throw focused window to space left
mod2 + right Throw focused window to space right
mod2 + 1 Throw focused window to space 1
mod2 + 2 Throw focused window to space 2
mod2 + 3 Throw focused window to space 3
mod2 + 4 Throw focused window to space 4
mod2 + 5 Throw focused window to space 5
mod2 + 6 Throw focused window to space 6
mod2 + 7 Throw focused window to space 7
mod2 + 8 Throw focused window to space 8
mod2 + 9 Throw focused window to space 9
mod2 + 0 Throw focused window to space 10
mod1 + w Focus Screen 1
mod2 + w Throw focused window to screen 1
mod1 + e Focus Screen 2
mod2 + e Throw focused window to screen 2
mod1 + r Focus Screen 3
mod2 + r Throw focused window to screen 3
mod1 + q Focus Screen 4
mod2 + q Throw focused window to screen 4
mod1 + t Toggle float for focused window
mod1 + i Display current layout
mod2 + t Toggle global tiling
mod1 + a Select tall layout
none Select tall-right layout
mod1 + s Select wide layout
none Select middle-wide layout
mod1 + d Select fullscreen layout
mod1 + f Select column layout
none Select row layout
none Select floating layout
none Select widescreen-tall layout
none Select bsp layout

Available Layouts

Amethyst allows you to cycle among several different window layouts. Layouts can also be enabled/disabled to control whether they appear in the cycle sequence at all.

Tall

The default layout. This gives you one "main pane" on the left, and one other pane on the right. By default, one window is placed in the main pane (extending the full height of the screen), and all remaining windows are placed in the other pane. If either pane has more than one window, that pane will be evenly split into rows, to show them all. You can use the keyboard shortcuts above to control which window(s), and how many, are in the main pane, as well as the horizontal size of the main pane vs. the other pane.

Tall-Right

Exactly the same as Tall, but the main pane is on the right, with the other pane on the left.

Wide

The rotated version of Tall, where the main pane is on the top (extending the full width of the screen), and the other pane is on the bottom. If either pane has more than one window, that pane will split into columns instead of rows.

3Column-Left

A three-column version of Tall, with one main pane on the left (extending the full height of the screen) and two other panes, one in the middle and one on the right. Like Tall, if any pane has more than one window, that pane will be split into rows. You can control how many windows are in the main pane as usual; other windows will be assigned as evenly as possible between the other two panes.

3Column-Middle

Exactly like 3Column-Left, but the main pane is in the middle, with the other panes on either side. (In previous versions of Amethyst, this layout was known as Middle-Wide.)

3Column-Right

Exactly like 3Column-Left, but the main pane is on the right, with the other panes in the middle and on the left.

Widescreen-Tall

This mode is like Tall, but if there are multiple windows in the main pane, the main pane splits into columns rather than rows. The other pane still splits windows into rows, like Tall. This layout gets its name because it probably makes the most sense on very wide screens, with a large main pane consisting of several columns, and all remaining windows stacked into the final column. Other layouts that work well on very wide screens include any that allow for more than two columns (to take advantage of the screen width), such as any of the 3Column-* layouts, or Column.

Fullscreen

In this layout, the currently focused window takes up the entire screen, and the other windows are not visible at all. You can rotate between each of the windows using the "focus the next window" shortcut, as usual.

Column

This layout has one column per window, with each window extending the full height of the screen. The farthest-left window is considered the "main" window in the sense that you can change its size with the "shrink/expand the main pane" shortcuts; the other windows split the remaining space evenly.

Row

The rotated version of Column, where each window takes up an entire row, extending the full width of the screen.

Floating

This mode makes all windows "floating", allowing you to move and resize them as if Amethyst were temporarily deactivated. Unlike the other modes, this will mean that windows can be placed "on top of" each other, obscuring your view of some windows.

Binary Space Partitioning (BSP)

This layout does not have a main pane in the way that other layouts do. When adding windows, any given pane can be split evenly into two panes along whatever axis is longer. This is recursive such that pane A can be split in the middle into pane A on the left and pane B on the right; pane B can then be split into pane B on top and pane C on bottom; pane C can then be split into pane C on the left and pane D on the right; and so on.

Contributing

If you'd like to contribute please branch off of the development branch and open pull requests against it rather than master. Otherwise just try to stick to the general style of the code. There is a setup script to guide you through the process of installing necessary tools and getting dependencies built. To get started run

$ ./bin/setup.sh

Contact

If you have questions or feedback your best options are to tweet or to get on gitter.

Donating

Amethyst is free and always will be. That said, a couple of people have expressed their desire to donate money in appreciation. Given the current political climate I would recommend donating to one of these organizations instead:

And a bunch of technology-oriented ones:

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].