From f399463a992cf3d41334ffe6b2847413be07330b Mon Sep 17 00:00:00 2001
From: Kevin Diaz <github@kev314.dev>
Date: Tue, 26 Aug 2025 13:02:50 -0400
Subject: [PATCH] Update installation instructions for Arch Linux and Nix in
 README.md

---
 README.md | 49 +++++++++++++++++++++++++++++++++++--------------
 1 file changed, 35 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 7189526..ea26a2a 100644
--- a/README.md
+++ b/README.md
@@ -87,29 +87,52 @@ If you want to use the ArchUpdater Widget, make sure you have any polkit agent i
 
 ### Installation
 
-#### For Arch
+#### Arch Linux
+
+<details>
+<summary><strong>AUR</strong></summary>
+
+You can install Noctalia from the [AUR](https://aur.archlinux.org/packages/noctalia-shell). This method will install the shell system-wide.
+
+```bash
+paru -S noctalia-shell
+```
+
+**Note:** When installed from the AUR, you must use the `-c noctalia-shell` flag to run the shell and any IPC commands. For example, to start the shell, run `qs -c noctalia-shell`. See the [Usage](#usage) section for more details.
+
+</details>
+
+<details>
+<summary><strong>Manual Installation</strong></summary>
+
+This method installs the shell to your local user configuration.
+
 ```bash
 # Install Quickshell
-yay -S quickshell-git
+paru -S quickshell-git
 # Download and install Noctalia (latest release)
 mkdir -p ~/.config/quickshell && curl -sL https://github.com/noctalia-dev/noctalia-shell/releases/latest/download/noctalia-latest.tar.gz | tar -xz --strip-components=1 -C ~/.config/quickshell
 ```
 
+</details>
 
-#### For Nix
+#### Nix
 
+<details>
+<summary><strong>Nix Installation</strong></summary>
+
+You can run Noctalia directly using the `nix run` command:
 ```bash
 nix run github:noctalia-dev/noctalia-shell
 ```
 
-<details>
-<summary><strong>For flakes</strong></summary>
-
-**Step 1**: Add quickshell and noctalia flakes
+Alternatively, you can add it to your NixOS configuration or flake:
 
+**Step 1**: Add Quickshell and Noctalia flakes to your `flake.nix`:
 ```nix
-
 {
+  description = "Example Nix flake with Noctalia + Quickshell";
+
   inputs = {
     nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
 
@@ -138,11 +161,8 @@ nix run github:noctalia-dev/noctalia-shell
 }
 ```
 
-and in `configuration.nix`
-
+**Step 2**: Add the packages to your `configuration.nix`:
 ```nix
-
-# your configuration.nix
 {
   environment.systemPackages = with pkgs; [
     noctalia.packages.${system}.default
@@ -151,7 +171,6 @@ and in `configuration.nix`
 }
 ```
 
-
 </details>
 
 ### Usage
@@ -178,7 +197,9 @@ and in `configuration.nix`
 
 
 <details>
-<summary> Without the binary </summary>
+<summary> Without the binary (Manual or AUR install) </summary>
+
+The following commands apply to a manual installation. If you installed Noctalia via the AUR package, you must add the `-c noctalia-shell` flag to each command (e.g., `qs -c noctalia-shell ipc call launcher toggle`).
 
 | Action                      | Command                                   |
 | --------------------------- | ----------------------------------------- |