Read the current Focus mode on macOS Monterey (12.0+) using JavaScript for Automation (JXA)

get-focus-mode.js

const app = Application.currentApplication()
app.includeStandardAdditions = true

function getJSON(path) {
	const fullPath = path.replace(/^~/, app.pathTo('home folder'))
	const contents = app.read(fullPath)
	return JSON.parse(contents)
}

function run() {

	let focus = "No focus" // default
	const assert = getJSON("~/Library/DoNotDisturb/DB/Assertions.json").data[0].storeAssertionRecords
	const config = getJSON("~/Library/DoNotDisturb/DB/ModeConfigurations.json").data[0].modeConfigurations

	if (assert) { // focus set manually

		const modeid = assert[0].assertionDetails.assertionDetailsModeIdentifier
		focus = config[modeid].mode.name

	} else { // focus set by trigger

		const date = new Date
		const now = date.getHours() * 60 + date.getMinutes()

		for (const modeid in config) {

			const triggers = config[modeid].triggers.triggers[0]
			if (triggers && triggers.enabledSetting == 2) {

				const start = triggers.timePeriodStartTimeHour * 60 + triggers.timePeriodStartTimeMinute
				const end = triggers.timePeriodEndTimeHour * 60 + triggers.timePeriodEndTimeMinute
				if (start < end) {
					if (now >= start && now < end) {
						focus = config[modeid].mode.name
					}
				} else if (start > end) { // includes midnight
					if (now >= start || now < end) {
						focus = config[modeid].mode.name
					}
				}
			}
		}
	}
	return focus
}

Thanks @diogocampos! I was working from the JXA Cookbook for that. I've updated the gist.

I'm wondering if this could be done in shell if I had access to jq for parsing json. Unfortunately, I don't really know how to read this code as I don't real AppleJavaScript.

EDITED TO ADD: I remembered that I could do a HEREDOC with this in it…

CURRENT=$(/usr/bin/osascript -l JavaScript <<EOT
....

EOT
)

and the variable $CURRENT would have the result of the JavaScript. That will work for me, unless there's a pure bash/zsh/shell option out there that someone can come up with.

Awesome, thank you.
I'm trying to integrate focus mode into an Übersicht* widget, which uses JSX. My JS chops aren't good enough to figure how to port the functions though. Any tips? 🙏

• https://tracesof.net/uebersicht/

@drewkerr I suggest you to add this to the top of the script so that it can be directly executed:

#!/usr/bin/env osascript -l JavaScript

@drewkerr Also — I would I go to (enable | disable) (DND | focus-mode) on macOS Monterey (12.6)?

@devnoname120 I'm not sure if there's an easy programmatic way. See the Automators discussion link above.

Thanks, can you clarify what this is doing? Its pulling the contents of Assertions.json and ModeConfigurations.json
What is it doing with these? I assume some is pulling a setting from assertions and then looking it up in Modeconfigurations to get the focus name, but what is it looking up? I tried looking at the files and can't work it out. Thanks so much.

Sure! ModeConfigurations.json contains the modes. Assertions.json contains the current mode, if set manually. If not, we loop over the mode configurations to see if any of the configured trigger times - which is most of the code - apply. If nothing applies, return "No focus".

Thanks so much for that. I'm still confused about what exactly is being cross matched from assertions in ModeConfigurations, For manually set focus I assumed that it was matching one of the identifiers i.e. 56361E65-B77B-4467-9C31-433E51BF0CCC, but none of them in assertions seem to match the ones in ModeConfigurations, I'm a bit baffled!

It will match things like com.apple.focus.personal-time in both files. Look at lines 13-14 to get an idea of the structure of those files. It doesn't seem to work to edit those files, if that's what you're hoping to do. It's possible to set the focus by scripting the UI though.

Thanks so much! no, I am trying to write a swift version to pull the focus mode, but I have a feeling the Apple Sandboxing won't let me access the user library.

Thanks again for making this and also explaining it, much appreciated.

Doesn't seem to return active focus mode name if its been set from another device (in my case an iPhone).

MacOS does recognise its in a Focus mode on the menubar but the script returns:

❯ osascript -l JavaScript ~/scripts/get-focus-mode.js
No focus

Contents of ~/Library/DoNotDisturb/DB/ModeConfigurations.json for active Work mode are:

"com.apple.focus.work": { "triggers": { "triggers": [] }, "automaticallyGenerated": false, "mode": { "name": "Work", "tintColorName": "systemTealColor", "identifier": "<REMOVED>", "semanticType": 4, "symbolImageName": "person.lanyardcard.fill", "modeIdentifier": "com.apple.focus.work", "visibility": 0 }, "dimsLockScreen": 0, "configuration": { "suppressionType": 2, "compatibilityVersion": 3, "configurationType": 0, "minimumBreakthroughUrgency": 1, "hideApplicationBadges": 1 }, "created": 1671056911.476048, "compatibilityVersion": 2, "hasSecureData": true, "impactsAvailability": 0, "lastModified": 1674036685.879897 },

Which suggests that its not matching the following condition:

if (triggers && triggers.enabledSetting == 2)

Maybe a focus mode triggered via geo-location doesn't get written out to ~/Library/DoNotDisturb/DB/ModeConfigurations.json ?

I'm running the script on Ventura 13.4.1, and I get:[ ](focus.js: execution error: Error: Error: Can't convert types. (-1700))

Not sure. It's working for me on the same version, running in Script Editor and Shortcuts, as long as Full Disk Access is allowed in System Settings (siriactionsd, in the case of Shortcuts). This isn't meant to be much more than a hack though.

I use the following Alfred Workflow in order to enable/disable DND: https://github.com/vitorgalvao/calm-notifications-workflow/tree/main/Workflow

It uses its own Shortcut under the hood that needs to be installed first.

I post it here as an example of a working implementation that people can look into.

Python if you want in that context.

#!/usr/bin/env python3

import json
import os
import datetime

ASSERT_PATH = os.path.expanduser("~/Library/DoNotDisturb/DB/Assertions.json")
MODECONFIG_PATH = os.path.expanduser("~/Library/DoNotDisturb/DB/ModeConfigurations.json")
def get_focus():
    focus = "No focus" #default
    assertJ = json.load(open(ASSERT_PATH))['data'][0]['storeAssertionRecords']
    configJ = json.load(open(MODECONFIG_PATH))['data'][0]['modeConfigurations']
    if assertJ:
        modeid = assertJ[0]['assertionDetails']['assertionDetailsModeIdentifier']
        focus = configJ[modeid]['mode']['name']
    else:
        date = datetime.datetime.today()
        now = date.hour * 60 + date.minute

        for modeid in configJ:
            triggers = configJ[modeid]['triggers']['triggers'][0]
            if triggers and triggers['enabledSetting'] == 2:
                start = triggers['timePeriodStartTimeHour'] * 60 + triggers['timePeriodStartTimeMinute']
                end = triggers['timePeriodEndTimeHour'] * 60 + triggers['timePeriodEndTimeMinute']
                if start < end:
                    if now >= start and now < end:
                        focus = configJ[modeid]['mode']['name']
                elif start > end: # includes midnight
                    if now >= start or now < end:
                        focus = configJ[modeid]['mode']['name']
    return focus

if '__main__' == __name__:
    print(get_focus())