Docs Contact support
Docs menu

Installing and signing in

Install the free Mac app, point it at your server, and sign in. What it keeps on your Mac, and how to sign out.

Updated Nov 14, 2026 4 min read

The Mac app is a free timer for your ChronoSlice server that lives in the menu bar. This page covers installing it, signing in, its settings, updates, and signing out.

What you need

  • A Mac with macOS 26 or later.
  • A ChronoSlice server that your Mac can reach over HTTPS. The app accepts a plain http:// address only for a local server: localhost, an address starting 127., or a name ending in .local or .test. See Reverse proxy and HTTPS.
  • An account on that server, with a password. If your account came from a Toggl Track import, give it a password first with chronoslice user set-password. See Command reference.

Install it

Download the app from chronoslice.app. It comes as a disk image. Open it and move ChronoSlice to your Applications folder, then open it. The app is signed by its developer and notarized by Apple.

Sign in

  1. Open ChronoSlice. The window asks for a Server, an Email and a Password.
  2. Type your server's address in Server, such as https://time.example.com. The box starts filled in with a different address, so replace it.
  3. Enter your email and password, and press Sign In.

You can leave out https://. The app adds http:// for local addresses (localhost, 127. addresses, and names ending in .local or .test) and https:// for the rest.

If you see That email and password don't match., check both. This account isn't in an organization yet. means the account has no organization to work in. The app works in the first organization your account belongs to, in alphabetical order by name.

What it keeps

The app signs in with your password once, then asks the server for an API token for this Mac, and forgets the password. The token is named ChronoSlice for Mac followed by your Mac's name, and it lives in your Keychain. You'll see it in Settings, under API tokens in the web app. See API tokens.

The app also keeps a copy of your time on your Mac, so it works offline. See Working offline and sync.

There's no sign-in through the browser or with a passkey yet.

Settings

Open Settings from the menu bar panel or with Command-comma.

General

  • Open ChronoSlice when you log in.
  • Open the timer panel with ⌃⌥T from anywhere. Turn the shortcut off here.
  • Appearance: System, Dark or Light.
  • Week starts on: the account's setting, Sunday or Monday.
  • Ask about idle time, and After N minutes away, from 1 to 120, 10 by default. When a timer runs and you've been away, or the Mac slept, that long, ChronoSlice asks whether to Keep It, Discard and Continue, or Discard and Stop.
  • Check for updates automatically, and Check for Updates….

Account

  • Your name, email, organization, server and time zone.
  • Sync, with the number of changes waiting, and Sync Now.
  • Sign Out…

Updates

The app updates itself. Check for Updates… is in the ChronoSlice menu and in Settings, and the app also checks automatically. This is separate from updating the server. See Updating.

Sign out

Press Sign Out… in Settings. It revokes this Mac's token on the server and deletes the local copy of your time. Everything that already synced stays on the server. If changes haven't synced yet, the app counts them and warns that they'll be lost if you sign out now. Choose Sign Out and Lose Them only if you don't need them, or reconnect to the server first.

If the server stops accepting the token, for example because you revoked it in the web app, the app says Your session ended. Sign in again to keep syncing. It keeps your local data for when you sign in again.

Was this helpful?

Still stuck?

Send us a request: it goes to the people who build ChronoSlice, and the reply comes by email. Include your ChronoSlice version (Settings › Licence shows it) and what you tried.