Companion apps

Tracking time with the Mac and Windows desktop apps

Timether’s Mac and Windows desktop apps let you track time without keeping the web dashboard open all day. The desktop app is designed as a lightweight companion to the main Timether web app. It helps you start, pause, resume, and save timers quickly while keeping your time synced with your workspace. What the desktop app is used for The desktop app is best for quick time tracking during your workday. You can use it to: - Start a timer - Pause an active timer - Resume a paused timer - Save tracked time - Reset the active timer - Select the correct workspace - Track time against available projects and clients The app stays out of your way, so you can focus on your work while Timether keeps your timer connected to the core application. Installing the desktop app To install the desktop app: 1. Download the Timether desktop app for your operating system. 2. Open the installer for Mac or Windows. 3. Follow the installation steps. 4. Open the Timether desktop app. 5. Connect your Timether account when prompted. After connecting, the app will sync with your Timether workspace. Connecting your Timether account When you open the desktop app for the first time, you may be asked to connect your Timether account. To connect: 1. Click Connect account or Sign in. 2. Timether will open the sign-in flow in your browser. 3. Sign in to your Timether account. 4. Select the workspace you want to connect. 5. Approve the connection. 6. Return to the desktop app. Once connected, the desktop app will use your selected workspace for time tracking. Switching workspaces in the desktop app If you belong to more than one workspace, you can switch between them from the desktop app. To switch workspaces: 1. Open the desktop app. 2. Click the current workspace name or workspace selector. 3. Choose the workspace you want to use. 4. The app will update the active workspace context. After switching, the app will show the projects and clients available in that workspace. Workspace scoping in the desktop app Timether uses strict workspace scoping. This means the desktop app only shows data from the workspace you are currently using. For example: - You will only see projects from the active workspace. - You will only see clients from the active workspace. - You can only track time to projects that belong to the active workspace. - You cannot track time to a project from another workspace. - You cannot connect a time entry to a client from another workspace. If a project or client is missing from the desktop app, check that you are using the correct workspace. You may need to switch workspaces before starting the timer. Starting a timer from the desktop app To start tracking time: 1. Open the Timether desktop app. 2. Make sure the correct workspace is selected. 3. Choose the project you are working on. 4. Add a description if needed. 5. Click Start. The timer will begin tracking your work and sync with Timether. Pausing and resuming a timer If you need to stop temporarily, click Pause. The timer will stop counting time but will keep the current tracked duration. When you are ready to continue, click Resume. The timer will continue from where it left off. Saving tracked time When you finish working, click Save. Saving turns the active timer into a time entry inside your Timether workspace. The saved entry will be available in the web dashboard, timesheets, reports, and invoices depending on your workspace plan and billing settings. Resetting a timer If you started a timer by mistake or do not want to keep the tracked time, click Reset. Resetting clears the active timer without saving it. Use this only when you want to discard the current timer. Background tracking and syncing The desktop app is designed to stay out of your way while you work. Your timer activity syncs directly with the main Timether application, so your tracked time remains connected to your workspace. This means timer activity from the desktop app can be reflected in the web dashboard and other connected Timether clients. If you start tracking from the desktop app, you can still review and manage the saved entry later from the web dashboard. What must be managed from the web dashboard The desktop app is focused on time tracking. Some workspace and management features are only available from the Timether web dashboard. You must use the web dashboard to manage: - Clients - Projects - Tags - Invoices - Reports - Team members - Member capacity - Internal hourly costs - Profitability and margin reporting - Billing and subscription settings - Workspace branding - API tokens Internal costs and margin reporting are management features. They cannot be configured from the desktop companion app. Owners and Managers should visit the web dashboard to update internal hourly costs, expected weekly capacity, and profitability-related settings. If the desktop app does not show the right data If the desktop app does not show the project or client you expect, check the following: 1. Make sure you are signed in to the correct Timether account. 2. Make sure the correct workspace is selected. 3. Check whether the project or client is archived. 4. Confirm that the project and client belong to the active workspace. 5. Open the web dashboard to confirm the project or client exists. Because Timether keeps workspace data strictly separated, the desktop app will not show projects or clients from other workspaces.

Logging time on the go with the mobile app

Timether’s mobile app lets you track and manage time from your phone, whether you are away from your desk, visiting a client, working remotely, or handling quick updates during the day. The mobile app is available for iOS and Android and is built as a companion to the main Timether web dashboard. What the mobile app is used for The mobile app is designed for quick time tracking and basic time entry management while you are on the go. You can use it to: - Track time from your phone - Create manual time entries - Edit existing time entries - Delete time entries - Switch between workspaces - View your basic time logs - Review recent tracked work For advanced workspace management, billing, profitability, and capacity reporting, use the Timether web dashboard. Setting up the mobile app To get started: 1. Install the Timether mobile app on your iOS or Android device. 2. Open the app. 3. Sign in with your Timether account. 4. Select the workspace you want to use. 5. Start tracking or managing time entries. Once signed in, the mobile app will connect to your Timether account and sync your activity with the selected workspace. Workspace navigation If you belong to multiple workspaces, the mobile app lets you choose which workspace you want to work in. Each workspace has its own clients, projects, tags, timers, time entries, reports, and settings. When you switch workspaces, the mobile app updates the active workspace context. After switching, you will only see the projects, clients, and time entries that belong to that workspace. Workspace scoping on mobile Timether keeps workspace data strictly separated. This means you cannot track time to a project from another workspace, and you cannot connect a time entry to a client that belongs to a different workspace. For example, if you are currently using your personal workspace, you will not see projects from your agency workspace. If a project or client is missing in the mobile app, check that you are in the correct workspace. Creating a time entry from mobile To create a manual time entry: 1. Open the Timether mobile app. 2. Make sure the correct workspace is selected. 3. Go to the time entries or logs section. 4. Tap Add Time Entry. 5. Enter a description of the work. 6. Select the project. 7. Add the duration. 8. Choose the date and time the work happened. 9. Add tags if needed. 10. Save the entry. The new time entry will be saved to the selected workspace and synced with the web dashboard. Editing a time entry To edit an existing time entry: 1. Open the time entry in the mobile app. 2. Update the details you need to change. 3. Save your changes. You may be able to update details such as the description, duration, project, tags, billable status, rate, or date, depending on your role and workspace permissions. If the time entry is locked because it has already been added to an active invoice, it cannot be edited until it is released from that invoice. Deleting a time entry To delete a time entry: 1. Open the time entry you want to remove. 2. Tap Delete or the available remove option. 3. Confirm the action. Deleting a time entry removes it from the workspace records. If the entry has already been included in a draft, sent, or paid invoice, it may be locked and cannot be deleted until the invoice is deleted, voided, or the entry is otherwise released. Viewing basic time logs Members can use the mobile app to view their basic time logs. This is useful for checking recent work, confirming that time was saved correctly, or reviewing entries while away from the computer. The mobile app is helpful for quick visibility, but it is not intended to replace the full reporting dashboard. Reporting on mobile The mobile app may show basic time log information so users can review their own tracked work. For deeper reporting, use the Timether web dashboard. Managers and owners should use the web app to review advanced reports such as: - Team timesheets - Capacity utilization - Internal cost breakdowns - Billable vs. non-billable cost - Project profit margins - Planning insights - Detailed productivity reports These reports often include management-level information and are better suited to the full web dashboard. What must be managed from the web dashboard The mobile app is focused on quick time tracking and time entry management. Use the Timether web dashboard for: - Managing clients - Managing projects - Managing tags - Creating invoices - Managing team members - Updating member capacity - Updating internal hourly costs - Reviewing profit margins - Reviewing capacity utilization - Managing billing and subscriptions - Managing API tokens - Changing advanced workspace settings This keeps the mobile app simple while keeping advanced workspace controls available in the main web app. If the mobile app shows the wrong workspace data If the mobile app does not show the clients, projects, or time entries you expect, check the following: 1. Make sure you are signed in to the correct Timether account. 2. Check the active workspace. 3. Switch to the correct workspace if needed. 4. Confirm that the project or client is not archived. 5. Open the web dashboard to confirm the data exists in that workspace. Because Timether uses strict workspace scoping, the mobile app only shows data from the workspace currently selected.

Using the Timether browser extension

The Timether browser extension helps you track time without leaving your current browser tab. It is useful when you are working inside tools like project boards, code platforms, design tools, documents, dashboards, admin panels, or client websites and want to quickly start or stop a timer. What the browser extension is used for You can use the Timether browser extension to track time directly from your browser. The extension is designed for quick actions, such as: - Starting a timer - Pausing a timer - Resuming a timer - Saving tracked time - Resetting an active timer - Selecting a project - Capturing the current browser tab title and URL This helps you stay focused on your work without switching back to the Timether web dashboard every time you need to track time. Connecting the browser extension Before using the extension, connect it to your Timether account. To connect: 1. Install the Timether browser extension. 2. Open the extension from your browser toolbar. 3. Click Connect Timether or Sign in. 4. Sign in to your Timether account. 5. Select the workspace you want to connect. 6. Approve the connection. After approval, the extension will connect to your selected workspace. Active workspace The browser extension uses your active workspace context to fetch available projects and clients. This means the extension will only show projects and clients that belong to the currently selected workspace. For example, if your active workspace is your agency workspace, the extension will show projects and clients from that workspace only. If you switch to your personal workspace, the available projects and clients will change to match that workspace. Switching workspaces If you belong to multiple workspaces, make sure the correct workspace is selected before starting a timer. To switch workspaces: 1. Open the Timether browser extension. 2. Click the current workspace name or workspace selector. 3. Choose the workspace you want to use. 4. Wait for the extension to refresh the available projects and clients. After switching, any new timer activity will happen inside the selected workspace. Starting a timer from the extension To start tracking time: 1. Open the page or tool you are working on. 2. Click the Timether extension icon in your browser toolbar. 3. Make sure the correct workspace is selected. 4. Select the project you want to track time against. 5. Add a description if needed. 6. Click Start. The timer will begin tracking time and sync with your Timether account. Pausing, resuming, and saving time You can manage your active timer from the browser extension. Use Pause when you need to temporarily stop tracking. Use Resume when you want to continue the same timer. Use Save when the work is finished and you want to create a time entry. Once saved, the time entry will be available in the Timether web dashboard, timesheets, reports, and invoices depending on your workspace plan and permissions. Capturing the current browser tab The browser extension can also capture the title and URL of your active browser tab. This is useful when you want the time entry description to include exactly what you were working on. For example, if you are working on a proposal page, the extension can add details like: **Proposal - Acme - **https://example.com/proposal To capture the current tab: 1. Open the browser tab you want to capture. 2. Open the Timether browser extension. 3. Make sure a timer is active. 4. Click Capture. The extension will add the tab title and URL to your active timer description. Workspace scoping rules Timether uses strict workspace scoping to keep your data separated. Projects, clients, timers, and time entries are bound to the workspace where they were created. This means you cannot log time to a project that belongs to a different workspace. You also cannot connect a time entry to a client from another workspace. These rules help prevent accidental tracking, reporting, and invoicing mistakes. Troubleshooting workspace issues If you cannot find a project or client in the browser extension, it is usually because the extension is connected to a different workspace. Check the following: 1. Make sure you are signed in to the correct Timether account. 2. Check the active workspace in the extension. 3. Switch to the correct workspace if needed. 4. Confirm that the project or client has not been archived. 5. Open the Timether web dashboard to confirm the project or client exists in that workspace. If you try to log time to a project that belongs to another workspace, Timether will block the action. To fix this, switch to the workspace where that project belongs, then start the timer again. If the timer does not sync If your timer does not appear to sync correctly: 1. Check your internet connection. 2. Make sure the extension is still connected to your Timether account. 3. Confirm that your selected workspace is active. 4. Refresh the extension. 5. Open the Timether web dashboard to check the active timer state. If the workspace is in a billing read-only state, new timer actions may be blocked until the billing issue is resolved by the workspace owner. What should be managed from the web dashboard The browser extension is designed for quick time tracking. Use the Timether web dashboard for workspace management and advanced reporting, such as: - Managing clients - Managing projects - Managing tags - Creating invoices - Reviewing full reports - Managing team members - Updating member capacity - Updating internal hourly costs - Reviewing profit margins - Managing billing and subscriptions - Managing API tokens The extension keeps time tracking fast, while the web dashboard gives you the full workspace management experience.

Building with the Timether API

The Timether API lets developers connect workspace data with internal tools, dashboards, reporting systems, automations, and custom workflows. API access is available for Team and Business workspaces through public API tokens. For comprehensive API documents, visit https://api-docs.timether.com API availability Public API access is available on: - Team - Business API token access is not available on the Free or Solo Pro plans. If you do not see API token settings in your workspace, check that your workspace is on a supported plan and that your role has permission to access developer settings. Creating an API token To create an API token: 1. Go to Workspace Settings. 2. Open the Developer, API, or API Tokens section. 3. Click Create Token. 4. Give the token a clear name. 5. Copy the generated token and store it securely. API tokens are shown only once when they are created. If you lose the token, you will need to revoke it and create a new one. Making API requests Timether API requests use the base path: /api/v1 Each API request should include the API token in the Authorization header using the Bearer format. Example: Authorization: Bearer your_api_token_here You must also include the workspace context using the X-Workspace-Id header. Example: X-Workspace-Id: your_workspace_id_here A typical request should include: Authorization: Bearer your_api_token_here X-Workspace-Id: your_workspace_id_here Content-Type: application/json Workspace headers are required Timether accounts can belong to multiple workspaces, and each workspace has its own separate data. Because of this, API requests must include the X-Workspace-Id header. This tells Timether which workspace the request should operate inside. If the workspace ID is missing, invalid, or not available to the token’s user, the request may be rejected. Strict workspace scoping API requests are strictly scoped to the workspace provided in the X-Workspace-Id header. This means API requests can only access records that belong to that workspace. For example: - You cannot create a time entry for a project from another workspace. - You cannot associate a project with a client from another workspace. - You cannot update a timer using a project outside the active workspace. - You cannot fetch workspace records from a different workspace using the wrong workspace ID. These rules help prevent accidental data leaks, incorrect reporting, and cross-workspace billing mistakes. If an API request references a project, client, tag, timer, or time entry from another workspace, Timether will block the request. Workspace membership fields Workspace membership objects may include planning and cost fields for team management. These fields are: { "expected_weekly_capacity_hours": 40, "internal_hourly_cost_cents": 3500 } expected_weekly_capacity_hours expected_weekly_capacity_hours stores the number of hours a workspace member is expected to work in a typical week. For example: { "expected_weekly_capacity_hours": 40 } This value can be used for capacity utilization reporting. For example, if a member tracks 32 hours in a week and their expected weekly capacity is 40 hours, their utilization is 80%. internal_hourly_cost_cents internal_hourly_cost_cents stores the internal hourly cost of a workspace member in integer cents. For example, an internal cost of $35.00/hour is stored as: { "internal_hourly_cost_cents": 3500 } Using integer cents helps avoid rounding issues in cost and profitability calculations. This value is used for internal reporting, such as billable vs. non-billable cost breakdowns and project profit margin calculations. Access restrictions for member planning fields The expected_weekly_capacity_hours and internal_hourly_cost_cents fields are restricted to Owner and Manager roles. Regular Members and Viewers cannot view or manage these values. This is because capacity and internal cost data may include sensitive business information. If an API token is used by a user who does not have permission to access these fields, Timether may hide the fields or reject attempts to update them. Updating member capacity and internal cost Owners and Managers can update member planning fields through supported workspace membership endpoints. When updating these values, send the new values as part of the membership update request. Example request body: { "expected_weekly_capacity_hours": 40, "internal_hourly_cost_cents": 3500 } Use clear internal rules for these values so reporting stays consistent across the workspace. For example, decide whether internal hourly cost should represent salary cost, contractor cost, blended cost, or another internal accounting method. Internal cost snapshot behavior When a time entry is created, Timether snapshots the member’s current internal hourly cost onto that time entry. This keeps historical cost and profitability reports accurate. For example, if a member’s internal cost is $35/hour when a time entry is created, that entry keeps the $35/hour cost. If the member’s internal cost is later changed to $45/hour, older time entries keep the original cost. Future time entries use the updated cost. This prevents old reports from changing unexpectedly when member costs are updated. Handling permission errors If your API request fails while reading or updating member capacity or internal cost fields, check the following: 1. The API token is valid. 2. The request includes the correct X-Workspace-Id header. 3. The token belongs to a user with access to that workspace. 4. The user has an Owner or Manager role. 5. The workspace is on a Team or Business plan. 6. The workspace is not in a billing read-only state for write requests. If the user does not have the correct role, use an Owner or Manager account to perform the request. Token security API tokens should be treated like passwords. Do not expose tokens in client-side code, public repositories, screenshots, shared documents, or browser-based scripts. Use environment variables or a secure secrets manager when storing tokens in applications. If a token is no longer needed or may have been exposed, revoke it from the API token settings and create a new one.