Sfruttare al Massimo i Log di Allenamento con LiftShift
Se vai in palestra e registri attentamente ogni serie su Hevy, Strong o Lyfta, probabilmente hai notato una cosa. I tracker mobile sono ottimi nel raccogliere dati grezzi ma quasi mai ti aiutano a capirli. Nel migliore dei casi, l'app mostra un grafico di un esercizio su un mese e ti congratula per un nuovo massimale. Il vero problema è che è difficile capire quali gruppi muscolari stai costantemente sottoponendo a training, dove hai raggiunto un vero plateau e devi cambiare approccio, e cosa sia semplicemente affaticamento normale dalla terza serie.
Di recente ho scoperto il progetto open-source LiftShift. È uno strumento web per l'analisi approfondita dei log di allenamento che gira direttamente nel browser e non richiede registrazione.
Cosa può fare il progetto
L'idea di base è semplice: fornisci all'app il tuo export o connetti il tuo account, e organizza i tuoi workout da una prospettiva di periodizzazione sportiva.
Ecco le funzionalità che spiccano immediatamente esplorando la dashboard:
- Mappa termica dei muscoli. Un modello corporeo interattivo mostra il carico di volume su ogni gruppo muscolare. Puoi cliccare su un muscolo specifico e vedere gli esercizi che hanno prodotto quello stimolo. L'algoritmo calcola le zone di volume (soglie MEV e MRV) aggiustate per l'esperienza di training e assegna un punteggio di ipertrofia da 0 a 100.
- Rilevamento dei plateau. Invece di un semplice trend del peso, lo strumento assegna stati chiari agli esercizi: crescita, plateau o declino. Il sistema distingue tra plateau senza via d'uscita (quando peso e ripetizioni sono completamente fermi) e fluttuazioni ondulatorie, poi suggerisce una soluzione: aggiungi una ripetizione, riduci il peso durante una settimana di deload, o cambia il range di ripetizioni.
- Analisi di ogni serie. Puoi aprire qualsiasi sessione passata e visualizzare le valutazioni delle serie. Il sistema identifica affaticamento normale, aumenti di peso troppo bruschi, drop set ben eseguiti, o serie fino al cedimento (AMRAP). Ogni serie riceve un badge e un consiglio diretto per il tuo prossimo workout.
- Unione dei dati da app diverse. Se hai usato Strong per anni e poi sei passato a Hevy, la tua cronologia di solito si frammenta. Il progetto può abbinare nomi diversi per lo stesso esercizio, rimuovere duplicati e ricomporre tutto in un'unica timeline.
- Export per reti neurali. Se i grafici integrati non bastano, i dati vengono esportati in un formato strutturato per prompt verso ChatGPT o Claude. Ci sono moduli già pronti: audit del junk volume, controllo del bilanciamento laterale, o valutazione del carico articolare.
- Mappa termica stile GitHub. Puoi vedere chiaramente le serie, le settimane perse e la costanza per tutto l'anno.
Sotto il cofano
L'architettura del progetto è focalizzata sulla privacy. Tutti i calcoli, il parsing dei CSV e il rendering dei grafici avvengono lato client.
Il frontend è costruito su uno stack moderno: React 19, TypeScript, Vite, Tailwind CSS e la libreria Recharts per la visualizzazione dei dati. Un piccolo backend Node.js con Express e Puppeteer viene usato esclusivamente come proxy per le chiamate API ai tracker come Hevy e Lyfta, dove sono richieste restrizioni CORS del browser o autorizzazione. I log di allenamento non vengono memorizzati sul server.
Per lavorare con Strong, sono supportati gli import di file CSV con delimitatori punto e virgola, virgolette e suffissi delle unità di peso nelle intestazioni.
Come eseguire in locale
Se vuoi distribuire il progetto sulla tua macchina o scrivere un parser personalizzato, bastano un paio di comandi. Avrai bisogno di Node.js versione 22 o superiore.
git clone https://github.com/aree6/LiftShift.git
cd LiftShift
npm install
npm run dev
Dopo l'avvio, il server locale si aprirà sulla porta standard di Vite.
Se stai usando la versione pubblica sul sito web del progetto, basta selezionare la tua piattaforma, caricare un CSV o incollare la tua API key, specificare le tue unità (kg o libbre), e dirigerti verso la dashboard.
Un piccolo dettaglio: quando esporti da Hevy, a volte l'app si lamenta dei formati delle date. Questo succede a causa della locale non inglese nell'app sorgente. Basta passare temporaneamente la lingua di esportazione a Inglese:
A chi è rivolto il progetto
LiftShift colma perfettamente il divario tra i semplici quaderni di palestra e i fogli di calcolo complessi degli allenatori in Excel. Se sei troppo pigro per calcolare manualmente il tonnage per gruppo muscolare e cercare squilibri, il client web lo fa in un paio di secondi.
Il progetto è distribuito sotto la licenza AGPL-3.0. Il codebase è pulito, scritto in strict TypeScript, quindi se vuoi aggiungere il supporto per il tuo tracker fitness preferito o implementare nuove metriche di periodizzazione, contribuire qui è piuttosto piacevole.
Progetti correlati