From 344c2c82e7cddc29f154982de85248a203488e7f Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Thu, 7 Aug 2025 14:02:20 -0400
Subject: [PATCH 1/2] docs: document optional GUI install

---
 README.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/README.md b/README.md
index 0abe272..f630dfb 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,7 @@ SeedPass now uses the `portalocker` library for cross-platform file locking. No
   - [2. Create a Virtual Environment](#2-create-a-virtual-environment)
   - [3. Activate the Virtual Environment](#3-activate-the-virtual-environment)
   - [4. Install Dependencies](#4-install-dependencies)
+  - [Optional GUI](#optional-gui)
 - [Usage](#usage)
   - [Running the Application](#running-the-application)
   - [Managing Multiple Seeds](#managing-multiple-seeds)
@@ -221,6 +222,42 @@ sudo apt install xclip
 
 After installing `xclip`, restart SeedPass to enable clipboard support.
 
+### Optional GUI
+
+SeedPass ships with a GTK-based desktop interface that requires additional system
+libraries. Install the packages for your platform before adding the Python GUI
+dependencies.
+
+- **Debian/Ubuntu**
+  ```bash
+  sudo apt install libgirepository1.0-dev libcairo2-dev libpango1.0-dev libwebkit2gtk-4.0-dev
+  ```
+- **Fedora**
+  ```bash
+  sudo dnf install gobject-introspection-devel cairo-devel pango-devel webkit2gtk4.0-devel
+  ```
+- **Arch Linux**
+  ```bash
+  sudo pacman -S gobject-introspection cairo pango webkit2gtk
+  ```
+- **macOS (Homebrew)**
+  ```bash
+  brew install pygobject3 gtk+3 adwaita-icon-theme librsvg webkitgtk
+  ```
+
+With the system requirements in place, install the Python GUI extras:
+
+```bash
+pip install .[gui]
+```
+
+CLI-only users can skip these steps and install just the core package for a
+lightweight setup:
+
+```bash
+pip install .
+```
+
 ## Quick Start
 
 After installing dependencies and activating your virtual environment, install the package in editable mode so the `seedpass` command is available:

From b33dc5148d5c08a0358115185baec7408df436a3 Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Thu, 7 Aug 2025 22:12:49 -0400
Subject: [PATCH 2/2] docs: note GUI development status

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index f630dfb..43785fc 100644
--- a/README.md
+++ b/README.md
@@ -224,9 +224,9 @@ After installing `xclip`, restart SeedPass to enable clipboard support.
 
 ### Optional GUI
 
-SeedPass ships with a GTK-based desktop interface that requires additional system
-libraries. Install the packages for your platform before adding the Python GUI
-dependencies.
+SeedPass ships with a GTK-based desktop interface that is still in development
+and not currently functional. Install the packages for your platform before
+adding the Python GUI dependencies.
 
 - **Debian/Ubuntu**
   ```bash