https://github.com/Axenide/Ambxst
An Axtremely customizable shell.
https://github.com/Axenide/Ambxst
desktop desktop-environment hyprland quickshell shell wayland
Last synced: 2 months ago
JSON representation
An Axtremely customizable shell.
- Host: GitHub
- URL: https://github.com/Axenide/Ambxst
- Owner: Axenide
- License: agpl-3.0
- Created: 2025-07-03T16:51:13.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-02-19T18:41:53.000Z (2 months ago)
- Last Synced: 2026-02-19T21:35:21.182Z (2 months ago)
- Topics: desktop, desktop-environment, hyprland, quickshell, shell, wayland
- Language: QML
- Homepage: https://axeni.de/ambxst
- Size: 32.8 MB
- Stars: 483
- Watchers: 6
- Forks: 25
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- my-awesome-github-stars - Axenide/Ambxst - An Axtremely customizable shell. (QML)
README
An Axtremely customizable shell.
---
Screenshots
---
Installation
```bash
curl -L get.axeni.de/ambxst | sh
```
Ambxst is currently supported on **Arch**, **Fedora**, and **NixOS**. This means both based and derivative distributions.
> [!IMPORTANT]
> The only pre-requisite is having Hyprland installed.
> [!NOTE]
> For NixOS users, the screen recording utility `gpu-screen-recorder` will only be able to use the `portal` backend until you add `programs.gpu-screen-recorder.enable = true;` to your `configuration.nix` or **home-manager**.
---
## Will this change my config?
Nope! Ambxst is designed to be non-intrusive. It won't modify any of your existing configurations.
It applies its own settings only when it runs, via IPC communication. This means you can safely switch back to your previous setup by simply exiting Ambxst.
---
Features
- [x] Customizable components
- [x] Themes
- [x] System integration
- [x] App launcher
- [x] Clipboard manager
- [x] Quick notes (and not so quick ones)
- [x] Wallpaper manager
- [x] Emoji picker
- [x] [tmux](https://github.com/tmux/tmux) session manager
- [x] System monitor
- [x] Media control
- [x] Notification system
- [x] Wi-Fi manager
- [x] Bluetooth manager
- [x] Audio mixer
- [x] [EasyEffects](https://github.com/wwmm/easyeffects) integration
- [x] Screen capture
- [x] Screen recording
- [x] Color picker
- [x] OCR
- [x] QR and barcode scanner
- [x] "Mirror" (webcam)
- [x] Game mode
- [x] Night mode
- [x] Power profile manager
- [x] AI Assistant
- [x] Weather
- [x] Calendar
- [x] Power menu
- [x] Workspace management
- [x] Support for different layouts (dwindle, master, scrolling, etc.)
- [x] Multi-monitor support
- [x] Customizable keybindings
- [ ] Plugin and extension system
- [ ] Compatibility with other Wayland compositors
---
## I need help!
If you are having trouble or have any questions:
- You can ask anything on [Discord](https://discord.com/invite/gHG9WHyNvH) or in the [GitHub discussions](https://github.com/Axenide/Ambxst/discussions).
- You can open an issue on the [GitHub repository](https://github.com/Axenide/Ambxst/issues).
- The main configuration is located at `~/.config/Ambxst`.
---
## Credits
- [end-4](https://github.com/end-4) for his awesome projects. I learned a lot from them! (And *yoinked* a lot of code, too. 😅)
- [soramane](https://github.com/soramanew) for helping me when I started with Quickshell. (You probably don't remember, but still, heh.)
- [outfoxxed](https://outfoxxed.me/) for creating Quickshell and great documentation!
- [tr1x_em](https://github.com/tr1x_em) for being a great friend and helping me find great tools. You rock!
- [Darsh](https://github.com/its-darsh) for not killing me when I left Fabric. u_u (Also for being a great friend and creating Fabric! Without Fabric, Ax-Shell wouldn't exist, so Ambxst wouldn't either. Thank you!)
- [Mario](https://github.com/mariokhz) for being a great friend and showing me Quickshell!
- [Samouly](https://samouly.is-a.dev/) for being Samouly. :3
- [Brys](https://github.com/brys0) for being his continuous support and for being a great friend!
- [Zen](https://github.com/wer-zen) for being a great friend and helping me when I started with Quickshell too!
- [kh](https://www.youtube.com/watch?v=dQw4w9WgXcQ) for being an awesome human being and listening to my delusions about Ambxst. :D
- And you, the user, for trying out Ambxst! You're awesome! 💖
(If I forgot someone, please let me know. 🙏)