Détails des formats d'import

Cette page documente tous les fichiers que tu peux importer dans Slek, ainsi que toutes les colonnes supportées pour chaque fichier CSV.

1. Fichiers FIT

Les fichiers FIT (.fit ou .fit.gz) peuvent être importés individuellement ou en masse via un fichier ZIP. Ces fichiers contiennent les données brutes enregistrées par ton appareil GPS/cardio.

Note : Les fichiers FIT sont un format d'échange standard binaire. Tu ne devrais jamais avoir à les modifier. Ils sont documentés ici si tu souhaites en savoir plus.

2. Fichier CSV d'activités

Le fichier CSV d'activités permet d'importer les métadonnées et statistiques associées à tes activités qui ne sont pas dans le fichier FIT ou que tu as corrigé (données aberrantes, …)

Colonnes requises

Colonne	Type	Description
`DATE`	Chaîne	Date de l'activité au format ISO (2026-01-08-12-48-27+0100)
`ACTUAL_SPORT`	Chaîne	Identifiant du sport (voir ci-dessous)

Colonnes optionnelles

Colonne	Type	Description
`NAME`	Chaîne	Nom de l'activité
`HAS_FIT`	Booléen ou `auto`	Indique si l'activité a un fichier FIT associé. Valeurs acceptées : `true`, `false`, `1`, `0`, `auto`. Si vide : `auto` (pas de validation)
`MULTI`	Nombre	Pour les activités multiples (ex: triathlon) indice dans l'épreuve (par défaut : 0)
`TAGS`	Chaîne	Tags séparés par la barre verticale (ex:`tag1 \| tag2 \| tag3`)
`EDITED`	Booléen	Indique si l'activité a été modifiée manuellement
`ELEV_CORR_HYSTERESIS_M`	Nombre	Hystérésis de correction d'altitude en mètres

Colonnes dynamiques : Métriques (`METRIC_*`)

Les colonnes commençant par METRIC_ permettent d'importer des métriques d'activité.

Format : METRIC_{nom_metrique}

Métriques intégrées :

METRIC_FEELING - Ressenti
METRIC_FOCUS - Focus
METRIC_RPE - RPE (Rate of Perceived Exertion)

Métriques personnalisées :

METRIC_CUSTOM_{nom de la donnée} - Métriques personnalisées (ex: METRIC_CUSTOM_Envie)

Note : Les métriques personnalisées doivent être configurées dans les paramètres avant l'import, sinon elles seront ignorées.

Colonnes dynamiques : Cibles (`TARGET_*`)

Les colonnes commençant par TARGET_ permettent d'importer les cibles d'une séance.

Note: pour le moment l'import des cibles n'est pas supporté. Le format documenté ici s'applique déjà à l'export.

Cibles simples :

TARGET_rpe - RPE cible (nombre positif)
TARGET_distanceM - Distance cible en mètres (nombre ≥ 0)
TARGET_cadenceRpm - Cadence cible en RPM (nombre positif)
TARGET_ascentM - Dénivelé positif cible en mètres (nombre ≥ 0)
TARGET_descentM - Dénivelé négatif cible en mètres (nombre ≥ 0)

Durée :

TARGET_durationMinS - Durée minimale en secondes (nombre ≥ 0)
TARGET_durationMaxS - Durée maximale en secondes (nombre ≥ 0)
- Si durationMinS = durationMaxS ou si seule durationMinS est fournie, cela crée une cible de durée fixe
- Si durationMinS ≠ durationMaxS, cela crée une plage de durée

Cibles de zones (format : noms de zones séparés par |) :

TARGET_hr - Zones de fréquence cardiaque (ex: Zone 1 | Zone 2)
TARGET_powerW - Zones de puissance (ex: Zone 3 | Zone 4)
TARGET_speedMps - Zones de vitesse (ex: Zone 2 | Zone 3)

Colonnes dynamiques : Statistiques réalisées (`DONE_*`)

Les colonnes commençant par DONE_ permettent d'importer les statistiques réalisées lors de l'activité.

Format : DONE_{nom_statistique}

Statistiques disponibles :

DONE_elapsedTimeS - Temps écoulé en secondes
DONE_timerTimeS - Temps du chronomètre en secondes
DONE_movingTimeS - Temps de mouvement en secondes
DONE_distanceM - Distance en mètres
DONE_caloriesKcal - Calories en kilocalories
DONE_avgHeartRateBpm - Fréquence cardiaque moyenne en bpm
DONE_maxHeartRateBpm - Fréquence cardiaque maximale en bpm
DONE_avgSpeedMps - Vitesse moyenne en m/s
DONE_maxSpeedMps - Vitesse maximale en m/s
DONE_avgPowerW - Puissance moyenne en watts
DONE_maxPowerW - Puissance maximale en watts
DONE_normalizedPowerW - Puissance normalisée en watts
DONE_avgCadence - Cadence moyenne
DONE_maxCadence - Cadence maximale
DONE_avgVerticalOscillationMm - Oscillation verticale moyenne en mm
DONE_avgVerticalRatio - Ratio vertical moyen
DONE_avgStanceTimePercent - Temps de contact moyen en pourcentage
DONE_avgStanceTimeMs - Temps de contact moyen en millisecondes
DONE_avgStanceTimeBalance - Équilibre du temps de contact moyen
DONE_avgStepLengthMm - Longueur de pas moyenne en mm
DONE_ascentM - Dénivelé positif en mètres
DONE_descentM - Dénivelé négatif en mètres
DONE_minAltitudeM - Altitude minimale en mètres
DONE_maxAltitudeM - Altitude maximale en mètres

Colonnes dynamiques : Temps en zones (`_TIZ_`)

Les colonnes de temps en zones permettent d'importer le temps passé dans chaque zone d'entraînement.

Format : {KIND}_TIZ_{NUMERO_ZONE}

Kinds disponibles :

HR - Fréquence cardiaque
SPEED - Vitesse
POWER - Puissance

Numéros de zones : De 1 à 9 (maximum 9 zones)

Exemples :

HR_TIZ_1 - Temps passé en zone 1 de FC (en secondes)
HR_TIZ_2 - Temps passé en zone 2 de FC (en secondes)
SPEED_TIZ_1 - Temps passé en zone 1 de vitesse (en secondes)
POWER_TIZ_3 - Temps passé en zone 3 de puissance (en secondes)

Colonnes dynamiques : Définitions de zones (`_ZONE_`)

Les colonnes de définitions de zones permettent d'importer les limites des zones d'entraînement utilisées pour calculer le temps passé dans chaque zone.

Format : {KIND}_ZONE_{NUMERO_ZONE}_{PROPRIETE}

Kinds disponibles :

HR - Fréquence cardiaque
SPEED - Vitesse
POWER - Puissance

Numéros de zones : De 1 à 9 (maximum 9 zones)

Propriétés disponibles :

MIN - Valeur minimale de la zone (requis)
MAX - Valeur maximale de la zone (optionnel)
NAME - Nom de la zone (optionnel)

Exemples :

HR_ZONE_1_MIN - Valeur minimale de la zone 1 de FC (en bpm)
HR_ZONE_1_MAX - Valeur maximale de la zone 1 de FC (en bpm)
HR_ZONE_1_NAME - Nom de la zone 1 de FC (ex: "Zone 1")
SPEED_ZONE_2_MIN - Valeur minimale de la zone 2 de vitesse (en m/s)
POWER_ZONE_3_MAX - Valeur maximale de la zone 3 de puissance (en watts)

Note : Étant donnée que les zones varient au cours du temps, les définitions de zones sont indispensables pour interpréter les valeurs de temps en zones (*_TIZ_*). Si les définitions ne sont pas fournies lors de l'import, les valeurs de temps en zones (*_TIZ_*) seront ignorées.

Colonnes dynamiques : Pics (`_PEAK_`)

Les colonnes de pics permettent d'importer les valeurs moyennes maximales sur différentes durées.

Format : {KIND}_PEAK_{DURATION}

Kinds disponibles :

HR - Fréquence cardiaque
SPEED - Vitesse
POWER - Puissance

Durations disponibles (en secondes) :

1, 2, 5, 10, 20, 30
60 (1 min), 120 (2 min), 180 (3 min)
300 (5 min), 360 (6 min), 600 (10 min), 720 (12 min)
1200 (20 min), 1800 (30 min)
3600 (1 h), 5400 (1 h 30), 7200 (2 h)
10800 (3 h), 14400 (4 h), 18000 (5 h)
21600 (6 h), 25200 (7 h), 28800 (8 h)
32400 (9 h), 36000 (10 h)

Exemples :

HR_PEAK_60 - Pic de FC moyen sur 1 minute (en bpm)
POWER_PEAK_300 - Pic de puissance moyen sur 5 minutes (en watts)
SPEED_PEAK_3600 - Pic de vitesse moyen sur 1 heure (en m/s)

3. Fichier CSV de métriques quotidiennes

Le fichier CSV de métriques quotidiennes permet d'importer tes données quotidiennes (checkup matinal, poids, FC max, etc.).

Colonnes requises

Colonne	Type	Description
`DAY`	Chaîne	Date au format ISO (YYYY-MM-DD)
`KEY`	Chaîne	Clé de la métrique (peut être scopée avec `/SPORT`)
`VALUE`	Nombre	Valeur de la métrique

Clés de métriques intégrées

Bien-être général :

FRESHNESS_GENERAL - Fraîcheur générale
FRESHNESS_INTESTINAL - Fraîcheur intestinale
FRESHNESS_MUSCULAR - Fraîcheur musculaire
FRESHNESS_MUSCULAR_TOP - Fraîcheur musculaire haut du corps
FRESHNESS_MUSCULAR_BOTTOM - Fraîcheur musculaire bas du corps
SERENITY - Sérénité
QUALITY_EAT - Qualité de l'alimentation
QUALITY_DRINK - Qualité de l'hydratation

Santé :

HEIGHT - Taille
WEIGHT_TOTAL - Poids total
HRV_RMSSD_NIGHT_AVG - HRV RMSSD moyenne de la nuit
HRV_RMSSD_SNAPSHOT - HRV RMSSD instantané
SPO2_SNAPSHOT - SpO2 instantané
SLEEP_SCORE - Score de sommeil
SLEEP_TOTAL - Durée totale de sommeil

Performance :

HR_MAX - FC maximale
HR_REST - FC au repos
HR_THRESHOLD - FC seuil
POWER_THRESHOLD - Puissance seuil
SPEED_THRESHOLD - Vitesse seuil
SPEED_VO2MAX - Vitesse VO2max

Métriques scopées

Les métriques peuvent être « scopées » par sport en ajoutant /SPORT après la clé :

Exemples :

HR_MAX/RUNNING - FC max pour la course à pied
POWER_THRESHOLD/CYCLING - Puissance seuil pour le vélo
SPEED_VO2MAX/RUNNING - Vitesse VO2max pour la course à pied

Métriques personnalisées

Les métriques personnalisées utilisent le format CUSTOM_{nom} :

Exemples :

CUSTOM_Envie - Première métrique personnalisée
CUSTOM_Chrono - Deuxième métrique personnalisée
CUSTOM_Chrono/RUNNING - Métrique personnalisée scopée pour la course à pied

Note : Les métriques personnalisées doivent être configurées dans les paramètres avant l'import, sinon elles seront ignorées.

4. Fichier CSV de bibliothèque

Le fichier CSV de bibliothèque permet d'importer ta bibliothèque de séances d'entraînement. Ce fichier peut être accompagné d'un fichier ZIP contenant les pièces jointes.

Colonnes requises

Colonne	Type	Description
`SPORT`	Chaîne	Identifiant du sport (ex: `RUNNING`, `CYCLING`, etc.)
`TITLE`	Chaîne	Titre de la séance

Colonnes optionnelles

Colonne	Type	Description
`TAGS`	Chaîne	Tags séparés par un \| (ex:`tag1 \| tag2`)
`IS_PLAIN_TEXT`	Booléen	Indique si la description est en texte brut. Valeurs acceptées : `true`, `false`, `1`, `0`
`DESCRIPTION`	Chaîne	Description de la séance (peut contenir du Markdown si `IS_PLAIN_TEXT` est `false`)
`ATTACHMENTS`	Chaîne	Chemins des pièces jointes séparés par la barre verticale. Les fichiers doivent être dans le dossier `attachments/` du ZIP

Colonnes dynamiques : Cibles (`TARGET_*`)

Les mêmes colonnes TARGET_* que pour les activités sont supportées. Voir la section Colonnes dynamiques : Cibles (TARGET_*) ci-dessus.

5. Fichier CSV d'événements

Le fichier CSV d'événements permet d'importer des événements (notes, courses, douleurs).

Colonnes requises

Colonne	Type	Description
`START`	Chaîne	Date de début au format ISO (YYYY-MM-DD)
`END`	Chaîne	Date de fin au format ISO (YYYY-MM-DD)
`KIND`	Chaîne	Type d'événement : `NOTE`, `RACE`, ou `PAIN`

Colonnes optionnelles communes

Colonne	Type	Description
`TITLE`	Chaîne	Titre de l'événement

Colonnes spécifiques aux courses (`KIND = RACE`)

Colonne	Type	Description
`RACE_PRIORITY`	Nombre	Priorité de la course (1, 2, ou 3)

Colonnes spécifiques aux gênes/douleurs (`KIND = PAIN`)

Colonne	Type	Description
`PAIN_ZONE`	Chaîne	Zones corporelles affectées, séparées par la barre verticale (liste ci-dessous)
`PAIN_INVALIDITY`	Nombre	Invalidité de 1 à 100
`PAIN_ALLOWED_SPORTS`	Chaîne	Sports autorisés, séparés par la barre verticale (liste ci-dessous)

6. Identifiants de sport

Identifiant	Sport
RUNNING__GENERIC	Course à pied
RUNNING__TREADMILL	Tapis de course
RUNNING__STREET	Course sur route
RUNNING__TRAIL	Trail
RUNNING__TRACK	Course sur piste
RUNNING__INDOOR	Course en intérieur
RUNNING__ORIENTEERING	Course d'orientation
CYCLING__GENERIC	Vélo
CYCLING__INDOOR	Home‑trainer
CYCLING__ROAD	Vélo de route
CYCLING__MOUNTAIN	VTT
CYCLING__DOWNHILL	Descente VTT
CYCLING__RECUMBENT	Vélo couché
CYCLING__CYCLOCROSS	Cyclocross
CYCLING__HAND	Vélo à mains
CYCLING__TRACK	Vélo de piste
CYCLING__BMX	BMX
CYCLING__GRAVEL	Gravel
CYCLING__COMMUTING	Déplacement
ECYCLING__GENERIC	Vélo électrique
ECYCLING__MOUNTAIN	VTT électrique
SWIMMING__GENERIC	Natation
SWIMMING__POOL	Piscine
SWIMMING__OPEN_WATER	Nage en eau libre
MULTISPORT__GENERIC	Multi‑sport
MULTISPORT__TRANSITION	Transition
OUTDOOR__GENERIC	Activité outdoor
OUTDOOR__HIKING	Rando
OUTDOOR__SNOWSHOEING	Raquettes à neige
OUTDOOR__CLIMBING	Escalade
OUTDOOR__MOUNTAINEERING	Alpinisme
SKIING__GENERIC	Ski
SKIING__ALPINE	Ski de piste
SKIING__SNOWBOARDING	Snowboard
SKIING__XC_SKATE	Skating
SKIING__XC	Ski de fond
SKIING__TOURING	Ski de rando
FITNESS__GENERIC	Fitness
FITNESS__HIIT	Fitness HIIT
FITNESS__INDOOR_ROWING	Rameur
FITNESS__ELLIPTICAL	Vélo elliptique
FITNESS__FLEXIBILITY_TRAINING	Assouplissements
FITNESS__STRENGTH_TRAINING	Renfo‑muscu
FITNESS__CARDIO_TRAINING	Cardio Training
FITNESS__YOGA	Yoga
FITNESS__PILATES	Pilates
RACKET__GENERIC	Sport de raquette
RACKET__TENNIS	Tennis
RACKET__BADMINTON	Badminton
RACKET__PADEL	Padel
RACKET__SQUASH	Squash
RACKET__TABLE_TENNIS	Tennis de table
TEAM__GENERIC	Sport co
TEAM__BASKETBALL	Basket
TEAM__SOCCER	Foot
TEAM__HANDBALL	Handball
TEAM__VOLLEYBALL	Volley
FIGHTING__GENERIC	Sport de combat
FIGHTING__BOXING	Boxe
FIGHTING__JUDO	Judo
WATER__GENERIC	Activité aquatique
WATER__ROWING	Aviron
WATER__KAYAKING	Kayak
OTHER__HORSE_RIDING	Équitation
OTHER__INLINE_SKATING	Roller
OTHER__ICE_SKATING	Patin à glace
OTHER__GENERIC	Autre sport

7. Identifiants de zone du corps

Identifiant	Zone
Trapezius	Dos
RightLat	Flanc
LeftLat	Flanc
RightTricep	Bras
LeftTricep	Bras
LeftGlute	Fesse
RightGlute	Fesse
RightHamstring	Cuisse
LeftHamstring	Cuisse
RightCalf	Mollet
LeftCalf	Mollet
RightAnkle	Cheville
LeftAnkle	Cheville
LeftRearDeltoid	Épaule
RightRearDeltoid	Épaule
LowerBack	Dos
LeftElbow	Coude
RightElbow	Coude
LeftHandFingers	Main
RightHandFingers	Main
BackHead	Tête
RightDeltoid	Épaule
LeftDeltoid	Épaule
RightBicep	Bras
LeftBicep	Bras
RightPectoral	Thorax
LeftPectoral	Thorax
RightOblique	Flanc
LeftOblique	Flanc
RightQuad	Cuisse
LeftQuad	Cuisse
RightKnee	Genou
LeftKnee	Genou
RightShin	Tibia
LeftShin	Tibia
RightWrist	Poignet
LeftWrist	Poignet
RightForearm	Avant-bras
LeftForearm	Avant-bras
LeftHip	Hanche
RightHip	Hanche
RightAdductor	Aine
LeftAdductor	Aine
Abdomen	Ventre
RightNeck	Cou
LeftNeck	Cou
RightFoot	Pied
LeftFoot	Pied
FrontHead	Tête

8. Notes importantes

Encodage : ⚠️ Les fichiers CSV doivent être encodés en UTF-8
Métriques personnalisées : Les métriques personnalisées doivent être configurées dans les paramètres avant l'import, sinon les lignes les contenant seront ignorées.
Fichiers FIT : Pour les activités avec HAS_FIT = true, le fichier FIT correspondant doit être importé avant l'import du CSV d'activités.
Pièces jointes : Pour la bibliothèque, les pièces jointes doivent être dans un fichier ZIP avec le CSV, dans le dossier attachments/.

Détails des formats d'import

1. Fichiers FIT

2. Fichier CSV d'activités

Colonnes requises

Colonnes optionnelles

Colonnes dynamiques : Métriques (METRIC_*)

Colonnes dynamiques : Cibles (TARGET_*)

Colonnes dynamiques : Statistiques réalisées (DONE_*)

Colonnes dynamiques : Temps en zones (*_TIZ_*)

Colonnes dynamiques : Définitions de zones (*_ZONE_*)

Colonnes dynamiques : Pics (*_PEAK_*)

3. Fichier CSV de métriques quotidiennes

Colonnes requises

Clés de métriques intégrées

Métriques scopées

Métriques personnalisées

4. Fichier CSV de bibliothèque

Colonnes requises

Colonnes optionnelles

Colonnes dynamiques : Cibles (TARGET_*)

5. Fichier CSV d'événements

Colonnes requises

Colonnes optionnelles communes

Colonnes spécifiques aux courses (KIND = RACE)

Colonnes spécifiques aux gênes/douleurs (KIND = PAIN)

6. Identifiants de sport

7. Identifiants de zone du corps

8. Notes importantes

Colonnes dynamiques : Métriques (`METRIC_*`)

Colonnes dynamiques : Cibles (`TARGET_*`)

Colonnes dynamiques : Statistiques réalisées (`DONE_*`)

Colonnes dynamiques : Temps en zones (`_TIZ_`)

Colonnes dynamiques : Définitions de zones (`_ZONE_`)

Colonnes dynamiques : Pics (`_PEAK_`)

Colonnes dynamiques : Cibles (`TARGET_*`)

Colonnes spécifiques aux courses (`KIND = RACE`)

Colonnes spécifiques aux gênes/douleurs (`KIND = PAIN`)