2023-06-18 15:02:21 +02:00
<!doctype html>
2023-08-23 11:36:28 +02:00
< html class = "no-js" lang = "en" data-content_root = "" >
2023-06-18 15:02:21 +02:00
< head > < meta charset = "utf-8" / >
< meta name = "viewport" content = "width=device-width,initial-scale=1" / >
< meta name = "color-scheme" content = "light dark" > < meta name = "viewport" content = "width=device-width, initial-scale=1" / >
< link rel = "index" title = "Index" href = "genindex.html" / > < link rel = "search" title = "Search" href = "search.html" / > < link rel = "next" title = "OAuth 2.0" href = "oauth.html" / > < link rel = "prev" title = "FitTrackee" href = "index.html" / >
2020-12-30 11:12:35 +01:00
2023-09-14 13:43:58 +02:00
<!-- Generated with Sphinx 7.1.2 and Furo 2023.09.10 -->
2023-12-23 18:39:26 +01:00
< title > Features - FitTrackee 0.7.28 documentation< / title >
2023-08-23 11:36:28 +02:00
< link rel = "stylesheet" type = "text/css" href = "_static/pygments.css?v=fa44fd50" / >
2023-07-30 17:05:25 +02:00
< link rel = "stylesheet" type = "text/css" href = "_static/styles/furo.css?v=135e06be" / >
< link rel = "stylesheet" type = "text/css" href = "_static/copybutton.css?v=76b2166b" / >
< link rel = "stylesheet" type = "text/css" href = "_static/styles/furo-extensions.css?v=36a5483c" / >
< link rel = "stylesheet" type = "text/css" href = "_static/css/fork-awesome.min.css?v=876feb3b" / >
< link rel = "stylesheet" type = "text/css" href = "_static/css/custom.css?v=9f1a53bb" / >
2023-06-18 15:02:21 +02:00
< style >
body {
--color-code-background: #eeffcc;
--color-code-foreground: black;
}
@media not print {
body[data-theme="dark"] {
--color-code-background: #272822;
--color-code-foreground: #f8f8f2;
}
@media (prefers-color-scheme: dark) {
body:not([data-theme="light"]) {
--color-code-background: #272822;
--color-code-foreground: #f8f8f2;
}
}
}
< / style > < / head >
< body >
< script >
document.body.dataset.theme = localStorage.getItem("theme") || "auto";
< / script >
< svg xmlns = "http://www.w3.org/2000/svg" style = "display: none;" >
< symbol id = "svg-toc" viewBox = "0 0 24 24" >
< title > Contents< / title >
< svg stroke = "currentColor" fill = "currentColor" stroke-width = "0" viewBox = "0 0 1024 1024" >
< path d = "M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z" / >
< / svg >
< / symbol >
< symbol id = "svg-menu" viewBox = "0 0 24 24" >
< title > Menu< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
< line x1 = "3" y1 = "12" x2 = "21" y2 = "12" > < / line >
< line x1 = "3" y1 = "6" x2 = "21" y2 = "6" > < / line >
< line x1 = "3" y1 = "18" x2 = "21" y2 = "18" > < / line >
< / svg >
< / symbol >
< symbol id = "svg-arrow-right" viewBox = "0 0 24 24" >
< title > Expand< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
< polyline points = "9 18 15 12 9 6" > < / polyline >
< / svg >
< / symbol >
< symbol id = "svg-sun" viewBox = "0 0 24 24" >
< title > Light mode< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
< circle cx = "12" cy = "12" r = "5" > < / circle >
< line x1 = "12" y1 = "1" x2 = "12" y2 = "3" > < / line >
< line x1 = "12" y1 = "21" x2 = "12" y2 = "23" > < / line >
< line x1 = "4.22" y1 = "4.22" x2 = "5.64" y2 = "5.64" > < / line >
< line x1 = "18.36" y1 = "18.36" x2 = "19.78" y2 = "19.78" > < / line >
< line x1 = "1" y1 = "12" x2 = "3" y2 = "12" > < / line >
< line x1 = "21" y1 = "12" x2 = "23" y2 = "12" > < / line >
< line x1 = "4.22" y1 = "19.78" x2 = "5.64" y2 = "18.36" > < / line >
< line x1 = "18.36" y1 = "5.64" x2 = "19.78" y2 = "4.22" > < / line >
< / svg >
< / symbol >
< symbol id = "svg-moon" viewBox = "0 0 24 24" >
< title > Dark mode< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
< path stroke = "none" d = "M0 0h24v24H0z" fill = "none" / >
< path d = "M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" / >
< / svg >
< / symbol >
< symbol id = "svg-sun-half" viewBox = "0 0 24 24" >
< title > Auto light/dark mode< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-shadow">
< path stroke = "none" d = "M0 0h24v24H0z" fill = "none" / >
< circle cx = "12" cy = "12" r = "9" / >
< path d = "M13 12h5" / >
< path d = "M13 15h4" / >
< path d = "M13 18h1" / >
< path d = "M13 9h4" / >
< path d = "M13 6h1" / >
< / svg >
< / symbol >
< / svg >
< input type = "checkbox" class = "sidebar-toggle" name = "__navigation" id = "__navigation" >
< input type = "checkbox" class = "sidebar-toggle" name = "__toc" id = "__toc" >
< label class = "overlay sidebar-overlay" for = "__navigation" >
< div class = "visually-hidden" > Hide navigation sidebar< / div >
< / label >
< label class = "overlay toc-overlay" for = "__toc" >
< div class = "visually-hidden" > Hide table of contents sidebar< / div >
< / label >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< div class = "page" >
< header class = "mobile-header" >
< div class = "header-left" >
< label class = "nav-overlay-icon" for = "__navigation" >
< div class = "visually-hidden" > Toggle site navigation sidebar< / div >
< i class = "icon" > < svg > < use href = "#svg-menu" > < / use > < / svg > < / i >
< / label >
< / div >
< div class = "header-center" >
2023-12-23 18:39:26 +01:00
< a href = "index.html" > < div class = "brand" > FitTrackee 0.7.28
2023-06-18 15:02:21 +02:00
documentation< / div > < / a >
< / div >
< div class = "header-right" >
< div class = "theme-toggle-container theme-toggle-header" >
< button class = "theme-toggle" >
< div class = "visually-hidden" > Toggle Light / Dark / Auto color theme< / div >
< svg class = "theme-icon-when-auto" > < use href = "#svg-sun-half" > < / use > < / svg >
< svg class = "theme-icon-when-dark" > < use href = "#svg-moon" > < / use > < / svg >
< svg class = "theme-icon-when-light" > < use href = "#svg-sun" > < / use > < / svg >
2020-12-30 11:12:35 +01:00
< / button >
< / div >
2023-06-18 15:02:21 +02:00
< label class = "toc-overlay-icon toc-header-icon" for = "__toc" >
< div class = "visually-hidden" > Toggle table of contents sidebar< / div >
< i class = "icon" > < svg > < use href = "#svg-toc" > < / use > < / svg > < / i >
< / label >
< / div >
< / header >
< aside class = "sidebar-drawer" >
< div class = "sidebar-container" >
< div class = "sidebar-sticky" > < a class = "sidebar-brand" href = "index.html" >
< div class = "sidebar-logo-container" >
< img class = "sidebar-logo" src = "_static/ft-logo.png" alt = "Logo" / >
< / div >
2023-12-23 18:39:26 +01:00
< span class = "sidebar-brand-text" > FitTrackee 0.7.28
2023-06-18 15:02:21 +02:00
documentation< / span >
< / a > < form class = "sidebar-search-container" method = "get" action = "search.html" role = "search" >
< input class = "sidebar-search" placeholder = "Search" name = "q" aria-label = "Search" >
< input type = "hidden" name = "check_keywords" value = "yes" >
< input type = "hidden" name = "area" value = "default" >
< / form >
< div id = "searchbox" > < / div > < div class = "sidebar-scroll" > < div class = "sidebar-tree" >
< ul class = "current" >
< li class = "toctree-l1 current current-page" > < a class = "current reference internal" href = "#" > Features< / a > < / li >
2023-04-12 17:32:08 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "oauth.html" > OAuth 2.0< / a > < / li >
2021-11-29 18:24:22 +01:00
< li class = "toctree-l1" > < a class = "reference internal" href = "installation.html" > Installation< / a > < / li >
2022-04-24 13:17:38 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "cli.html" > Command line interface< / a > < / li >
2023-04-12 17:32:08 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "third_party_tools.html" > Third-party tools< / a > < / li >
2023-06-18 15:02:21 +02:00
< li class = "toctree-l1 has-children" > < a class = "reference internal" href = "api/index.html" > API documentation< / a > < input class = "toctree-checkbox" id = "toctree-checkbox-1" name = "toctree-checkbox-1" role = "switch" type = "checkbox" / > < label for = "toctree-checkbox-1" > < div class = "visually-hidden" > Toggle navigation of API documentation< / div > < i class = "icon" > < svg > < use href = "#svg-arrow-right" > < / use > < / svg > < / i > < / label > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/auth.html" > Authentication and account< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/configuration.html" > Configuration< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/oauth2.html" > OAuth2< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/records.html" > Records< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/sports.html" > Sports< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/stats.html" > Statistics< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/users.html" > Users< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "api/workouts.html" > Workouts< / a > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / li >
2023-06-18 15:02:21 +02:00
< li class = "toctree-l1 has-children" > < a class = "reference internal" href = "troubleshooting/index.html" > Troubleshooting< / a > < input class = "toctree-checkbox" id = "toctree-checkbox-2" name = "toctree-checkbox-2" role = "switch" type = "checkbox" / > < label for = "toctree-checkbox-2" > < div class = "visually-hidden" > Toggle navigation of Troubleshooting< / div > < i class = "icon" > < svg > < use href = "#svg-arrow-right" > < / use > < / svg > < / i > < / label > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "troubleshooting/administrator.html" > Administrator< / a > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
2022-02-05 22:09:17 +01:00
< / li >
2023-06-18 15:02:21 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "changelog.html" > Change log< / a > < / li >
2022-02-05 22:09:17 +01:00
< / ul >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / div >
2023-06-18 15:23:33 +02:00
< / div > < div id = "furo-languages" tabindex = "0" >
< span class = "languages-label" >
< i class = "fa fa-language" > < / i >
< / span >
< div class = "languages-list" >
< a href = "../en/features.html" hreflang = en lang = en >
English
< / a >
< a href = "../fr/features.html" hreflang = fr lang = fr >
Français
< / a >
< / div >
2023-06-18 15:02:21 +02:00
< / div >
< / div >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / div >
< / aside >
< div class = "main" >
< div class = "content" >
< div class = "article-container" >
< a href = "#" class = "back-to-top muted-link" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" >
< path d = "M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z" > < / path >
< / svg >
< span > Back to top< / span >
< / a >
< div class = "content-icon-container" >
< div class = "theme-toggle-container theme-toggle-content" >
< button class = "theme-toggle" >
< div class = "visually-hidden" > Toggle Light / Dark / Auto color theme< / div >
< svg class = "theme-icon-when-auto" > < use href = "#svg-sun-half" > < / use > < / svg >
< svg class = "theme-icon-when-dark" > < use href = "#svg-moon" > < / use > < / svg >
< svg class = "theme-icon-when-light" > < use href = "#svg-sun" > < / use > < / svg >
< / button >
< / div >
< label class = "toc-overlay-icon toc-content-icon" for = "__toc" >
< div class = "visually-hidden" > Toggle table of contents sidebar< / div >
< i class = "icon" > < svg > < use href = "#svg-toc" > < / use > < / svg > < / i >
< / label >
< / div >
< article role = "main" >
< section id = "features" >
< h1 > Features< a class = "headerlink" href = "#features" title = "Permalink to this heading" > #< / a > < / h1 >
2022-09-19 18:49:25 +02:00
< div class = "line-block" >
< div class = "line" > < strong > FitTrackee< / strong > allows you to store and display gpx files and some statistics from your outdoor activities.< / div >
< div class = "line" > For now, this app is kind of a single-user application. Even if several users can register, a user can only view his own workouts.< / div >
< / div >
2023-12-20 19:44:22 +01:00
< p > Gpx files are stored in an upload directory (< strong > without encryption< / strong > ).< / p >
2022-09-19 18:49:25 +02:00
< p > With the default configuration, < a class = "reference external" href = "https://www.openstreetmap.org" > Open Street Map< / a > is used as tile server in Workout detail and for static map generation.< / p >
2021-11-06 21:26:02 +01:00
< section id = "workouts" >
2023-06-18 15:02:21 +02:00
< h2 > Workouts< a class = "headerlink" href = "#workouts" title = "Permalink to this heading" > #< / a > < / h2 >
2020-12-30 11:12:35 +01:00
< ul class = "simple" >
< li > < dl class = "simple" >
2023-12-20 19:44:22 +01:00
< dt > 17 sports are supported:< / dt > < dd > < ul >
2020-12-30 11:12:35 +01:00
< li > < p > Cycling (Sport)< / p > < / li >
< li > < p > Cycling (Transport)< / p > < / li >
2023-12-20 19:44:22 +01:00
< li > < p > Cycling (Trekking) (< em > new in 0.7.27< / em > )< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > Cycling (Virtual) (< em > new in 0.7.3< / em > )< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > Hiking< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > Mountain Biking< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > Mountain Biking (Electric) (< em > new in 0.5.0< / em > )< / p > < / li >
2022-12-11 19:00:07 +01:00
< li > < p > Mountaineering (< em > new in 0.7.9< / em > )< / p > < / li >
2023-07-22 11:36:39 +02:00
< li > < p > Open Water Swimming (< em > new in 0.7.20< / em > )< / p > < / li >
2023-07-15 13:39:59 +02:00
< li > < p > Paragliding (< em > new in 0.7.19< / em > )< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > Rowing (< em > new in 0.5.0< / em > )< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > Running< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > Skiing (Alpine) (< em > new in 0.5.0< / em > )< / p > < / li >
< li > < p > Skiing (Cross Country) (< em > new in 0.5.0< / em > )< / p > < / li >
< li > < p > Snowshoes (< em > new in 0.5.2< / em > )< / p > < / li >
< li > < p > Trail (< em > new in 0.5.0< / em > )< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > Walking< / p > < / li >
< / ul >
< / dd >
< / dl >
< / li >
2021-11-11 17:33:30 +01:00
< li > < dl class = "simple" >
2021-11-12 19:25:31 +01:00
< dt > (< em > new in 0.5.0< / em > ) Stopped speed threshold used by < a class = "reference external" href = "https://github.com/tkrajina/gpxpy" > gpxpy< / a > is not the default one for the following sports (0.1 km/h instead of 1 km/h):< / dt > < dd > < ul >
2021-11-11 17:33:30 +01:00
< li > < p > Hiking< / p > < / li >
2022-12-11 19:00:07 +01:00
< li > < p > Mountaineering< / p > < / li >
2023-07-22 11:36:39 +02:00
< li > < p > Open Water Swimming< / p > < / li >
2023-07-15 13:39:59 +02:00
< li > < p > Paragliding< / p > < / li >
2021-11-11 17:33:30 +01:00
< li > < p > Skiing (Cross Country)< / p > < / li >
2021-12-19 10:29:56 +01:00
< li > < p > Snowshoes< / p > < / li >
2021-11-11 17:33:30 +01:00
< li > < p > Trail< / p > < / li >
< li > < p > Walking< / p > < / li >
< / ul >
< / dd >
< / dl >
< / li >
2021-11-12 19:25:31 +01:00
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > It can be overridden in user preferences.< / p >
< / div >
2023-07-23 11:29:16 +02:00
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > Except the stopped speed threshold, all sports are analyzed in the same way (no specificity taken into account for the moment).< / p >
< / div >
2023-04-12 17:32:08 +02:00
< ul class = "simple" >
2021-11-12 19:25:31 +01:00
< li > < p > Dashboard with month calendar displaying workouts and record. The week can start on Sunday or Monday (which can be changed in the user preferences). The calendar displays up to 100 workouts.< / p > < / li >
2023-04-12 17:32:08 +02:00
< li > < p > Workout creation by uploading a gpx file (related data are stored in database in metric system).< / p > < / li >
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< div class = "line-block" >
< div class = "line" > Only gpx files with time are supported.< / div >
< div class = "line" > Calculated values may differ from values calculated by the application that originally generated the gpx files, in particular the maximum speed.< / div >
< / div >
< / div >
< ul >
2022-12-21 12:43:46 +01:00
< li > < div class = "line-block" >
< div class = "line" > A workout can even be created without gpx (the user must enter date, time, duration and distance).< / div >
< div class = "line" > Ascent and descent can also be provided (< em > new in 0.7.10< / em > ).< / div >
< / div >
< / li >
2022-01-19 16:06:41 +01:00
< li > < div class = "line-block" >
2023-07-23 11:29:16 +02:00
< div class = "line" > A workout with a gpx file can be displayed with map and charts (speed and elevation (if the gpx file contains elevation data, < em > updated in 0.7.20< / em > )).< / div >
2022-11-30 12:43:54 +01:00
< div class = "line" > Controls allow full screen view and position reset (< em > new in 0.5.5< / em > ).< / div >
2022-01-19 16:06:41 +01:00
< / div >
< / li >
< li > < div class = "line-block" >
2023-04-12 17:32:08 +02:00
< div class = "line" > If < strong > Visual Crossing< / strong > (< em > new in 0.7.11< / em > ) API key is provided, weather is displayed in workout detail. Data source is displayed in < strong > About< / strong > page.< / div >
< div class = "line" > Wind is displayed, with an arrow indicating the direction (a tooltip can be displayed with the direction that the wind is coming < strong > from< / strong > ) (< em > new in 0.5.5< / em > ).< / div >
2022-01-19 16:06:41 +01:00
< / div >
< / li >
< li > < p > Segments can be displayed.< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > Workout gpx file can be downloaded (< em > new in 0.5.1< / em > )< / p > < / li >
2021-11-12 19:25:31 +01:00
< li > < p > Workout edition and deletion. User can add a note.< / p > < / li >
2021-11-28 11:39:11 +01:00
< li > < dl class = "simple" >
2022-01-19 16:06:41 +01:00
< dt > User statistics, by time period (week, month, year) and sport:< / dt > < dd > < ul class = "simple" >
2021-11-28 11:39:11 +01:00
< li > < p > total distance< / p > < / li >
< li > < p > total duration< / p > < / li >
< li > < p > total workouts< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > total ascent (< em > new in 0.5.0< / em > )< / p > < / li >
< li > < p > total descent (< em > new in 0.5.0< / em > )< / p > < / li >
< li > < p > average speed (< em > new in 0.5.1< / em > )< / p > < / li >
2021-11-28 11:39:11 +01:00
< / ul >
< / dd >
< / dl >
< / li >
2020-12-30 11:12:35 +01:00
< li > < dl class = "simple" >
2022-01-19 16:06:41 +01:00
< dt > User records by sports:< / dt > < dd > < ul class = "simple" >
2020-12-30 11:12:35 +01:00
< li > < p > average speed< / p > < / li >
2022-03-26 20:30:37 +01:00
< li > < p > farthest distance< / p > < / li >
2022-11-30 12:43:54 +01:00
< li > < p > highest ascent (< em > new in 0.6.11< / em > , can be hidden, see user preferences)< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > longest duration< / p > < / li >
< li > < p > maximum speed< / p > < / li >
< / ul >
< / dd >
< / dl >
< / li >
2022-03-26 20:30:37 +01:00
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > Records may differ from records displayed by the application that originally generated the gpx files.< /p>
< / div >
< ul class = "simple" >
2023-04-12 17:32:08 +02:00
< li > < dl class = "simple" >
< dt > Workouts list.< / dt > < dd > < ul >
< li > < dl class = "simple" >
< dt > The user can filter workouts on:< / dt > < dd > < ul >
< li > < p > date< / p > < / li >
< li > < p > sports (only sports with workouts are displayed in sport dropdown)< / p > < / li >
< li > < p > title (< em > new in 0.7.15< / em > )< / p > < / li >
< li > < p > distance< / p > < / li >
< li > < p > duration< / p > < / li >
< li > < p > average speed< / p > < / li >
< li > < p > maximum speed< / p > < / li >
< / ul >
< / dd >
< / dl >
< / li >
< li > < dl class = "simple" >
< dt > Workouts can be sorted by:< / dt > < dd > < ul >
< li > < p > date< / p > < / li >
< li > < p > distance< / p > < / li >
< li > < p > duration< / p > < / li >
< li > < p > average speed< / p > < / li >
< / ul >
< / dd >
< / dl >
< / li >
< / ul >
< / dd >
< / dl >
< / li >
2020-12-30 11:12:35 +01:00
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
2021-11-13 12:20:35 +01:00
< p > For now, only the owner of the workout can see it.< / p >
2020-12-30 11:12:35 +01:00
< / div >
2021-11-06 21:26:02 +01:00
< / section >
2022-02-05 22:09:17 +01:00
< section id = "account-preferences" >
2023-06-18 15:02:21 +02:00
< h2 > Account & preferences< a class = "headerlink" href = "#account-preferences" title = "Permalink to this heading" > #< / a > < / h2 >
2022-02-05 22:09:17 +01:00
< ul class = "simple" >
2022-03-27 15:11:12 +02:00
< li > < p > A user can create, update and deleted his account.< / p > < / li >
2023-03-05 14:26:31 +01:00
< li > < p > The user must agree to the privacy policy to register. If a more recent policy is available, a message is displayed on the dashboard to review the new version (< em > new in 0.7.13< / em > ).< / p > < / li >
2022-07-03 17:27:43 +02:00
< li > < p > On registration, the user account is created with selected language in dropdown as user preference (< em > new in 0.6.9< / em > ).< / p > < / li >
2022-04-24 13:17:38 +02:00
< li > < p > After registration, the user account is inactive and an email with confirmation instructions is sent to activate it.
2023-03-05 14:26:31 +01:00
A user with an inactive account cannot log in. (< em > new in 0.6.0< / em > ).< / p > < / li >
2022-03-27 15:11:12 +02:00
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
2022-04-24 13:17:38 +02:00
< p > In case email sending is not configured, a < a class = "reference external" href = "cli.html#ftcli-users-update" > command line< / a > allows to activate users account.< / p >
2022-03-27 15:11:12 +02:00
< / div >
< ul class = "simple" >
2022-02-05 22:09:17 +01:00
< li > < p > A user can set language, timezone and first day of week.< / p > < / li >
2023-12-30 11:25:00 +01:00
< li > < p > A user can set the interface theme (light (default value), dark or according to browser preferences). When the dark or light theme is set, it overrides browser preferences (< em > new in 0.7.27< / em > ).< / p > < / li >
2022-02-05 22:09:17 +01:00
< li > < p > A user can reset his password (< em > new in 0.3.0< / em > )< / p > < / li >
2022-03-26 20:30:37 +01:00
< li > < p > A user can change his email address (< em > new in 0.6.0< / em > )< / p > < / li >
2022-02-05 22:09:17 +01:00
< li > < p > A user can choose between metric system and imperial system for distance, elevation and speed display (< em > new in 0.5.0< / em > )< / p > < / li >
2022-07-23 18:19:40 +02:00
< li > < p > A user can choose to display or hide ascent records and total on Dashboard (< em > new in 0.6.11< / em > )< / p > < / li >
2022-11-01 19:58:12 +01:00
< li > < p > A user can choose format used to display dates (< em > new in 0.7.3< / em > )< / p > < / li >
2023-04-12 17:32:08 +02:00
< li > < p > A user can choose elevation chart axis start: zero or minimum altitude (< em > new in 0.7.15< / em > )< / p > < / li >
2023-05-29 14:35:09 +02:00
< li > < p > A user can choose to exclude extreme values (which may be GPS errors) when calculating the maximum speed (by default, extreme values are excluded) (< em > new in 0.7.16< / em > )< / p > < / li >
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > Changing this preference will only affect next file uploads.< / p >
< / div >
< ul class = "simple" >
2022-02-05 22:09:17 +01:00
< li > < dl class = "simple" >
< dt > A user can set sport preferences (< em > new in 0.5.0< / em > ):< / dt > < dd > < ul >
< li > < p > change sport color (used for sport image and charts)< / p > < / li >
< li > < p > can override stopped speed threshold (for next uploaded gpx files)< / p > < / li >
< li > < p > disable/enable a sport.< / p > < / li >
< / ul >
< / dd >
< / dl >
< / li >
< / ul >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< div class = "line-block" >
< div class = "line" > If a sport is disabled by an administrator, it can not be enabled by a user. In this case, it will only appear in preferences if the user has workouts and only sport color can be changed.< / div >
< div class = "line" > A disabled sport (by admin or user) will not appear in dropdown when < strong > adding a workout< / strong > .< / div >
< div class = "line" > A workout with a disabled sport will still be displayed in the application.< / div >
< / div >
< / div >
2023-03-05 14:26:31 +01:00
< ul >
2022-08-27 16:50:29 +02:00
< li > < p > A user can create < a class = "reference external" href = "apps.html" > clients< / a > for third-party applications (< em > new in 0.7.0< / em > ).< / p > < / li >
2023-03-05 14:26:31 +01:00
< li > < div class = "line-block" >
< div class = "line" > A user can request a data export (< em > new in 0.7.13< / em > ).< / div >
< div class = "line" > It generates a zip archive containing 2 < code class = "docutils literal notranslate" > < span class = "pre" > json< / span > < / code > files (user info and workouts data) and all uploaded gpx files.< / div >
< / div >
< / li >
2022-08-27 16:50:29 +02:00
< / ul >
2023-03-05 14:26:31 +01:00
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > For now, it’ < strong > FitTrackee< / strong > instance.< / p >
< / div >
2022-02-05 22:09:17 +01:00
< / section >
< section id = "administration" >
2023-06-18 15:02:21 +02:00
< h2 > Administration< a class = "headerlink" href = "#administration" title = "Permalink to this heading" > #< / a > < / h2 >
2022-02-05 22:09:17 +01:00
< p > (< em > new in 0.3.0< / em > )< / p >
2023-03-05 14:26:31 +01:00
< section id = "application" >
2023-06-18 15:02:21 +02:00
< h3 > Application< a class = "headerlink" href = "#application" title = "Permalink to this heading" > #< / a > < / h3 >
2023-03-05 14:26:31 +01:00
< p > < strong > Configuration< / strong > < / p >
2022-02-05 22:09:17 +01:00
< p > The following parameters can be set:< / p >
< ul class = "simple" >
2023-03-05 14:26:31 +01:00
< li > < p > active users limit. If 0, registration is enabled (no limit defined).< / p > < / li >
2022-11-05 10:10:25 +01:00
< li > < p > maximum size of gpx file (individually uploaded or in a zip archive) (< em > changed in 0.7.4< / em > )< / p > < / li >
2022-02-05 22:09:17 +01:00
< li > < p > maximum size of zip archive< / p > < / li >
2022-11-05 10:10:25 +01:00
< li > < p > maximum number of files in the zip archive (< em > changed in 0.7.4< / em > )< / p > < / li >
2022-03-26 20:30:37 +01:00
< li > < p > administrator email for contact (< em > new in 0.6.0< / em > )< / p > < / li >
2022-02-05 22:09:17 +01:00
< / ul >
< div class = "admonition warning" >
< p class = "admonition-title" > Warning< / p >
< p > Updating server configuration may be necessary to handle large files (like < a class = "reference external" href = "https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size" > nginx< / a > for instance).< / p >
< / div >
2022-04-24 13:17:38 +02:00
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > If email sending is disabled, a warning is displayed.< / p >
< / div >
2023-03-05 14:26:31 +01:00
< p > < strong > About< / strong > < / p >
< p > (< em > new in 0.7.13< / em > )< / p >
< div class = "line-block" >
< div class = "line" > It is possible displayed additional information that may be useful to users in < strong > About< / strong > page.< / div >
< div class = "line" > Markdown syntax can be used.< / div >
< / div >
< p > < strong > Privacy policy< / strong > < / p >
< p > (< em > new in 0.7.13< / em > )< / p >
< div class = "line-block" >
< div class = "line" > A default privacy policy is available (originally adapted from the < a class = "reference external" href = "https://github.com/discourse/discourse" > Discourse< / a > privacy policy).< / div >
< div class = "line" > A custom privacy policy can set if needed (Markdown syntax can be used). A policy update will display a message on users dashboard to review it.< / div >
< / div >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< p > Only the default privacy policy is translated (if the translation is available).< / p >
< / div >
< / section >
< section id = "users" >
2023-06-18 15:02:21 +02:00
< h3 > Users< a class = "headerlink" href = "#users" title = "Permalink to this heading" > #< / a > < / h3 >
2022-02-05 22:09:17 +01:00
< ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > display and filter users list< / p > < / li >
2023-03-05 14:26:31 +01:00
< li > < p > edit a user to:< / p >
< ul >
2022-03-26 20:30:37 +01:00
< li > < p > add/remove administration rights< / p > < / li >
< li > < p > activate his account (< em > new in 0.6.0< / em > )< / p > < / li >
< li > < p > update his email (in case his account is locked) (< em > new in 0.6.0< / em > )< / p > < / li >
2022-04-24 16:02:49 +02:00
< li > < p > reset his password (in case his account is locked) (< em > new in 0.6.0< / em > ). If email sending is disabled, it is only possible via CLI.< / p > < / li >
2022-03-26 20:30:37 +01:00
< / ul >
< / li >
2022-02-05 22:09:17 +01:00
< li > < p > delete a user< / p > < / li >
< / ul >
2023-03-05 14:26:31 +01:00
< / section >
< section id = "sports" >
2023-06-18 15:02:21 +02:00
< h3 > Sports< a class = "headerlink" href = "#sports" title = "Permalink to this heading" > #< / a > < / h3 >
2022-02-05 22:09:17 +01:00
< ul class = "simple" >
< li > < p > enable or disable a sport (a sport can be disabled even if workout with this sport exists)< / p > < / li >
< / ul >
2023-03-05 14:26:31 +01:00
< / section >
2022-02-05 22:09:17 +01:00
< / section >
2021-11-06 21:26:02 +01:00
< section id = "translations" >
2023-06-18 15:02:21 +02:00
< h2 > Translations< a class = "headerlink" href = "#translations" title = "Permalink to this heading" > #< / a > < / h2 >
2022-07-03 08:02:43 +02:00
< p > FitTrackee is available in the following languages (which can be saved in the user preferences):< / p >
2022-11-30 12:43:54 +01:00
< ul class = "simple" >
< li > < p > English< / p > < / li >
< li > < p > French (< em > new in 0.2.3< / em > )< / p > < / li >
< li > < p > German (< em > new in 0.6.9< / em > )< / p > < / li >
< li > < p > Dutch (< em > new in 0.7.8< / em > )< / p > < / li >
2022-12-21 12:43:46 +01:00
< li > < p > Italian (< em > new in 0.7.10< / em > )< / p > < / li >
2023-04-12 17:32:08 +02:00
< li > < p > Galician (< em > new in 0.7.15< / em > )< / p > < / li >
< li > < p > Spanish (< em > new in 0.7.15< / em > )< / p > < / li >
< li > < p > Norwegian Bokmål (< em > new in 0.7.15< / em > )< / p > < / li >
2023-06-25 14:00:35 +02:00
< li > < p > Polish (< em > new in 0.7.18< / em > )< / p > < / li >
2022-11-30 12:43:54 +01:00
< / ul >
2023-06-25 14:00:35 +02:00
< p > Application translations status on < a class = "reference external" href = "https://hosted.weblate.org/engage/fittrackee/" > Weblate< / a > (may differ from the released version):< / p >
2022-07-03 08:02:43 +02:00
< figure class = "align-default" >
< img alt = "https://hosted.weblate.org/widgets/fittrackee/-/multi-auto.svg" src = "https://hosted.weblate.org/widgets/fittrackee/-/multi-auto.svg" / > < / figure >
2021-11-06 21:26:02 +01:00
< / section >
2022-02-05 22:09:17 +01:00
< section id = "screenshots" >
2023-06-18 15:02:21 +02:00
< h2 > Screenshots< a class = "headerlink" href = "#screenshots" title = "Permalink to this heading" > #< / a > < / h2 >
2021-11-06 21:26:02 +01:00
< section id = "dashboard" >
2023-06-18 15:02:21 +02:00
< h3 > Dashboard< a class = "headerlink" href = "#dashboard" title = "Permalink to this heading" > #< / a > < / h3 >
2021-11-06 21:26:02 +01:00
< figure class = "align-default" >
2020-12-30 11:12:35 +01:00
< img alt = "FitTrackee Dashboard" src = "_images/fittrackee_screenshot-01.png" / >
2021-11-06 21:26:02 +01:00
< / figure >
< / section >
< section id = "workout-detail" >
2023-06-18 15:02:21 +02:00
< h3 > Workout detail< a class = "headerlink" href = "#workout-detail" title = "Permalink to this heading" > #< / a > < / h3 >
2021-11-06 21:26:02 +01:00
< figure class = "align-default" >
2021-01-10 11:16:43 +01:00
< img alt = "FitTrackee Workout" src = "_images/fittrackee_screenshot-02.png" / >
2021-11-06 21:26:02 +01:00
< / figure >
< / section >
< section id = "workouts-list" >
2023-06-18 15:02:21 +02:00
< h3 > Workouts list< a class = "headerlink" href = "#workouts-list" title = "Permalink to this heading" > #< / a > < / h3 >
2021-11-06 21:26:02 +01:00
< figure class = "align-default" >
2021-01-10 11:16:43 +01:00
< img alt = "FitTrackee Workouts" src = "_images/fittrackee_screenshot-03.png" / >
2021-11-06 21:26:02 +01:00
< / figure >
< / section >
< section id = "statistics" >
2023-06-18 15:02:21 +02:00
< h3 > Statistics< a class = "headerlink" href = "#statistics" title = "Permalink to this heading" > #< / a > < / h3 >
2021-11-06 21:26:02 +01:00
< figure class = "align-default" >
2020-12-30 11:12:35 +01:00
< img alt = "FitTrackee Statistics" src = "_images/fittrackee_screenshot-04.png" / >
2021-11-06 21:26:02 +01:00
< / figure >
< / section >
< section id = "id1" >
2023-06-18 15:02:21 +02:00
< h3 > Administration< a class = "headerlink" href = "#id1" title = "Permalink to this heading" > #< / a > < / h3 >
2021-11-06 21:26:02 +01:00
< figure class = "align-default" >
2020-12-30 11:12:35 +01:00
< img alt = "FitTrackee Administration" src = "_images/fittrackee_screenshot-05.png" / >
2021-11-03 12:41:23 +01:00
< / figure >
< figure class = "align-default" >
< img alt = "FitTrackee Sports Administration" src = "_images/fittrackee_screenshot-06.png" / >
< / figure >
< / section >
2022-02-05 22:09:17 +01:00
< / section >
2021-11-03 12:41:23 +01:00
< / section >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / article >
< / div >
< footer >
< div class = "related-pages" >
< a class = "next-page" href = "oauth.html" >
< div class = "page-info" >
< div class = "context" >
< span > Next< / span >
< / div >
< div class = "title" > OAuth 2.0< / div >
< / div >
< svg class = "furo-related-icon" > < use href = "#svg-arrow-right" > < / use > < / svg >
< / a >
< a class = "prev-page" href = "index.html" >
< svg class = "furo-related-icon" > < use href = "#svg-arrow-right" > < / use > < / svg >
< div class = "page-info" >
< div class = "context" >
< span > Previous< / span >
< / div >
< div class = "title" > Home< / div >
< / div >
< / a >
< / div >
< div class = "bottom-of-page" >
< div class = "left-details" >
< div class = "copyright" >
Copyright © 2018 - 2023, SamR1
< / div >
Made with < a href = "https://www.sphinx-doc.org/" > Sphinx< / a > and < a class = "muted-link" href = "https://pradyunsg.me" > @pradyunsg< / a > 's
< a href = "https://github.com/pradyunsg/furo" > Furo< / a >
< / div >
< div class = "right-details" >
< div class = "icons" >
< a class = "muted-link fa fa-github fa-lg" href = "https://github.com/SamR1/FitTrackee" aria-label = "GitHub" > < / a >
2023-06-28 08:44:42 +02:00
< a class = "muted-link fa fa-mastodon fa-lg" rel = "me" href = "https://fosstodon.org/@FitTrackee" aria-label = "Mastodon" > < / a >
2023-06-18 15:02:21 +02:00
< / div >
< / div >
< / div >
< / footer >
2020-12-30 11:12:35 +01:00
< / div >
2023-06-18 15:02:21 +02:00
< aside class = "toc-drawer" >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< div class = "toc-sticky toc-scroll" >
< div class = "toc-title-container" >
< span class = "toc-title" >
On this page
< / span >
< / div >
< div class = "toc-tree-container" >
< div class = "toc-tree" >
< ul >
< li > < a class = "reference internal" href = "#" > Features< / a > < ul >
< li > < a class = "reference internal" href = "#workouts" > Workouts< / a > < / li >
< li > < a class = "reference internal" href = "#account-preferences" > Account & preferences< / a > < / li >
< li > < a class = "reference internal" href = "#administration" > Administration< / a > < ul >
< li > < a class = "reference internal" href = "#application" > Application< / a > < / li >
< li > < a class = "reference internal" href = "#users" > Users< / a > < / li >
< li > < a class = "reference internal" href = "#sports" > Sports< / a > < / li >
< / ul >
< / li >
< li > < a class = "reference internal" href = "#translations" > Translations< / a > < / li >
< li > < a class = "reference internal" href = "#screenshots" > Screenshots< / a > < ul >
< li > < a class = "reference internal" href = "#dashboard" > Dashboard< / a > < / li >
< li > < a class = "reference internal" href = "#workout-detail" > Workout detail< / a > < / li >
< li > < a class = "reference internal" href = "#workouts-list" > Workouts list< / a > < / li >
< li > < a class = "reference internal" href = "#statistics" > Statistics< / a > < / li >
< li > < a class = "reference internal" href = "#id1" > Administration< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
2022-11-27 12:06:42 +01:00
2023-06-18 15:02:21 +02:00
< / div >
< / div >
< / div >
< / aside >
< / div >
2023-12-23 18:39:26 +01:00
< / div > < script data-url_root = "./" id = "documentation_options" src = "_static/documentation_options.js?v=2288a6db" > < / script >
2023-07-30 17:05:25 +02:00
< script src = "_static/doctools.js?v=888ff710" > < / script >
< script src = "_static/sphinx_highlight.js?v=4825356b" > < / script >
< script src = "_static/scripts/furo.js?v=32e29ea5" > < / script >
< script src = "_static/clipboard.min.js?v=a7894cd8" > < / script >
< script src = "_static/copybutton.js?v=f281be69" > < / script >
2023-06-18 15:02:21 +02:00
< / body >
2020-12-30 11:12:35 +01:00
< / html >
