Skip to content

bylickilabs/FocusPulse-Pro

Repository files navigation

► FocusPulse ◄

🧠 FocusPulse Pro – Intelligenter Konzentrationstracker für Desktop & Web

Electron JavaScript HTML5 CSS3 Responsive MIT License
FocusPulsePro1



🔍 Beschreibung

FocusPulse Pro ist ein lokal laufender, visuell ansprechender Konzentrationstracker für Windows, macOS und Browser.
Er analysiert in Echtzeit deine Aktivität (Tastatur & Maus), speichert Sitzungen automatisch und visualisiert deinen Fortschritt – offline, datenschutzkonform, effizient.




✨ Hauptfunktionen

Kategorie Beschreibung
🧠 Live-Tracking Aufzeichnung deiner Aktivität im Hintergrund
⏱️ Intervallwahl 30 Sek. / 1 Min / 2 Min Buttons zur Anpassung des Messintervalls
🎯 Fokusziele Konfigurierbar: von 30 Sek bis 18 Stunden
📊 Wochenanalyse Heatmap & Balkenvergleich der letzten 7 Tage
💾 Session-Archivierung Speichere & lade benannte Sitzungen im Browser
📤 Exporte JSON- und CSV-Dateien für Analyse oder Archivierung
🔔 Idle-Erkennung Warnung nach >5 Minuten Inaktivität
🖥️ Electron Desktop-App Minimierbar in Tray, mit eigenem Icon & Setup-Installer (NSIS)
🎨 Neon UI Animierter Hintergrund, fließender Verlauf, moderne Schrift, Tooltip-Support



🧭 Projektstruktur

FocusPulse_Pro/
├── index.html
├── main.js # Electron-Starter
├── package.json # Build-Konfiguration
├── LICENSE.txt
├── icon.ico / icon.icns
├── css/
│ └── style.css
├── js/
│ ├── tracker.js
│ ├── chart.js
│ ├── chart2.js
│ ├── storage.js
│ ├── utils.js
│ └── ai.js
└── .github/workflows/deploy.yml

⚙️ Lokale Nutzung via XAMPP (empfohlen für Web)

  • 🪟 Schritt-für-Schritt-Anleitung:
  1. Lade XAMPP von: https://www.apachefriends.org/de
  2. Installiere XAMPP, starte das Control Panel
  3. Aktiviere den Apache Webserver
  4. Kopiere das Projekt in:
C:\xampp\htdocs\FocusPulse
  1. Öffne im Browser:
http://localhost/FocusPulse/



📌 Hinweis: localStorage speichert deine Daten lokal im Browser, keine Cloud notwendig.


🚀 GitHub Pages (optional)

  1. Repository erstellen
  2. Code hochladen
  3. In Settings > Pages aktivieren:
  • Branch: main
  • Verzeichnis: /root

🔗 Deine App ist dann unter folgendem Link erreichbar:

https://<username>.github.io/FocusPulse/



🖥️ Windows & macOS Installer (Electron)

  • Windows (.exe)
npm install
npm run dist
  • Ergebnis: dist/FocusPulse Pro Setup.exe
    • macOS (.dmg)
npm install
npm run dist
  • Ergebnis: dist/FocusPulse Pro.dmg
    • Hinweis: .dmg-Build muss auf macOS durchgeführt werden



🧩 Erweiterte Funktionen

  • autorun.inf für USB-Sticks
  • LICENSE.txt im Setup integriert
  • icon.ico & icon.icns für Branding
  • updater-config.json für zukünftige Updater-Unterstützung



📌 Hinweis zu Tab-/App-Tracking:

  • Die Web-App funktioniert nur wenn geöffnet & sichtbar
  • Der Electron-Client trackt auch minimiert im Tray
  • Aktivitätserkennung erfolgt per:
document.addEventListener("mousemove", ...)
document.addEventListener("keydown", ...)



📄 Lizenz MIT License LICENSE


© 2025 Thorsten Bylicki | https://www.bylickilabs.de




📫 Kontakt

  • 📧 Fragen oder Vorschläge:

📦 Forke das Projekt & mach einen Pull Request!

🔖 Tags (GitHub Topics)

focuspulse
productivity
focus-tracker
electron
vanillajs
chartjs
localstorage
neon-ui
time-tracking
offline-app