Tim Time Tracker Help
App Usage
The app is not showing in the menu bar
macOS hides menu bar items if there isn't enough space. Try closing other items or you can reorder the app to the right by holding ⌘ command and dragging the icon
Can I import data from another time tracking app?
Tim expects a specific JSON format to import, however some open source conversion tools are available.
See integrations.How do I control the date format and the first day of the week?
This is set by your macOS System Settings -> General -> Language & Region
Where are backup files located?
Settings -> Backups -> View Backups
Default location:~/Library/Containers/neat.software.Tim/Data/Documents/BackupsWhere is the live data file located?
~/Library/Containers/neat.software.Tim/Data/Library/Preferences/neat.software.Tim.plist
Contact us if you need it decrypted to an importable file.Where can I find crash reports?
Enter this command into Terminal:
f=$(ls ~/Library/Logs/DiagnosticReports/Tim-\*.ips 2>&1|head -1);\[\[ -f "$f" \]\]&&open -R "$f"||echo -e "\\nNo Crash Reports Found\\n"
You can contact us and send us any crash files.Can I export data from the command line?
To pipe data to a file:
osascript -e 'tell application "Tim" to export' > data.json
Purchases
What does the Pro version include?
See the Pro info page
Where do I enter my license key?
If you bought the app directly and were issued a license key code, you don't have to enter it anywhere. The direct purchase version already comes fully Pro unlocked. Please save it for support purposes. If you need assistance or need to be reissued a copy, we can verify your purchase with the key.
I am unable to restore my previous App Store purchase:
Make sure you are signed into the App Store with the account you made the original purchase with.
If you bought the app prior to version 7.0 (Oct 2022), the purchase currently cannot be restored in the app. The reason being the older version was paid upfront and newer versions are free with an in-app purchase upgrade, so the product SKU is different. You can contact us with your receipt and we will issue you a promo code.
On the upgrade screen in the app, click the "More" button in the bottom right, then "Redeem Code". Enter the promo code into the App Store window that pops up and the app will upgrade automatically.
Since the app has a free version to try, we generally do not offer refunds on upgrades. If you bought the app through the App Store, you can request a refund from Apple at their discretion.
Do you offer a discount for students?
Please visit Student App Centre which will verify your student status and provide you a discount code.
Documentation
- AppleScript: To view all commands, open the Script Editor app then File -> Open Dictionary... -> Tim.app
Examples:
tell application "Tim" to export
tell application "Tim" to import POSIX file "/path/to/file.json"
tell application "Tim" to createTask title "Task B"
tell application "Tim" to getTask "Task A"
tell application "Tim" to startTask "D43FA035-6406-495D-9ADD-46721986040F"
- Shortcuts: Open the Shortcuts app then locate Tim in the Apps tab. You can then build shortcuts in the UI.
- x-callback-url: Tim supports the x-callback-url standard, allowing a calling app to receive information. You can use
tim://x-callback-url/getCurrentUrl?x-success=https://www.apple.comto get the current Tim deep link url and pass it to the specified x-success url. - Deep Links:
tim://- Is the url scheme & will open the apptim://\[id\]- Go to a task/group by ID. You can copy the id from the task/group edit window and click the info button.tim://\[id\]?action=start¬es=My%20Notes- Start a task timer by id with optional record notes.tim://?action=stop- Stop any running timer.tim://create?type=\[task|group\]&title=My%20Title¬es=My%20Notes- Create a new task/group. Additional fields are optional.