This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
trigger:Web_Server [2018/07/16 02:55] peternlewis |
trigger:Web_Server [2018/07/20 20:48] DavidShepherdson Corrected some minor typos. |
||
---|---|---|---|
Line 7: | Line 7: | ||
If the Keyboard Maestro web server is enabled, then you can connect to it using your web browser. | If the Keyboard Maestro web server is enabled, then you can connect to it using your web browser. | ||
- | :!: Note: A HTTP Port of 4490 is used in all examples on this page. But it can be set to any port you prefer. | + | :!: Note: A HTTP Port of 4490 or 4491 is used in all examples on this page. But it can be set to any port you prefer. |
- | **To Display the Web Server User Interface** | + | **To Display the Web Server User Interface**\\ |
+ | (you can use either `127.0.0.1` or `localhost`. They are equivalent.) | ||
``` | ``` | ||
- | https://localhost:4491 | + | http://127.0.0.1:4490 <!- for normal connection -> |
+ | http://localhost:4490 <!- for normal connection -> | ||
+ | https://localhost:4491 <!- for secure connection -> | ||
``` | ``` | ||
- | (note the use of the **next** port number after the specified one for the secure connection) or | + | If you have configured a username and password for the web server, then you can log in and execute any active macro. You do not need to explicitly set a trigger; if you enable the web server, and configure a username and password, then all active macros can be executed via the web browser using the username and password. |
- | + | ||
- | ``` | + | |
- | http://127.0.0.1:4490/ | + | |
- | ``` | + | |
- | If you have configured a username and password for the web server, then you can log in and execute any active macro. You do not need to explicitly set a trigger, if you enable the web server, and configure a username and password, then all active macros can be executed via the web browser using the username and password. | + | |
Any macro with the [[Public Web]] trigger can be triggered by anyone without the username or password as long as they can connect to your Mac. | Any macro with the [[Public Web]] trigger can be triggered by anyone without the username or password as long as they can connect to your Mac. | ||
Line 27: | Line 25: | ||
**To Execute a Specific Macro** | **To Execute a Specific Macro** | ||
```html | ```html | ||
- | https://127.0.0.1:4491/action.html?macro=<YourMacroUUID>&value=<TheTriggerValueToPass> | + | https://localhost:4491/action.html?macro=<YourMacroUUID>&value=<TheTriggerValueToPass> |
``` | ``` | ||
Line 33: | Line 31: | ||
===== Enable and Setup Web Server ===== | ===== Enable and Setup Web Server ===== | ||
- | Keyboard Maestro has an built-in web server. You can enable it in the Keyboard Maestro Web Server preferences, and provide the following data. | + | Keyboard Maestro has a built-in web server. You can enable it in the Keyboard Maestro Web Server preferences, and provide the following data. |
{{:trigger:km-web-server-pref.png?nolink|}} | {{:trigger:km-web-server-pref.png?nolink|}} | ||
Line 42: | Line 40: | ||
| Username | `<NONE>` | _Required for authenticated access_. Enter any name you prefer, but pick one that you will remember. | | | Username | `<NONE>` | _Required for authenticated access_. Enter any name you prefer, but pick one that you will remember. | | ||
| Password | `<NONE>` | _Required for authenticated access_. Although there are no specific requirements for the password, you should pick a strong one that you will remember, or better, use a Password Manager. | | | Password | `<NONE>` | _Required for authenticated access_. Although there are no specific requirements for the password, you should pick a strong one that you will remember, or better, use a Password Manager. | | ||
- | | Web Browser Access Enabled | _checked_ | This must be checked in order to Keyboard Maestro Control on an iOS device. | | + | | Web Browser Access Enabled | _checked_ | This must be checked in order to use Keyboard Maestro Control on an iOS device. | |
- | | Receive Clipboards into Clipboard History | _unchecked_ | If checked, you can send your clipboard from on Mac to another using the Clipboard History Switcher. | | + | | Receive Clipboards into Clipboard History | _unchecked_ | If checked, you can send your clipboard from one Mac to another using the Clipboard History Switcher. | |
- | | Replacing Current Clipboard | _unchecked_ | If checked, received clipboards will replace your current system clipboard, otherwise they will be added to the clipboard history as the immediate paste clipboard. | | + | | Replacing Current Clipboard | _unchecked_ | If checked, received clipboards will replace your current system clipboard, otherwise they will be added to the clipboard history as the immediate past clipboard. | |
Line 55: | Line 53: | ||
- Then execute any macro you have defined | - Then execute any macro you have defined | ||
- If you have configured any macro with a Public Web trigger | - If you have configured any macro with a Public Web trigger | ||
- | - Then anyone on the Internet (with access to your local area network) trigger _only_ those macros that have set the [[Public Web]] trigger. Of course, if you properly setup your Internet router, unauthorized access from the Internet should be very unlikely. | + | - Then anyone on the Internet (with access to your local area network) can trigger _only_ those macros that have set the [[Public Web]] trigger. Of course, if you properly setup your Internet router, unauthorized access from the Internet should be very unlikely. |
If you have not entered a username or password, then you will not be able to login, but any Public Web triggered macros will still be available (as long as the web server is enabled). | If you have not entered a username or password, then you will not be able to login, but any Public Web triggered macros will still be available (as long as the web server is enabled). | ||
Line 62: | Line 60: | ||
``` | ``` | ||
- | URL: https://127.0.0.1:4491 | + | URL: https://localhost:4491 |
``` | ``` | ||