Skip to content

Repository files navigation

Chronify

Chronify

Il Spotify Wrapped del tuo PC — in tempo reale, permanente e dettagliato.

Chronify traccia automaticamente e in modo preciso tutto il tempo che passi al computer: giochi, applicazioni, sessioni, ore, statistiche avanzate, timeline, heatmap e recap condivisibili. 100% locale — nessun dato lascia il tuo PC.

Dashboard


✨ Funzionalità

  • Tracking automatico a due flussi
    • App aperte → ogni applicazione aperta accumula tempo in parallelo, anche se è dietro un'altra finestra o su un secondo monitor (es. Discord che resta attivo mentre usi il browser).
    • Primo piano → l'app attiva alimenta il tempo reale al PC (niente doppi conteggi).
    • Rilevamento inattività (idle), cambio finestra, sessioni unite, split a mezzanotte.
  • Dashboard live — oggi / ieri / settimana / mese / anno / totale, con trend rispetto al periodo precedente, sessione corrente e top app.
  • Timeline giornaliera — ricostruzione a blocchi della giornata, con traccia 24h. Clicca un blocco per categoria, tag e note.
  • App & Giochi — ore totali, sessioni, durata media, sessione più lunga, orari preferiti, trend 7/30 giorni, icone reali delle app.
  • Heatmap stile GitHub (un anno) + distribuzioni orarie e durata sessioni.
  • Recap automatici giornaliero / settimanale / mensile / annuale, salvati e navigabili nel tempo.
  • Memory cards condivisibili (“Hai passato 83 ore su 5 giochi”, “Orario medio 22:40”, …).
  • Insight intelligenti — orari di picco, comportamento notturno, app abbandonate, streak, trend.
  • Notifiche opzionali — soglia giornaliera, sopra la media, sessioni troppo lunghe, streak.
  • Tag, note e categorie manuali sulle sessioni (gaming, lavoro, studio, social, creative…).
  • Export CSV / JSON.
  • Background + tray — chiudendo la finestra Chronify continua a tracciare nella tray; avvio automatico al login.
  • Aggiornamenti automatici in-app.
  • Personalizzazione — tema chiaro/scuro/sistema e colore d'accento.

📸 Screenshot

App & Giochi Heatmap & distribuzioni Recap & Memory Cards
App Heatmap Recap

⬇️ Installazione

Opzione 1 — Installer (consigliata)

  1. Vai nella sezione Releases.
  2. Scarica l'ultimo Chronify-Setup-x.y.z.exe.
  3. Esegui l'installer e segui la procedura. Chronify si avvia e inizia a tracciare.
  4. Gli aggiornamenti arrivano automaticamente: quando ne esce uno, viene scaricato in background e installato alla chiusura dell'app.

Esiste anche una versione portable (Chronify-x.y.z-portable.exe) che non richiede installazione.

Opzione 2 — Da sorgente

git clone https://github.com/OrsooTR/chronify.git
cd chronify
npm install
npm run dev        # avvio in sviluppo (hot reload)

Build dell'eseguibile in locale:

npm run package    # crea l'installer in ./release

🚀 Come si usa

  • Avvialo e dimenticatene. Chronify traccia in automatico mentre usi il PC.
  • La Dashboard risponde subito a “quanto ho usato il PC oggi/questa settimana/quest'anno?”.
  • App & Giochi → clicca un'app per vederne il dettaglio (trend, orari, sessione più lunga…).
  • Timeline → rivivi una giornata; clicca un blocco per aggiungere categoria, tag e note.
  • Recap → genera il tuo wrapped e salva le memory cards.
  • Impostazioni → soglia di inattività, sessione minima, notifiche, tema, colore, avvio automatico.
  • Chiudendo la finestra, l'app resta nella tray (icona vicino all'orologio di Windows) e continua a tracciare. Click sull'icona per riaprirla; tasto destro per Pausa o Esci.

🔒 Privacy: tutti i dati sono salvati solo in locale in %APPDATA%/Chronify/chronify.db. Nessun invio in cloud.

🏗️ Architettura (in breve)

Electron + React + TypeScript, con netta separazione dei livelli. Vedi ARCHITECTURE.md.

src/
  shared/     tipi entità · contratto IPC tipizzato · helper
  main/        tracking engine (watcher PowerShell) · data layer (SQLite/WASM) · services · tray · updater
  preload/     bridge tipizzato (window API)
  renderer/    UI React: dashboard, timeline, app, heatmap, recap, settings, export
Scelta Perché
Electron + electron-vite accesso OS per il tracking, HMR, bundling pulito
TypeScript end-to-end contratto IPC tipizzato, meno bug
React + Zustand + framer-motion UI a componenti, store minimale, animazioni fluide
SQLite via sql.js (WASM) query veloci, file locale, zero build nativa
PowerShell watcher enumerazione finestre aperte senza moduli nativi
electron-updater aggiornamenti automatici via GitHub Releases

🗺️ Roadmap

  • Tracking, dashboard, timeline, app, heatmap, grafici
  • Recap + memory cards, insight, export
  • Tag/note, notifiche, tray/background, auto-update
  • Wrapped annuale esportabile come immagine
  • Sync multi-dispositivo (cloud opzionale)
  • Insight con AI

📄 Licenza

MIT.


Fatto con ⏱️ — Chronify

About

Chronify — il Spotify Wrapped del tuo PC: tracking automatico di app, giochi e tempo al computer. Electron + React + TypeScript.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages