An Axtremely customizable shell.

---

Screenshots

---

Installation

curl -L get.axeni.de/ambxst | sh

Warning

Ambxst is currently in early development.

---

What does the installation do?

Important

For now Ambxst is installed via Nix flakes, so Nix is required for supporting it on as many distros as possible. But we are looking for contributions to support other package managers (and make this easier for everyone).

On non-NixOS distros, the installation script does the following:

• Installs Nix if it's not already installed.
• Installs some necessary system dependencies (only a few that Nix cannot handle by itself).
• Installs Ambxst as a Nix flake. (Dependency hell? No, thanks. 😎)
• Creates an alias to launch ambxst from anywhere (for example: exec-once = ambxst in your hyprland.conf).
• Gives you a kiss on the cheek. 😘 (Optional, of course.)

On NixOS:

• Installs Ambxst via:

  nix profile add github:Axenide/Ambxst

Note

The installation script doesn't do anything else on NixOS, so you can declare it however you like in your system.

---

Features

• Customizable components
• Themes
• System integration
• App launcher
• Clipboard manager
• Quick notes (and not so quick ones)
• Wallpaper manager
• Emoji picker
• tmux session manager
• System monitor
• Media control
• Notification system
• Wi-Fi manager
• Bluetooth manager
• Audio mixer
• EasyEffects integration
• Screen capture
• Screen recording
• Color picker
• OCR
• QR and barcode scanner
• Webcam mirror
• Game mode
• Night mode
• Power profile manager
• AI Assistant
• Weather
• Calendar
• Power menu
• Workspace management
• Support for different layouts (dwindle, master, scrolling, etc.)
• Multi-monitor support
• Customizable keybindings
• Plugin and extension system
• Polkit
• Compatibility with other Wayland compositors

---

What about the docs?

I want to release this before the end of the year, so you'll have to wait a bit for the full documentation. u_u

For now, the most important things to know are:

• The main configuration is located at ~/.config/Ambxst

• Removing Ambxst is as simple as:

  nix profile remove Ambxst

• You can ask anything on the:

  • Axenide Discord server
  • GitHub discussions

Caution

Packages installed via Nix will take priority over system ones. Keep this in mind if you run into version conflicts.

Credits

• end-4 for his awesome projects. I learned a lot from them! (And yoinked a lot of code, too. 😅)
• soramane for helping me when I started with Quickshell. (You probably don't remember, but still, heh.)
• outfoxxed for creating Quickshell and great documentation!
• tr1x_em for being a great friend and helping me find great tools. You rock!
• 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 for being a great friend and showing me Quickshell!
• Samouly for being Samouly. :3
• Zen for being a great friend and helping me when I started with Quickshell too!
• kh 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. 🙏)