What features can I expect in the (near) future?
Keep an eye on the issue list, where you can see the things that are on the roadmap. You can also let us know your interests by adding a thumbs-up to the issues corresponding to certain features, or leave a comment (you need a Github account for that).
How can I request a feature?
First check the issue list whether the issue has been requested already. If so, hit the thumbs-up sign to let us know your interest (you need to be logged in with Github for this). Otherwise, create a new issue (if you have an account with Github) or send an email.
I think I discovered a bug, what should I do?
First check the issue list whether the bug is already known. If not, please create a new issue or send an email.
Can I help implement a new feature?
Yes, you can! I suggest you make an issue, or a PR with a proof of concept so we can discuss early on whether this is something we agree should be part of TimeTagger. Not all suggestions will be accepted though - TimeTagger must stay a robust and coherent application.
In any case, you can tweak TimeTagger to your liking and run it yourself locally.
What browsers are supported?
Supported browsers include Firefox, Chrome, Safari, Edge, and their mobile counterparts.
Does TimeTagger work on mobile devices?
Yes, the TimeTagger app is designed to work well on small screens. Simply open it in your mobile webbrowser. If it does not work with your standard browser, try installing Firefox or Chrome.
TimeTagger can also be installed as a native app on Android and iOS: open the app (https://timetagger.app/app) in your phone's browser, and select "Add to homescreen". Some devices will show a prompt, in others you may find the option in the menu.
Is TimeTagger available via Google Play / the Appstore?
No, but you can still install it: TimeTagger is designed as a Progressive Web App (PWA), which makes it possible to install it outside of the playstore/appstore. Open the app (https://timetagger.app/app) in your phone's browser, and select "Add to homescreen". Some devices will show a prompt, in others you may find the option in the menu.
At some point we may add it to the official stores to make it easier for users to discover and install TimeTagger.
Can TimeTagger be run as a desktop app?
Yes. Open the app in the Chrome browser, and then click "Install TimeTagger App" (or similar) in the address bar.
Can TimeTagger be used off-line?
Yes, in any way you are using TimeTagger (from a browser, mobile app, or desktop app), the TimeTagger app page will still work when there is no internet connection.
New records (and changes to existing records) are stored in the browser/application cache. Therefore, when you don't have an internet connection (e.g. while traveling), you can safely use TimeTagger and let it sync later. You can safely close the browser, but note that the local data is cleared when you log out.
Is there a dark mode?
Yes, it can be enabled via the settings dialog (☰ settings).
How can I edit a record?
You can click on a record in the timeline and then drag it or change the start and end time. You can also click on a record description (in the main view or in the report dialog) to open the record dialog.
How can I use tags to organize my time records?
In TimeTagger tags are used instead of projects. This means you can for instance use the tags "#paid", "#client1", and "#writing" in a single record. TimeTagger will display an overview of the tags in a smart way.
If you prefer a more project-like approach, you can also use a single tag, e.g. "#paid/client1/writing".
What characters are allowed in tags?
All alphanumeric characters can be used, including special characters like ë or é. Further, the dash, underscore, and forward slash are allowed.
How can I find all records with a certain tag?
With the tag manage dialog (☰ manage tags) you can search for tags, and all matching records will be shown.
How can I manage the tag names?
With the tag manage dialog (☰ manage tags) you can search and rename tags. Some strategies that can be applied:
- Rename a tag: replace a single tag with another single tag.
- Remove a tag: remove a tag with nothing.
- Split a tag in two: replace e.g.
- Merge two tags: replace e.g.
Is my data being backed up?
Yes. We run daily backups on all user data. Backups are purged using a smart system that keeps the first backup of the week and month. This way we have backups of up to 2 months back. There is currently no way for users to restore a backup, but if you really messed up, you can do a request to restore from a backup.
We also perform monthly offsite backups (to a different datacentre), just in case.
Should I perform backups myself?
We're confident that we have you covered. But it does not hurt to do a full export before doing something like renaming a lot of tags.
Why is the price so low?
The price can be much lower than most competitive services because we don't have a free tier. All users (except those on a trial) are paid users.
What are the advantages of using the service rather than hosting it myself?
- You don't have to manage a server and deal with updates.
- Authentication: if you want to use TimeTagger on multiple devices, you'd need to run it on a server and implement authentication. We've got that covered.
- Backups of your data.
- The generated income allows us to keep improving TimeTagger.
Can I use TimeTagger for free?
Since TimeTagger is open source software, you can run it yourself by cloning/downloading from the Github repo. This requires some programming skills though.
When you make use of the service at https://timetagger.app, you have a right to a free 14-day trial. If you think you need a longer trial, you may ask for it via the email address above, and I will consider it :)
How can I purchase a subscription?
You must first sign up for an account. By default you are on the trial. You can then purchase a subscription via the account page. The purchase is handled by Paddle, which results in a simple and secure checkout experience.
Do the prices include VAT?
Yes, all prices include VAT. The amount of VAT depends on your country and whether you represent a company. The VAT is calculated automatically and will be shown on your invoice.
Can I purchase a subscription if I don't have a creditcard?
The payment service allows payments with creditcard, Paypal and Apple Pay. If you prefer to pay from your bank account, you can connect your bank account with a Paypal account, and then pay via Paypal.
Can I purchase a subscription for my business?
Yes, you can! During the checkout, you can enter your VAT number and company details. You can also edit these details on the invoice.
Can I purchase multiple subscriptions at once?
Yes, to purchase multiple subscriptions ( 5+), please contact us via email.
Where can I find my invoices?
Invoices are sent via email, and can also be accessed via the account page.
What is the billing period?
Billing occurs on a yearly basis. Monthly billing is not feasible because the price is so low that the transaction costs would dominate the price.
How can I cancel my subscription?
You can cancel your subscription from the account page. This will bring you back to the trial if it has not expired yet. You can always still export your data. Your data is not removed unless you make a request for your data to be deleted.
How can I import data?
TimeTagger can import time records from Excel or CSV files, e.g. to restore from your own backup, or to import time records from another tracker. Importing should just work for time records exported by Yast, Timechimp, TimeTurtle, and possibly other trackers too.
In the app, open the import dialog (☰ import). It is recommended to first try importing your data in the sandbox so you can check that the import has the expected result.
If you have trouble getting the import to work, open your data in a spreadsheet (e.g. Excel, Libre Office, Google sheets) and see if it might need a change in the header names, or perhaps a small conversion. Below you'll find the technical details on what TimeTagger expects for imported data.
Alternatively, feel free to open an issue or send an (anonymised) sample of your time tracking data, so that support for your data can be added, or we can help you convert it.
How should my import-data be formatted?
The import data should consist of rows, where each row represents one record, and the top row is the header. Values on a row can be separated with either tab, comma, or semicolon (this is automatically detected). Wrapping values in double-quotes (as is common in CSV files) is supported.
The supported headers are listed below. Common aliases for each field are automatically converted. Each record should be resolvable into at least a start time and a stop time.
- key: existing records are replaced if they match the given key/id. If no key is provided, existing records are replaced if the start/stop times match.
- tag / project: the tag or project name associated with the record.
- start time: a Unix timestamp or other date-time string (e.g. ISO 8601).
- stop time: a Unix timestamp or other date-time string (e.g. ISO 8601).
- description: the description/comment. Newlines and tabs are removed.
Additional headers are supported to deal with exports of other trackers:
- date: if given, the start time can also be in `hh:mm` or `hh:mm:ss` format.
- duration: can be `hh:mm`, `hh:mm:ss`, or simply the number of seconds. Is used when the stop time is not of the preferred format.
How do I convert my imported projects into proper tags?
Many time trackers use project labels. If you have imported time tracking data from elsewhere, your tags may look a bit out of place. Via the tag manage dialog (☰ manage tags) you can rename tags, or e.g. split a tag name into multiple components.
How can I export records of a certain time period?
TimeTagger has two export mechanisms: the report and the full export.
The report dialog (which opens via the report button) produces a table that can be saved as PDF or copied into a spreadsheet. The latter can be convenient if you want to process data for a certain tag and time period. It can also represent durations in decimal hours, which is usually easier to process in a spreadsheet.
How can I do a full export of all my data?
The full export dialog (☰ export) produces a table that contains the data of all your records. The table can be copied into a text file (as tab-separated values) or a spreadsheet (e.g. Excel or Libre office), and has the following columns: key, start, stop, tags, description. The output of a full export gives you access to your "raw" data, and can e.g. be used in the import dialog.
What date-time format should I use for a full export?
You can chose between local format, Unix timestamps, or the ISO 8601 standard format. You'd think that the ISO version works best, but it turns out most spreadsheet programs like the local date-time format best (and therefore this is the default). The downside of this format is that it is ambiguous due to its lack of time zone information.
Like this style of FAQ? Checkout FAQ-div!