FitFileViewer Documentation
Welcome to the comprehensive documentation for FitFileViewer, a cross-platform desktop application for viewing and analyzing .fit files from fitness devices like Garmin watches and cycling computers.
🎯 What is FitFileViewer?
FitFileViewer is a free, open-source application that lets you:
- View GPS Routes on interactive maps with multiple tile providers
- Analyze Performance with detailed charts and graphs
- Explore Data through comprehensive data tables
- Export Data in various formats (CSV, GPX, images)
- Work Offline - all your data stays on your computer
📚 Documentation Overview
| Section | Description |
|---|---|
| 🚀 Getting Started | Installation, system requirements, and quick start guide |
| 👤 User Guide | How to use the application effectively |
| 📊 Data Visualization | Maps, charts, tables, and summary views |
| 🏗️ Architecture | Technical architecture and design patterns |
| 🛠️ Development | Development setup and contribution guidelines |
| 🔧 API Reference | API documentation for developers |
🚀 Quick Start
1. Download and Install
Get the latest release for your operating system:
- Windows:
.exeinstaller or portable version - macOS:
.dmgor.pkgpackage - Linux:
.AppImage,.deb,.rpm, or other formats
2. Open a FIT File
- Launch FitFileViewer
- Drag and drop a
.fitfile into the window, or - Use File → Open FIT File (or press
Ctrl+O/Cmd+O)
3. Explore Your Data
Navigate between tabs to view:
- 🗺️ Map: Interactive GPS route visualization
- 📊 Charts: Performance graphs and charts
- 📋 Tables: Detailed data records
- 📄 Summary: Activity statistics and metrics
✨ Key Features
Interactive Maps 🗺️
- Multiple map styles (OpenStreetMap, Satellite, Terrain)
- Route visualization with lap markers
- Measurement tools for distance analysis
- Full-screen mode for detailed viewing
Performance Charts 📊
View your data with interactive Chart.js and Vega-Lite charts:
- Speed vs Time/Distance
- Heart Rate zones and trends
- Elevation profiles
- Power and Cadence data
- Custom data ranges and zoom
Data Tables 📋
- Sortable and filterable records
- Export to CSV format
- Search through thousands of data points
- Lap and session summaries
Cross-Platform Support 💻
| Platform | Supported Formats |
|---|---|
| Windows | .exe, .msi, .portable |
| macOS | .dmg, .pkg, .zip |
| Linux | .AppImage, .deb, .rpm, .snap |
🔧 Technical Details
FitFileViewer is built with modern technologies:
- Electron - Cross-platform desktop framework
- Chart.js & Vega-Lite - Data visualization
- Leaflet - Interactive maps
- DataTables - Data table management
- Garmin FIT SDK - FIT file parsing
📖 Documentation Sections
For Users
- Installation Guide - How to download and install
- Quick Start - Get up and running quickly
- User Interface - Understanding the application layout
- Troubleshooting - Common issues and solutions
For Developers
- Development Setup - Set up your development environment
- Architecture Overview - Understand the codebase
- API Reference - API documentation
- Contributing - How to contribute
🌟 Open Source
FitFileViewer is completely open source under the Unlicense:
🙏 Credits
FitFileViewer uses these amazing open-source projects:
- Garmin FIT SDK - FIT file parsing
- Leaflet - Interactive maps
- Chart.js - Charts and graphs
- Vega-Lite - Data visualization
- Electron - Desktop application framework
Ready to get started?
📥 Install FitFileViewer
📥 Install FitFileViewer