Please reach out to me if you have any other questions, I am usually very quick to respond!
When the app initially runs, first visit each of your Spaces so the app can learn about them. As you move through your Spaces, it will then automatically create a Room assigned to that Space, which you can then name (and jump directly back to, etc). Before you visit each Space, the app will not know about them.
Make sure the app's dock icon setting is correct — it should be set to "None":
Also, the app needs this menubar setting enabled (if you want it to operate without a menubar icon, you can select that option within the app's Advanced Settings screen):
If you use window tiling or workspace managers like yabai, hammerspoon, or Magnet, please make sure those apps are set to ignore CurrentKey. Here's an example with Magnet:
Some window management apps rearrange windows across Spaces in ways that can cause unexpected Room switches. Adjusting your tiling app's settings to prevent moving windows between Spaces usually resolves this.
When the app is closed and reopened, it will try its best to reassign Rooms correctly but sometimes gets it wrong.
One thing you can do to help the app figure out which Rooms belong to which Spaces: set a unique desktop background image for your different Spaces (ideally a static image like .png or .jpg — not the dynamic time-of-day ones from Apple). This isn't necessary, but if you quit the app frequently, it can help CurrentKey wrangle with the situation and restore your Rooms more successfully.
If you frequently use clamshell mode, plug in more than one external display at a time, or if your display resolutions change when displays are lost or added, Apple's window manager unfortunately mixes things up, and it can lead to CurrentKey getting confused.
Normally it's not a big deal, but under these conditions/usage patterns, CurrentKey performs better when "Displays have separate Spaces" is turned off.
Please reach out to me and I will get back to you ASAP (probably within a couple of hours unless I'm asleep) and help you get it working. I seriously LOVE it when users give me feedback.
Yes. Thanks to a recent (and gradual) rebranding, the app can go by either, though it will increasingly be referred to as CurrentKey in public settings. The app's name as it runs on the Mac is still CurrentKey Stats.
Absolutely! The app was designed to support multiple screens. That means you can look back and see how you used apps on specific screens (that have unique Spaces/desktops). Each display can have its own set of Rooms (up to 16 per screen), and stats are tracked across all of them.
Note: I am continuing to improve the multi-screen experience, and if you use multiple screens regularly, I would love to hear your feedback!
Yes there is! Here are the latest blog posts. The blog is the best place to find release notes, tips, and feature announcements. You can also check the App Store listing for version history.
Mac lets you create virtual desktops (it refers to them as Spaces). CurrentKey refers to them as Rooms: places that you can customize for their specific purpose.
Read more about the basics: Apple support article
Each Room can have a custom name and icon. You can set up to 16 Rooms per screen. Choose from 250+ built-in icons with color options, or use any emoji. "Travel Planning" > "Desktop 2".
Jump to any Room instantly with hotkeys. Set them up via CurrentKey's built-in settings, or use AppleScript's gotoroom command wired to a keyboard shortcut, Stream Deck, or Raycast. For a quick walkthrough, see the Room Manager Guide.
After you make changes in Mac preferences, you have to restart your computer. To enable system-wide hotkeys, add CurrentKey Stats to the list of apps in System Preferences.
Great question! Split your projects and various interests into different Rooms (Macs allow up to 16 virtual desktops per screen). Give each Room a name that corresponds with a project, be they for work like "Client #3" or personal stuff like "Travel Planning".
To jump to a Room, click the dropdown by the Room name and select the one you want. You can also jump via hotkeys or an AppleScript command.
Throughout CurrentKey's graphs and charts, you'll be able to narrow your focus on how you spent time in a specific Room.
Even if you use your Mac for work, you probably also use it for a ton of other things. The distractions can be real.
Try this: create a new Room and give it a name like "Gaming", "Pinning", or "binge watching" — whatever your recent obsession may be. Any time you're doing those activities, switch to that Room. At the end of the day you can see how much time was spent on the sweet distractions!
Getting that shown in blocks of real time can really transform your world! If you'd rather not procrastinate, consider changing that Room's icon to the stop sign in bright red for a subtle reminder. If you want to use it as a reward, maybe the ice cream icon in a soothing purple is more your speed.
Once you start to understand your habits, you can start to use them to your advantage!
They should! CurrentKey was designed to do its absolute best to restore your Rooms, and it works pretty well. If you're running into issues, two things can help:
The stats are collected while CurrentKey is running. The app detects mouse-cursor movement or app-switches to know if you are "active" or not. After a user-picked duration of inactivity (set in Settings via the "How long before CurrentKey considers your computer inactive?" option), the app will stop counting time as active.
Inactive sessions also start when your screen saver or login screen activates. If you are watching long videos or using apps like Amphetamine to keep your Mac from sleeping while idle (or only interacting via a non-mouse device like a game controller), you may consider upping the inactivity threshold and remembering to move the mouse cursor every so often.
Do you ever stay up past midnight using your computer? I do! And I wanted stats for any given day to reflect that, so you can either tell CurrentKey to consider everything after midnight OR after 4 AM the beginning of a new day. Change it in your settings (found by clicking the gear icon).
Here's to my fellow night owls!
This preference is reflected both in the popup's "summary view" as well as each of the "day-by-day" bar charts. If you've toggled the "4am" setting on, there will be a reminder on charts and exported reports to that effect.
You can download .csv data reports for every chart included in the app (a total of 11 pie and bar charts), so you can go back to your logs at any time. Stats views include a view for app usage across the past 30 days, a comparison of this week versus last week hour-by-hour, and a larger display window to view app stats in.
While CurrentKey always rounds to the minute and strives to keep things as accurate as possible, software is complex and may not always be perfectly accurate. Hopefully the stats give you nice high-level insights (and better than ScreenTime!). Always use your best judgement and appraise the stats with a discerning eye.
If you see a bug, please let me know and I'll try to fix it!
Yes they can! You can pick from 250+ custom icons and give them a custom color, or you can set any emoji you want. You can also import your own custom icon images.
The "App Stats" graphs can get a bit cluttered if you include all the apps you've used, including the ones with very little time. You can set a minimum threshold of time needed to make the cut for your charts to keep everything cleaner.
Check out the settings panel (shown by a gear icon) to fully customize the threshold to make sense for how you work.
By default, a new "day" starts at midnight. But if you're a night owl, you can change it to 4 AM so late-night sessions are counted as part of the previous day. The preference is reflected in charts and exported reports.
Still have questions?