TimeTracker Documentation

Overview

TimeTracker is a desktop application designed to help users track and manage their time across different applications and tasks. It provides automatic time tracking, manual time entry, task management, and detailed reporting capabilities.

Features

Time Tracking

Track your time automatically and manually

  1. To start automatic tracking, click the Start button in the Timer Controls section.
  2. To stop tracking, click the Stop button.
  3. To add a manual entry, click the Manual Entry button, fill in the details, and click Save.
  4. Idle detection will notify you if you are away from your computer for a set period.
  5. Inactive tracking notifications will remind you if tracking is paused or stopped for too long.
Time Tracking Interface
  • Automatic Tracking: The app automatically tracks time spent on different applications and windows
  • Manual Tracking: Users can manually add time entries for activities
  • Idle Detection: The app detects when the user is idle and can notify them
  • Inactive Tracking Notifications: Users receive notifications when tracking has been inactive for a set period

Activity Management

Manage and organize your activities

  1. View your activities grouped by application or window title.
  2. Select multiple activities for bulk actions using the checkboxes.
  3. Assign activities to tasks for better organization.
  4. Review your activity history to see past tracked items.
Activity Management Interface
  • Activity Grouping: Activities can be grouped by either application or window title
  • Activity Selection: Users can select multiple activities for bulk actions
  • Task Assignment: Activities can be assigned to specific tasks
  • Activity History: View and manage past activities

Task Management

Create and manage tasks

  1. Click Add Task to create a new task.
  2. Assign time entries or activities to tasks for detailed tracking.
  3. Monitor time spent on each task in the task list.
Task Management Interface
  • Task Creation: Create and manage tasks
  • Task Assignment: Assign time entries to specific tasks
  • Task Tracking: Monitor time spent on different tasks

Reporting

Generate detailed reports

  1. Navigate to the Reports section from the sidebar.
  2. Select the type of report you want to generate (activity, task, or custom).
  3. Adjust filters and parameters as needed, then click Generate.
  4. Download or export reports as needed.
Reporting Interface
  • Activity Reports: Generate reports based on tracked activities
  • Task Reports: View time spent on specific tasks
  • Custom Reports: Create custom reports based on various parameters

Goals

Set and track your goals

  1. Go to the Goals section.
  2. Click Add Goal and set your desired parameters.
  3. Track your progress in the goals dashboard.
  4. Receive notifications as you approach or reach your goals.
Goals Interface
  • Goal Setting: Set time-based goals for different activities or tasks
  • Goal Tracking: Monitor progress towards set goals
  • Goal Notifications: Receive notifications about goal progress

Settings

Customize your experience

  1. Open the Settings section from the sidebar.
  2. Adjust application categories, notification preferences, grouping type, and theme.
  3. Changes are saved automatically and applied instantly.
Settings Interface
  • Application Categories: Categorize applications for better organization
  • Notification Settings: Configure idle and inactive tracking notifications
  • Group Type Settings: Choose between grouping by application or window title
  • Theme Settings: Customize the application's appearance

Connectors

Integrate with external services and tools

  1. Navigate to the Connectors section in Settings.
  2. Choose from available integration options like Jira, GitHub, or other supported services.
  3. Configure the connection by providing necessary credentials and settings.
  4. Enable or disable specific connectors as needed.
Connectors Settings Interface
  • Service Integration: Connect with popular development and project management tools
  • Automatic Sync: Time entries can be automatically synced with connected services
  • Custom Mapping: Configure how time entries map to tasks in external services
  • Connection Management: Easily enable, disable, or reconfigure connections

User Interface

Main Components

  • Sidebar: Navigation menu for different sections
  • Header: Contains main controls and navigation
  • Timer Controls: Start/stop tracking and manual time entry
  • Activity List: Displays current and past activities
  • Footer: Additional information and controls

Usage Guide

Starting Time Tracking

  1. Click the "Start" button in the Timer Controls section
  2. The app will begin automatically tracking your activities
  3. Activities will be displayed in the Activity List

Stopping Time Tracking

  1. Click the "Stop" button in the Timer Controls section
  2. The current tracking session will end
  3. All tracked activities will be saved

Adding Manual Time Entry

  1. Click the manual entry button in Timer Controls
  2. Fill in the required information:
    • Activity description
    • Start time
    • End time
    • Category (optional)
  3. Click "Save" to add the entry

Best Practices

  1. Start tracking at the beginning of your work session
  2. Regularly review and categorize activities
  3. Assign activities to tasks for better organization
  4. Set realistic goals and monitor progress
  5. Generate reports regularly to analyze time usage
  6. Keep application categories updated for accurate tracking

Troubleshooting

Common Issues

Tracking Not Starting

  • Check if the app has necessary permissions
  • Restart the application
  • Verify system requirements

Activities Not Showing

  • Check if tracking is active
  • Verify application categories
  • Check for any error messages

Notifications Not Working

  • Verify notification permissions
  • Check notification settings
  • Ensure the app is running in the background