User Tools

Site Tools


manual:Preferences

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
manual:Preferences [2020/08/17 21:11]
JMichaelTX [Engine] ADD commands to restore Google Chrome. Add TOC
manual:Preferences [2020/08/17 21:53]
JMichaelTX [Chrome Browser Used in Actions & Tokens]
Line 90: Line 90:
 You can also add and remove applications from the clipboard history exclusion list.  When an excluded application is at the front, Keyboard Maestro will not automatically record the clipboard history each time it changes. ​ It will still read the current System Clipboard if you explicitly ask for it in a macro or open the Clipboard History Switcher. You can also add and remove applications from the clipboard history exclusion list.  When an excluded application is at the front, Keyboard Maestro will not automatically record the clipboard history each time it changes. ​ It will still read the current System Clipboard if you explicitly ask for it in a macro or open the Clipboard History Switcher.
  
-===== Other Hidden ​Preferences =====+===== Preferences ​Set by Command Line =====
  
 You can configure various preferences using defaults write from the Mac OS X Terminal. ​ Some preferences will take effect immediately,​ but others may require the editor or engine to be relaunched. You can configure various preferences using defaults write from the Mac OS X Terminal. ​ Some preferences will take effect immediately,​ but others may require the editor or engine to be relaunched.
Line 193: Line 193:
 </​code>​ </​code>​
  
-==== AppleScript ====+==== AppleScript ​OSA Command ​====
  
 You can set the command line tool that is used to execute AppleScripts You can set the command line tool that is used to execute AppleScripts
Line 203: Line 203:
 ==== Safari Browser Used in Actions & Tokens ==== ==== Safari Browser Used in Actions & Tokens ====
  
-You can set the AppleScript name of the Safari ​application, as well as the name of the Safari browser shown in applications:​+**Change which Safari-based Browser will be targeted by the "​Safari"​ Actions, Tokens, and Functions.** 
 + 
 +These preferences change ​AppleScript ​Application ​name that is used to control the respective browser in the form of CODE{{{tell application "<​browser name>"​}}}. ​ Note that the Safari ​browser must still behave like Safari, and the Chrome browser must behave like Chrome, or the actions will not work.  Do not bother trying to set them to Firefox or something like that as it will not work.  All this allows you to do is select a specific version of Safari or Chrome respectively. 
 + 
 +You can Safari-based Browser targeted in Actions, etc, as well as the name of the Safari browser shown in applications:​
  
 <code bash> <code bash>
Line 217: Line 221:
  
 ==== Chrome Browser Used in Actions & Tokens ==== ==== Chrome Browser Used in Actions & Tokens ====
 +
 +**Change which Chrome-based Browser will be targeted by the various Keyboard Maestro "​[[token:​ChromeTitle|Chrome Related]]"​ Actions, Tokens, and Functions.**
 +
 +:!: Note:  By using the [[token:​FrontBrowserTitle|FrontBrowser Related]] Tokens, Actions, and Functions, you may not need to change the below. ​ Just use these _FrontBrowser_ entities and whatever Browser is currently (or most recently) frontmost will be targeted. ​ This includes all Safari-based Browsers and Chrome-based Browsers.
  
 <code bash> <code bash>
 +# ~~~ For Brave Browser ~~~
 +defaults write com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID -string "​com.brave.Browser"​
 +defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "Brave Browser"​
 +
 +# ~~~For Chrome Canary ~~~
 defaults write com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID -string "​com.google.Chrome.canary"​ defaults write com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID -string "​com.google.Chrome.canary"​
 defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "​Chrome Canary"​ defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "​Chrome Canary"​
 </​code>​ </​code>​
  
-To restore the defaults back to use Google Chrome, just delete the preferences:​+**To restore the defaults** back to use Google Chrome, just delete the preferences:​
  
 <code bash> <code bash>
 +# ~~~ Restore to Google Chrome ~~~
 defaults delete com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID defaults delete com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID
 defaults delete com.stairways.keyboardmaestro.engine BrowserGoogleChromeName defaults delete com.stairways.keyboardmaestro.engine BrowserGoogleChromeName
 </​code>​ </​code>​
  
-The AppleScript name is used in AppleScript'​s which control the respective browser in the form of CODE{{{tell app "<​browser name>"​}}}. ​ Note that the Safari browser must still behave like Safari, and the Chrome browser must behave like Chrome, or the actions will not work.  Do not bother trying to set them to Firefox or something like that as it will not work.  All this allows you to do is select a specific version of Safari or Chrome respectively.+
  
 ==== Engine Animation ==== ==== Engine Animation ====
manual/Preferences.txt · Last modified: 2024/05/27 21:26 by peternlewis