AxyZ — macOS Window Manager

Русское описание ниже

AxyZ is a lightweight, open-source macOS window manager that allows you to quickly position windows using customizable global hotkeys.

✨ What's New in v1.1

• Cheatsheet Overlay: Hold the Option (⌥) key for 0.5s to display a beautiful semi-transparent overlay with all active hotkeys.
• Thirds Layout Cycling: The Left and Right Half shortcuts now cycle intelligently. Press once for ½, again for ⅓, and a third time for ⅔ of the screen width!
• Multi-Display Support: Instantly move windows between your monitors using Control + Option + Left/Right Arrow.
• HUD Toggle: You can now disable the heads-up display notifications from Preferences.

💡 The Problem It Solves

On macOS, managing multiple windows manually by dragging edges can be slow and tedious. AxyZ solves this by offering instant keyboard shortcuts to snap windows into halves, thirds, quarters, center, or fullscreen. It runs entirely in the background as a menu bar app (LSUIElement), ensuring zero distraction and maximum desktop space.

⬇️ Installation

Option 1: Via Homebrew (Recommended)

brew install --cask appleimax1/axyz/axyz

Option 2: Direct Download

You can download the compiled .dmg installer directly from GitHub Releases or Google Drive.

⚠️ Important: First-Time Setup

Because the application is not signed with an official Apple Developer account, macOS Gatekeeper may block it upon first run. To bypass this and open the app:

1. Move AxyZ.app to your /Applications folder.
2. Open Terminal and run the following command to remove the quarantine attribute:

   sudo xattr -cr /Applications/AxyZ.app

3. Grant AxyZ Accessibility Permissions in System Settings > Privacy & Security > Accessibility so it can manage other windows.

---

⌨️ Default Hotkeys

All hotkeys are fully customizable in the Preferences window. The default layout is:

Action	Shortcut	Description
Center	⌥ + ⇧ + S	Moves window to center & resizes to 70% of screen
Strict Center	⌥ + S	Centers window without changing its size
Fullscreen	⌥ + W	Maximize window
Undo	⌥ + Z	Reverts the last window movement
Left Half / Thirds	⌥ + A	Snap to left side (Cycles ½ → ⅓ → ⅔)
Right Half / Thirds	⌥ + D	Snap to right side (Cycles ½ → ⅓ → ⅔)
Top Half	⌥ + Q	Snap to top side
Bottom Half	⌥ + E	Snap to bottom side
Upper Left Quarter	⌥ + 1	Snap to top-left corner
Lower Left Quarter	⌥ + 2	Snap to bottom-left corner
Upper Right Quarter	⌥ + 3	Snap to top-right corner
Lower Right Quarter	⌥ + 4	Snap to bottom-right corner
Next Display	⌃ + ⌥ + ➡️	Move window to the next monitor
Previous Display	⌃ + ⌥ + ⬅️	Move window to the previous monitor

---

AxyZ — Оконный менеджер для macOS

AxyZ — это легкий оконный менеджер для macOS с открытым исходным кодом, который позволяет мгновенно менять положение окон с помощью настраиваемых глобальных горячих клавиш.

✨ Что нового в версии 1.1

• Шпаргалка (Cheatsheet): Удерживайте клавишу Option (⌥) полсекунды, чтобы увидеть красивый полупрозрачный оверлей со всеми хоткеями.
• Треугольная цикличность (Thirds Layout): Хоткеи левой и правой половины теперь умнее. Нажмите один раз для ½, второй раз для ⅓, и третий раз для ⅔ ширины экрана!
• Поддержка нескольких мониторов: Мгновенно перекидывайте окна между экранами с помощью Control + Option + Стрелки.
• Отключение HUD: Всплывающие уведомления с названиями действий теперь можно отключить в настройках.

💡 Какую проблему решает программа

В macOS ручное перетаскивание окон за края для организации рабочего пространства отнимает много времени. AxyZ решает эту проблему, предлагая быстрые сочетания клавиш для раскладки окон по половинам, третям, четвертям, центру или на весь экран. Приложение работает полностью в фоновом режиме (скрыто из Dock) и управляется через иконку в строке меню.

⬇️ Установка

Способ 1: Через Homebrew (Рекомендуется)

brew install --cask appleimax1/axyz/axyz

Способ 2: Прямая загрузка

Вы можете скачать файл .dmg напрямую из GitHub Releases или с Google Диска.

⚠️ Важно: Первый запуск

Так как приложение собрано без платной подписи Apple Developer, система macOS Gatekeeper может заблокировать запуск. Чтобы запустить приложение:

1. Переместите AxyZ.app в папку /Программы (/Applications).
2. Откройте Терминал и выполните следующую команду для снятия блокировки карантина:

   sudo xattr -cr /Applications/AxyZ.app

3. Дайте AxyZ разрешение на Универсальный доступ в Системных настройках > Конфиденциальность и безопасность > Универсальный доступ, чтобы утилита могла управлять окнами.

---

⌨️ Стандартные Горячие Клавиши

Вы можете изменить любые хоткеи под себя в окне настроек. Стандартная раскладка:

Действие	Сочетание клавиш	Описание
По центру	⌥ + ⇧ + S	По центру экрана с изменением размера до 70%
По центру (строго)	⌥ + S	Центрирует окно без изменения его масштаба
На весь экран	⌥ + W	Развернуть окно на весь экран
Отмена	⌥ + Z	Возвращает окно в предыдущее положение (Undo)
Левая половина / Трети	⌥ + A	Окно влево (Циклично ½ → ⅓ → ⅔)
Правая половина / Трети	⌥ + D	Окно вправо (Циклично ½ → ⅓ → ⅔)
Верхняя половина	⌥ + Q	Окно на верхнюю половину экрана
Нижняя половина	⌥ + E	Окно на нижнюю половину экрана
Левый верх	⌥ + 1	Поместить в левую верхнюю четверть
Левый низ	⌥ + 2	Поместить в левую нижнюю четверть
Правый верх	⌥ + 3	Поместить в правую верхнюю четверть
Правый низ	⌥ + 4	Поместить в правую нижнюю четверть
След. монитор	⌃ + ⌥ + ➡️	Переместить окно на следующий монитор
Пред. монитор	⌃ + ⌥ + ⬅️	Переместить окно на предыдущий монитор

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.