VCOF0101

OmniFocus: Repeating «Weekday» Task

This command creates a new task that repeats on the indicated weekday, optionally including a designated due time.

Scope and Syntax

Language: English (United States 🇺🇸 · Great Britain 🇬🇧 · Australia 🇦🇺 · Canada 🇨🇦) • Scope: System-Wide

Command phrase variations (words in [brackets] are optional):

“Repeating Sunday Task”
“Repeating Monday Task”
“Repeating Tuesday Task”
“Repeating Wednesday Task”
“Repeating Thursday Task”
“Repeating Friday Task”
“Repeating Saturday Task”

Requirements

Application: OmniFocus 4
System: macOS 12, iOS 15, iPadOS 15, visionOS 1.0

Installing Voice Control commands on iOS · iPadOS · visionOS

While Apple’s mobile operating systems currently do not support the Open URL action used in the voice commands files provided on this website, you can still create and use customized Omni Automation voice commands for iPhones and iPads!

To create your voice commands, we’ll use specialized Shorcuts workflows that you can “tap-to-install” from the various example pages. Simply follow these steps or view the illustrated instructions here:

First, install an Omni Automation shortcut from one of the provided links. (below)
Next, in the mobile Settings app, tap Accessibility ▸ Voice Control ▸ Customize Commands ▸ Custom ▸ Create New Command… and in the forthcoming New Command interface select the installed shortcut as the value for the “Action” parameter.
Enter one of the command phrases from the example’s documentation page (above) for the value of the “Phrase” property, and…
Finally, set the value of the “Application” parameter to either “Any” for global access or choose the Omni app to target from the provided list of installed applications.

You can then activate Voice Control and use your voice command to trigger the shortcut to run the Omni Automation script!

Installing Siri commands on iOS · iPadOS · visionOS

To use this voice command with Siri, simply install the provided Shortcuts workflow. To trigger the command, summon Siri and say:

“Hey Siri, [Name of installed Shortcuts workflow]”

NOTE: After installation of the shortcut, you can rename it to whatever phrase fits your needs.

Downloads

⇩ COMMANDS-FILE OmniFocus 4.0 (macOS)
⇩ SHORTCUT-LINK (“Repeating Sunday Task”) (iOS · iPadOS · visionOS)
⇩ SHORTCUT-LINK (“Repeating Monday Task”) (iOS · iPadOS · visionOS)
⇩ SHORTCUT-LINK (“Repeating Tuesday Task”) (iOS · iPadOS · visionOS)
⇩ SHORTCUT-LINK (“Repeating Wednesday Task”) (iOS · iPadOS · visionOS)
⇩ SHORTCUT-LINK (“Repeating Thursday Task”) (iOS · iPadOS · visionOS)
⇩ SHORTCUT-LINK (“Repeating Friday Task”) (iOS · iPadOS · visionOS)
⇩ SHORTCUT-LINK (“Repeating Saturday Task”) (iOS · iPadOS · visionOS)

Script Code

Here is the script code:

New Repeating Sunday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=SU"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” SUNDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 0) ? "next Sunday":"Sunday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

New Repeating Monday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=MO"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” MONDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 1) ? "next Monday":"Monday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

New Repeating Tuesday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=TU"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” TUESDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 2) ? "next Tuesday":"Tuesday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

New Repeating Wednesday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		var formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=WE"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” WEDNESDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 3) ? "next Wednesday":"Wednesday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

New Repeating Thursday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		var formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=TH"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” THURSDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 4) ? "next Thursday":"Thursday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

New Repeating Friday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		var formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=FR"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” FRIDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 5) ? "next Friday":"Friday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

New Repeating Saturday Task


(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			"Task Name",
			null,
			null
		)
		
		// CREATE DATE INPUT
		timeFmtr = Formatter.Date.withFormat('h:mm a')
		dateInput = new Form.Field.Date(
			"indictatedTime",
			"Time (optional)",
			null,
			timeFmtr
		)

		// CREATE NEW FORM AND ADD FIELD
		var inputForm = new Form()
		inputForm.addField(textInputField)
		inputForm.addField(dateInput)

		// VALIDATE USER INPUT
		inputForm.validate = function(formObject){
			textInput = formObject.values["textInput"]
			if (!textInput){return false}
			return true
		}

		// DISPLAY THE FORM
		formPrompt = "Task Information:"
		buttonTitle = "Continue"
		spokenPrompt = "Task name and optional time"
		
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)
		
		var formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		taskTitle = formObject.values["textInput"]
		dateObj = formObject.values["indictatedTime"]

		// CREATE TASK
		var task = new Task(taskTitle)
		ruleString = "FREQ=WEEKLY;BYDAY=SA"
		repetitionMethod = Task.RepetitionMethod.DueDate
		task.repetitionRule = new Task.RepetitionRule(ruleString, repetitionMethod)
		if(dateObj){
			hours = dateObj.getHours()
			minutes = dateObj.getMinutes()
			// GET “NEXT” SATURDAY
			dateFmatr = Formatter.Date.withStyle(Formatter.Date.Style.Short)
			queryString = (new Date().getDay() === 6) ? "next Saturday":"Saturday"
			dateObj = dateFmatr.dateFromString(queryString)
			// ASSIGN TIMES TO TARGET DATE
			targetDate = new Date(dateObj.setHours(hours, minutes, 0, 0))
			task.dueDate = targetDate
		}
		
		// SHOW NEW TASK
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
		var taskID = task.id.primaryKey
		URL.fromString("omnifocus:///task/" + taskID).open()
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();

LEGAL

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. OMNI-AUTOMATION.COM assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. OMNI-AUTOMATION.COM provides this only as a convenience to our users. OMNI-AUTOMATION.COM has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and OMNI-AUTOMATION.COM assumes no responsibility in this regard. Please understand that a third-party site is independent from OMNI-AUTOMATION.COM and that OMNI-AUTOMATION.COM has no control over the content on that website. Please contact the vendor for additional information.