Repository navigation
Releases: kylelee/auto-tile
Release list
v18.0 AutoTile
Release Notes — AutoTile v18.0
AutoTile v18.0 — First Unified Release 🎉
AutoTile v18.0 is the first independent release, forked from the excellent
Tiling Shell v17.3 and heavily
inspired by Omarchy and Hyprland.
It runs on GNOME Shell 42–50, X11 & Wayland, multi-monitor with mixed
scaling factors.
AutoTile uses its own UUID (
autotile@kylelee.github.io) and settings
schema — it can be installed alongside Tiling Shell. If you're migrating
from Tiling Shell, reconfigure your settings once after installing.
✨ Highlights
Auto-tiling core
- Insert after focused window — when the focused window is tiled, a new
window opens on the tile right after it; tiled windows behind it shift
forward along the global top-to-bottom / left-to-right order, cascading
across monitors. - Workspace overflow tiling — when every monitor on the current workspace
is full, new windows auto-tile to the first free tile on a later workspace
(creating one first when dynamic workspaces are enabled).
(new preference, on by default) - Auto-refill of freed tiles — closing or moving away a tiled window
refills the gap: same-workspace windows shift forward, and remaining gaps
pull windows back from workspaces to the right, so every workspace stays
continuously filled from the top-left. (new preference, on by default) - Layout enforcement while dragging — with refill enabled, dragging can
no longer un-tile a window: stray drops snap back into the layout. - Focus on close — when a tiled window closes, keyboard focus moves to
the window that took its tile.
Keyboard tiling
- Swap: moving a window onto an occupied tile swaps the two windows,
even across monitors. - Smart cross-monitor move: prefers free tiles, scans monitors in row
order by nearest-center distance;SUPER+UPprefers a tile on the monitor
above over maximizing. - Cross-workspace moves: at the last monitor's edge, windows move to the
adjacent workspace (auto-created with dynamic workspaces). - Directional focus穿透 workspaces: directional focus falls through to
windows on the adjacent workspace at the screen edge.
Robustness & i18n
- Layout import validation & self-healing: invalid layout JSON is
rejected with a clear reason; corrupted layouts no longer crash the
extension — the last tile and layout are always protected. - Rebuilt Chinese translations:
zh_Simplified/zh_Traditional
directories with runtime catalog resolution (zh_CN/zh_SG→ Simplified,
zh_TW/zh_HK→ Traditional). - Ghost-window immunity: windows being destroyed by the compositor are
never tiled. - Numerous fixes over the fork baseline: tiling geometry drift, signal
leaks, settings-import data loss (auto-restore from backup), D-Bus export
rollback,Math.clampcrash, and more — see
CHANGELOG.md for the full list.
⚠️ Default changes
- Focus-navigation keybindings now default to
<Alt>+arrowsand
<Alt>Page_Down/Page_Up. - The default layout set now ships 5 layouts, with a 50/50 two-column
layout first.
AutoTile v18.0 — 首个统一版本 🎉
AutoTile v18.0 是从优秀的 Tiling Shell
v17.3 fork 而来的首个独立发布版本,深受 Omarchy 与
Hyprland 启发。支持 GNOME Shell 42–50、X11 与
Wayland、不同缩放比例的多显示器。
AutoTile 使用独立 UUID(
autotile@kylelee.github.io)与独立设置 schema,
可与 Tiling Shell 共存安装;从 Tiling Shell 迁移需重新配置一次设置。
✨ 亮点
自动平铺核心
- 焦点后插入:焦点窗口已平铺时,新窗口插入到它之后的空位,其后的窗口沿
全局自上而下、自左而右顺序链式前移,跨显示器级联。 - 工作区溢出平铺:当前工作区所有显示器满员时,新窗口自动平铺到后续
工作区的首个空位(动态工作区开启时可先创建新工作区)。(新设置,默认开启) - 空位自动回填:平铺窗口关闭或移走后,同工作区窗口链式前移补位,缺口再
从右侧工作区拉回窗口填补,每个工作区始终自左上角连续填满。(新设置,默认开启) - 拖拽布局锁定:回填开启时,拖拽无法让窗口脱离平铺,散乱落点自动吸回布局。
- 关窗聚焦:平铺窗口关闭后,键盘焦点自动落到补上该位置的窗口。
键盘平铺
- 占位交换:移动窗口到已占用 tile 时自动交换两个窗口位置,支持跨显示器。
- 跨显示器智能移动:优先落位空闲 tile;
SUPER+UP在上方显示器有空位时
优先进 tile 而非最大化。 - 跨工作区移动:窗口移到最末显示器边缘时进入相邻工作区(可自动创建)。
- 方向焦点穿透:方向焦点切换在工作区边缘落到相邻工作区的窗口。
稳定性与本地化
- 布局导入校验与自愈:非法布局 JSON 会被拒绝并给出明确原因;损坏的布局
不再导致崩溃,最后一个 tile 与布局始终受保护。 - 中文翻译重构:
zh_Simplified/zh_Traditional目录 + 运行时目录解析
(zh_CN/zh_SG→ 简体,zh_TW/zh_HK→ 繁体)。 - 幽灵窗免疫:正在被销毁的窗口不会被误贴砖。
- 相对 fork 基线的大量修复:贴砖几何漂移、信号泄漏、设置导入数据丢失
(自动从备份恢复)、D-Bus 失败回滚、Math.clamp崩溃等——完整清单见
CHANGELOG.md。
⚠️ 默认值变更
- 焦点导航快捷键默认改为
<Alt>+方向键与<Alt>Page_Down/Page_Up。 - 默认布局集内置 5 个布局,首选 50/50 双栏布局。
🙏 Thanks to Domenico Ferraro and the original
Tiling Shell project, the Omarchy contributors, and Hyprland.