FitFileViewer by Nick2bad4u / Typpi ☠️ - README

CI Badges

🧹 🏗️ 🛡️ 🤖 🔍 📚 🔒 🧑‍💻 ⚡ 🗺️ 👋 🧹 💤 🔎 🎨 📊 🎨 📋 🔑 🐧 🍏 🪟 📅 🔍 🌐 🔑 🔄 🧹 🛡️ 🔑 🔤 📖 🦠

📑 Table of Contents

• Overview 📖
• Screenshots 🖼️
• Installation 🛠️
• Usage 🚀
• Changelog 📝
• Supported Builds 🏗️
• Development 👨‍💻
• Credits 🙏
• 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 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 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 file in the repository.

---

🏗️ Supported Builds

Platform	Architecture	Format	Filename Example
Windows	x64	NSIS EXE	Fit-File-Viewer-nsis-x64-.exe
Windows	ia32	NSIS EXE	Fit-File-Viewer-nsis-ia32-.exe
Windows	x64	MSI	Fit-File-Viewer-msi-x64-.msi
Windows	ia32	MSI	Fit-File-Viewer-msi-ia32-.msi
Windows	x64	Portable	Fit-File-Viewer-portable-x64-.exe
Windows	ia32	Portable	Fit-File-Viewer-portable-ia32-.exe
Windows	x64	NSIS Web	Fit-File-Viewer-nsis-web-x64-.exe
Windows	ia32	NSIS Web	Fit-File-Viewer-nsis-web-ia32-.exe
Windows	x64	7z Archive	fitfileviewer--x64.nsis.7z
Windows	ia32	7z Archive	fitfileviewer--ia32.nsis.7z
macOS	x64/arm64	DMG	Fit-File-Viewer-dmg-.dmg
macOS	x64/arm64	PKG	Fit-File-Viewer-pkg-.pkg
macOS	x64/arm64	ZIP	Fit-File-Viewer-darwin-.zip
macOS	x64/arm64	TAR.BZ2	Fit-File-Viewer-darwin-.tar.bz2
macOS	x64/arm64	TAR.GZ	Fit-File-Viewer-darwin-.tar.gz
macOS	x64/arm64	TAR.XZ	Fit-File-Viewer-darwin-.tar.xz
Linux	x64/arm64	AppImage	Fit-File-Viewer-appimage-.AppImage
Linux	x64/arm64	DEB	Fit-File-Viewer-deb-.deb
Linux	x64/arm64	RPM	Fit-File-Viewer-rpm-.rpm
Linux	x64/arm64	PACMAN	Fit-File-Viewer-pacman-.pacman
Linux	x64/arm64	SNAP	Fit-File-Viewer-snap-.snap
Linux	x64/arm64	TAR.BZ2	Fit-File-Viewer-linux-.tar.bz2
Linux	x64/arm64	TAR.GZ	Fit-File-Viewer-linux-.tar.gz
Linux	x64/arm64	TAR.XZ	Fit-File-Viewer-linux-.tar.xz
Linux	x64/arm64	ZIP	Fit-File-Viewer-linux-.zip
FreeBSD	x64/arm64	FreeBSD	Fit-File-Viewer-freebsd-.freebsd
Android	arm64	APK	Fit-File-Viewer-apk-.apk

_{Replace with the actual release version, e.g. 14.8.0}

➡️ Go to the Latest Release

---

🧑‍💻 Development

To set up a development environment:

# 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.
• Issues and feature requests: GitHub Issues

Credits 🙏

This project uses the following libraries and tools:

• FitFileViewer.com 🌐

• HarryOnline 🌍

• Garmin FIT JavaScript SDK (FIT Protocol License Agreement) ⌚

• Leaflet.js (BSD-2-Clause License) 🗺️

• Vega-Lite (BSD-3-Clause License) 📊

• Vega-Embed (BSD-3-Clause License) 📈

• Chart.js (MIT License) 📉

• jQuery (MIT License) 🧑‍💻

• Electron (MIT License) ⚡

• Node.js (MIT License) 🖥️

• Electron Builder (MIT License) 🏗️

• GitHub Actions (MIT License) 🔧

• GitHub Pages (MIT License) 🌐

• GitHub API (MIT License) 🔌

• GitHub Copilot (MIT License) 🤖

---

📄 License

See LICENSE.md for details.

---

For more information, documentation, and updates, visit the GitHub repository. 📦