Skip to content

pwaAndSecureContext.md

Latest commit

 

History

History
65 lines (42 loc) · 4.04 KB

pwaAndSecureContext.md

File metadata and controls

65 lines (42 loc) · 4.04 KB
Raw

Install as PWA on desktop

If you use MCWW on localhost (127.0.0.1), installing PWA should be easy - just click a button in address panel, or in the management tab, and then click "Install"

Features:

  • Shortcuts on desktop and start menu
  • No browser UI
  • No context menu or text selection on elements where it's not supposed to be
  • File association for images
  • Offline placeholder

If you see "Not supported or already installed. Read this for details", the possible reasons are:

  • Connection is not secure. If your UI is on localhost be sure the address is not 0.0.0.0. Use 127.0.0.1 instead. If it's on another PC, and scheme HTTP (not HTTPS) read below how to acquire secure connection without certificates or tunnels
  • Browser doesn't support it. Firefox desktop doesn't support PWAs, other browsers should support
  • Already installed. You need to click "Open in App" button inside browser's UI, click "⋮" and select "Uninstall", then you will be able to install the shortcut again

Share over local network

You can get access to ComfyUI and Minimalistic over local network (e.g. from phone or from a laptop). To do this you need to add --listen flag in ComfyUI. In standalone server mode it should be GRADIO_SERVER_NAME="0.0.0.0" environment variable. It will be available in the same network. To open it use server's ip address and port (you can find it in a task manager)

In local network you will lose some features due to insecure HTTP context. You can get them back using the instruction below

Secure context

Secure context is localhost, 127.0.0.1, or HTTPS. In this context MCWW supports additional features:

  • Web camera inside image and video upload components
  • Microphone inside audio upload components
  • Copy button inside text output components
  • Screen recorder
  • PWA (Install as an app)
  • Open images from the system clipboard
  • Copy images into the system clipboard from the custom context menu

Get secure context on local network

You can get secure context on chromium-based browsers (e.g. Cromite in this guide). Open page with address chrome://flags, search for "insecure", enter your address here and select "enabled". Then you need to restart the app. It can not be restarted after closing and reopening, so you need to force stop it inside android's app info page

On PC you will have an annoying message on startup, here is the solutions how to hide it: uazo/cromite#2605

Install as an app (PWA)

You can use PWA to install this app on your phone. If you use it over local network you need to get secure context to the app (see above). Follow steps in the picture

It's here! Now you can use it in separate window instead of browser's tab

Share over Internet

The easiest way to share your app in the Internet is using GRADIO_SHARE="True" env. variable. It will create a temporal tunnel to your instance using gradio.live frp service. And use MCWW_AUTH='[["user", "123"]]' variable in pair with it. (Replace 123 with your password). It's important because Gradio library used in this project is a very vulnerable library

Other ways to share MCWW in the Internet:

  • Use another tunnel ngrok (not open-source). For better security use basic auth or traffic policy in addition to MCWW_AUTH variable
  • Host your own hugging face FRP server fork in a cloud. Read here for details https://github.com/huggingface/frp and .env.example for settings. In this case the tunnel will be permanent and controlled by you. You can also set an additional HTTP Authentication for better projection
  • Set up a proper VPN into your local network. To get HTTPS use self signed certificates and reverse proxy like stunnel