KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

FitFileViewer

★ 60 Open GitHub ↗

Fit File Viewer - Cross-Platform application to analyze Fit files. Builds available for Windows, Mac, and Linux in a variety of formats.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FitFileViewer by Nick2bad4u / Typpi ☠️ - README

<details><summary>CI Badges</summary>

[![Build and Release Electron App](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/Build.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/Build.yml) 🏗️
[![Windows 7 Legacy Snapshot](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/build-win7.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/build-win7.yml) 🪟
[![Build Flatpak](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/flatpak-build.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/flatpak-build.yml) 📦
[![Docusaurus](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/docusaurus.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/docusaurus.yml) 📚
[![Clean Old Releases](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/cleanReleases.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/cleanReleases.yml) 🧹
[![CodeQL-Advanced](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/codeql.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/codeql.yml) 🛡️
[![Dependency Review](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/dependency-review.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/dependency-review.yml) 🔍
[![GitLeaks Scan](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/gitleaks.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/gitleaks.yml) 🔑
[![Greetings](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/greetings.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/greetings.yml) 👋
[![Mark stale issues and pull requests](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/stale.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/stale.yml) 💤
[![Automatic Rebase](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/rebase.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/rebase.yml) 🔄
[![Repo Stats](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/repo-stats.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/repo-stats.yml) 📊
[![TruffleHog Secret Scan](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/trufflehog.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/trufflehog.yml) 🔑
[![Update ChangeLogs](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/updateChangeLogs.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/updateChangeLogs.yml) 📝
[![Upload Linux Distributables to Archive.org](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-linux-ia.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-linux-ia.yml) 🐧
[![Upload Mac Distributables to Archive.org](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-macos-ia.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-macos-ia.yml) 🍏
[![Upload Windows Distributables to Archive.org](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-windows-ia.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/upload-windows-ia.yml) 🪟
[![VirusTotal Scan](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/VirusTotal.yml/badge.svg)](https://github.com/Nick2bad4u/FitFileViewer/actions/workflows/VirusTotal.yml) 🦠

</details>

## 📑 Table of Contents

- [Overview](#-overview) 📖
- [Screenshots](#-screenshots) 🖼️
- [Installation](#️-installation) 🛠️
- [Usage](#-usage) 🚀
- [Changelog](#-changelog) 📝
- [Supported Builds](#️-supported-builds) 🏗️
  - [Windows Builds](#-windows-builds) 🪟
  - [Mac Builds](#-mac-builds) 🍏
  - [Linux Builds](#-linux-builds) 🐧
- [Development](#-development) 👨‍💻
- [Credits](#-credits) 🙏
- [License](#-license) 📄

## 📜 Overview

Open `.fit` files, the 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. 📈
- Ability to export data and charts in multiple formats and to Imgur. 📤
- Chart customization options for personalized views. 🎨
- Full integration with [FitFileViewer.com](https://www.FitFileViewer.com/) 🌐
- Support for multiple platforms: Windows, macOS, and Linux. 🖥

Enjoy an intuitive interface designed for seamless `.fit` file exploration.

## 📸 Screenshots

![Map](https://raw.githubusercontent.com/Nick2bad4u/FitFileViewer/refs/heads/main/docs/screenshots/MapsV2.png)
_Interactive map displaying the activity route._

![Table](https://raw.githubusercontent.com/Nick2bad4u/FitFileViewer/refs/heads/main/docs/screenshots/DataV2.png)
_Full FitFileViewer.com Integration - Data table showing detailed activity metrics._

![Charts](https://raw.githubusercontent.com/Nick2bad4u/FitFileViewer/refs/heads/main/docs/screenshots/ChartsV3.png)
_Charts visualizing trends and performance data._

</div>

## 🛠️ 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 FitFileViewer.

_See the [Supported Builds](#️-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

<sub> - Most Windows users should download the "Installer EXE", "MSI" or "Portable" versions </sub>

| 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 |
| Windows  | Win7 (legacy) | Portable EXE  | Fit-File-Viewer-win7-\*.exe\[.zip]      |

<details><summary>🗂️ Update Files (Nupkg &amp; Blockmap)</summary>

| 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                               |

</details>

**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.
- For Windows 7, use the **Win7 (legacy)** portable asset (`Fit-File-Viewer-win7-*.exe` or `.exe.zip`) from the latest GitHub release. This is a carried-forward legacy snapshot, not a freshly rebuilt current-version binary.

### 🍏 Mac Builds

<sub> - Most Mac users should download the "DMG" or "PKG" versions </sub>

| 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         |

<details><summary>🗂️ Update Files (Blockmap)</summary>

| 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     |

</details>

**Note:**

- "Blockmap" files are used for differential updates and are not intended for manual installation.
- 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

<sub> - Most Linux users should download the "AppImage" or "DEB" versions </sub>

| 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      |

**Note:**

- The "APK" file is NOT an Android APK, but rather an Alpine Linux package.

<sub>- Replace `X.X.X` with the actual release version (e.g., `14.8.0`)</sub>

[➡️ **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

# Navigate to the project directory
cd FitFileViewer

# 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:

- [**FitFileViewer.com**](https://www.FitFileViewer.com/) [![FitFileViewer.com logo](https://raw.githubusercontent.com/Nick2bad4u/FitFileViewer/main/static/icons/harry.png)](https://www.FitFileViewer.com/)
- [**HarryOnline**](https://www.harryonline.net/) [![HarryOnline logo](https://raw.githubusercontent.com/Nick2bad4u/FitFileViewer/main/static/icons/harry.png)](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://pages.github.com/)) 🌐
- [GitHub API](https://docs.github.com/en/rest) ([MIT License](https://github.com/octokit/octokit.rb/blob/main/LICENSE.md)) 🔌
- [GitHub Copilot](https://github.com/features/copilot) ([MIT License](https://github.com/github/copilot-docs/blob/main/LICENSE.txt)) 🤖

---

## 📄 License

See [LICENSE.md](LICENSE.md) for details.

---

For more information, documentation, and updates, visit the [GitHub repository](https://github.com/Nick2bad4u/FitFileViewer). 📦

FitFileViewer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README