English | Türkçe
Atom Shell is a customizable desktop shell for Hyprland, built with QML and Quickshell on the Caelestia Shell architecture.
It brings the desktop bar, launcher, media controls, device management, and Nexus settings center into one interface. Setup and management scripts handle dependencies, configuration backups, updates, and rollback. Arch Linux and CachyOS are the primary native targets.
All screenshots are captured natively at 1080p from a clean installation.
| Desktop Bar & Workspaces | Application Launcher |
|---|---|
 |
 |
| Dashboard Overview | Dashboard Media & Lyrics |
|---|---|
 |
 |
| Phone Integration | System Performance HUD |
|---|---|
 |
 |
| Nexus Settings Center | In-Game Performance Panel |
|---|---|
 |
 |
- Comprehensive Bilingual UI: Full English and Turkish support across all QML modules (
qsTr()catalogs and live language switching in Nexus). - Material You Dynamic Theming: Wallpaper-derived color schemes, custom accent palettes, blur, and opacity controls.
- Nexus Control Center: 15 modular setting panels managing displays, networks, Bluetooth, audio, power, updates, plugins, shortcuts, and apps.
- Game Mode & Frame Generation: Real-time FPS overlay HUD, direct scanout passthrough, GPU/CPU performance governor, and 3D test cube.
- Phone & Tailscale Integration: Live battery state, drag-and-drop file transfers, scrcpy screen mirroring, remote call answering, and mesh discovery.
- Graceful Low-Battery Hibernation: Multi-stage countdown and secure snapshot to disk before battery exhaustion.
- Ergonomic Keyboard Shortcuts: Interactive search HUD (
F12/Super + Shift + H) and conflict-free Hyprland Lua keybindings. - Safe Setup & Rollbacks: Interactive setup, timestamped backups, and configuration merge and rollback tools.
| Distribution | Runtime | Support Level |
|---|---|---|
| Arch Linux | Native Qt 6.9+, Quickshell | Tier 1 (Full Native) |
| CachyOS | Native Qt 6.9+, Quickshell | Tier 1 (Full Native) |
| Debian 13/14 | Nix runtime + apt integration | Supported |
| Ubuntu / Linux Mint | Nix runtime + apt integration | Experimental (requires Hyprland 0.55+) |
For distribution-specific prerequisites and details, refer to the Distribution Guide.
Requirements: Hyprland 0.55+, Qt 6.9+, and Quickshell 0.3 or a current Git build. The installer handles platform-specific dependencies; review the Distribution Guide before setup.
Clone the repository and start the interactive setup wizard:
git clone https://github.com/aToom13/Atom-Shell.git
cd Atom-Shell
# Interactive installation wizard
./setup.shAlternatively, you can run ./install.sh with granular command-line flags:
# Preview actions without modifying system files
./install.sh --dry-run
# Non-interactive automated install
./install.sh --non-interactive --config-mode mergeRun the built-in diagnostic tool to check dependencies and report missing integrations:
atomshell doctorThe atomshell management utility is installed to ~/.local/bin/atomshell:
atomshell start # Launch Atom Shell in background
atomshell stop # Safely stop active shell instance
atomshell restart # Reload and restart shell components
atomshell nexus # Open Nexus Control Center
atomshell doctor # Run dependency and health diagnostics
atomshell log # Stream live quickshell logsDetailed topics and technical guides are split into dedicated documents:
- Nexus Control Center Guide: Deep dive into the 15 control pages and configuration state.
- Game Mode & Optimization Guide: Frame Generation, in-game HUD, VRR, and test cube.
- Phone & Tailscale Integration: KDE Connect, wireless ADB, clipboard sync, and SSH automation.
- Keyboard Shortcuts Guide: Window tiling, special workspaces, and shortcut search HUD.
- Architecture & Runtime: Quickshell lifecycle, IPC mechanisms, and configuration hierarchy.
- Distribution Notes: Platform requirements, package lists, and Nix runtime details.
Licensed under GPL-3.0. Atom Shell builds on Caelestia Shell; upstream copyright and license notices are retained.