v0.3.1 – Self-contained macOS app

Improved

• The macOS app is now fully self-contained.
• All required Python dependencies (including fitdecode) are bundled inside the app bundle under Contents/Resources/python_deps.
• Users no longer need to install Python packages manually or run any Terminal commands.

Fixes

• Corrected app icon configuration so the custom icon displays reliably in Finder.

Notes

• No changes to core conversion functionality.
• This release focuses on improving installation and overall user experience.

v0.3.0 – English codebase cleanup

What’s new in v0.3.0

Improved

• Translated entire Python converter script to English for consistency.
• Cleaned up comments and naming conventions.
• Improved internal clarity and future maintainability across the codebase.

Notes

• No functional changes to the converter logic.
• macOS app wrapper (.app) continues to work as before.

v0.2.0 – Duotone runner icon

What is new

• New duotone runner app icon for the macOS app
• Updated bundle configuration so the custom icon is reliably used
• Improved mac-app/README_APP.md with clearer build and icon instructions

Download

• fit2csv-macos-v0.2.0.zip (see Assets below)

v0.1.0 – First public macOS release

fit2csv v0.1.0 – First public macOS release

🚀 What's New

This is the first public release of the fit2csv macOS application — a lightweight, standalone tool for converting .FIT files (Garmin, Polar, Wahoo, etc.) into .CSV files.

This release includes:

• A standalone macOS app (.app) that wraps the Python conversion script
• Simple macOS GUI:
  • Select input folder
  • Select output folder (or use automatic csv_out folder)
• Automatic creation of missing output folder
• Automatic opening of output folder after conversion
• macOS notification when conversion is finished
• Built-in Python script (fit2csv_batch.py) embedded inside the .app bundle
• Fully open-source under the MIT license

---

📥 Download

Download the prebuilt app here:

➡️ fit2csv-macos-v0.1.0.zip (attached below)

Unzip it to get:

fit2csv.app

---

🧰 Requirements

• macOS with Python 3 installed (python3 must be available in PATH)
• Python package fitdecode installed:

pip install fitdecode

---

🖥 How to Use

1. Download the .zip file from this release
2. Unzip it → you get fit2csv.app
3. The first time you run it:
   • Right-click → Open
   • Click Open again
     (needed because the app is unsigned)
4. Select the folder containing .fit files
5. Select an output folder
   • OR press Cancel to use automatic csv_out inside the input folder
6. Wait for the “Conversion finished” notification
7. The output folder will open automatically

---

🐍 Python Script

If you prefer running the script manually:

python3 src/fit2csv_batch.py /path/to/fit-files --out /path/to/output

Source code is available in the src/ directory.

---

🛠 Future Improvements

• Progress indicator
• Windows/Linux packaging
• Native Python GUI (Tkinter / PyQt)
• Optional filtering / advanced FIT record export
• FIT → Parquet support

---

🙌 Contributions Welcome

Pull requests and issues are welcomed.
If you build an improvement, feel free to contribute it back!