From 16fd535e453cdd29e7cbe95369aa97a9831182aa Mon Sep 17 00:00:00 2001
From: Vaxry <vaxry@vaxry.net>
Date: Wed, 16 Oct 2024 15:29:27 +0100
Subject: [PATCH] ecosystem: add polkit agent

---
 pages/Hypr Ecosystem/_index.md              |  1 +
 pages/Hypr Ecosystem/aquamarine.md          |  2 +-
 pages/Hypr Ecosystem/hyprcursor.md          |  2 +-
 pages/Hypr Ecosystem/hyprlang.md            |  2 +-
 pages/Hypr Ecosystem/hyprpolkitagent.md     | 23 +++++++++++++++++++++
 pages/Hypr Ecosystem/hyprutils.md           |  2 +-
 pages/Hypr Ecosystem/hyprwayland-scanner.md |  2 +-
 pages/Useful Utilities/Must-have.md         | 15 +-------------
 8 files changed, 30 insertions(+), 19 deletions(-)
 create mode 100644 pages/Hypr Ecosystem/hyprpolkitagent.md

diff --git a/pages/Hypr Ecosystem/_index.md b/pages/Hypr Ecosystem/_index.md
index 30e1137..4c6cb63 100644
--- a/pages/Hypr Ecosystem/_index.md	
+++ b/pages/Hypr Ecosystem/_index.md	
@@ -21,6 +21,7 @@ These docs always target latest -git branch of respective apps.
  - **[xdg-desktop-portal-hyprland](./xdg-desktop-portal-hyprland)**
  - **[hyprsysteminfo](./hyprsysteminfo)**
  - **[hyprsunset](./hyprsunset)**
+ - **[hyprpolkitagent](./hyprpolkitagent)**
 
 ### Libraries and other utilities
  - **[hyprcursor](./hyprcursor)**
diff --git a/pages/Hypr Ecosystem/aquamarine.md b/pages/Hypr Ecosystem/aquamarine.md
index 24fa256..5c892c1 100644
--- a/pages/Hypr Ecosystem/aquamarine.md	
+++ b/pages/Hypr Ecosystem/aquamarine.md	
@@ -1,5 +1,5 @@
 ---
-weight: 11
+weight: 105
 title: aquamarine
 ---
 
diff --git a/pages/Hypr Ecosystem/hyprcursor.md b/pages/Hypr Ecosystem/hyprcursor.md
index c978f00..d7024a6 100644
--- a/pages/Hypr Ecosystem/hyprcursor.md	
+++ b/pages/Hypr Ecosystem/hyprcursor.md	
@@ -1,5 +1,5 @@
 ---
-weight: 5
+weight: 101
 title: hyprcursor
 ---
 hyprcursor is a new cursor theme format that has many advantages
diff --git a/pages/Hypr Ecosystem/hyprlang.md b/pages/Hypr Ecosystem/hyprlang.md
index f9395d7..fdb02e5 100644
--- a/pages/Hypr Ecosystem/hyprlang.md	
+++ b/pages/Hypr Ecosystem/hyprlang.md	
@@ -1,5 +1,5 @@
 ---
-weight: 9
+weight: 103
 title: hyprlang
 ---
 
diff --git a/pages/Hypr Ecosystem/hyprpolkitagent.md b/pages/Hypr Ecosystem/hyprpolkitagent.md
new file mode 100644
index 0000000..f3ac776
--- /dev/null
+++ b/pages/Hypr Ecosystem/hyprpolkitagent.md	
@@ -0,0 +1,23 @@
+---
+weight: 8
+title: hyprpolkitagent
+---
+
+hyprpolkitagent is a polkit authentication daemon. It is required for GUI applications to
+be able to request elevated privileges.
+
+If it's not available in your distro's repositories, you can either [build it from source](https://github.com/hyprwm/hyprpolkitagent)
+or use a different agent, e.g. [KDE's one](https://github.com/KDE/polkit-kde-agent-1/).
+
+## Usage
+
+Add `exec-once = systemctl --user start plasma-polkit-agent` to your Hyprland config and restart hyprland.
+(obviously change that to whatever you are using if you are not using the hypr one)
+
+On distributions that use a different init system, such as Gentoo, it may be
+necessary to use
+`exec-once=/usr/lib64/libexec/hyprpolkitagent` instead.
+
+Other possible paths include
+`/usr/lib/hyprpolkitagent` and
+`/usr/libexec/hyprpolkitagent`.
\ No newline at end of file
diff --git a/pages/Hypr Ecosystem/hyprutils.md b/pages/Hypr Ecosystem/hyprutils.md
index bf40414..620546d 100644
--- a/pages/Hypr Ecosystem/hyprutils.md	
+++ b/pages/Hypr Ecosystem/hyprutils.md	
@@ -1,5 +1,5 @@
 ---
-weight: 9
+weight: 102
 title: hyprutils
 ---
 
diff --git a/pages/Hypr Ecosystem/hyprwayland-scanner.md b/pages/Hypr Ecosystem/hyprwayland-scanner.md
index 4d416f8..5239314 100644
--- a/pages/Hypr Ecosystem/hyprwayland-scanner.md	
+++ b/pages/Hypr Ecosystem/hyprwayland-scanner.md	
@@ -1,5 +1,5 @@
 ---
-weight: 10
+weight: 104
 title: hyprwayland-scanner
 ---
 
diff --git a/pages/Useful Utilities/Must-have.md b/pages/Useful Utilities/Must-have.md
index eb7b362..037258c 100644
--- a/pages/Useful Utilities/Must-have.md	
+++ b/pages/Useful Utilities/Must-have.md	
@@ -54,20 +54,7 @@ _Starting method:_ manual (`exec-once`)
 Authentication agents are the things that pop up a window asking you for a
 password whenever an app wants to elevate its privileges.
 
-Our recommendation is the KDE one. For arch, it's `polkit-kde-agent`.
-
-You can autostart it with
-`exec-once=systemctl --user start plasma-polkit-agent`.
-
-On distributions that use a different init system, such as Gentoo, it may be
-necessary to use
-`exec-once=/usr/lib64/libexec/polkit-kde-authentication-agent-1` instead.
-
-Other possible paths include
-`/usr/lib/polkit-kde-authentication-agent-1`,
-`/usr/libexec/polkit-kde-authentication-agent-1`,
-`/usr/libexec/kf5/polkit-kde-authentication-agent-1`, and
-`/usr/libexec/kf6/polkit-kde-authentication-agent-1`.
+See [hyprpolkitagent](../hyprpolkitagent)
 
 ### Qt Wayland Support