VCOF0056

OmniFocus: Append New Task

A voice command that will add a new task either to the currently selected project or task, or to the inbox. If a project or task is not selected when the command is executed, the new task will be placed in the Inbox.

By default, new tasks are appended to the end of existing task array.

Scope and Syntax

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

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

• “Add [New] Task [at End]”
• “Add [New] Action [at End]”
• “Append [New] Task [at End]”
• “Append [New] Action [at End]”

Requirements

• Application: OmniFocus 4
• System: macOS 12.3, iOS 15, iPadOS 15, visionOS

Downloads

• ⇩ COMMANDS-FILE OmniFocus 4.0 (macOS)
• ⇩ SHORTCUT LINK (“Append New Task”) (iOS · iPadOS · visionOS)

Voice Command Code

Here’s the Omni Automation code for the command:

Add New Task
Copy

(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()
		
		// DETERMINE IF SINGLE TASK OR PROJECT IS SELECTED
		sel = document.windows[0].selection
		selCount = sel.tasks.length + sel.projects.length 
		if(selCount === 1){
			if (sel.tasks.length === 1){
				var selectedItem = sel.tasks[0]
			} else if (sel.projects.length === 1){
				var selectedItem = sel.projects[0]
			} else {
				var selectedItem = null 
			}
		}

		// CREATE TEXT FIELD OBJECT
		textInputField = new Form.Field.String(
			"textInput",
			null,
			null,
			null
		)

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

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

		// DISPLAY THE FORM
		formPrompt = "Enter name for new task:"
		buttonTitle = "Continue"
		
		utterance = createUtterance(formPrompt)
		synthesizer.speakUtterance(utterance)
		
		formObject = await inputForm.show(formPrompt, buttonTitle)
		
		// RETRIVE FORM INPUT
		textInput = formObject.values["textInput"]
		
		// IF SINGLE TASK OR PROJECT SELECTED ADD TO ITEM
		if(selectedItem){
			var task = new Task(textInput, selectedItem.ending)
		} else {
			var task = new Task(textInput, inbox.ending)
		}

		// SELECT NEW TASK
		URL.fromString("omnifocus:///task/" + task.id.primaryKey).open()

		// RESPOND USING INPUT
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		if(!err.message.includes("cancelled")){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}
	}
})();