Documentation / Start here
Getting started
Complete first-run setup, understand consent and macOS access, and record your first task.
On this page
Before you begin
- Install: download WorkSealed from the Mac App Store, then launch it from Applications.
- Use the menu bar: the menu-bar app runs tracking and opens the main window for managing work.
- Account: no WorkSealed account is required.
In the App Store edition, use the purchase window to start the 30-day free trial, buy the app, or restore an existing purchase. Starting the trial does not authorize an automatic paid charge. See Purchase for access after the trial ends.
Step 1: quick setup
On the welcome screen, enter:
- Client name: who you will bill.
- Project name: the work you are doing for that client.
- First task: the activity you want to track first.
- Hourly rate and Currency: the client’s starting rate and ISO currency code, such as
USD.
Choose . Projects and tasks inherit the client’s rate unless you set an override later. You can rename these items and create more after setup.
Step 2: recording consent
- Read the activity-recording disclosure.
- Explicitly consent to recording while tracking is running. Consent is separate from macOS permissions.
- Start a timer only when ready by pressing . Granting consent does not start one.
Consent rules:
- Required for tracking: a timer cannot start without consent.
- Defer recording: if a later consent screen offers , use it to leave recording off.
- Change your choice: open → .
- Withdraw consent: immediately stop an active session and prevent further recording. Existing work logs remain.
Choose external timestamps
Select one of the first-run choices:
- External timestamps: periodically send a cryptographic fingerprint of sealed history to an independent timestamp authority. This adds independent time evidence to exported work.
- Offline only: keep sealing local and make no timestamp-authority requests. Your evidence has no independent proof of its creation time.
The setup screen lists FreeTSA, DigiCert, and Sectigo; enabled providers are tried in rotation until one responds. You can change the mode and providers under Settings → Anchoring.
Choose local history protection
Setup also asks whether to use macOS Keychain for a local history checkpoint. Choose Use macOS Keychain for local history protection or Continue without Keychain. Both let you track, sign, invoice, and export. This choice is separate from recording consent and optional macOS permissions. You can change it under Settings → Security.
Optional macOS permissions
The App Store edition offers two optional permissions:
| Permission | What it adds | If you leave it off |
|---|---|---|
| Screen & System Audio Recording | Access to other apps’ window titles. WorkSealed does not capture pixels or audio. | Time, app activity, and invoicing still work; window titles remain empty. |
| Notifications | Alerts for idle sessions, service restarts, and completed restores. | Idle decisions remain available in the menu-bar popover. |
- Use or on the permission card.
- If a restart is required, quit the menu-bar app and reopen it. Closing the main window alone does not restart the recording process.
The App Store edition does not request Accessibility or Input Monitoring. A direct edition can use Accessibility for window-title access instead. See Permissions for the edition-specific explanation.
Start and stop your first task
- Choose after completing the required choices.
- Open the menu-bar popover and choose your first task through . Use the main window’s list to manage its properties.
- Press when work begins. Confirm the popover shows Tracking and the intended task.
- Press when you finish. Review the new records in .
If you cannot start, check:
- Consent: activity recording must be authorized.
- Access: the App Store edition needs valid trial or purchase access.
- Budget: a stop-tracking limit may prevent task activation.
Before sending your first invoice
- Set sender details in Business.
- Set invoice defaults in Billing.
- Review your work logs, then create an invoice.
- Choose a backup destination in Backup & Restore. You are responsible for backing up the local database.
Need a hand? Contact support.