# Standard Desktop App import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Callout } from 'fumadocs-ui/components/callout'; We also offer an **Experimental Timesheet AI App** with cutting-edge AI capabilities. It's perfect for early adopters who want to try new features before they're released. [Jump to experimental downloads](/new-desktop-app) For a complete guide on getting started, see [Desktop app basics](https://help.timecamp.com/help/desktop-app-basics) article. ## Downloads ### Windows 10 & 11 **Download the installer (.exe)** [Download TimeCamp for Windows](https://download.timecamp.com/desktop/latest/windows) **Run the installer** Locate the downloaded file and run it. Follow the on-screen instructions to complete the installation. We also offer MSI installer for Windows. Please [contact us](https://www.timecamp.com/contact) if you need it. ### macOS For macOS Monterey (version 12) and later (Intel and Apple Silicon). **Download the disk image** [Download TimeCamp.dmg](https://download.timecamp.com/desktop/latest/macos) **Install the application** Open the downloaded `.dmg` file and drag the TimeCamp icon to your Applications folder. ### Linux **Ubuntu 22 & 24 with GNOME (Wayland)** **Install Window Calls Extended GNOME extension** To enable time tracking for applications on Ubuntu (>=21.04) or Debian, you need this extension. **Option A: Using Extension Manager (recommended)** 1. Open Terminal. 2. Install Extension Manager: ```bash sudo apt install -y gnome-shell-extension-manager ``` *(This may require administrator privileges)* 3. Open "Extension Manager" app. 4. Browse for `hseliger`. 5. Install **"Window Calls Extended"**. **Option B: Using browser** If you have the [GNOME Shell Integration](https://chromewebstore.google.com/detail/gnome-shell-integration/gphhapmejobijbbhgpjhcjognlahblep) browser extension installed, you can install "Window Calls Extended" directly from the [GNOME Extensions website](https://extensions.gnome.org/extension/4974/window-calls-extended/). Once installed, the app should automatically start collecting information about open programs. **Install TimeCamp application** [Download for Ubuntu 22 & 24 (.deb)](https://download.timecamp.com/desktop/latest/ubuntu) Install the `.deb` file using your preferred method (e.g., `sudo dpkg -i filename.deb` or double-clicking). **Note:** TimeCamp doesn't start automatically after installation. Launch it manually from your application menu and provide your login details. **Fedora 42+ with KDE (Wayland)** Close existing TimeCamp app if it's running before proceeding. **Download RPM installer** [Download TimeCamp RPM](https://timecamp-public-desktop-app.s3.us-east-1.amazonaws.com/timecamp-desktop/prod-9eba558e/2025-10-27-13_01-master-1.8.4.0/timecamp-1.8.4.0-1.fc42.x86_64-fedora42.rpm) **Open Terminal** Launch your terminal application. **Navigate to download location** ```bash cd ~/Downloads ``` **Run installer** Replace `timecamp.rpm` with the actual filename if different. ```bash sudo dnf -y install ./timecamp.rpm ``` If it's already installed, you can use: ```bash sudo dnf reinstall ./timecamp.rpm ``` **Start TimeCamp** Find and start the TimeCamp app from your application launcher. **Debian 12+** TBD (similar to Ubuntu) **SUSE** Please [contact us](https://www.timecamp.com/contact) **Missing distro?** Please [contact us](https://www.timecamp.com/contact) ## What's New ### 12 Jul 2026 - v1.12.1 * **new**: Configurable screenshot capture frequency, including support for screenshots when no task is selected * **new**: Task descriptions are now displayed in tooltips * **new**: (Windows) Task tags can be requested before task selection when supported by the account * **new**: (Windows) MSI installations now create a desktop shortcut * **new**: Expanded enterprise deployment controls for authentication, autostart, proxy visibility, anonymous users, remote sessions and installer behavior * **improvement**: Power, display-sleep, screen-lock, RDP and suspend handling now preserves tracking and away-time boundaries more accurately across Windows, macOS and Linux * **improvement**: Away-time prompts now appear immediately after tracking stops, with more reliable idle-grace handling during activity uploads * **improvement**: (Windows) Per-monitor DPI awareness improves widget scaling and rendering when moving between displays * **improvement**: (Linux and macOS) Single-instance handling now allows one running app instance per operating-system user * **improvement**: Deep-link registration is now handled by installers for more reliable login and launch behavior * **improvement**: Task hierarchy paths now use forward slashes consistently across platforms * **improvement**: Updated wxWidgets to 3.3.2 and libcurl to 8.19.0 for compatibility, stability and security * **improvement**: Database access now uses prepared statements and safer multi-threaded connection handling * **improvement**: (Linux) Activity tracking falls back to generic computer activity when detailed application data is unavailable * **fix**: Expired API sessions returning HTTP 401 are now handled consistently and prompt reauthentication * **fix**: (Windows and Linux) Missing application and installer icons were restored * **fix**: (Windows) Installers now close running application processes more reliably during upgrades * **fix**: Fixed application shutdown crashes and taskbar icon cleanup issues * **fix**: Active activity is flushed before upload, preventing recent tracking data from being omitted * **fix**: Working-time limits no longer suppress the application-started activity * **fix**: Tracking continues through computer or display sleep when pausing on session lock is disabled * **fix**: Widget labels, bitmap paths, pause-button visibility and high-DPI resizing now render correctly * **fix**: (macOS) Clicking the menu-bar icon opens the menu instead of the task picker * **fix**: (Windows) The first tray-menu item no longer appears bold * **fix**: (Ubuntu) Closing and reopening a laptop lid now records breaks correctly ### 10 Mar 2026 - v1.9.4 * **fix**: (Windows)Enabled missing SSL certificate revocation checks for improved connection security ### 3 Mar 2026 - v1.9.3 * **new**: (Linux) Deep link (`tc://`) schema support for Linux * **improvement**: (Windows) Improved NSIS installer process termination to prevent conflicts during upgrades * **improvement**: Menu item label translations fixed across platforms * **improvement**: Path resolution normalized for application resources on macOS, Windows and Linux * **improvement**: (Linux) Linux computer activity fallback — logs generic "computer activity" when specific data unavailable * **fix**: (Linux) Application indicator icon corrected on Linux * **fix**: (Linux) UTF-8 strings passed correctly to GTK notifications and library on Linux * **fix**: (Linux) Language directory resolution fixed for proper translations loading * **fix**: (Windows)Unused DLLs removed to reduce application size ### 24 Feb 2026 - v1.9.2 * **improvement**: Updated libcurl to 8.18.0 for better performance and security * **improvement**: Unified installer configuration using config.json * **improvement**: Installer build process streamlined with universal WXS configuration ### 17 Feb 2026 - v1.9.1 * **new**: Option to disable file logging via configuration * **new**: Custom app naming support for white-label deployments * **improvement**: SSL verification enabled for all HTTP POST calls * **improvement**: Installer build process modernized with Python-based tooling and Azure Trusted Signing * **fix**: macOS resource path resolution corrected ### 11 Feb 2026 - v1.9.0 * **fix**: Text in the windget was trimmed on high-dpi screens * **fix**: Long email addresses now display correctly in the user interface * **fix**: Server response logging improved in file uploader * **fix**: Task time span requests no longer run concurrently, preventing duplicate API calls ### 9 Feb 2026 - v1.8.8 * **new**: Brave browser support for automatic activity tracking * **improvement**: Unified away-time dialog across all platforms (macOS, Windows, Linux) * **improvement**: Away-time dialog layout and button visibility improvements * **fix**: Task time span requests no longer run concurrently, preventing duplicate API calls * **fix**: Polish translations updated ### 24 Jan 2026 - v1.8.7 * **new**: API token manual login for environments where deep link login is unavailable * **new**: Option to retain uploaded screenshots instead of deleting after upload * **new**: Blurred screenshot mode for enhanced privacy before uploading * **new**: Automatic tracking mode support via server configuration * **new**: Server-side control for window title collection * **improvement**: Language resources included in Linux RPM and DEB packages * **improvement**: DPI override for better display scaling on Windows * **improvement**: Enhanced XML data preparation for REST API calls * **improvement**: Server-configurable idle time override for auto-updates * **fix**: Linux package dependencies updated * **fix**: First run window display fixed on certain configurations ### 5 Jan 2026 - v1.8.6 * **improvement**: Enhanced idle time detection for Wayland sessions on Linux * **fix**: macOS taskbar icon now retains correct color when inactive * **fix**: Screenshots retained on server errors (last 10 kept for debugging) * **fix**: Thread management in fraud detectors fixed to prevent macOS crashes # Getting started Explore our documentation to learn about: * **[Getting Started](/new-desktop-app)** - Installation, setup, and first steps * **[Views](/new-desktop-app/views)** - Calendar, Table, List, Timeline, and more * **[AI Features](/new-desktop-app/ai-features)** - Smart categorization and descriptions * **[Power Features](/new-desktop-app/power-features)** - Advanced tracking capabilities * **[Plugins](/new-desktop-app/plugins)** - Extend functionality with plugins * **[What's New](/new-desktop-app/whats-new)** - Latest updates and improvements * **[Roadmap](/new-desktop-app/roadmap)** - Upcoming features and plans # MCP Server import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; import { Callout } from 'fumadocs-ui/components/callout'; The TimeCamp MCP (Model Context Protocol) server allows AI assistants to interact with your TimeCamp data directly. You can start, stop, and manage time entries, browse projects and tasks, and more — all through natural language conversations with your favorite AI tool. MCP is an open standard that enables AI models to securely connect to external data sources and tools. Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io). ## Server URL ``` https://mcp.timecamp.com/mcp ``` ## What you can do With the TimeCamp MCP server, your AI assistant can: * Start and stop time tracking * Create and manage time entries * Browse projects and tasks * View tracked time summaries * Manage your TimeCamp workspace ## Setup ### Claude Desktop Claude MCP Server setup 1. Open Claude Desktop and go to **Settings** → **Connectors** → **Customize** 2. Click the **+** icon → **Add custom connector** 3. Enter the following URL: ``` https://mcp.timecamp.com/mcp ``` 4. Click **Save** 5. Claude will prompt you to authenticate with your TimeCamp account ### Claude Code (CLI) Add the server using the CLI: ```bash claude mcp add timecamp https://mcp.timecamp.com/mcp ``` ### ChatGPT 1. Open [chatgpt.com](https://chatgpt.com) and go to **Settings** → **Connected apps** 2. Click **Add connection** 3. Search for "TimeCamp" or enter the server URL manually: ``` https://mcp.timecamp.com/mcp ``` 4. Click **Connect** and authenticate with your TimeCamp account 5. TimeCamp tools will now be available in your ChatGPT conversations ### Cursor IDE Add the TimeCamp MCP server to your Cursor configuration: 1. Open **Cursor Settings** → **MCP** 2. Click **Add new MCP server** 3. Choose **Type: URL** and enter: ``` https://mcp.timecamp.com/mcp ``` Alternatively, add it directly to your `.cursor/mcp.json` file: ```json { "mcpServers": { "timecamp": { "url": "https://mcp.timecamp.com/mcp" } } } ``` 4. Restart Cursor or reload the MCP servers 5. You'll be prompted to authenticate with your TimeCamp account ### Any MCP-compatible client **Server URL:** ``` https://mcp.timecamp.com/mcp ``` #### Configuration examples **JSON configuration** (commonly used by MCP clients): ```json { "mcpServers": { "timecamp": { "url": "https://mcp.timecamp.com/mcp" } } } ``` **Windsurf:** Add to your Windsurf MCP settings with the URL `https://mcp.timecamp.com/mcp`. **VS Code (Copilot):** Add to your `.vscode/mcp.json`: ```json { "servers": { "timecamp": { "url": "https://mcp.timecamp.com/mcp" } } } ``` Authentication is handled via OAuth. When you first connect, your AI client will redirect you to TimeCamp to authorize access. # Power BI import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; import { Callout } from 'fumadocs-ui/components/callout'; TimeCamp offers three ways to be connected with Power BI: 1. Using free REST API in Power BI Desktop 2. Export data to any database using an open-source script, then connect Power BI to it 3. For self-hosted TimeCamp, connect to the database directly We offer free consultation, please choose the best time, by clicking [this link](https://meetings-eu1.hubspot.com/kamil-rudnicki). This method connects Power BI Desktop directly to the TimeCamp REST API. It's free and easy to set up. #### Step 1: Download the example report Download our pre-configured Power BI report template: **[Download TimeCamp Power BI Report](/docs/powerbi/Time%20entries%20PowerBI%20\(test%20user%20token\).pbix.zip)** #### Step 2: Open the report in Power BI Desktop 1. Open **Power BI Desktop** (free download from Microsoft) 2. Open the downloaded `.pbix` file #### Step 3: Replace the API token with your own 1. In Power BI Desktop, go to **Home** → **Transform data** → **Edit parameters** 2. Paste your TimeCamp API token into the "ApiToken" parameter 3. Click **OK**, then **Apply changes** **Where to find your TimeCamp API token:** * Log in to TimeCamp * Go to **Settings** → **Your Profile** * Copy your API token from the profile page [Instruction](https://docs.google.com/document/d/16r547_ZdbYhA0oj2w8iZht8I0FsRg6MZ1Cpo0iEltAw/edit?tab=t.0) #### Step 4: Refresh the data Click **Refresh** to load your TimeCamp data into the report. This method only works with **Power BI Desktop**. For Power BI Online, use the "Export to database" method instead. ### Export data to a database, then connect Power BI This method gives you the most flexibility and works with both **Power BI Desktop** and **Power BI Online**. We recommend using Google BigQuery as your data warehouse. #### Step 1: Export TimeCamp data to a database Use our open-source data pipeline to export your TimeCamp data: 1. Visit the [TimeCamp Data Pipeline](https://github.com/timecamp-org/good-enough-timecamp-data-pipeline) repository on GitHub 2. Follow the setup instructions in the README 3. Run the pipeline to export your data to your preferred destination: * **Google BigQuery** (recommended) * PostgreSQL * MySQL * DuckDB * CSV/Parquet files **Available datasets you can export:** * Time entries with project/task details * Projects & tasks hierarchy * Computer activities (desktop app tracking) * Users with group information * Application names and categories #### Step 2: Connect Power BI to your database Once your data is in the database, connect Power BI to it: **For Google BigQuery:** 1. Open **Power BI Desktop** or go to **Power BI Online** 2. Click **Get Data** → **Database** → **Google BigQuery** 3. Sign in with your Google account that has access to BigQuery 4. Select your BigQuery project and dataset 5. Choose the tables you want to import (entries, tasks, users, etc.) 6. Click **Load** to import the data **For other databases:** Use the appropriate connector in Power BI (PostgreSQL, MySQL, etc.) and enter your database credentials. #### Benefits of this approach * Works with Power BI Online (cloud) and Desktop * Automatic data refresh scheduling * Better performance for large datasets * Full control over your data Please contact us at [sales@timecamp.com](mailto:sales@timecamp.com) if you are interested in self-hosted version of TimeCamp. # Download TimeCamp import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; import { Step, Steps } from 'fumadocs-ui/components/steps'; Download the **Standard TimeCamp Desktop App** — our recommended time tracking solution that works reliably across all major platforms. We also offer an **Experimental Timesheet AI App** with cutting-edge AI capabilities. It's perfect for early adopters who want to try new features before they're released. [Jump to experimental downloads](#experimental-timecamp-timesheet-app) ### Windows 10 & 11
🪟

Download for Windows

Compilation date: 2025-11-19

📦 [**Download TimeCamp Installer**](https://drive.google.com/open?id=1cd89ZdbSDL6nd8n7WjpSfEQGA5FwuayD\&usp=drive_fs)
### Download & Install 1. Download the installer from the link above 2. Run the `.exe` file and follow the installation wizard 3. Launch TimeCamp from your Start menu ### Grant Permissions When prompted, allow TimeCamp to run at startup for automatic time tracking.
### macOS Monterey (12) and later
🍎

Download for macOS

Compilation date: 2026-01-05

📦 [**Download TimeCamp.dmg**](https://timecamp-public-desktop-app.s3.us-east-1.amazonaws.com/timecamp-desktop/prod-deeplink-01e7191c/2026-01-05-16_24-master-1.8.6.0/TimeCamp.dmg)
### Download & Install 1. Download the `.dmg` file from the link above 2. Open the downloaded file 3. Drag TimeCamp to your Applications folder 4. Launch TimeCamp from Applications ### Grant Permissions When prompted, grant the following permissions in **System Settings → Privacy & Security**: * **Accessibility** — required for tracking apps/windows * **Screen Recording** — optional, enables OCR features
Choose your Linux distribution below. ### Fedora 42+ with KDE (Wayland)
🐧

Download for Fedora

RPM Package • Version 1.8.4.0

📦 [**Download RPM Installer**](https://timecamp-public-desktop-app.s3.us-east-1.amazonaws.com/timecamp-desktop/prod-9eba558e/2025-10-27-13_01-master-1.8.4.0/timecamp-1.8.4.0-1.fc42.x86_64-fedora42.rpm)
Close any existing TimeCamp app if it's currently running. ### Download the RPM Download the RPM installer from the link above. ### Install via Terminal Open Terminal and navigate to your Downloads folder: ```bash cd ~/Downloads ``` Install the package (adjust the filename if needed): ```bash sudo dnf -y install ./timecamp-1.8.4.0-1.fc42.x86_64-fedora42.rpm ``` If TimeCamp is already installed and you want to reinstall, use `sudo dnf reinstall` instead. ### Launch TimeCamp Find and start the TimeCamp app from your application menu. *** ### Ubuntu 22 & 24 with GNOME (Wayland)
🐧

Download for Ubuntu

DEB Package • Version 1.8.6.3

📦 [**Download DEB Installer**](https://timecamp-public-desktop-app.s3.us-east-1.amazonaws.com/timecamp-desktop/dev-e8f29240/2025-12-21-09_18-linux_idle_time_fix-1.8.6.3/timecamp_1.8.6.3-dev_amd64-ubuntu2204.deb)
### Install GNOME Extension (Required) To enable time tracking on Ubuntu 21.04+ or Debian with GNOME, you need to install an extension that allows TimeCamp to gather window information. 1. Open the **Terminal** app 2. Install the Extension Manager: ```bash sudo apt install -y gnome-shell-extension-manager ``` 3. Open the **Extension Manager** app 4. Go to the **Browse** tab and search for `hseliger` 5. Click **Install** next to **"Window Calls Extended"** Once installed, the app will automatically start collecting information about open programs. ### Install TimeCamp Download the `.deb` package from the link above and install it using your preferred method: **Option A — Using Software Center:** Double-click the downloaded `.deb` file **Option B — Using Terminal:** ```bash cd ~/Downloads sudo dpkg -i timecamp_1.8.6.3-dev_amd64-ubuntu2204.deb ``` ### Launch TimeCamp Find and start the TimeCamp app from your application menu. *** ### Debian 12+ Installation is similar to Ubuntu. Detailed instructions coming soon. *** ### SUSE / Other Distributions
📧

Need help with your distribution?

Contact us at timecamp.com/contact and we'll help you get set up.

# AI features import { Accordion, Accordions } from 'fumadocs-ui/components/accordion'; **The first fully automated time tracker.** Fifteen years ago, we pioneered automatic time tracking with keywords. Now, the next chapter. TimeCamp watches how you work, learns your patterns, and fills your timesheet—without you lifting a finger. No timers. No manual entry. Just accurate time data. Privacy first. Data stays local and private. Calendar View ## What AI Can Do * ✅ **Suggest tasks** based on your activities * ✅ **Generate descriptions** from screen content * ✅ **Auto-fill gaps** in your timesheet * ✅ **Learn from corrections** to improve over time * ✅ **Chat** you can use Assistant as general purpose chat with tools, scheduled tasks ## Pro Tips 1. **Keep app running** - Add to login items for auto-start 2. **Review suggestions** - Correct mistakes to improve AI 3. **Organize projects** - Clear structure in TimeCamp = better AI 4. **Task descriptions** - Describe your tasks in a way that is easy for AI to understand in Description field in [TimeCamp](https://app.timecamp.com/app#/active-projects) ## Available Models You can pick the model in **Settings → AI**. Relative cost is shown against `google/gemini-pro-latest`. Our recommended model (price/performance ratio) is set as `auto` in Settings. It may change over time, but it's usually the best model for most use cases. | Model | Modality | Relative cost | Comment | | -------------------------------- | ---------- | ------------- | ----------------------------------------------------- | | `openai/gpt-latest` | Multimodal | \~2.5× | | | `anthropic/claude-sonnet-latest` | Multimodal | \~1.4× | | | `google/gemini-pro-latest` | Multimodal | 1× (baseline) | | | `deepseek/deepseek-pro-latest` | Text only | \~0.65× | From time to time, fails more often than other models | | `google/gemini-flash-latest` | Multimodal | \~0.25× | | | `google/gemma-latest` | Multimodal | \~0.05× | From time to time, fails more often than other models | Models are not deterministic, so you may get different results with the same input and same model. Sometimes models that cost more, can perform worse than cheaper models. It's best to test this by yourself. Open specific time entry and click `Suggest with AI` button, then change model in Settings and see if the results are better. We offer help to determine the best model for your use case using evals. [Contact us](https://www.timecamp.com/contact) for more information. ## Keep Using AI Features Every workspace starts with **$10 in free AI credits**—enough to see the magic for yourself. Once you've used them up, pick how you'd like to keep going: 1. **Top up through TimeCamp** — Plans start at **$4.99/month**. Add credits for yourself or your whole team in one place. No setup, no hidden fees, cancel anytime [https://billing.timecamp.com](https://billing.timecamp.com). Get credits now 2. **Bring your own API key** — Prefer to manage AI yourself? Connect any model via [OpenRouter](https://openrouter.ai/) in **Settings → AI** and pay your provider directly. ## FAQ * **macOS** (10.15 or higher - only ARM64 architecture is supported currently) * **Windows** (10 or higher) Linux is not supported yet, we plan to support it in the future. App tracks the following data and saves it in local SQLite database: * Application name * Window title * URL of the browser tab * OCR of the opened window (optional, processed locally, by default disabled) It can be set in app Settings. You can switch to any of the [available models](#available-models) in **Settings → AI**. All models run with a strict no-data policy: * No training on your data * No data retention * Full control with private Azure or custom API keys using OpenRouter API The application will ask for two permissions on MacOS: 1. **Accessibility Permission** * Allows the app to track which applications and windows are active * Required for computer activity monitoring * Grant in: System Settings → Privacy & Security → Accessibility 2. **Screen Recording Permission (optional)** * Required for OCR (screen text capture) functionality * Allows the app to capture screen content for analysis * Grant in: System Settings → Privacy & Security → Screen Recording **Note**: The app will automatically prompt you to grant these permissions on first launch. You must grant both for full functionality. ## Legal For the legal terms that apply to TimeCamp products, please refer to TimeCamp's [Privacy Policy](https://www.timecamp.com/privacy-policy/#:~:text=AI%20TIME%20TRACKER%20PRIVACY%20POLICY), [Terms & Conditions](https://www.timecamp.com/terms-conditions/#:~:text=11.-,AI%20Terms%20of%20Service,-1.%20AI%20suggestions), and [List of Sub-Processors](https://www.timecamp.com/subprocessors/#:~:text=Third%2DParty%20AI-,Subprocessors,-%28Only%20if%20AI). ### Privacy Policy See TimeCamp's [Privacy Policy](https://www.timecamp.com/privacy-policy/#:~:text=AI%20TIME%20TRACKER%20PRIVACY%20POLICY). ### Terms of Service See TimeCamp's [Terms & Conditions](https://www.timecamp.com/terms-conditions/#:~:text=11.-,AI%20Terms%20of%20Service,-1.%20AI%20suggestions). ### Subprocessors See TimeCamp's [List of Sub-Processors](https://www.timecamp.com/subprocessors/#:~:text=Third%2DParty%20AI-,Subprocessors,-%28Only%20if%20AI). # FAQ ## How to fix an API token problem If the app cannot sync data, asks you to log in again, or reports an API token problem, replace the token saved in the desktop app. 1. Open TimeCamp [Profile Settings](https://app.timecamp.com/app#/settings/users/me) and copy your current API token. 2. Open the menubar app and click `Settings...`. 3. Click the `Configure` in Account integrations section. 4. Remove the token (make it empty) 5. Click `Back to settings` and close the settings window. 6. Open main window, you should see Onboarding dialog, where you can enter the new API token.