update: temporary fix for kirigami not found error

AGENTS.md

@@ -6,15 +6,15 @@
 
 ## IMPORTANT: axctl Build Requirement
 
-When changes are made to axctl (in `/home/adriano/Repos/Axenide/axctl/`), manual build and install is required:
+When changes are made to axctl (in `/home/adriano/Repos/Leriart/axctl/`), manual build and install is required:
 
-1. Build: `cd /home/adriano/Repos/Axenide/axctl && go build -o bin/axctl .`
+1. Build: `cd /home/adriano/Repos/Leriart/axctl && go build -o bin/axctl .`
 2. Install: Replace `/usr/local/bin/axctl` with the new binary (requires manual intervention)
 
 The agent cannot test axctl changes directly because the daemon runs in the user's session environment.
 
 ## OVERVIEW
-Ambxst is a highly customizable Wayland shell built with Quickshell. It provides a unified panel (bar, dock, notch), dashboard, lockscreen, desktop widgets, and notification system, driven by a reactive JSON configuration system. Multi-monitor support via `Variants` on `Quickshell.screens`.
+NothingLess is a highly customizable Wayland shell built with Quickshell. It provides a unified panel (bar, dock, notch), dashboard, lockscreen, desktop widgets, and notification system, driven by a reactive JSON configuration system. Multi-monitor support via `Variants` on `Quickshell.screens`.
 
 ## STRUCTURE
 ```
@@ -59,7 +59,7 @@ Ambxst is a highly customizable Wayland shell built with Quickshell. It provides
 | **Config Logic** | `config/Config.qml` | >3100 lines. `FileView` + `JsonAdapter` persistence |
 | **Transient State** | `modules/globals/GlobalStates.qml` | Window visibility, active modes, runtime flags |
 | **Services** | `modules/services/*.qml` | 30+ singletons. System integration layer |
-| **Theme/Colors** | `modules/theme/Colors.qml` | Watches `~/.cache/ambxst/colors.json` reactively |
+| **Theme/Colors** | `modules/theme/Colors.qml` | Watches `~/.cache/NothingLess/colors.json` reactively |
 | **Styling** | `modules/theme/Styling.qml` | `radius()`, `fontSize()`, `getStyledRectConfig()` |
 | **UI Primitives** | `modules/components/` | `StyledRect`, `BarPopup`, `SearchInput`, shaders |
 | **Dashboard** | `modules/widgets/dashboard/` | Tabbed hub with LRU lazy-loading |
@@ -118,7 +118,7 @@ qs -p shell.qml
 ./cli.sh
 
 # Install (Arch/Fedora/NixOS)
-curl -L get.axeni.de/ambxst | sh
+curl -L github.com/Leriart/NothingLess/NothingLess | sh
 ```
 
 ## NOTES
@@ -127,8 +127,8 @@ curl -L get.axeni.de/ambxst | sh
 - The `qs.` import prefix is a Quickshell VFS construct, not a physical directory.
 - `screenshotToolMode` in `GlobalStates.qml` is **DEPRECATED**.
 - Gemini AI provider doesn't support the `system` role; handled in `services/ai/strategies/`.
-- `axctl` is a core part of this project. It abstracts compositor interactions. It is one of Axenide's projects and the source code is available at `/home/adriano/Repos/Axenide/axctl/`.
-- We register a changelog in a website. The local repo for this website is at `/home/adriano/Repos/Axenide/web/`. The changelog entries are stored in `content/ambxst/changelog/` as Zola markdown files. Write following the structure by referencing other entries, and add links to PRs and issues when relevant. Only write a changelog when the user asks for it.
+- `axctl` is a core part of this project. It abstracts compositor interactions. It is one of Leriart's projects and the source code is available at `/home/adriano/Repos/Leriart/axctl/`.
+- We register a changelog in a website. The local repo for this website is at `/home/adriano/Repos/Leriart/web/`. The changelog entries are stored in `content/NothingLess/changelog/` as Zola markdown files. Write following the structure by referencing other entries, and add links to PRs and issues when relevant. Only write a changelog when the user asks for it.
 
 - Some projects to keep in mind for reference:
   - DankMaterialShell (DMS): https://github.com/AvengeMedia/DankMaterialShell

README.md

@@ -1,148 +1,211 @@
 <p align="center">
-<img src="./assets/ambxst/ambxst-logo-color.svg" alt="Ambxst Logo" style="width: 50%;" align="center" />
-  <br>
-  <br>
-An <i><b>Ax</b>tremely</i> customizable shell.
+  <img src="./assets/not.gif" alt="NothingLess" width="400"/>
+  <br><br>
+  A high-performance, deeply customizable Wayland shell built with Quickshell.
+  <br><br>
+  <i>Forked from <a href="https://github.com/Axenide/Ambxst">Ambxst</a> — less is more.</i>
 </p>
 
-  <p align="center">
-  <a href="https://github.com/Axenide/Ax-Shell/stargazers">
-    <img src="https://img.shields.io/github/stars/Axenide/Ambxst?style=for-the-badge&logo=github&color=E3B341&logoColor=D9E0EE&labelColor=000000" alt="GitHub stars">
-  </a>
-  <a href="https://ko-fi.com/Axenide">
-    <img src="https://img.shields.io/badge/Support me on-Ko--fi-FF6433?style=for-the-badge&logo=kofi&logoColor=white&labelColor=000000" alt="Ko-Fi">
+<p align="center">
+  <a href="https://github.com/Leriart/NothingLess">
+    <img src="https://img.shields.io/badge/NothingLess-0A0A0A?style=for-the-badge&logo=github&logoColor=FFFFFF" alt="repo">
   </a>
-  <a href="https://discord.com/invite/gHG9WHyNvH">
-    <img src="https://img.shields.io/discord/669048311034150914?style=for-the-badge&logo=discord&logoColor=D9E0EE&labelColor=000000&color=5865F2&label=Discord" alt="Discord">
+  <a href="https://github.com/Axenide/Ambxst">
+    <img src="https://img.shields.io/badge/Fork%20of-Ambxst-E80012?style=for-the-badge&logo=github&logoColor=FFFFFF&labelColor=0A0A0A" alt="fork">
   </a>
 </p>
 
 ---
 
-<h2><sub><img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Camera%20with%20Flash.png" alt="Camera with Flash" width="32" height="32" /></sub> Screenshots</h2>
+## Screenshots
+
+<p align="center">
+  <img src="./assets/screenshots/settings.png" alt="NothingLess Settings" width="45%"/>
+  &nbsp;&nbsp;
+  <img src="./assets/screenshots/gaming.png" alt="NothingLess Gaming" width="45%"/>
+</p>
+
+---
+
+## Installation
+
+```bash
+curl -sL https://github.com/Leriart/NothingLess/raw/main/install.sh | sh
+```
+
+Or clone manually:
+
+```bash
+git clone https://github.com/Leriart/NothingLess.git ~/.local/src/nothingless
+sudo ln -s ~/.local/src/nothingless/cli.sh /usr/local/bin/nothingless
+```
+
+Then run:
+
+```bash
+nothingless
+```
 
-<div align="center">
-  <img src="./assets/screenshots/1.png" width="100%" />
+### Compositor integration
 
-  <br />
+```bash
+nothingless install hyprland           # Auto-detect (default: conf)
+nothingless install hyprland --conf    # Force config file mode (safe default)
+nothingless install hyprland --lua     # Force Lua mode (Hyprland >= 0.48)
+nothingless remove hyprland            # Remove NothingLess config from Hyprland
+```
 
-  <img src="./assets/screenshots/2.png" width="32%" />
-  <img src="./assets/screenshots/3.png" width="32%" />
-  <img src="./assets/screenshots/4.png" width="32%" />
+**Mode selection:**
+- `--conf` (default): Creates `~/.local/share/nothingless/hyprland.conf` and adds `source = ~/.local/share/nothingless/hyprland.conf` to your Hyprland config. Works on all Hyprland versions.
+- `--lua`: Creates `~/.local/share/nothingless/hyprland.lua` as valid Lua and adds `loadfile(...)()` to your Hyprland config. Requires Hyprland >= 0.48.
+- No flag: Auto-detects based on existing config (`hyprland.lua` → lua, `hyprland.conf` → conf). If neither exists, defaults to `--conf`.
 
-  <img src="./assets/screenshots/5.png" width="32%" />
-  <img src="./assets/screenshots/6.png" width="32%" />
-  <img src="./assets/screenshots/7.png" width="32%" />
+On first boot, `exec-once = nothingless` launches the shell, which starts the axctl daemon internally. All compositor settings are managed by axctl (live via `raw-batch`, persisted via `axctl.toml`).
 
-  <img src="./assets/screenshots/8.png" width="32%" />
-  <img src="./assets/screenshots/9.png" width="32%" />
-  <img src="./assets/screenshots/10.png" width="32%" />
-</div>
+Supported on **Arch**, **Fedora**, and **NixOS** (requires Hyprland).
 
 ---
 
-<h2><sub><img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Package.png" alt="Package" width="32" height="32" /></sub> Installation</h2>
+## Commands
+
+### CLI
 
 ```bash
-curl -L get.axeni.de/ambxst | sh
+nothingless                          # Start NothingLess shell
+nothingless update                   # Update NothingLess
+nothingless reload                   # Reload NothingLess
+nothingless quit                     # Quit NothingLess
+nothingless lock                     # Activate lockscreen
+nothingless run <command>            # Run a NothingLess module
+nothingless brightness <0-100>       # Set brightness
+nothingless brightness +/-<delta>    # Adjust brightness
+nothingless brightness -s            # Save current brightness
+nothingless brightness -r            # Restore saved brightness
+nothingless screen on|off            # Control display power
+nothingless suspend                  # Suspend system
 ```
 
-This will install Ambxst and its dependencies. You will have the `ambxst` command available in your terminal, which you can use to start the shell.
+### Module Commands
+
+| `nothingless run ...` | Description |
+|---|---|
+| `launcher` | Open app launcher |
+| `dashboard` | Open dashboard |
+| `assistant` | Open AI assistant |
+| `clipboard` | Open clipboard manager |
+| `emoji` | Open emoji picker |
+| `notes` | Open notes |
+| `tmux` | Open tmux session manager |
+| `wallpapers` | Open wallpaper picker |
+| `overview` | Open workspace overview |
+| `powermenu` | Open power menu |
+| `tools` | Open tools menu |
+| `config` | Open settings |
+| `screenshot` | Take screenshot |
+| `screenrecord` | Screen record |
+| `lens` | Open OCR capture |
+| `toggle-metrics` | Toggle notch metrics display |
+| `lockscreen` | Lock session |
+
+### Keybinds
+
+| Key | Action |
+|---|---|
+| `SUPER` (hold) | Launcher |
+| `SUPER + D` | Dashboard |
+| `SUPER + A` | Assistant |
+| `SUPER + V` | Clipboard |
+| `SUPER + PERIOD` | Emoji picker |
+| `SUPER + N` | Notes |
+| `SUPER + T` | Tmux |
+| `SUPER + COMMA` | Wallpapers |
+| `SUPER + TAB` | Workspace overview |
+| `SUPER + ESC` | Power menu |
+| `SUPER + S` | Tools menu |
+| `SUPER + SHIFT + C` | Settings |
+| `SUPER + SHIFT + S` | Screenshot |
+| `SUPER + SHIFT + R` | Screen record |
+| `SUPER + SHIFT + A` | Lens |
+| `SUPER + L` | Lock session |
+| `SUPER + SHIFT + BACKSPACE` | Toggle metrics overlay |
 
-### Hyprland (more compositors coming soon!)
+---
 
-1. Run the installation command above.
+## FPS Monitoring (`nothing-fps`)
 
-2. Run `ambxst install hyprland` to add Ambxst's configuration to Hyprland. This will source a config file that applies Ambxst's settings. It will look like this:
+NothingLess includes a modified MangoHud that captures FPS data and displays it in the notch metrics overlay.
 
 ```bash
-# Ambxst
-source = ~/.local/share/ambxst/hyprland.conf
+# Launch a game with FPS monitoring
+nothing-fps ./my-game
 
-# OVERRIDES
-# Down here you can write or source anything that you want to override from Ambxst's settings.
+# Steam launch options (right-click game > Properties > Launch Options)
+nothing-fps %command%
 ```
 
-As stated, anything you want to override from Ambxst's settings should be written under the "OVERRIDES" section.
+**How it works:**
 
-3. Start Ambxst by running `ambxst` in your terminal. If you want to keep it running without having the terminal window open, you can run `ambxst & disown`. This will be only necessary for your first test run, as Ambxst will start automatically on login after step 2.
+1. `nothing-fps` sets up a modified MangoHud (`libMangoHud_shim.so`) via `LD_PRELOAD`
+2. MangoHud hooks Vulkan/OpenGL to capture frame-present events
+3. Calculated FPS is written to `/dev/shm/nothingless_fps`
+4. NothingLess reads this file in real-time and displays FPS in the notch
 
-Ambxst is currently supported on **Arch**, **Fedora**, and **NixOS**. This means both based and derivative distributions.
+**Rebuilding MangoHud from source:**
 
-> [!IMPORTANT]
-> The only pre-requisite is having Hyprland installed.
+```bash
+./scripts/mangohud-patch/build-mangohud.sh
+```
 
-> [!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**.
+Requires: `meson`, `ninja`, `gcc`, `glslang`, `python-mako`.
 
 ---
 
-## Will this change my config?
+## Differences from Ambxst
 
-Nope! Besides the source line in your `hyprland.conf`, Ambxst is designed to be non-intrusive. It won't modify any of your existing configurations.
+### Architecture
 
----
+| Area | Ambxst | NothingLess |
+|------|--------|-------------|
+| Compositor settings | ~40 options (border, shadow, blur) | 130+ options across 11 categories |
+| Config reload handling | Basic | `configreloaded` event detection with instant bind/settings recovery |
 
-<h2><sub><img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Telegram-Animated-Emojis/main/Activity/Sparkles.webp" alt="Sparkles" width="32" height="32" /></sub> Features</h2>
-
-- [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
+### Performance
+
+| Area | Ambxst | NothingLess |
+|------|--------|-------------|
+| Video wallpaper | mpv-based | QtMultimedia + FFmpeg (hardware-accelerated, lower overhead) |
+| Rendering backend | Default | Configurable: OpenGL (default) or Vulkan with threaded render loop |
+| GPU optimization | Standard | NVIDIA env vars, GPU texture caching (`GradientCache`) |
+| GLSL shaders | Original set | Optimized (reduced draw calls, shared GPU textures) |
+| FPS monitoring | Not available | Custom MangoHud integration with real-time notch display |
 
----
 
-## I need help!
+### Design
 
-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`.
+| Area | Ambxst | NothingLess |
+|------|--------|-------------|
+| Typography | Roboto, varied | Ndot (dot-matrix), monospace-first |
+| Color scheme | Vibrant themes | Monochrome with subtle red accents |
+| Animations | Heavy, ornate | Minimal, functional |
+| Branding | Color glyphs | Red + white dot-matrix |
 
 ---
 
 ## Credits
-- [outfoxxed](https://outfoxxed.me/) for creating Quickshell and great documentation!
-- [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.)
-- [tr1x_em](https://trix.is-a.dev/) 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. 🙏)
+
+- **Leriart** -- fork maintainer and NothingLess developer
+- **Axenide** -- original [Ambxst](https://github.com/Axenide/Ambxst) creator
+- **Zack** ([@zackytodearena](https://bsky.app/profile/zackytodearena.bsky.social)) -- logo & animation design
+- **outfoxxed** -- creator of [Quickshell](https://git.outfoxxed.me/outfoxxed/quickshell)
+- **end-4** -- inspiration from [dots-hyprland](https://github.com/end-4/dots-hyprland)
+- **DankMaterialShell** -- design reference from [DMS](https://github.com/AvengeMedia/DankMaterialShell)
+- **Noctalia** -- reference from [noctalia-shell](https://github.com/noctalia-dev/noctalia-shell)
+
+---
+
+## License
+
+- NothingLess modifications are provided under the same license as the upstream.
+- Ambxst and the Ambxst logo are trademarks of Adriano Tisera (Axenide).
+- See [LICENSE](./LICENSE) and [TRADEMARK.md](./assets/nothingless/TRADEMARK.md) for details.
+