Skip to content

1.0.37

Choose a tag to compare

@github-actions github-actions released this 04 May 13:17
a1cdcd1

TrackFlow Desktop 1.0.37

Downloads

Platform File Notes
macOS (Apple Silicon) TrackFlow-1.0.37-mac-arm64.dmg M1/M2/M3/M4
macOS (Intel) TrackFlow-1.0.37-mac-x64.dmg 2020 and older
Windows TrackFlow-1.0.37-win-x64.exe Windows 10+
Linux (.deb) TrackFlow-1.0.37-linux-amd64.deb Ubuntu/Debian
Linux (AppImage) TrackFlow-1.0.37-x86_64.AppImage Universal Linux

What's New

New Features

  • Shift info display — timer window now shows assigned shift name, time range, and break duration when tracking
  • Branded icons — new TrackFlow-branded tray icon, app icon, and notification icon across all platforms
  • Simplified authentication — streamlined login flow with reduced API overhead

Improvements

  • Redesigned tray icons with idle/tracking states and color variants for better system tray visibility
  • Added dedicated notification icon for macOS/Windows alerts
  • Retina (@2x) tray icon support for high-DPI displays
  • Cleaner main process code — refactored for maintainability

Testing

  • New test coverage: API client error handling, idle alert reappearance after window close, tray click behavior

Installation

macOS:

  1. Download the .dmg for your chip (Apple Silicon or Intel)
  2. Open the DMG and drag TrackFlow to Applications
  3. First launch only — open Terminal and run:
    xattr -cr /Applications/TrackFlow.app
    
  4. Launch TrackFlow from Applications
  5. Grant Screen Recording permission when prompted (System Settings → Privacy & Security → Screen Recording)

Windows:

  1. Download the .exe installer
  2. Run the installer — choose install location if needed
  3. Launch TrackFlow from Start Menu or Desktop shortcut
  4. If upgrading: the installer automatically closes the running app before updating

Linux (deb):

sudo dpkg -i TrackFlow-1.0.37-linux-amd64.deb

Linux (AppImage):

chmod +x TrackFlow-1.0.37-x86_64.AppImage
./TrackFlow-1.0.37-x86_64.AppImage

Uninstallation

macOS:

  1. Quit TrackFlow (right-click tray icon → Quit)
  2. Drag TrackFlow from Applications to Trash
  3. To remove data: rm -rf ~/Library/Application\ Support/trackflow-agent

Windows:

  1. Open Settings → Apps → Installed Apps
  2. Find TrackFlow → Uninstall
  3. Or run the uninstaller from Start Menu → TrackFlow → Uninstall
  4. To remove data: delete %APPDATA%/trackflow-agent

Linux:

# deb
sudo dpkg -r trackflow-agent

# AppImage — just delete the file
rm TrackFlow-*.AppImage

# Remove data
rm -rf ~/.config/trackflow-agent

Troubleshooting

macOS: "app is damaged" or won't open

xattr -cr /Applications/TrackFlow.app

macOS: Screen Recording permission
System Settings → Privacy & Security → Screen Recording → Enable TrackFlow.
If TrackFlow is not listed, restart the app.

All platforms: "Cannot reach the server"
The server is likely reachable but your DNS cache is stale. Fix:

  • macOS: sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder
  • Windows: Run ipconfig /flushdns in Command Prompt (as Administrator)
  • Linux: sudo systemd-resolve --flush-caches
    Then retry login — no app restart needed.

Windows: "Failed to uninstall old application files"
The installer automatically closes the running app. If you still see this, close TrackFlow from the system tray before running the installer.

Empty project list after login
Sign out → close app completely → reopen → sign in.

View logs:

  • macOS: ~/Library/Application Support/trackflow-agent/trackflow.log
  • Windows: %APPDATA%/trackflow-agent/trackflow.log
  • Linux: ~/.config/trackflow-agent/trackflow.log