https://github.com/nick2bad4u/fitfileviewer
Fit File Viewer - Cross-Platform application to analyze Fit files. Builds available for Windows, Mac, and Linux in a variety of formats.
https://github.com/nick2bad4u/fitfileviewer
fit fit-file fit-file-viewer garmin strava
Last synced: 4 months ago
JSON representation
Fit File Viewer - Cross-Platform application to analyze Fit files. Builds available for Windows, Mac, and Linux in a variety of formats.
- Host: GitHub
- URL: https://github.com/nick2bad4u/fitfileviewer
- Owner: Nick2bad4u
- License: mit
- Created: 2025-04-17T20:57:21.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-06-07T18:01:27.000Z (4 months ago)
- Last Synced: 2025-06-07T18:24:07.497Z (4 months ago)
- Topics: fit, fit-file, fit-file-viewer, garmin, strava
- Language: JavaScript
- Homepage: https://fitfileviewer.typpi.online/
- Size: 31.9 MB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# FitFileViewer by Nick2bad4u / Typpi ☠️ - README
CI Badges
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/ActionLint.yml) 🧹
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/Build.yml) 🏗️
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/flatpak-build.yml) 📦
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/release-stats.yml) 📊
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/print-release-asset-sizes.yml) 📋
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/git-sizer-dispatch.yml)
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/cleanReleases.yml) 🧹
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/codeql.yml) 🛡️
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/dependabot/dependabot-updates) 🤖
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/dependency-review.yml) 🔍
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/jekyll-gh-pages.yml) 📚
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/devskim.yml) 🔒
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/eslint.yml) 🧑💻
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/electronegativity.yml) ⚡
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/sitemap.yml) 🗺️
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/greetings.yml) 👋
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/superlinter.yml) 🧹
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/stale.yml) 💤
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/osv-scanner.yml) 🔎
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/prettier.yml) 🎨
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/scorecards.yml) 📊
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/stylelint.yml) 🎨
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/summary.yml) 📋
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/trufflehog.yml) 🔑
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/updateChangeLogs.yml) 📝
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-linux-ia.yml) 🐧
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-macos-ia.yml) 🍏
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-windows-ia.yml) 🪟
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/vscode-version.yml) 📅
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/npm-audit.yml) 🔍
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/pages/pages-build-deployment) 🌐
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/gitleaks.yml) 🔑
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/rebase.yml) 🔄
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/mega-linter.yml) 🧹
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/security-devops.yml) 🛡️
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/pssecret-scanner.yml) 🔑
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/typos.yml) 🔤
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/spelling_action.yml) 📖
[](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/VirusTotal.yml) 🦠
.gif?raw=true)
.gif?raw=true)
## 📑 Table of Contents
- [Overview](#-overview) 📖
- [Screenshots](#-screenshots) 🖼️
- [Installation](#%EF%B8%8F-installation) 🛠️
- [Usage](#-usage) 🚀
- [Changelog](#-changelog) 📝
- [Supported Builds](#%EF%B8%8F-supported-builds) 🏗️
- [Windows Builds](#-windows-builds) 🪟
- [Mac Builds](#-mac-builds) 🍏
- [Linux Builds](#-linux-builds) 🐧
- [Development](#-development) 👨💻
- [Credits](#-credits) 🙏
- [License](#-license) 📄
## 📜 Overview
Open `.fit` files, a popular file format used for recording activity data from fitness devices such as GPS watches and cycling computers, and explore their data with ease. This standalone application offers:
- Interactive maps for visualizing activity routes. 🗺️
- Data tables for detailed insights. 📋
- Charts for analyzing trends and performance. 📈
Enjoy an intuitive interface designed for seamless `.fit` file exploration.
## 📸 Screenshots
*Interactive map displaying the activity route.*
*Full FitFileViewer.com Intergration - Data table showing detailed activity metrics.*
*Charts visualizing trends and performance data.*
## 🛠️ Installation
1. Go to the [FitFileViewer Releases Page](https://github.com/Nick2bad4u/FitFileViewer/releases) on GitHub.
2. Download the latest installer or zip for your operating system (Windows, macOS, or Linux).
3. Extract the archive if needed, then run the installer or executable to launch Fit File Viewer.
*See the [Supported Builds](#%EF%B8%8F-supported-builds) section below for available formats and filenames.*
---
## 🚀 Usage
1. Open Fit File Viewer.
2. Drag and drop a `.fit` file into the app window, or use the **Open FIT File** button.
3. Browse your activity data using the interactive map, data tables, and charts.
4. Use the menu to export, print, or adjust settings.
---
## 📜 Changelog
For a detailed list of changes, bug fixes, and new features, please refer to the [CHANGELOG.md](CHANGELOG.md) file in the repository.
---
## 🏗️ Supported Builds
- The following builds are available for download. Each build is tailored for specific platforms and architectures, ensuring compatibility and optimal performance
- The filenames follow a consistent naming convention to indicate the platform, architecture, format, and version. Replace `X.X.X` with the actual release version (e.g., `14.8.0`)
[➡️ **Go to the Latest Release**](https://github.com/Nick2bad4u/FitFileViewer/releases/latest)
### 🪟 Windows Builds
- Most Windows users should download the "Installer EXE", "MSI" or "Portable" versions
| Platform | Architecture | Format | Filename Example |
| :------- | :-------------- | :----------------- | :---------------------------------------------|
| Windows | x64 | Installer EXE | Fit-File-Viewer-nsis-x64-X.X.X.exe |
| Windows | x64 | Installer Web | Fit-File-Viewer-nsis-web-x64-X.X.X.exe |
| Windows | x64 | Installer 7z | fitfileviewer-X.X.X-x64.nsis.7z |
| Windows | x64 | Squirrel EXE | Fit-File-Viewer-squirrel-x64-X.X.X.exe |
| Windows | x64 | MSI | Fit-File-Viewer-msi-x64-X.X.X.msi |
| Windows | x64 | MSI 7z | Fit-File-Viewer-msi-x64-X.X.X.7z |
| Windows | x64 | MSI TAR.BZ2 | Fit-File-Viewer-msi-x64-X.X.X.tar.bz2 |
| Windows | x64 | MSI TAR.GZ | Fit-File-Viewer-msi-x64-X.X.X.tar.gz |
| Windows | x64 | MSI TAR.XZ | Fit-File-Viewer-msi-x64-X.X.X.tar.xz |
| Windows | x64 | MSI ZIP | Fit-File-Viewer-msi-x64-X.X.X.zip |
| Windows | x64 | Portable | Fit-File-Viewer-portable-x64-X.X.X.exe |
| Windows | ia32 / win32 | Installer EXE | Fit-File-Viewer-nsis-ia32-X.X.X.exe |
| Windows | ia32 / win32 | Installer Web | Fit-File-Viewer-nsis-web-ia32-X.X.X.exe |
| Windows | ia32 / win32 | Installer 7z | fitfileviewer-X.X.X-ia32.nsis.7z |
| Windows | ia32 / win32 | Squirrel EXE | Fit-File-Viewer-squirrel-ia32-X.X.X.exe |
| Windows | ia32 / win32 | MSI | Fit-File-Viewer-msi-ia32-X.X.X.msi |
| Windows | ia32 / win32 | MSI 7z | Fit-File-Viewer-msi-ia32-X.X.X.7z |
| Windows | ia32 / win32 | MSI TAR.BZ2 | Fit-File-Viewer-msi-ia32-X.X.X.tar.bz2 |
| Windows | ia32 / win32 | MSI TAR.GZ | Fit-File-Viewer-msi-ia32-X.X.X.tar.gz |
| Windows | ia32 / win32 | MSI TAR.XZ | Fit-File-Viewer-msi-ia32-X.X.X.tar.xz |
| Windows | ia32 / win32 | MSI ZIP | Fit-File-Viewer-msi-ia32-X.X.X.zip |
| Windows | ia32 / win32 | Portable | Fit-File-Viewer-portable-ia32-X.X.X.exe |
🗂️ Update Files (Nupkg & Blockmap)
| Platform | Architecture | Format | Filename Example |
| :------- | :-------------- | :----------------- | :--------------------------------------------- |
| Windows | x64 | Blockmap | Fit-File-Viewer-nsis-x64-X.X.X.exe.blockmap |
| Windows | ia32 / win32 | Blockmap | Fit-File-Viewer-nsis-ia32-X.X.X.exe.blockmap |
| Windows | x64 | Squirrel Nupkg | fitfileviewer-X.X.X-full.nupkg |
| Windows | ia32 / win32 | Squirrel Nupkg | fitfileviewer-X.X.X-win32-full.nupkg |
| Windows | x64 | Squirrel RELEASES | RELEASES |
| Windows | ia32 / win32 | Squirrel RELEASES | RELEASES-win32 |
**Note:**
- Most users should download the "Installer EXE", "MSI" or "Portable" for a standard installation experience.
- "Portable" builds do not require installation—just extract and run.
- "Squirrel Nupkg/RELEASES" and "Blockmap" files are used for automatic updates and are not intended for manual installation.
- Replace `X.X.X` with the actual release version (e.g., `16.3.0`).
### 🍏 Mac Builds
- Most Mac users should download the "DMG" or "PKG" versions
| Platform | Architecture | Format | Filename Example |
| :------- | :----------- | :--------- | :----------------------------------------------- |
| macOS | x64 | DMG | Fit-File-Viewer-dmg-x64-X.X.X.dmg |
| macOS | x64 | PKG | Fit-File-Viewer-pkg-x64-X.X.X.pkg |
| macOS | x64 | TAR.BZ2 | Fit-File-Viewer-darwin-X.X.X.tar.bz2 |
| macOS | x64 | TAR.GZ | Fit-File-Viewer-darwin-X.X.X.tar.gz |
| macOS | x64 | TAR.XZ | Fit-File-Viewer-darwin-X.X.X.tar.xz |
| macOS | universal | DMG | Fit-File-Viewer-dmg-universal-X.X.X.dmg |
| macOS | universal | PKG | Fit-File-Viewer-pkg-universal-X.X.X.pkg |
| macOS | universal | TAR.BZ2 | Fit-File-Viewer-darwin-universal-X.X.X.tar.bz2 |
| macOS | universal | TAR.GZ | Fit-File-Viewer-darwin-universal-X.X.X.tar.gz |
| macOS | universal | TAR.XZ | Fit-File-Viewer-darwin-universal-X.X.X.tar.xz |
| macOS | universal | ZIP | Fit-File-Viewer-darwin-universal-X.X.X.zip |
| macOS | arm64 | DMG | Fit-File-Viewer-dmg-arm64-X.X.X.dmg |
| macOS | arm64 | PKG | Fit-File-Viewer-pkg-arm64-X.X.X.pkg |
| macOS | arm64 | TAR.BZ2 | Fit-File-Viewer-darwin-arm64-X.X.X.tar.bz2 |
| macOS | arm64 | TAR.GZ | Fit-File-Viewer-darwin-arm64-X.X.X.tar.gz |
| macOS | arm64 | TAR.XZ | Fit-File-Viewer-darwin-arm64-X.X.X.tar.xz |
| macOS | arm64 | ZIP | Fit-File-Viewer-darwin-arm64-X.X.X.zip |
🗂️ Update Files (Blockmap)
| Platform | Architecture | Format | Filename Example |
| :------- | :----------- | :------------- | :--------------------------------------------------- |
| macOS | x64 | DMG Blockmap | Fit-File-Viewer-dmg-x64-X.X.X.dmg.blockmap |
| macOS | universal | DMG Blockmap | Fit-File-Viewer-dmg-universal-X.X.X.dmg.blockmap |
| macOS | arm64 | DMG Blockmap | Fit-File-Viewer-dmg-arm64-X.X.X.dmg.blockmap |
| macOS | universal | ZIP Blockmap | Fit-File-Viewer-darwin-universal-X.X.X.zip.blockmap |
| macOS | arm64 | ZIP Blockmap | Fit-File-Viewer-darwin-arm64-X.X.X.zip.blockmap |
**Note:**
- "Blockmap" files are used for differential updates and are not intended for manual installation.
- Replace `X.X.X` with the actual release version (e.g., `16.3.0`).
- Most users should download the "DMG" or "PKG" for a standard installation experience.
- "ZIP" and "TAR" archives are provided for advanced users or manual extraction.
### 🐧 Linux Builds
| Platform | Architecture | Format | Filename Example |
| :------- | :----------- | :------------- | :------------------------------------------------- |
| Linux | x64 | AppImage | Fit-File-Viewer-appimage-x86_64-X.X.X.AppImage |
| Linux | x64 | DEB | Fit-File-Viewer-deb-amd64-X.X.X.deb |
| Linux | x64 | RPM | Fit-File-Viewer-rpm-x86_64-X.X.X.rpm |
| Linux | x64 | PACMAN | Fit-File-Viewer-pacman-x64-X.X.X.pacman |
| Linux | x64 | SNAP | Fit-File-Viewer-snap-amd64-X.X.X.snap |
| Linux | x64 | FLATPAK | FitFileViewer-vX.X.X.flatpak |
| Linux | x64 | FLATPAK ZIP | FitFileViewer-vX.X.X.flatpak.zip |
| Linux | x64 | TAR.BZ2 | Fit-File-Viewer-linux-X.X.X.tar.bz2 |
| Linux | x64 | TAR.GZ | Fit-File-Viewer-linux-X.X.X.tar.gz |
| Linux | x64 | TAR.XZ | Fit-File-Viewer-linux-X.X.X.tar.xz |
| Linux | x64 | ZIP | Fit-File-Viewer-linux-X.X.X.zip |
| Linux | x64 | APK (Alpine) | Fit-File-Viewer-apk-x64-X.X.X.apk |
| Linux | x64 | FreeBSD | Fit-File-Viewer-freebsd-x64-X.X.X.freebsd |
- Most Linux users should download the "AppImage", "DEB", "RPM" or "FLATPAK" versions
Replace X.X.X with the actual release version (e.g., 16.3.0).
[➡️ **Go to the Latest Release**](https://github.com/Nick2bad4u/FitFileViewer/releases/latest)
---
## 🧑💻 Development
To set up a development environment:
```bash
# Clone the repository
git clone https://github.com/Nick2bad4u/FitFileViewer.git
cd FitFileViewer/electron-app
# Install dependencies
npm install
# Run the app in development mode
npm start
# To build a production release
npm run build
```
- For more details, see the [GitHub repository](https://github.com/Nick2bad4u/FitFileViewer).
- Issues and feature requests: [GitHub Issues](https://github.com/Nick2bad4u/FitFileViewer/issues)
## 🙏 Credits
This project uses the following libraries and tools:
- [{:width="14" height="12" style="vertical-align:middle;"} **FitFileViewer.com**](https://www.FitFileViewer.com/) 🌐
- [{:width="14" height="12" style="vertical-align:middle;"} **HarryOnline**](https://www.harryonline.net/) 🌍
- [Garmin FIT JavaScript SDK](https://github.com/garmin/fit-javascript-sdk) ([FIT Protocol License Agreement](https://developer.garmin.com/fit/download/)) ⌚
- [Leaflet.js](https://leafletjs.com) ([BSD-2-Clause License](https://github.com/Leaflet/Leaflet/blob/main/LICENSE)) 🗺️
- [Vega-Lite](https://vega.github.io/vega-lite/) ([BSD-3-Clause License](https://github.com/vega/vega-lite/blob/main/LICENSE)) 📊
- [Vega-Embed](https://github.com/vega/vega-embed) ([BSD-3-Clause License](https://github.com/vega/vega-embed/blob/main/LICENSE)) 📈
- [Chart.js](https://www.chartjs.org/) ([MIT License](https://github.com/chartjs/Chart.js/blob/master/LICENSE.md)) 📉
- [jQuery](https://jquery.com/) ([MIT License](https://jquery.org/license/)) 🧑💻
- [Electron](https://www.electronjs.org/) ([MIT License](https://github.com/electron/electron/blob/main/LICENSE)) ⚡
- [Node.js](https://nodejs.org/) ([MIT License](https://github.com/nodejs/node/blob/main/LICENSE)) 🖥️
- [Electron Builder](https://www.electron.build/) ([MIT License](https://github.com/electron-userland/electron-builder/blob/master/LICENSE)) 🏗️
- [GitHub Actions](https://github.com/features/actions) ([MIT License](https://github.com/actions/runner/blob/main/LICENSE)) 🔧
- [GitHub Pages](https://pages.github.com/) ([MIT License](https://github.com/github/pages-gem/blob/master/LICENSE.txt)) 🌐
- [GitHub API](https://docs.github.com/en/rest) ([MIT License](https://github.com/octokit/octokit.rb/blob/master/LICENSE.txt)) 🔌
- [GitHub Copilot](https://github.com/features/copilot) ([MIT License](https://github.com/github/copilot-docs/blob/main/LICENSE)) 🤖
---
## 📄 License
See [LICENSE.md](LICENSE.md) for details.
---
For more information, documentation, and updates, visit the [GitHub repository](https://github.com/Nick2bad4u/FitFileViewer). 📦
