Home Time Tracking & Timer

Time Tracking & Timer

By Lahiru Himesh Madusanka
4 articles

Getting Started with the Timether Timer

Tracking time in real time from the dashboard Timether lets you track your work as it happens using the timer on your main dashboard. This is useful when you want to start working now and save the exact time later as a time entry. The dashboard timer is designed to be quick and simple: choose what you are working on, start the timer, pause when needed, and save it once the work is done. Starting the timer To start tracking time: 1. Go to your main dashboard. 2. Select the project you are working on. 3. Add any task or description if needed. 4. Click Start ▶. Once started, the timer will begin counting your active work time. Your timer state is saved automatically, so it stays linked to your user account and workspace. This means the active timer can continue from where it left off within the same workspace, even if you refresh the page or come back later. Pausing the timer If you need to take a break, click Pause. Pausing stops the timer temporarily without clearing the tracked time. This is useful when you are stepping away, switching context briefly, or taking a break that should not be counted as work time. Resuming the timer When you are ready to continue, click Resume. The timer will continue from the time already tracked instead of starting again from zero. Saving the timer as a time entry When you finish the work, click Save. Saving commits the active timer into a permanent time entry. Once saved, the tracked time will be added to your timesheet or project records. When you save a timer entry, Timether uses the selected project to automatically apply the correct billing details. How billable status and hourly rate are applied When you select a project for the timer, Timether automatically uses that project’s billing settings for the new time entry. If the project is billable, the saved time entry will also be marked as billable by default. Timether also applies the project’s hourly rate automatically. The hourly rate is stored internally in cents to keep billing calculations accurate. For example, an hourly rate is saved as an integer value in cents rather than as a rounded decimal amount. This helps avoid calculation issues and keeps your billing records consistent. Resetting the active timer If you started a timer by mistake or no longer want to keep the tracked time, click Reset. Resetting clears the active timer without saving it. Use Reset only when you want to discard the current timer. Once reset, the tracked time is removed from the active timer and will not be added as a time entry. Timer states are saved per user and workspace Your active timer is saved separately for each user and workspace. This means your timer belongs only to your account inside the current workspace. Other users will not see or control your active timer, and timers from one workspace will not mix with another workspace. This makes it easier to work across different teams, clients, or businesses without accidentally tracking time in the wrong place.

Last updated on May 19, 2026

Manually logging and editing time entries

Manually logging and editing time entries Sometimes you may need to add time manually instead of using the timer. For example, you might have forgotten to start the timer, worked offline, or need to record time from a meeting or call. Timether lets you manually create, edit, and delete time entries from your workspace, while still keeping your billing and invoice records accurate. Manually adding a time entry To create a time entry manually: 1. Go to your time entries or timesheet section. 2. Click Add Time Entry. 3. Enter a short description of the work. 4. Select the project the work belongs to. 5. Enter the duration. 6. Choose the date and time when the work happened. 7. Add any tags if needed. 8. Review the billable status and rate. 9. Save the entry. Once saved, the time entry will be added to your workspace and can be used for reporting, project tracking, and invoicing. What details can be added? When creating a manual time entry, you can include the main information needed to describe and bill the work properly. The description explains what the time was spent on. This can be a short note such as “Client meeting”, “Bug fixing”, or “Homepage design updates”. The duration records how much time was spent on the work. The project connects the entry to the correct client or project. This helps keep reports, totals, and invoices organized. The date and time show when the work occurred. You can also add tags to group or filter entries later. Tags are useful for marking types of work such as design, development, meetings, support, or research. The rate is used for billable work. Depending on the selected project, Timether may automatically apply the project’s hourly rate and billable status. Validation rules Before a manual time entry can be saved, Timether checks that the required details are valid. The duration must be greater than zero. You cannot save a time entry with a zero or negative duration. The occurred date and time are also required. This tells Timether when the work actually happened and helps keep reports and invoices accurate. If any required information is missing or invalid, Timether will ask you to correct it before saving the entry. Editing an existing time entry To edit a time entry: 1. Open the time entry you want to update. 2. Change the required details, such as the description, duration, project, tags, rate, or date. 3. Save your changes. Editing is useful when you need to correct a mistake, update the description, move the entry to a different project, or adjust the duration. However, some time entries may be locked if they are already connected to an invoice. Deleting a time entry To delete a time entry: 1. Open the time entry you want to remove. 2. Click Delete. 3. Confirm the action. Deleting removes the time entry from your workspace records. Only delete an entry if you are sure it is no longer needed. If the entry has already been included in an invoice, it may not be possible to delete it until the invoice connection is removed. Why some time entries are locked Timether protects time entries that have already been used for invoicing. If a time entry has been compiled into an active invoice, it becomes locked. Locked entries cannot be edited or deleted because changing them could affect invoice totals, billing records, and client-facing documents. This applies to invoices with the following statuses: - Draft - Sent - Paid Even if an invoice is still in draft, the time entries connected to it are treated as locked while the invoice remains active. How to unlock an invoiced time entry To edit or delete a locked time entry, the invoice connection must be removed first. This can be done by either voiding the invoice or detaching the related line item from the invoice. Once the time entry is no longer connected to an active, non-voided invoice, it can be modified or deleted again. This locking behavior helps keep your invoices reliable and prevents accidental changes to time that has already been prepared for billing.

Last updated on May 19, 2026

Connecting first-party apps and browser extensions

Connecting first-party apps and browser extensions Timether works with companion clients such as the Chrome extension, Firefox extension, desktop app, and mobile apps. These apps help you track time more easily from the tools and devices you already use. To connect a Timether companion app, you need to sign in to your Timether cloud account and authorize the app for the correct workspace. Plan requirement First-party app access is available on paid plans that include the first_party_app_access entitlement. This is included in: - Solo Pro - Team - Business First-party app access is not available on the Free plan. If you are using the Free plan, you may need to upgrade before connecting Timether’s browser extensions, desktop app, or mobile apps to your cloud account. How the connection flow works Timether uses a secure connect flow for first-party apps. When you connect a browser extension or companion app, the app will open Timether in your browser and ask you to sign in if you are not already signed in. After you choose the workspace and approve the connection, Timether sends the app back a secure access token and workspace ID. The access token usually starts with tthr_. This token allows the companion app to communicate with your Timether account for the selected workspace. You do not need to manually copy or paste this token in most cases. The app should receive it automatically after the connection is approved. Connecting the Chrome extension To connect the Timether Chrome extension: 1. Install the Timether Chrome extension. 2. Open the extension from your browser toolbar. 3. Click Connect Timether or Sign in. 4. A Timether sign-in page will open. 5. Sign in to your Timether account. 6. Select the workspace you want to connect. 7. Approve the connection. Once approved, the extension will return to Chrome and complete the connection automatically. After connecting, the extension will be linked to the selected workspace. Any time tracking actions from the extension will use that workspace. Connecting the Firefox extension To connect the Timether Firefox extension: 1. Install the Timether Firefox extension. 2. Open the extension from your browser toolbar. 3. Click Connect Timether or Sign in. 4. Sign in to your Timether account when prompted. 5. Select the workspace you want to use. 6. Approve the connection. After approval, Timether will redirect back to the Firefox extension with the required connection details. The extension will then use the connected workspace for time tracking. Connecting the desktop app To connect the Timether desktop app: 1. Open the Timether desktop app. 2. Click Connect account or Sign in. 3. Your browser will open the Timether sign-in page. 4. Sign in to your Timether account. 5. Select the workspace you want to connect. 6. Approve the connection. After approval, return to the desktop app. The app should complete the connection automatically. If the app does not update immediately, try reopening it or using the connect option again. Connecting the mobile app To connect the Timether mobile app: 1. Open the Timether mobile app. 2. Tap Sign in or Connect account. 3. Sign in using your Timether account. 4. Choose the workspace you want to use. 5. Approve the connection. Once connected, the mobile app will use your selected workspace for time tracking and related actions. Workspace selection When connecting a companion app, make sure you select the correct workspace. The app connection is scoped to the workspace you approve during the connect flow. This helps keep time entries, projects, clients, and settings separated between different teams or businesses. If you work across multiple workspaces, you may need to reconnect or switch workspace depending on the app you are using. Browser extension redirect safety For security, Timether only allows browser extension redirects to approved URL formats. Chrome extension redirect URLs must end with: - .chromiumapp.org Firefox extension redirect URLs must either end with: - .extensions.allizom.org - .extensions.mozilla.org Or use the local Firefox OAuth redirect format: - http://127.0.0.1/mozoauth2/ These rules help make sure that connection tokens are only returned to trusted browser extension redirect URLs. About the connection token During the connect flow, Timether creates a secure token for the companion app. This token usually begins with tthr_. The token is used by the app to access your Timether account for the selected workspace. You should not share this token with anyone. Treat it like a password because it allows access to your Timether workspace through the connected app. If you think a token or app connection has been exposed, disconnect the app from your account settings and reconnect it again. Troubleshooting If you cannot connect a companion app, first check whether your current plan includes first-party app access. If the connection page opens but does not return to the app, make sure you are using the official Timether app or extension. For browser extensions, the redirect URL must match Timether’s allowed safety rules. Unsupported redirect URLs will be blocked for security reasons. If the app connects to the wrong workspace, disconnect it and repeat the connect flow, then choose the correct workspace during approval.

Last updated on May 19, 2026

Tracking time directly from browser tabs

Tracking time directly from browser tabs Timether’s browser extensions make it easier to remember exactly what you were working on by capturing details from your active browser tab. This is useful when your work happens across websites, documents, dashboards, project tools, design tools, admin panels, or client portals. Instead of manually typing what you were doing, you can capture the current tab and add it to your active timer. What tab capture does When you use the Timether browser extension, it can read the title and URL of your active browser tab. For example, if you are working on a client proposal, the extension can capture details like: **Proposal - Acme - **https://example.com/proposal These details can then be added to your active timer description, making your time entry easier to understand later. Using the Capture action To capture your current browser tab: 1. Open the page you are working on. 2. Click the Timether browser extension. 3. Make sure you have an active timer running. 4. Click Capture. Timether will take the active tab’s title and URL, then add those details to your active timer description. Depending on how your timer description is currently written, the captured tab details may be added before or after the existing description. What gets captured The browser extension can capture: - The active browser tab title - The active browser tab URL This helps create a clearer record of what you were doing while the timer was running. For example, your timer description may become: **Homepage updates - **https://clientsite.com/admin/pages/home Or: **Proposal - Acme - **https://example.com/proposal This is especially useful when you review your time entries later or prepare reports and invoices. How it works behind the scenes When you click Capture, the Timether browser extension sends the captured tab details to Timether using the timer capture action. This is handled through: POST /api/v1/timer/capture Timether then updates the active timer description by adding the browser tab title and URL. The timer itself continues running. Capture only updates the description of the active timer; it does not stop, pause, reset, or save the timer. Why this is useful Tab capture is helpful when your work moves quickly and you do not want to stop and write detailed notes every time. Developers can capture issue pages, pull requests, documentation, staging links, or admin screens. Designers can capture design files, reference pages, client websites, or review links. Marketers can capture campaign dashboards, analytics reports, landing pages, ad platforms, or content briefs. This gives you a better memory trail of what you worked on, without adding extra friction to your workflow. When to use tab capture Use tab capture when the current browser tab gives useful context about the work you are doing. For example, you might capture a tab when you are: - Reviewing a client page - Working on a proposal - Debugging an issue - Updating website content - Checking analytics - Preparing a report - Researching a topic - Managing a campaign The captured title and URL make the final time entry more meaningful and easier to recognize later. Privacy and control The extension only captures the tab details when you choose to use the Capture action. It does not automatically add every page you visit to your timer description. You stay in control of what gets added to your timer. If a captured title or URL is not useful, you can edit the timer description before saving the time entry.

Last updated on May 19, 2026