Etherbit Tiling
O tecido invisível que coloca suas janelas em órbita perfeita.
Gerenciador automático de janelas (tiling window manager) com algoritmo agnóstico em Rust,
foco principal em macOS (Swift nativo) e suporte a Linux / GNOME 45+ (Wayland) e
KDE Plasma 6 (Wayland). Inspirado no ambiente COSMIC do Pop!_OS.
✨ Visão geral
O Etherbit Tiling nasceu da falta, no Mac, de um gerenciador de janelas realmente automático,
fluido e resistente a atualizações do sistema. Em vez de arrastar janelas na mão, o Etherbit calcula
o espaço da tela e posiciona cada janela na sua "órbita" ideal automaticamente.
O coração do projeto é o algoritmo Ether Flow — uma divisão matemática de tela, agnóstica de
plataforma, escrita em Rust. Cada sistema operacional tem apenas uma fina camada nativa que captura
eventos de janela e aplica as decisões do core.
📖 A história e a filosofia do nome estão em docs/NOMENCLATURA.md.
O que entrega
- Tiling Dinâmico — janelas organizadas automaticamente ao abrir/fechar apps, sem mouse.
- Ether Flow — preenchimento inteligente que elimina espaços mortos e se adapta em tempo real.
- Arquitetura nativa e resiliente — camada macOS em Swift sobre as APIs estáveis da Apple
(Accessibility); não quebra a cada atualização do macOS.
Atalhos (GNOME e KDE, padrão inspirado no COSMIC)
No KDE, Super é a tecla Meta. A exceção é o liga/desliga da chave geral, que no KDE é Meta+Shift+Y.
| Atalho | Ação |
|---|
Super + setas | Foca a janela vizinha (atravessa monitores) |
Super+Shift + setas | Move a janela (na borda, vai para o monitor vizinho) |
Super+Alt + setas | Troca a janela com a vizinha |
Super+Ctrl + setas | Redimensiona (direita/baixo cresce, esquerda/cima encolhe) |
Super+O | Alterna a orientação do split da janela focada |
Super+G | Alterna a janela focada entre tiling e flutuante |
Super+S | Agrupa/desagrupa as janelas em abas |
Super+] / Super+[ | Próxima/anterior aba do grupo |
Super+Y | Liga/desliga o tiling no workspace atual |
Os atalhos nativos do GNOME que colidem (meia-tela, maximizar, mover entre monitores, trava de
rotação em Super+O) ficam desligados enquanto a extensão está ativa e são restaurados ao desativá-la
(chave override-conflicting-keys). Detalhes em rules/0068.
No KDE, o instalador libera os padrões do KWin que colidem: Quick Tile (Meta+setas), mover para a tela
vizinha (Meta+Shift+setas) e Switch Window (Meta+Alt+setas). O desinstalador os restaura. Para manter
os atalhos do KWin, instale com ETHERBIT_KEEP_KDE_SHORTCUTS=1. Detalhes em
rules/0070.
🗂️ Estrutura do monorepo
Etherbit-Tiling/
├── core/ # 🦀 Rust — algoritmo agnóstico "Ether Flow" (etherbit-tiling-core)
├── platform-macos/ # 🍎 Swift nativo (AppKit + Accessibility) — build no host macOS
├── etherbit-tiling-daemon/ # 🐧 Linux — daemon (Rust/D-Bus) compartilhado por GNOME e KDE
├── platform-linux-gnome/ # 🐧 Linux/GNOME — extension (Vite/TS); usa o daemon
├── platform-linux-kde/ # 🐧 Linux/KDE Plasma 6 (Wayland) — KWin Script (Vite/TS); reusa o daemon
├── web/ # 🌐 Landing page global (Vite + CSS3 puro) — hub de downloads
├── .devcontainer/ docker/ # 🐳 Dev Container (imagem em docker/Dockerfile.core)
├── docs/ rules/ # 📚 Documentação e decisões de projeto (ADR)
└── Cargo.toml # Workspace Rust raiz, agnóstico (só o core)
Árvore detalhada e o papel de cada componente em docs/ESTRUTURA.md.
🚀 Começando
O desenvolvimento do core (Rust) e da extension (TypeScript/Vite) roda dentro de um
Dev Container. O build do macOS (Swift) roda no host macOS (restrição do SDK da Apple).
# 1. Abra o projeto no VS Code e escolha: "Reopen in Container"
# 2. Build do core (workspace raiz, agnóstico):
cargo build
# 3. Build/execução do daemon Linux (workspace próprio, compartilhado por GNOME/KDE):
cd etherbit-tiling-daemon && cargo build # ou: cargo run -p etherbit-tiling-daemon (sobe o D-Bus dev.ediano.etherbit.Tiling)
# 4. Build/instalação da extensão GNOME (pnpm via corepack):
cd platform-linux-gnome/extension && pnpm install && pnpm run install:ext
# 5. Build/instalação do KWin Script KDE (Plasma 6/Wayland; reusa o daemon):
cd platform-linux-kde/kwin-script && pnpm install && pnpm run install:script
Ícone na bandeja (KDE): o applet da System Tray vem no release
(packaging/build-kde-release.sh + install-kde.sh). Ele fica elegível, não é forçado no painel —
habilite em Config. da Bandeja do Sistema → Entradas → Etherbit Tiling → Mostrar (ADR 0059).
Guia completo em docs/DESENVOLVIMENTO.md.
📚 Documentação
🧱 Status
🚧 Fundação inicial. A estrutura do monorepo, o ambiente de desenvolvimento (Dev Container) e os
crates stub já estão no lugar. O algoritmo Ether Flow e as camadas de plataforma estão em construção.
