VCOF0084

OmniFocus: Title Case Name

This command will apply title case formatting to the name of the selected task, project, folder, or tag.

Scope and Syntax

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

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

• “Title Case Name”

Requirements

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

Video: Title Case Name

Uses the voice command to set the name of items to title case.

PLAY (E) PAUSE BACK REWIND

PLAY PAUSE BACK REWIND

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 (“Title Case Name”) (iOS · iPadOS · visionOS)

Script Code

Here is the script code:

Title Case Name
Copy

(() => {
	/*
		Title Caps
		Ported to JavaScript By John Resig - http://ejohn.org/ - 21 May 2008
		Original by John Gruber - http://daringfireball.net/ - 10 May 2008
		Adapted for Omni Automation by Sal Soghoian - 2 June 2018
		License: http://www.opensource.org/licenses/mit-license.php
	*/

	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()

		var small = "(a|an|and|as|at|but|by|en|for|if|in|of|on|or|the|to|v[.]?|via|vs[.]?)";
		var punct = "([!\"#$%&'()*+,./:;<=>?@[\\\\\\]^_`{|}~-]*)";
  
		const titleCaps = function(title){
			var parts = [], split = /[:.;?!] |(?: |^)["Ò]/g, index = 0;
		
			while (true) {
				var m = split.exec(title);

				parts.push( title.substring(index, m ? m.index : title.length)
					.replace(/\b([A-Za-z][a-z.'Õ]*)\b/g, function(all){
						return /[A-Za-z]\.[A-Za-z]/.test(all) ? all : upper(all);
					})
					.replace(RegExp("\\b" + small + "\\b", "ig"), lower)
					.replace(RegExp("^" + punct + small + "\\b", "ig"), function(all, punct, word){
						return punct + upper(word);
					})
					.replace(RegExp("\\b" + small + punct + "$", "ig"), upper));
			
				index = split.lastIndex;
			
				if ( m ) parts.push( m[0] );
				else break;
			}
		
			return parts.join("").replace(/ V(s?)\. /ig, " v$1. ")
				.replace(/(['Õ])S\b/ig, "$1s")
				.replace(/\b(AT&T|Q&A)\b/ig, function(all){
					return all.toUpperCase();
				});
		};
	
		function lower(word){
			return word.toLowerCase();
		}
	
		function upper(word){
			return word.substr(0,1).toUpperCase() + word.substr(1);
		}
	
		function setCharAt(str,index,chr) {
			if(index > str.length-1) return str;
			return str.substr(0,index) + chr + str.substr(index+1);
		};
	
		var sel = document.windows[0].selection.databaseObjects
		if(sel.length < 1 ){
			throw {
				name: "Selection Issue", 
				message: "Please select a single folder, project, task, or tag."
			}
		} else {
			var targetObj = sel[0]
		}
		
		var objName = targetObj.name
		if(objName.length === 0){
			throw {
				name: "Missing Text", 
				message: "The selected item has no name."
			}
		}
	
		if (objName.lastIndexOf('’') === -1){
			changedText = titleCaps(objName)
		} else {
			indices = [];
			for (var i=0; i < objName.length; i++){
				if (objName[i] === "’") indices.push(i);
			}
			objName = objName.replace(/’/g, "'")
			changedText = titleCaps(objName)
			indices.forEach(index => {
				changedText = setCharAt(changedText,index,'’') 
			})
		}
	
		targetObj.name = titleCaps(objName)

		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		// new Alert(err.name, err.message).show()
	}
})();