{"id":49149574,"url":"https://github.com/traciges/ayuz","last_synced_at":"2026-05-16T01:13:10.123Z","repository":{"id":345835880,"uuid":"1187573374","full_name":"Traciges/Ayuz","owner":"Traciges","description":"The unofficial MyAsus alternative for Linux. A unified GTK4 control center for ASUS laptops to manage battery health, fan curves, OLED dimming, and audio","archived":false,"fork":false,"pushed_at":"2026-04-20T20:22:43.000Z","size":6662,"stargazers_count":140,"open_issues_count":3,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-22T05:47:34.242Z","etag":null,"topics":["asus","battery-management","fan-control","fedora","g-helper","gtk4","linux","myasus","rust","vivobook","zenbook"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Traciges.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-20T22:10:14.000Z","updated_at":"2026-04-22T05:12:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Traciges/Ayuz","commit_stats":null,"previous_names":["traciges/myasus-linux","traciges/zenbook-control","traciges/asus-hub","traciges/ayuz"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Traciges/Ayuz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Traciges%2FAyuz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Traciges%2FAyuz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Traciges%2FAyuz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Traciges%2FAyuz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Traciges","download_url":"https://codeload.github.com/Traciges/Ayuz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Traciges%2FAyuz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32280981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asus","battery-management","fan-control","fedora","g-helper","gtk4","linux","myasus","rust","vivobook","zenbook"],"created_at":"2026-04-22T05:35:06.123Z","updated_at":"2026-05-16T01:13:10.115Z","avatar_url":"https://github.com/Traciges.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"assets/trayicon.png\" alt=\"Ayuz icon\" width=\"128\" height=\"128\"/\u003e\n  \u003cbr\u003e\n  Ayuz\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A centralized settings application for ASUS laptops on Linux - bringing together hardware controls, display tuning, audio profiles, and system management in one place.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eTested on:\u003c/strong\u003e ASUS Zenbook S16 · Fedora 43 · KDE Plasma\n\u003c/p\u003e\n\n---\n\n\u003e [!WARNING]\n\u003e **Disclaimer:** This is an unofficial, community-driven, open-source project. **\"Ayuz\" is NOT affiliated with, endorsed by, sponsored by, or connected to ASUSTeK Computer Inc. in any way.** \"ASUS\", \"Zenbook\", \"ROG\", \"Vivobook\", and \"MyAsus\" are registered trademarks of ASUSTeK Computer Inc. \u003cbr\u003e\n\u003e The use of ASUS trademarks within this website and associated tools and libraries is only to provide a recognisable identifier to users to enable them to associate that these tools will work with ASUS laptops. \u003cbr\u003e\n\u003e This software is provided as-is, without warranty, and uses community reverse-engineered backend tools. Use at your own risk.\n\n---\n\n## Screenshots\n\n\u003ctable align=\"center\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" colspan=\"2\"\u003e\u003cimg src=\"screenshots/Homepage.png\" alt=\"Homepage\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eHomepage\u003c/em\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"screenshots/Audio.png\" alt=\"Audio settings\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eAudio Settings\u003c/em\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"screenshots/Aura.png\" alt=\"Aura settings\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eAura Settings\u003c/em\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n  \u003ctd align=\"center\"\u003e\u003cimg src=\"screenshots/Display.png\" alt=\"Display settings\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eDisplay Settings\u003c/em\u003e\u003c/td\u003e\n  \u003ctd align=\"center\"\u003e\u003cimg src=\"screenshots/Keyboard.png\" alt=\"Keyboard settings\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eKeyboard Settings\u003c/em\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n  \u003ctd align=\"center\"\u003e\u003cimg src=\"screenshots/System.png\" alt=\"System settings\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eSystem Settings\u003c/em\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"screenshots/Touchpad.png\" alt=\"Touchpad settings\" width=\"100%\"/\u003e\u003cbr/\u003e\u003cem\u003eTouchpad Settings\u003c/em\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Motivation\n\nASUS provides the MyAsus application for Windows, offering a unified interface to control display settings, battery care, fan profiles, keyboard backlight, and more. On Linux, no equivalent exists. \u003cbr\u003e\nInstead, the relevant controls are scattered across a variety of independent tools and configuration files:\n\n- Battery charge limits via `asusctl`\n- Audio effects via EasyEffects with manual preset management\n- Display brightness quirks via `kscreen-doctor`\n- Fan profiles via D-Bus calls to `asusd`\n- Keyboard backlight via idle daemons like `swayidle`\n- Aura RGB lighting via raw D-Bus calls to `asusd`\n- AniMatrix support\n- OLED-specific care settings buried in KDE power management config files\n\nAyuz aims to consolidate all of these into a single, clean GTK4 interface - making it easy to manage your ASUS laptop on Linux without needing to know which tool controls which feature. \u003cbr\u003e\nThe application is smart about availability: if a required tool or desktop environment is not detected, the corresponding setting is automatically disabled rather than silently failing.\n\n---\n\n## Features\n\n### Display\n\n| Feature                   | Description                                                                                                       | Requires                      |\n| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------- |\n| OLED Flicker-Free Dimming | Reduces OLED panel flickering at low brightness levels using a 10-100% slider                                     | KDE, `kscreen-doctor`         |\n| Color Gamut               | Switch between Native, sRGB, DCI-P3, and Display P3 color profiles - bundled ICC files sourced directly from ASUS | KDE, `kscreen-doctor`         |\n| Target Mode               | Dims unfocused windows using the KWin `diminactive` compositor effect                                             | KDE, `qdbus`, `kwriteconfig6` |\n| OLED Pixel Refresh        | Activates a pixel refresh screensaver after inactivity to reduce burn-in risk                                     | KDE, `kwriteconfig6`          |\n| Panel Auto-Hide           | Automatically hides the KDE panel to reduce static OLED elements                                                  | KDE, `qdbus`                  |\n| Panel Transparency        | Sets the KDE panel to transparent or opaque                                                                       | KDE, `qdbus`                  |\n\n\u003e **Bundled color gamut presets:** Native, sRGB, DCI-P3 and Display P3 \u003cbr\u003e\n\u003e These presets are the original ASUS color gamut profiles.\n\n### Keyboard\n\n| Feature             | Description                                                                    | Requires           |\n| ------------------- | ------------------------------------------------------------------------------ | ------------------ |\n| Automatic Backlight | Uses the ambient light sensor to automatically adjust keyboard brightness      | `iio-sensor-proxy` |\n| Backlight Idle Mode | Turns off backlight after inactivity (1/2/5 min), configurable per power state | `swayidle`         |\n| FN Key Mode         | Toggle between function key priority (F1-F12) and shortcut priority            | `asusd`            |\n| FN+F Fan Hotkey     | Cycles fan profiles globally (Balanced → Performance → Quiet → Balanced) via the hardware FN+F key; shows an on-screen notification on each switch | `asusd`            |\n\n### Aura RGB\n\n| Feature           | Description                                                                                                                   | Requires |\n| ----------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------- |\n| Lighting Mode     | Choose from 12 modes: Static, Breathe, Rainbow Cycle, Rainbow Wave, Star, Rain, Highlight, Laser, Ripple, Pulse, Comet, Flash | `asusd`  |\n| Color Control     | Set primary and secondary colors (RGB) - secondary color available for Breathe and Star modes                                 | `asusd`  |\n| Brightness        | Four brightness levels: Off, Low, Medium, High                                                                                | `asusd`  |\n| Speed \u0026 Direction | Control animation speed (Low/Medium/High) and direction (Rainbow Wave only)                                                   | `asusd`  |\n| Power Settings    | Configure LED behavior per zone for Boot, Awake, Sleep, and Shutdown states                                                   | `asusd`  |\n\n### AniMatrix LED Panel\n\nControls for the AniMatrix LED matrix display found on select ROG laptops (e.g. ROG Zephyrus G14 GA401). The section is always visible but grayed out on unsupported hardware.\n\n| Feature                  | Description                                                                                                      | Requires |\n| ------------------------ | ---------------------------------------------------------------------------------------------------------------- | -------- |\n| Enable / Disable         | Turn the AniMatrix panel on or off                                                                               | `asusd`  |\n| Brightness               | Four brightness levels: Off, Low, Medium, High                                                                   | `asusd`  |\n| Built-in Animations      | Enable or disable firmware-driven animations and select which animation plays during Boot, Awake, Sleep, Shutdown | `asusd`  |\n| Power Behavior           | Automatically turn off the panel when unplugged, suspended, or when the lid is closed                            | `asusd`  |\n| GIF Gallery              | Stream one of 34 bundled ASUS animations directly to the panel; play/stop with a single button                   | `asusd`  |\n| Profile Integration      | All AniMatrix settings are saved per profile and restored on profile switch                                       | `asusd`  |\n\n\u003e **GIF Gallery availability:** The gallery currently supports **GA401** hardware (ROG G14 2021), where the bundled ASUS GIF format (74×36 px) matches the panel exactly. GIF playback on other AniMatrix models (GA402, GU604, G635L, G835L) is planned for a future release once multi-device frame sizing is available. Firmware controls (brightness, built-in animations, power behavior) work on all supported models.\n\n### Touchpad\n\n| Feature         | Description                                                               | Requires                     |\n| --------------- | ------------------------------------------------------------------------- | ---------------------------- |\n| Smart Gestures  | Control volume, brightness, and media playback via touchpad edge swipes   | `brightnessctl`, `playerctl` |\n| Touchpad Toggle | Enable or disable the touchpad, with a 10-second auto-revert safety timer | KDE or GNOME                 |\n| ASUS NumberPad  | Toggle the LED numeric keypad embedded in the touchpad. Emits standard Linux Numpad keycodes (`KEY_KP0`..`KEY_KPENTER`) through a virtual uinput device, so international keyboard layouts (e.g. German, Lithuanian) work natively. Flip the active state at runtime with `ayuz --toggle-numberpad`. | `i2c-dev` + `uinput` kernel modules; user in `i2c` and `input` groups (see below) |\n\n#### NumberPad Requirements\n\nThe NumberPad driver runs entirely in-process. It needs unprivileged read/write access to two kernel facilities:\n\n- **`/dev/i2c-N`** - the touchpad's I2C slave receives a 13-byte magic packet to turn the LED grid on or off.\n- **`/dev/uinput`** - a virtual keyboard emits Numpad keycodes when you tap a cell.\n\n1. Load the required kernel modules (persist via `/etc/modules-load.d/ayuz.conf` if you want them at boot):\n\n   ```bash\n   sudo modprobe i2c-dev uinput\n   ```\n\n2. Add your user to the `i2c` and `input` groups, then restart your device:\n\n   ```bash\n   sudo usermod -aG i2c,input $USER\n   ```\n\n3. Install the bundled udev rules. Distro packages (Fedora/Debian/RPM/DEB) install them automatically to `/usr/lib/udev/rules.d/99-ayuz-numberpad.rules`. \n**For source builds and AppImage users**, manual installation is required:\n\n   ```bash\n   # If using the AppImage, download the rules file first:\n   wget [https://raw.githubusercontent.com/Traciges/Ayuz/main/packaging/udev/99-ayuz-numberpad.rules](https://raw.githubusercontent.com/Traciges/Ayuz/main/packaging/udev/99-ayuz-numberpad.rules)\n\n   # Copy it to the system folder and reload udev:\n   sudo cp 99-ayuz-numberpad.rules /etc/udev/rules.d/\n   sudo udevadm control --reload-rules \u0026\u0026 sudo udevadm trigger\n   ```\n\nIf any of these are missing the NumberPad row in the Touchpad page is disabled and shows an actionable error.\n\n### Audio\n\n| Feature        | Description                                                | Requires      |\n| -------------- | ---------------------------------------------------------- | ------------- |\n| Volume \u0026 Boost | Control system volume from 0-150% via PipeWire             | `wpctl`       |\n| Sound Profiles | Apply EasyEffects presets bundled with the app (see below) | `easyeffects` |\n\n\u003e **Bundled EasyEffects presets:** Movie, Music, Perfect EQ, Video, Voice, Custom \u003cbr\u003e\n\u003e These presets are **not** the original ASUS audio profiles - they are [Community Presets](https://github.com/wwmm/easyeffects/wiki/Community-presets) from the EasyEffects project, included for convenience. They are automatically installed to the EasyEffects preset directory on first use.\n\n### System\n\n| Feature                  | Description                                                                                                                                                   | Requires      |\n| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |\n| Battery Maintenance Mode | Limit charging to 80% for long-term battery health                                                                                                            | `asusd`       |\n| Full Charge              | Charge to 100% with automatic revert to maintenance mode after 24 hours                                                                                       | `asusd`       |\n| Deep Sleep               | Switch between `s2idle` and `deep` suspend modes                                                                                                              | -             |\n| Fan Profiles             | Switch between Performance, Balanced, and Quiet fan curves                                                                                                    | `asusd`       |\n| GPU Mode                 | Switch between GPU modes: Hybrid, Integrated, Nvidia (No Modeset), VFIO, ASUS eGPU, and ASUS MUX Discrete. Switching GPU modes requires a full system reboot. | `supergfxctl` |\n| GPU Memory Allocation    | Reserve system RAM for the integrated GPU (UMA Frame Buffer). Options: Auto, 1-8 GB. Requires a supported BIOS. Changes require a full system reboot.         | `asusd`       |\n\n### General\n\n- **Profiles** - create and manage multiple named configuration profiles, each with a custom icon. Settings are automatically saved to the currently selected profile and instantly restored when switching\n- **Global search** - search across all settings with a keyboard shortcut\n- **System tray** - minimize to tray, restore or quit from tray menu\n- **Autostart** - optional autostart with the system; when enabled, the app launches hidden (`--hidden`) and only appears in the tray. Managed via a `.desktop` file at `~/.config/autostart/de.guido.ayuz.desktop`\n- **Persistent configuration** - settings are saved to `~/.config/ayuz/config.json` and restored on every launch\n- **Multilingual UI** - English, German, and Brazilian Portuguese supported, switchable at runtime\n- **Toast notifications** - errors and status messages shown as non-blocking toasts\n\n---\n\n## Dependencies\n\nAyuz integrates with several external tools and system services. Install only the ones relevant to the features you want to use.\n\n| Dependency                                                 | Purpose                                                          | Package (Fedora)              |\n| ---------------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------- |\n| [`asusctl`](https://gitlab.com/asus-linux/asusctl)         | Battery care, fan profiles, FN key mode                          | `asusctl` (copr)              |\n| `asusd`                                                    | System daemon required by asusctl                                | bundled with `asusctl`        |\n| [`supergfxctl`](https://gitlab.com/asus-linux/supergfxctl) | GPU mode switching (Hybrid, Integrated, Nvidia, VFIO, eGPU, MUX) | `supergfxctl` (copr)          |\n| [`easyeffects`](https://github.com/wwmm/easyeffects)       | Audio sound profiles                                             | `easyeffects`                 |\n| `kscreen-doctor`                                           | OLED flicker-free dimming                                        | `kscreen`                     |\n| `iio-sensor-proxy`                                         | Ambient light sensor for auto backlight                          | `iio-sensor-proxy`            |\n| `swayidle`                                                 | Keyboard backlight idle timer                                    | `swayidle`                    |\n| `wpctl`                                                    | PipeWire volume control                                          | bundled with `pipewire-utils` |\n| `qdbus`                                                    | KDE-specific D-Bus calls (KDE features)                          | `qt6-tools`                   |\n| `kwriteconfig6`                                            | KDE config file access (KDE features)                            | `kf6-kconfig`                 |\n| `gsettings`                                                | Touchpad toggle on GNOME                                         | `glib2`                       |\n| `brightnessctl`                                            | Smart Gestures                                                   | `brightnessctl`               |\n| `playerctl`                                                | Media playback control                                           | `playerctl`                   |\n\n\u003e Features that depend on a missing tool or an incompatible desktop environment are automatically disabled in the UI.\n\n---\n\n## Hardware \u0026 OS Compatibility\n\nThe application has been developed and tested on:\n\n- **Laptop:** ASUS Zenbook S16\n- **OS:** Fedora 43\n- **Desktop:** KDE Plasma (Wayland)\n\nOther ASUS laptops are likely supported to varying degrees. Features relying on `asusd` (battery, fan, FN key) depend on your device being supported by asusctl. Check the [asusctl device support list](https://gitlab.com/asus-linux/asusctl) for compatibility. \u003cbr\u003e\nOther Linux distributions should work as long as the relevant dependencies can be installed. Features are individually guarded against missing tools, so the app remains usable even if only some dependencies are available.\n\n**AniMatrix models:** The AniMatrix LED panel section is supported on the following hardware, detected automatically via DMI board name:\n\n| Model identifier | Device |\n| ---------------- | ------ |\n| `GA401I`, `GA401Q` | ROG Zephyrus G14 (2021) |\n| `GA402R`, `GA402X`, `GA402N` | ROG Zephyrus G14 (2022) |\n| `GU604V` | ROG Zephyrus Duo 16 |\n| `G635L` | ROG Strix G16 |\n| `G835L` | ROG Strix SCAR 16 |\n\nOn all other models the AniMatrix section is shown as grayed out.\n\n---\n\n## Installation\n\n### Package Managers:\n\n**Fedora (Copr - Community Maintained)** \u003cbr\u003e\nA community member has packaged Ayuz for Fedora via Copr, providing automatic rebuilds and updates. \u003cbr\u003e\n**Note:** This repository is maintained by the community [SkyR0ver](https://github.com/SkyR0ver/ayuz-rpm), not officially by the upstream project. Currently supported on Fedora 43+.\n\n```bash\nsudo dnf copr enable lukenukem/asus-linux\nsudo dnf copr enable skyr0ver/asus-hub\nsudo dnf install ayuz\nsudo systemctl enable --now supergfxd.service\n```\n\n\u003cbr\u003e\n\n**Arch Linux (AUR)** \u003cbr\u003e\nThe application is available in the Arch User Repository. Install using your preferred AUR helper:\n\n| Package    | Description                                              |\n| ---------- | -------------------------------------------------------- |\n| `ayuz`     | Compiles the latest stable release from source           |\n| `ayuz-bin` | Downloads and installs the pre-compiled binary (fastest) |\n| `ayuz-git` | Compiles the latest commit from the main branch          |\n\n```bash\nyay -S ayuz\n```\n\n\u003cbr\u003e\n\n**NixOS (Flakes)** \u003cbr\u003e\nAdd `ayuz` to your `flake.nix` inputs: `ayuz.url = \"github:Traciges/Ayuz\";`.\n\n- **NixOS Module (Recommended):** Automatically configures required system services (`asusd`, `supergfxd`), udev rules, and polkit policies.\n  ```nix\n  { inputs, ... }: {\n    imports = [ inputs.ayuz.nixosModules.default ];\n    services.ayuz.enable = true;\n    services.ayuz.supportMyAsusKey = true; # Rebind MyAsus/ROG key to launch Ayuz\n    services.ayuz.fnKeyMode = \"shortcut\"; # Set the initial Fn key lock state\n  }\n  ```\n- **Home Manager Module:** For per-user installation, optional autostart, and configuration.\n  ```nix\n  { inputs, ... }: {\n    imports = [ inputs.ayuz.homeManagerModules.default ];\n    programs.ayuz.enable = true;\n    programs.ayuz.autostart = true; # Start minimized on login\n    programs.ayuz.settings = {\n      # accepts either a Nix attribute set or a raw JSON string\n      language = \"en\";\n    };\n  }\n  ```\n- **Traditional (Flakeless) usage:** You can use `builtins.getFlake` to use the modules or package directly.\n  ```nix\n  { pkgs, ... }:\n  let\n    ayuz-flake = builtins.getFlake \"github:Traciges/Ayuz\";\n  in {\n    imports = [ ayuz-flake.nixosModules.default ];\n    services.ayuz = { ... };\n    home-manager.users.username = {\n      imports = [ ayuz-flake.homeManagerModules.default ];\n      programs.ayuz = { ... };\n    };\n  }\n  ```\n\n### Install from GitHub Releases:\n\n### 1. Prerequisites\n\n**Note:** If you plan to use the AppImage (see Step 5), you can skip this step entirely. The AppImage already bundles all the necessary UI dependencies.\n\n- Rust toolchain (install via [rustup](https://rustup.rs))\n- GTK4 and Libadwaita development libraries\n\n**Fedora:**\n\n```bash\nsudo dnf install gtk4-devel libadwaita-devel gtk4-layer-shell-devel\n```\n\n**Arch:**\n\n```bash\nsudo pacman -S gtk4 libadwaita gtk4-layer-shell\n```\n\n### 2. Install external tools\n\nMost tools are already included with a standard Fedora KDE installation (`kscreen-doctor`, `kwriteconfig6`, `wpctl`). The following need to be installed manually: \u003cbr\u003e\n**asusctl** (via COPR - see [asus-linux.org](https://asus-linux.org) for full documentation):\n\n```bash\nsudo dnf copr enable lukenukem/asus-linux\nsudo dnf update\nsudo dnf install asusctl supergfxctl\nsudo dnf update --refresh\nsudo systemctl enable supergfxd.service\n```\n\n### 3. Reboot after installation\n\n### 4. Remaining tools:\n\n```bash\nsudo dnf install easyeffects iio-sensor-proxy swayidle brightnessctl playerctl\n```\n\n### 5. Download \u0026 Install\n\n**Manual Download:**\n\nDownload the package matching your distribution from the [GitHub Releases](https://github.com/Traciges/ayuz/releases) page:\n\n- **Fedora / RPM-based:**\n\n  ```bash\n  sudo dnf install ./ayuz-1.1.4-1.x86_64.rpm\n  ```\n\n- **Debian / Ubuntu / DEB-based:**\n\n  ```bash\n  sudo apt install ./ayuz_1.1.4-1_amd64.deb\n  ```\n\n- **AppImage (any distribution):**\n  ```bash\n  chmod +x ayuz-1.1.4-1.AppImage\n  ./ayuz-1.1.4-1.AppImage\n  ```\n\n**Note for AppImage users:** Because the AppImage runs without root privileges, it cannot install the necessary hardware permissions for the ASUS NumberPad automatically. If you want to use the NumberPad feature, please follow the manual `udev` rules installation in the NumberPad Requirements section above.\n\n### Uninstall\n\n- **Fedora, CentOS oder RHEL (via RPM/DNF):**\n\n  ```bash\n  sudo dnf remove ayuz\n  ```\n\n- **Ubuntu, Debian oder Linux Mint (via DEB/APT):**\n\n  ```bash\n  sudo apt remove ayuz\n  ```\n\n- **openSUSE (via RPM/Zypper):**\n  ```bash\n  sudo zypper remove ayuz\n  ```\n\n### Build from source\n\n```bash\ngit clone https://github.com/Traciges/ayuz\ncd ayuz\ncargo build --release\n./target/release/ayuz\n```\n\n### Build an RPM\n\n```bash\ncargo install cargo-rpm\ncargo generate-rpm\n```\n\n### Build a DEB\n\n```bash\ncargo install cargo-deb\ncargo deb\n```\n\n### Build an AppImage\n\nRequires [`appimagetool`](https://github.com/AppImage/AppImageKit/releases) on your `$PATH`.\n\n```bash\ncargo install cargo-appimage\ncargo appimage\n./target/appimage/ayuz-1.1.4-1.AppImage\n```\n\n---\n\n## Contributing\n\nContributions are welcome. If you own a different ASUS laptop model and want to add or fix support for specific features, feel free to open an issue or pull request.\n\nWhen adding a new feature, follow the existing component pattern in `src/components/` and add corresponding translation keys to both `locales/en.yml` and `locales/de.yml`.\n\n---\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraciges%2Fayuz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftraciges%2Fayuz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraciges%2Fayuz/lists"}