brut
6.4 KiB
title
| title |
|---|
| BincioActivity |
BincioActivity è il sito dove raccogliamo tutte le nostre attività in bici: uscite, gare, gite. Ogni membro ha il proprio profilo con le sue uscite, distanze, dislivelli e tracce GPS.
Come caricare le attività
Da file GPX / FIT / TCX
Questi sono i file che producono il Garmin, il Karoo, o qualsiasi altro ciclocomputer. Anche Strava ti permette di esportarli.
- Apri il sito e clicca Upload
- Trascina i file nella finestra, oppure clicca per sceglierli
- Il sito li elabora e li aggiunge al tuo profilo
Puoi caricare più file in una volta sola. I duplicati vengono ignorati automaticamente.
Da Strava
Se usi Strava, puoi collegare il tuo account e importare le attività direttamente:
- Nel menu di upload, clicca Sync from Strava
- Autorizza l'accesso (una sola volta)
- Le attività vengono importate automaticamente
La connessione a Strava è opzionale — puoi sempre usare i file diretti dal ciclocomputer.
Come modificare un'attività
Clicca Edit su qualsiasi attività per:
- Cambiare il titolo — rinominare l'uscita
- Aggiungere una descrizione — racconta com'è andata, scrivi note, aggiungi riflessioni (supporta il markdown)
- Caricare foto — aggiungi immagini scattate durante l'uscita
- Scegliere il tipo di sport — ciclismo, corsa, escursione, sci...
- Assegnare la bici o il gear — per tenere traccia di quale mezzo hai usato
- Nascondere l'attività — se non vuoi che appaia nel feed
Le modifiche si salvano subito.
Ricalcolare il dislivello
Se il dislivello sembra strano (troppo alto o troppo basso), nel pannello di modifica ci sono due pulsanti per correggerlo:
- Ricalcola (hysteresis) — usa i dati di quota già registrati, ma applica un filtro per eliminare il rumore. Veloce, funziona offline. Ideale per Garmin, Karoo, Wahoo (che hanno l'altimetro barometrico).
- Ricalcola (DEM) — scarica i dati di quota dal terreno reale (modello digitale del terreno) e sostituisce quelli GPS. Più preciso per dispositivi senza altimetro barometrico.
Privacy
Ogni attività può essere:
- Pubblica — visibile a tutti i membri del sito
- Non elencata — non appare nel feed, ma è accessibile a chi ha il link diretto (utile per condividere con qualcuno senza metterla in evidenza)
App mobile
C'è anche un'app per Android (e presto iOS) che permette di:
- Importare le attività direttamente dal telefono o dal Karoo
- Vedere il proprio feed offline
- Sincronizzare le attività con il sito
Per il Karoo: l'app legge i file FIT direttamente dalla cartella /Rides senza bisogno di esportarli. Apri l'app dopo un'uscita e le attività compaiono da sole.
Per i più autarchici: deployment e federazione
BincioActivity è software libero, pensato per girare ovunque — dal telefono a un VPS. I tuoi dati sono sempre file leggibili, mai intrappolati in un formato proprietario.
Dove puoi farlo girare
Sul telefono — L'app Android funziona completamente offline, senza account e senza server. I file FIT vengono elaborati direttamente sul dispositivo. Nessun dato lascia il telefono a meno che tu non lo decida.
Sul proprio computer — Con Python installato, puoi avviare un'istanza locale in pochi minuti. Punta la cartella dove tieni i file GPX/FIT, esegui l'estrazione e il sito gira su localhost. Utile per esplorare i propri dati senza mettere niente online.
Su un server casalingo o un VPS — L'istanza condivisa di Bincio gira su un VPS privato. Chiunque del gruppo può fare lo stesso: un piccolo server Debian con nginx e il sito è online, privato, accessibile solo a chi ha le credenziali. Nessuna dipendenza da piattaforme esterne.
Su GitHub Pages o hosting statico — Se vuoi un sito pubblico e gratuito, il sito generato è composto da file statici puri. Si può pubblicare su GitHub Pages, Netlify o Cloudflare Pages senza alcun server applicativo.
Il formato BAS — i tuoi dati sono sempre leggibili
Tutte le attività vengono salvate nel formato BAS (BincioActivity Schema): file JSON semplici, aperti, documentati. Chiunque può leggerli con qualsiasi strumento — un foglio di calcolo, uno script Python, un altro software.
La struttura è questa:
i-tuoi-dati/
index.json ← elenco di tutte le attività
activities/
2024-06-01T073012Z-morning-ride.json ← dati completi
2024-06-01T073012Z-morning-ride.geojson ← traccia GPS
Non c'è nessun database, nessun formato binario, nessuna API obbligatoria. Se domani BincioActivity sparisce, i tuoi dati restano leggibili com'erano.
Cosa puoi condividere e come
Ci sono tre livelli di condivisione, dal più grezzo al più elaborato:
File originali (FIT / GPX / TCX) — I file grezzi del ciclocomputer. Massima fedeltà, massima portabilità. Chiunque abbia Strava, Garmin Connect, o qualsiasi altro software può aprirli.
File BAS (JSON) — I dati già estratti ed elaborati. Più compatti dei file originali, leggibili direttamente da qualsiasi script. Il tuo feed personale è sempre disponibile all'URL /u/tuonome/index.json.
Sito HTML — Il sito generato è una cartella di file statici. Puoi copiarlo su una chiavetta, mandarlo per email, o pubblicarlo dove vuoi. Non richiede nessun server per funzionare in sola lettura.
Federazione
La cosa più interessante: più istanze BincioActivity possono parlarsi. Se ognuno di noi ospitasse la propria istanza, il sito condiviso potrebbe semplicemente puntare al feed di ognuno:
bincio.org/index.json
→ dave: https://dave.example.com/index.json
→ alice: https://alice.example.com/index.json
→ bob: https://bob.example.com/index.json
Ogni persona mantiene il controllo totale dei propri dati. L'istanza condivisa aggrega senza possedere. Non è fantascienza — è già il modo in cui funziona il formato BAS internamente.
Domande frequenti
Posso scaricare i miei dati?
Sì. Il tuo profilo è disponibile in formato JSON all'indirizzo /u/tuonome/index.json.
Posso eliminare un'attività? Sì, se è attivo il servizio che permette di editare le attività. Clicca su "edit" e poi "delete". Se non vuoi elencare una attività, puoi nasconderla dal feed impostando la privacy su "non elencata".
Che formati di file accetta il sito?
GPX, FIT, TCX — e le versioni compresse .gz di ognuno. Sono i formati standard di tutti i ciclocomputer e le app GPS.