Use it from your phone

There are three ways to use Chrysalis on a phone. Pick the one that fits.

#Chrysalis on your computer, phone on the same Wi-Fi

1. On the computer, open Settings > Server. Only the admin account sees this tab.
2. Turn on Allow other devices on my network. It applies right away.
3. Scan the QR code with your phone's camera, or type the address shown under it.

Every account still needs its password from the phone. If the phone cannot connect, check that both devices are on the same network and that the computer's firewall allows the port (8788 unless you changed it).

#Away from home

Put the computer and the phone on the same private network with Tailscale, then open the computer's Tailscale address on the phone. If you use its Tailscale name rather than the IP address, add that name under Host names in Settings > Server.

#HTTPS for the microphone and installing as an app

Phones only allow the microphone, and adding a site to the home screen as an app, over HTTPS. To serve Chrysalis over HTTPS you need a certificate and key file for the address you open it by. With Tailscale:

tailscale cert my-computer.tailnet-name.ts.net

Then in Settings > Server, turn on Use HTTPS and fill in Certificate and Key with the two files it wrote. The same settings are ssl.certPath and ssl.keyPath in config.yaml.

#Chrysalis on the phone itself

Install the Android app. It runs the whole server on the phone and opens it in your browser, so it works with no computer and no network.

• Tap Keep running in the background, or Android may pause the server while you are in the browser.
• Stop shuts the server down; Open Chrysalis opens it again in the browser.
• Logs shows what the server is doing, with a Copy button for bug reports.
• Your data lives inside the app. Uninstalling deletes it, so export backups first.