| Both sides previous revision Previous revision | |
| indigo_2024.1_documentation:indigo_touch_web [2025/02/09 23:15] – [Troubleshooting] davel17 | indigo_2024.1_documentation:indigo_touch_web [2025/04/14 20:10] (current) – external edit 127.0.0.1 |
|---|
| ===== Indigo Touch For Web ===== | ===== Indigo Touch For Web ===== |
| Indigo includes an [[indigo_2024.1_documentation:indigo_web_server|integrated web server]] that allows you to serve your own custom content, and it also includes a web-based alternative to Indigo Touch for iOS called **Indigo Touch for Web** or ITW. ITW is a Single Page Application (SPA) that runs entirely in a browser. ITW is not meant to be a replacement for the Mac Client -- you can't configure devices or add variables for example -- however, the most common Indigo functions are available. These include turning on/off devices, controlling thermostats, changing variable values and so on. Available features are listed below and we have plans to include more features in the future! | Indigo includes an [[indigo_2024.1_documentation:indigo_web_server|integrated web server]] that allows you to serve your own custom content, and it also includes a web-based alternative to Indigo Touch for iOS called **Indigo Touch for Web** or ITW. ITW is a Single Page Application (SPA) that runs entirely in a browser. ITW is not meant to be a replacement for the Mac Client -- you can't configure devices or add variables for example -- however, the most common Indigo functions are available. These include turning on/off devices, controlling thermostats, changing variable values and so on. Available features are listed below, and we have plans to include more features in the future! |
| |
| {{:indigo_2023.1_documentation:indigo_touch_web_2023_1.png?500|}} | {{:indigo_2023.1_documentation:indigo_touch_web_2023_1.png?nolink&500|Indigo Touch Web Image}} |
| |
| ITW works by establishing a bi-directional connection to the Indigo [[indigo_2024.1_documentation:api|Websocket API]]. ITW works on both desktop and mobile (mobile availability depends on configuration and whether you'e connected locally via WiFi or remotely via cellular). | ITW works by establishing a bidirectional connection to the Indigo [[indigo_2024.1_documentation:api|Websocket API]]. ITW works on both desktop and mobile (mobile availability depends on configuration and whether you're connected locally via Wi-Fi or remotely via cellular). |
| ==== Loading ITW ==== | ==== Loading ITW ==== |
| There are several ways to load ITW depending on your environment. The three most common being: | There are several ways to load ITW depending on your environment. The three most common being: |
| |
| - the Indigo Reflector Service using your custom reflector address such as //''<nowiki>https://my_reflector.indigodomo.net</nowiki>''// via a secure //''<nowiki>https://</nowiki>''// connection (the reflector service requires an Indigo up-to-date subscription). | - the Indigo Reflector Service using your custom reflector address such as //''<nowiki>https://my_reflector.indigodomo.net<nowiki>''// via a secure //''<nowiki>https://</nowiki>''// connection (the reflector service requires an Indigo up-to-date subscription). |
| - a local loop-back address such as //''<nowiki>http://localhost:8176</nowiki>''// or //''<nowiki>http://127.0.0.1:8176</nowiki>''// via an insecure //''http:''// connection. These connections are only valid when used on the same machine running the Indigo server (and obviously, won't work on mobile). | - a local loop-back address such as //''<nowiki>http://localhost:8176</nowiki>''// or //''<nowiki>http://127.0.0.1:8176</nowiki>''// via an insecure //''<nowiki>http://</nowiki>''// connection. These connections are only valid when used on the same machine running the Indigo server (and obviously, won't work on mobile). |
| - a direct IP address such as //''<nowiki>http://10.0.1.123:8176</nowiki>''// or //''<nowiki>http://192.168.0.123:8176</nowiki>''// via an insecure //''http:''// connection. | - a direct IP address such as //''<nowiki>http://10.0.1.123:8176</nowiki>''// or //''<nowiki>http://192.168.0.123:8176</nowiki>''// via an insecure //''<nowiki>http://</nowiki>''// connection. |
| |
| Note that the custom port address (8176 above) may differ depending on the settings you use when launching the Indigo Server. | Note that the custom port address (8176 above) may differ depending on the settings you use when launching the Indigo Server. |
| |
| When you use a bare address like the examples above, the server will redirect the request and load the ITW homepage //''index.html''// so -- depending on your browser -- the address field will show //''localhost:8176/index.html''// or //''<nowiki>http://localhost:8176/index.html</nowiki>''// or something similar. | When you use a bare address like the examples above, the server will redirect the request and load the ITW homepage //''index.html''// so -- depending on your browser -- the address field will show //''localhost:8176/index.html''// or //''<nowiki>http://localhost:8176/index.html<nowiki>''// or something similar. |
| |
| ==== Interface Controls ==== | ==== Interface Controls ==== |
| * Refresh from server - ITW objects update automatically when data are changed in Indigo, but sometimes you might want to force the data to refresh for a specific device. Selecting this item will cause the device data to be refreshed. | * Refresh from server - ITW objects update automatically when data are changed in Indigo, but sometimes you might want to force the data to refresh for a specific device. Selecting this item will cause the device data to be refreshed. |
| * Send status request - only available for devices that support the Send Status Request feature in the Indigo Client. | * Send status request - only available for devices that support the Send Status Request feature in the Indigo Client. |
| * Show device JSON - this item will cause a pop up window to display the entire JSON payload for the device. | * Show device JSON - this item will cause a pop-up window to display the entire JSON payload for the device. |
| |
| == Actions == | == Actions == |
| |
| | Light Mode | Dark Mode | | | Light Mode | Dark Mode | |
| | {{:indigo_2024.1_documentation:indigo_touch_web_2023_1.png?500|}} | {{:indigo_2024.1_documentation:indigo_touch_web_2023_1_Dark.png?500|}} | | | {{:indigo_2024.1_documentation:indigo_touch_web_2023_1.png?nolink&500|Indigo Touch Web Image}} | {{:indigo_2024.1_documentation:indigo_touch_web_2023_1_Dark.png?nolink&500|Indigo Touch Web Image}} | |
| |
| |
| ==== Loading A Specific Tab ==== | ==== Loading A Specific Tab ==== |
| By default, ITW will show the Devices tab when it first loads. If you would like to begin with a different tab, you can add a URL query argument to the end of the target URL (**query arguments must be lower case and you must include //''index.html''// as a part of the URL for this feature to work**). | By default, ITW will show the Devices tab when it first loads. If you would like to begin with a different tab, you can add a URL query argument to the end of the target URL (**query arguments must be lowercase, and you must include //''index.html''// as a part of the URL for this feature to work**). |
| |
| Examples: | Examples: |