screen-toolkit : full screen utility (#221)

* screen-toolkit: add Noctalia v5 plugin * screen-toolkit: credit original plugin * screen-toolkit: fix recording, OCR capture, and result panel UX * screen-toolkit: rename record tool labels to Record / Rec FS * screen-toolkit: update plugin thumbnail * screen-toolkit: fix README validation (backtick deps, result panel toggle) * screen-toolkit: fix OCR results and dependencies * screen-toolkit: backtick recording and annotator deps in README --------- Co-authored-by: Ahmed5Emad <ahmed5emad@users.noreply.github.com>
2026-08-03 08:22:08 -04:00
parent 57227f8b51
commit 636317303c
15 changed files with 2860 additions and 0 deletions
@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+# share-upload.sh <file> [api_key] [expiry]
+# api_key: X02 API key — if empty, falls back to uguu.se (anonymous, 3h, 128MB max)
+# expiry:  1h | 1d | 7d | 30d | permanent (X02 only, default: 7d)
+# Prints URL to stdout on success, exits non-zero on failure
+# Exit codes:
+#   1 — invalid arguments (no file given)
+#   2 — file not found
+#   3 — missing dependency
+#   4 — upload request failed
+#   5 — invalid or empty response
+#   6 — file too large
+# Used by: service.luau
+
+set -euo pipefail
+
+FILE="${1:-}"
+API_KEY="${2:-}"
+EXPIRY="${3:-7d}"
+
+UGUU_MAX_BYTES=$((128 * 1024 * 1024))  # 128 MB
+
+[ -n "$FILE" ] || { echo "ERROR: no file given"         >&2; exit 1; }
+[ -f "$FILE" ] || { echo "ERROR: file not found: $FILE" >&2; exit 2; }
+
+command -v curl >/dev/null 2>&1 || { echo "ERROR: missing dependency: curl" >&2; exit 3; }
+
+# ── X02 (authenticated) ───────────────────────────────────────────────────────
+if [ -n "$API_KEY" ]; then
+    EXPIRY_FLAG=()
+    if [ "$EXPIRY" != "permanent" ] && [ -n "$EXPIRY" ]; then
+        EXPIRY_FLAG=(-F "expiry=${EXPIRY}")
+    fi
+
+    URL=$(curl -sS -f \
+        -X POST "https://up.x02.me/api/upload" \
+        -H "x-api-key: ${API_KEY}" \
+        -F "file=@${FILE}" \
+        "${EXPIRY_FLAG[@]}" \
+        --connect-timeout 20 \
+        --max-time 120 \
+        2>/dev/null) \
+        || { echo "ERROR: X02 upload request failed" >&2; exit 4; }
+
+    if [ -n "$URL" ] && [[ "$URL" == http* ]]; then
+        printf '%s\n' "$URL"
+        exit 0
+    fi
+
+    echo "ERROR: X02: unexpected response: $URL" >&2
+    exit 5
+fi
+
+# ── uguu.se (anonymous fallback) ──────────────────────────────────────────────
+command -v jq >/dev/null 2>&1 || { echo "ERROR: missing dependency: jq" >&2; exit 3; }
+
+FILE_SIZE=$(stat -c%s "$FILE" 2>/dev/null || stat -f%z "$FILE" 2>/dev/null || echo 0)
+if [ "$FILE_SIZE" -gt "$UGUU_MAX_BYTES" ]; then
+    echo "ERROR: file too large for anonymous upload (128MB max). Add an X02 API key for larger files." >&2
+    exit 6
+fi
+
+RESP=$(curl -sS -f -A 'Mozilla/5.0' \
+    --connect-timeout 20 --max-time 60 \
+    -F "files[]=@${FILE}" \
+    'https://uguu.se/upload' 2>/dev/null) \
+|| RESP=$(curl -sS -A 'Mozilla/5.0' \
+    --connect-timeout 20 --max-time 60 \
+    -F "files[]=@${FILE}" \
+    'https://uguu.se/upload.php' 2>/dev/null) \
+|| { echo "ERROR: uguu.se upload request failed" >&2; exit 4; }
+
+URL=$(printf '%s' "$RESP" | jq -r '.files[0].url // empty' 2>/dev/null)
+
+if [ -n "$URL" ] && [[ "$URL" == http* ]]; then
+    printf '%s\n' "$URL"
+    exit 0
+fi
+
+echo "ERROR: uguu.se: no valid URL in response" >&2
+exit 5