Files
TimeTracker/desktop/assets
Dries Peeters bd5d4d0cc7 fix: client portal projects layout and desktop app refresh
Client portal: add min-w-0, break-words, and flex gap/shrink utilities on
the projects grid cards so long project names no longer force horizontal
overflow and clip against the viewport edge.

Desktop: add app and tray icons, adjust Electron main process (window,
tray, lifecycle), renderer connection and API client updates, build script
and package metadata, and regenerate the bundled renderer script.
2026-04-25 08:07:16 +02:00
..

Desktop App Icons

This directory should contain the icon files for the TimeTracker desktop application.

Required Icon Files

The following icon files are required for building the desktop app:

  • icon.ico - Windows icon (256x256 or 512x512 pixels, multi-resolution)
  • icon.icns - macOS icon (512x512 pixels, multi-resolution)
  • icon.png - Linux icon (512x512 pixels)

The main project logo is located at app/static/images/timetracker-logo.svg.

Option 1: Online Tools

  1. For Windows (.ico):

    • Use CloudConvert or ConvertICO
    • Upload app/static/images/timetracker-logo.svg
    • Set size to 256x256 or 512x512
    • Download and save as icon.ico
  2. For macOS (.icns):

    • Use CloudConvert or iConvert Icons
    • Upload app/static/images/timetracker-logo.svg
    • Set size to 512x512
    • Download and save as icon.icns
  3. For Linux (.png):

    • Use CloudConvert or any image converter
    • Upload app/static/images/timetracker-logo.svg
    • Set size to 512x512
    • Download and save as icon.png

Option 2: Command Line (if ImageMagick is installed)

# Convert SVG to PNG (for Linux)
convert app/static/images/timetracker-logo.svg -resize 512x512 desktop/assets/icon.png

# Convert SVG to ICO (for Windows) - requires additional tools
# On macOS: brew install imagemagick
# On Linux: apt-get install imagemagick
convert app/static/images/timetracker-logo.svg -resize 256x256 desktop/assets/icon.ico

# For .icns on macOS, use iconutil or online converter

Option 3: Using Electron Icon Generator

If you have Node.js installed:

cd desktop
npm install -g electron-icon-maker
electron-icon-maker --input=../app/static/images/timetracker-logo.svg --output=./assets

Current Status

  • logo.svg is tracked for renderer branding
  • icon.png, icon.ico, icon.icns, and tray-icon.png are tracked for packaged runtime/builds
  • Configuration in package.json includes assets/**/*
  • Favicon is configured in index.html

Notes

  • The icons will be used as the application icon in the taskbar/dock
  • The favicon in the HTML will be used in the browser window title bar
  • Make sure icons are high quality (at least 256x256 for Windows, 512x512 for macOS/Linux)