GuGa 1.0.3__tar.gz

guga-1.0.3/GuGa.egg-info/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: GuGa
+Version: 1.0.3
+Summary: Linux to Android notification bridge.
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: flask
+Requires-Dist: flask-socketio
+Requires-Dist: eventlet
+Requires-Dist: gunicorn
+Requires-Dist: python-dotenv
+Requires-Dist: qrcode
+Requires-Dist: cryptography
+Requires-Dist: aiohttp
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/PositiveMatician/GuGa-Nexus/main/app-stable/app/src/main/assets/logo.png" width="128" height="128" />
+</p>
+
+<h1 align="center">GuGa Nexus</h1>
+
+<p align="center">
+  Send your Linux terminal and OS notifications straight to your Android.<br/>
+  No cloud. No subscription. No port forwarding.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/GuGa/">
+    <img src="https://img.shields.io/pypi/v/GuGa.svg" alt="PyPI Version" />
+  </a>
+  <img src="https://img.shields.io/badge/platform-Linux-lightgrey" alt="Platform" />
+  <img src="https://img.shields.io/badge/encryption-AES--256--GCM-green" alt="Encryption" />
+  <img src="https://img.shields.io/badge/license-MIT-yellow" alt="License" />
+</p>
+
+🔗 [View the full Open Source Repository on GitHub](https://github.com/PositiveMatician/GuGa-Nexus)
+
+---
+
+**GuGa Nexus** is a minimalist, privacy-focused ecosystem that bridges your Linux machine and your Android device. It uses end-to-end AES-256-GCM encryption and works strictly over your own local network or a direct Cloudflare Tunnel—never storing your data on a third-party server.
+
+- **Waiting for a long script to finish?** Get notified the moment it's done.
+- **Training a model overnight?** Wake up to the final accuracy line in your notification.
+- **SSHed into a remote server?** GuGa reaches your phone over the internet seamlessly.
+
+---
+
+## Installation
+
+GuGa is distributed strictly as a standard Python module via PyPI.
+
+1. **Install the package:**
+```bash
+pip install GuGa
+```
+
+2. **Initialize the background daemon:**
+```bash
+guga --install-service
+```
+*(This interactive setup will cleanly provision your systemd daemon and configure your network routing. Afterwards, your QR code will be generated).*
+
+3. **Install the Android App:**
+Download the `stable` Android APK from the [GitHub Releases Page](https://github.com/PositiveMatician/GuGa-Nexus/releases) and scan the QR code printed in your terminal!
+
+---
+
+## 🚀 Examples & Usage
+
+Once deployed, the `guga` command-line utility is globally available on your terminal. It's designed to automatically detect whether you want to send a plain text notification, or if you want it to execute and watch a long-running process on your behalf.
+
+### 1. Plain Notifications (Message Mode)
+Send simple text updates directly to your Android device.
+
+```bash
+# Push a simple message
+guga "Build finished successfully ✅"
+
+# You can also stream output into it via stdin!
+echo "Database migration complete" | guga
+```
+
+### 2. Process Watching (Run Mode)
+Put `guga` in front of any command. It will execute the command natively while streaming the output to your terminal just as normal. Once the command finishes, it will instantly notify your phone with the **Elapsed Time**, **Exit Status**, and the **Last Console Line**.
+
+```bash
+# Get notified when training finishes
+guga python train_model.py --epochs 100
+
+# Compile code and get notified if it succeeded or crashed
+guga make build-project
+
+# Add custom labels to your notifications for clarity
+guga -r ./deploy.sh --title "Production Server"
+```
+
+---
+
+## Post-Install Utilities
+
+If you need to view your pairing credentials or manage your background daemon after installation, GuGa provides several utility commands:
+
+```bash
+guga --qr                             # Show the pairing QR code
+guga --show-pin                       # Show the secure Zero-Trust PIN
+guga --install-service --reconfigure  # Re-run the interactive setup
+```
+
+To control the Linux backend server explicitly:
+```bash
+sudo systemctl start guga       # Start the server daemon
+sudo systemctl stop guga        # Stop the server daemon
+journalctl -u guga -f           # View live server connection logs
+```
+
+---
+
+## Core Features & Architecture
+
+* **Terminal Tracking:** Push notifications to Android via the `guga` global CLI.
+* **System OS Monitoring:** Automatically intercepts DBus to forward your native Linux desktop notifications straight to your phone.
+* **Zero-Trust Coupling:** Cryptographically secure pairing logic relying strictly on visual QR transmission + 8-Digit PINs (No OAuth or cloud-accounts required).
+* **Network Versatility:** Operates flawlessly in **LAN-only mode** strictly over local WiFi, or seamlessly hooks into Cloudflared to grant you **Internet-anywhere access** without needing to own a domain or configure port-forwarding.

guga-1.0.3/GuGa.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+GuGa.egg-info/PKG-INFO
+GuGa.egg-info/SOURCES.txt
+GuGa.egg-info/dependency_links.txt
+GuGa.egg-info/entry_points.txt
+GuGa.egg-info/requires.txt
+GuGa.egg-info/top_level.txt
+guga/__init__.py
+guga/alerter.py
+guga/cli.py
+guga/daemon.py
+guga/installer.py
+guga/__pycache__/__init__.cpython-314.pyc
+guga/__pycache__/cli.cpython-314.pyc
+guga/__pycache__/daemon.cpython-314.pyc
+guga/man/guga.1
+guga/man/guga.md

guga-1.0.3/GuGa.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

guga-1.0.3/GuGa.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+guga = guga.cli:main

guga-1.0.3/GuGa.egg-info/requires.txt

@@ -0,0 +1,8 @@
+flask
+flask-socketio
+eventlet
+gunicorn
+python-dotenv
+qrcode
+cryptography
+aiohttp

guga-1.0.3/GuGa.egg-info/top_level.txt

@@ -0,0 +1 @@
+guga

guga-1.0.3/MANIFEST.in

@@ -0,0 +1,2 @@
+recursive-include guga/man *
+recursive-include guga *

guga-1.0.3/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: GuGa
+Version: 1.0.3
+Summary: Linux to Android notification bridge.
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: flask
+Requires-Dist: flask-socketio
+Requires-Dist: eventlet
+Requires-Dist: gunicorn
+Requires-Dist: python-dotenv
+Requires-Dist: qrcode
+Requires-Dist: cryptography
+Requires-Dist: aiohttp
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/PositiveMatician/GuGa-Nexus/main/app-stable/app/src/main/assets/logo.png" width="128" height="128" />
+</p>
+
+<h1 align="center">GuGa Nexus</h1>
+
+<p align="center">
+  Send your Linux terminal and OS notifications straight to your Android.<br/>
+  No cloud. No subscription. No port forwarding.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/GuGa/">
+    <img src="https://img.shields.io/pypi/v/GuGa.svg" alt="PyPI Version" />
+  </a>
+  <img src="https://img.shields.io/badge/platform-Linux-lightgrey" alt="Platform" />
+  <img src="https://img.shields.io/badge/encryption-AES--256--GCM-green" alt="Encryption" />
+  <img src="https://img.shields.io/badge/license-MIT-yellow" alt="License" />
+</p>
+
+🔗 [View the full Open Source Repository on GitHub](https://github.com/PositiveMatician/GuGa-Nexus)
+
+---
+
+**GuGa Nexus** is a minimalist, privacy-focused ecosystem that bridges your Linux machine and your Android device. It uses end-to-end AES-256-GCM encryption and works strictly over your own local network or a direct Cloudflare Tunnel—never storing your data on a third-party server.
+
+- **Waiting for a long script to finish?** Get notified the moment it's done.
+- **Training a model overnight?** Wake up to the final accuracy line in your notification.
+- **SSHed into a remote server?** GuGa reaches your phone over the internet seamlessly.
+
+---
+
+## Installation
+
+GuGa is distributed strictly as a standard Python module via PyPI.
+
+1. **Install the package:**
+```bash
+pip install GuGa
+```
+
+2. **Initialize the background daemon:**
+```bash
+guga --install-service
+```
+*(This interactive setup will cleanly provision your systemd daemon and configure your network routing. Afterwards, your QR code will be generated).*
+
+3. **Install the Android App:**
+Download the `stable` Android APK from the [GitHub Releases Page](https://github.com/PositiveMatician/GuGa-Nexus/releases) and scan the QR code printed in your terminal!
+
+---
+
+## 🚀 Examples & Usage
+
+Once deployed, the `guga` command-line utility is globally available on your terminal. It's designed to automatically detect whether you want to send a plain text notification, or if you want it to execute and watch a long-running process on your behalf.
+
+### 1. Plain Notifications (Message Mode)
+Send simple text updates directly to your Android device.
+
+```bash
+# Push a simple message
+guga "Build finished successfully ✅"
+
+# You can also stream output into it via stdin!
+echo "Database migration complete" | guga
+```
+
+### 2. Process Watching (Run Mode)
+Put `guga` in front of any command. It will execute the command natively while streaming the output to your terminal just as normal. Once the command finishes, it will instantly notify your phone with the **Elapsed Time**, **Exit Status**, and the **Last Console Line**.
+
+```bash
+# Get notified when training finishes
+guga python train_model.py --epochs 100
+
+# Compile code and get notified if it succeeded or crashed
+guga make build-project
+
+# Add custom labels to your notifications for clarity
+guga -r ./deploy.sh --title "Production Server"
+```
+
+---
+
+## Post-Install Utilities
+
+If you need to view your pairing credentials or manage your background daemon after installation, GuGa provides several utility commands:
+
+```bash
+guga --qr                             # Show the pairing QR code
+guga --show-pin                       # Show the secure Zero-Trust PIN
+guga --install-service --reconfigure  # Re-run the interactive setup
+```
+
+To control the Linux backend server explicitly:
+```bash
+sudo systemctl start guga       # Start the server daemon
+sudo systemctl stop guga        # Stop the server daemon
+journalctl -u guga -f           # View live server connection logs
+```
+
+---
+
+## Core Features & Architecture
+
+* **Terminal Tracking:** Push notifications to Android via the `guga` global CLI.
+* **System OS Monitoring:** Automatically intercepts DBus to forward your native Linux desktop notifications straight to your phone.
+* **Zero-Trust Coupling:** Cryptographically secure pairing logic relying strictly on visual QR transmission + 8-Digit PINs (No OAuth or cloud-accounts required).
+* **Network Versatility:** Operates flawlessly in **LAN-only mode** strictly over local WiFi, or seamlessly hooks into Cloudflared to grant you **Internet-anywhere access** without needing to own a domain or configure port-forwarding.

guga-1.0.3/README.md

@@ -0,0 +1,108 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/PositiveMatician/GuGa-Nexus/main/app-stable/app/src/main/assets/logo.png" width="128" height="128" />
+</p>
+
+<h1 align="center">GuGa Nexus</h1>
+
+<p align="center">
+  Send your Linux terminal and OS notifications straight to your Android.<br/>
+  No cloud. No subscription. No port forwarding.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/GuGa/">
+    <img src="https://img.shields.io/pypi/v/GuGa.svg" alt="PyPI Version" />
+  </a>
+  <img src="https://img.shields.io/badge/platform-Linux-lightgrey" alt="Platform" />
+  <img src="https://img.shields.io/badge/encryption-AES--256--GCM-green" alt="Encryption" />
+  <img src="https://img.shields.io/badge/license-MIT-yellow" alt="License" />
+</p>
+
+🔗 [View the full Open Source Repository on GitHub](https://github.com/PositiveMatician/GuGa-Nexus)
+
+---
+
+**GuGa Nexus** is a minimalist, privacy-focused ecosystem that bridges your Linux machine and your Android device. It uses end-to-end AES-256-GCM encryption and works strictly over your own local network or a direct Cloudflare Tunnel—never storing your data on a third-party server.
+
+- **Waiting for a long script to finish?** Get notified the moment it's done.
+- **Training a model overnight?** Wake up to the final accuracy line in your notification.
+- **SSHed into a remote server?** GuGa reaches your phone over the internet seamlessly.
+
+---
+
+## Installation
+
+GuGa is distributed strictly as a standard Python module via PyPI.
+
+1. **Install the package:**
+```bash
+pip install GuGa
+```
+
+2. **Initialize the background daemon:**
+```bash
+guga --install-service
+```
+*(This interactive setup will cleanly provision your systemd daemon and configure your network routing. Afterwards, your QR code will be generated).*
+
+3. **Install the Android App:**
+Download the `stable` Android APK from the [GitHub Releases Page](https://github.com/PositiveMatician/GuGa-Nexus/releases) and scan the QR code printed in your terminal!
+
+---
+
+## 🚀 Examples & Usage
+
+Once deployed, the `guga` command-line utility is globally available on your terminal. It's designed to automatically detect whether you want to send a plain text notification, or if you want it to execute and watch a long-running process on your behalf.
+
+### 1. Plain Notifications (Message Mode)
+Send simple text updates directly to your Android device.
+
+```bash
+# Push a simple message
+guga "Build finished successfully ✅"
+
+# You can also stream output into it via stdin!
+echo "Database migration complete" | guga
+```
+
+### 2. Process Watching (Run Mode)
+Put `guga` in front of any command. It will execute the command natively while streaming the output to your terminal just as normal. Once the command finishes, it will instantly notify your phone with the **Elapsed Time**, **Exit Status**, and the **Last Console Line**.
+
+```bash
+# Get notified when training finishes
+guga python train_model.py --epochs 100
+
+# Compile code and get notified if it succeeded or crashed
+guga make build-project
+
+# Add custom labels to your notifications for clarity
+guga -r ./deploy.sh --title "Production Server"
+```
+
+---
+
+## Post-Install Utilities
+
+If you need to view your pairing credentials or manage your background daemon after installation, GuGa provides several utility commands:
+
+```bash
+guga --qr                             # Show the pairing QR code
+guga --show-pin                       # Show the secure Zero-Trust PIN
+guga --install-service --reconfigure  # Re-run the interactive setup
+```
+
+To control the Linux backend server explicitly:
+```bash
+sudo systemctl start guga       # Start the server daemon
+sudo systemctl stop guga        # Stop the server daemon
+journalctl -u guga -f           # View live server connection logs
+```
+
+---
+
+## Core Features & Architecture
+
+* **Terminal Tracking:** Push notifications to Android via the `guga` global CLI.
+* **System OS Monitoring:** Automatically intercepts DBus to forward your native Linux desktop notifications straight to your phone.
+* **Zero-Trust Coupling:** Cryptographically secure pairing logic relying strictly on visual QR transmission + 8-Digit PINs (No OAuth or cloud-accounts required).
+* **Network Versatility:** Operates flawlessly in **LAN-only mode** strictly over local WiFi, or seamlessly hooks into Cloudflared to grant you **Internet-anywhere access** without needing to own a domain or configure port-forwarding.

guga-1.0.3/guga/alerter.py

@@ -0,0 +1,174 @@
+import asyncio
+import asyncio.subprocess
+import re
+import aiohttp
+import os
+import platform
+import sys
+from dotenv import load_dotenv
+
+CONFIG_DIR = os.path.expanduser("~/.guga")
+env_path = os.path.join(CONFIG_DIR, '.env')
+load_dotenv(dotenv_path=env_path)
+
+# Enforce Linux-only restriction
+if platform.system() != "Linux":
+    print("❌ ERROR: OS Notification monitoring only works on Linux (D-Bus required).")
+    print(f"Current OS: {platform.system()}")
+    sys.exit(1)
+
+# ------------------------------------------------------------
+# Configuration
+# ------------------------------------------------------------
+SERVER_URL = os.getenv("ALERTER_SERVER_URL", "http://localhost:6769/send")
+LOG_FILE = os.path.join(CONFIG_DIR, "alerter.log")
+
+# ------------------------------------------------------------
+# Text Cleaning (Stripping Formatting)
+# ------------------------------------------------------------
+def clean_text(text: str) -> str:
+    """
+    Strips HTML-like tags and common markdown formatting from text.
+    """
+    if not text:
+        return ""
+    
+    # 1. Strip HTML tags (e.g., <b>, <i>, <a href="...">)
+    text = re.sub(r'<[^>]+>', '', text)
+    
+    # 2. Strip Markdown bold/italic/strike (e.g., **, *, __, _, ~~)
+    text = re.sub(r'(\*\*|__|\*|_|~~)', '', text)
+    
+    # 3. Strip Markdown links [text](url) -> text
+    text = re.sub(r'\[([^\]]+)\]\([^\)]+\)', r'\1', text)
+    
+    # 4. Strip excessive newlines and whitespace
+    text = re.sub(r'\n+', ' ', text)
+    text = text.strip()
+    
+    return text
+
+# ------------------------------------------------------------
+# Forwarding Logic
+# ------------------------------------------------------------
+async def forward_to_server(app_name: str, title: str, body: str):
+    """
+    Sends the cleaned notification to the local server's /send route.
+    """
+    clean_title = clean_text(title)
+    clean_body = clean_text(body)
+    
+    payload_msg = f"{clean_title}: {clean_body}"
+    if not clean_title and not clean_body:
+        return
+
+    log_entry = f"Forwarding: {payload_msg}\n"
+    print(log_entry.strip())
+    with open(LOG_FILE, "a") as f:
+        f.write(log_entry)
+    
+    try:
+        async with aiohttp.ClientSession() as session:
+            async with session.post(SERVER_URL, json={"message": payload_msg , "title":app_name}) as resp:
+                status_msg = f"Server Response: {resp.status}\n"
+                print(status_msg.strip())
+                with open(LOG_FILE, "a") as f:
+                    f.write(status_msg)
+    except Exception as e:
+        err_msg = f"Error forwarding: {e}\n"
+        print(err_msg.strip())
+        with open(LOG_FILE, "a") as f:
+            f.write(err_msg)
+
+# ------------------------------------------------------------
+# D-Bus Monitor via Subprocess
+# ------------------------------------------------------------
+async def monitor_notifications():
+    """
+    Runs dbus-monitor and parses its output to detect notifications.
+    """
+    # Explicitly filter for method_call to avoid duplicates from signals
+    cmd = ["dbus-monitor", "type='method_call',interface='org.freedesktop.Notifications',member='Notify'"]
+    
+    try:
+        proc = await asyncio.create_subprocess_exec(
+            *cmd,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.STDOUT
+        )
+    except Exception as e:
+        print(f"Failed to start dbus-monitor: {e}")
+        return
+
+    if not proc.stdout:
+        print("Failed to capture dbus-monitor stdout.")
+        return
+
+    print("Monitoring D-Bus for notifications (method calls only)...")
+    
+    # State tracking
+    state = "IDLE"
+    app_name = ""
+    summary = ""
+    body = ""
+    
+    while True:
+        line_bytes = await proc.stdout.readline()
+        if not line_bytes:
+            break
+            
+        line = line_bytes.decode(errors='replace').strip()
+        
+        # Detect start of method call specifically
+        if "method call" in line and "interface=org.freedesktop.Notifications; member=Notify" in line:
+            state = "APP_NAME"
+            app_name = ""
+            summary = ""
+            body = ""
+            continue
+            
+        if state == "APP_NAME":
+            match = re.search(r'string\s+"(.*)"', line)
+            if match:
+                app_name = match.group(1)
+                state = "REPLACES_ID"
+        
+        elif state == "REPLACES_ID":
+            if "uint32" in line:
+                state = "ICON"
+                
+        elif state == "ICON":
+            match = re.search(r'string\s+"(.*)"', line)
+            if match:
+                state = "SUMMARY"
+                
+        elif state == "SUMMARY":
+            match = re.search(r'string\s+"(.*)"', line)
+            if match:
+                summary = match.group(1)
+                state = "BODY"
+                
+        elif state == "BODY":
+            # Body can be a string or we might see 'array [' if body is empty
+            match = re.search(r'string\s+"(.*)"', line)
+            if match:
+                body = match.group(1)
+                # Done capturing this notification
+                print(f"\n[Intercepted] App: {app_name}")
+                with open(LOG_FILE, "a") as f:
+                    f.write(f"\n[Intercepted] App: {app_name}\nTitle: {summary}\nBody: {body}\n")
+                asyncio.create_task(forward_to_server(app_name, summary, body))
+                state = "IDLE"
+            elif "array [" in line:
+                # Body was empty, moving to actions
+                print(f"\n[Intercepted] App: {app_name} (No body)")
+                with open(LOG_FILE, "a") as f:
+                    f.write(f"\n[Intercepted] App: {app_name}\nTitle: {summary}\nBody: (empty)\n")
+                asyncio.create_task(forward_to_server(app_name, summary, ""))
+                state = "IDLE"
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(monitor_notifications())
+    except KeyboardInterrupt:
+        print("\nStopping OS Notification Alerter...")