📱 Available Apps

A collection of single-file Swift utilities designed for the macOS menu bar. Every app can be run directly as a .swift script or installed as a universal (arm64 + x86_64) .app bundle with a dedicated ai.thefocus.* Bundle ID.

📄 PdfBar

Bundle ID: ai.thefocus.pdfbar

Monitors your ~/Downloads, ~/Desktop, and iCloud reading folders for PDF and EPUB files, keeping the 15 most recent documents one click away.

Key Features:

• Real-time file monitoring with FSEvents
• Option (⌥) + Click to open and analyze in the ChatGPT macOS app
• Multi-directory scanning (Downloads, Desktop, iCloud reading)
• Universal .app bundle (PdfBar.app) with custom document icon

Quick Start:

./pdfbar/pdfbar.swift
# Or build PdfBar.app:
./pdfbar/build.sh && open pdfbar/PdfBar.app

📖 Documentation | 📦 Releases | 🔧 View Source

---

🛰️ Starlink Status

Bundle ID: ai.thefocus.starlinkstatus

Real-time monitoring of your Starlink dish (192.168.100.1:9200) with throughput, latency, packet loss, obstruction stats, and GPS lock status.

Key Features:

• Live downlink/uplink throughput, ping latency, and drop rate
• 5-minute rolling performance averages
• Device firmware, uptime, boot count, and GPS satellite status
• Automatic detection of grpcurl on both Apple Silicon and Intel Macs

Quick Start:

brew install grpcurl
./starlinkstatus/starlinkstatus.swift
# Or build StarlinkStatus.app:
./starlinkstatus/build.sh && open starlinkstatus/StarlinkStatus.app

📖 Documentation | 📦 Releases | 🔧 View Source

---

🌐 NetCheck & NetCheck Geo

Bundle IDs: ai.thefocus.netcheck (NetCheck.app) · ai.thefocus.netcheck-geo (NetCheckGeo.app)

Continuous 1-second connectivity monitoring against 1.1.1.1, available as both a lightweight menu bar monitor (netcheck.swift) and a GPS-enabled Connection Atlas (netcheck_geo.swift).

Key Features:

• 1-second ping probes with rolling 60-sample success rate, min/avg/max latency, and jitter
• NetCheck Geo: interactive dark-mode MapKit + SwiftUI Connection Atlas
• Per-SSID Wi-Fi allowlist (~/Library/Application Support/NetCheck/networks.json) so tracking only runs on chosen networks
• Local-only CSV trip archives in ~/Library/Application Support/NetCheck/trips/

Quick Start:

# Lightweight ping monitor
./netcheck/netcheck.swift

# Build both NetCheck.app and NetCheckGeo.app
./netcheck/build.sh
open netcheck/NetCheckGeo.app

📖 Documentation | 📦 Releases | 🔧 View Source

---

🌡️ AranetBar (Companion Repo)

Bundle ID: ai.thefocus.aranetbar

Passive Bluetooth LE indoor air quality monitor for the Aranet4 sensor — live CO₂, temperature, humidity, pressure, and downloadable history charts in one Swift file. Hosted in The-Focus-AI/aranet4-bluetooth.

Key Features:

• Zero-connection BLE advertisement scanning for live CO₂ readings
• On-demand history download & local caching with gap-honest SwiftUI charts
• Automatic multi-sensor selection and camera-notch visibility detection
• Rich headless CLI (--once, --dump-menu, --history, --render-history)

📖 Overview | 📦 AranetBar Releases | 🔧 View Source

---

🔧 Installing Prebuilt Bundles

All prebuilt .zip downloads are universal (arm64 + x86_64) and ad-hoc signed. After moving an .app into /Applications, clear Gatekeeper's quarantine attribute once before first launch:

xattr -dr com.apple.quarantine /Applications/NetCheckGeo.app

📄 License

MIT License — See LICENSE for details.