Skip to main content

​
Mixlar Connect Setup

Use the Mixlar iOS app or web viewer to control your Mixlar Mix remotely, receive toast notifications, and view live system widgets.
  • Mixlar Control installed on your PC
  • Web Controller plugin available
  • Optional: Tailscale for remote/HTTPS access
  • Optional: Toast Notifications if you want phone-driven toasts

​
1. Prepare Mixlar Control for iOS & Web Access

To use the iOS app, Mixlar Control must run a local web server.
1

Install the Web Controller Plugin

Open Settings → Plugins inside Mixlar Control.Find Web Controller and click Install.
Once installed, a globe icon will appear under Installed Plugins — click it to open the configuration window.
2

Configure the web server port

In the Configuration tab:
  • Default port: 5000
  • Best to leave this value unless another app is already using it
  • If you change it, you must Save, then Uninstall and Reinstall the plugin for the change to apply
3

Optional: Enable login security

In the Security tab you can:
  • Turn on authentication
  • Set a username and password
This is recommended if you don’t fully trust your home network or you plan to use remote access over Tailscale.

​
2. Remote Access & HTTPS (Tailscale Setup)

Use this section if you want to connect from outside your home network or use HTTPS with the iOS app.
  • HTTPS is required for secure remote iOS access
  • If you only use a local IP on your home network, you can skip certificates and Tailscale
1

Install Tailscale

  1. Go to https://tailscale.com/download
  2. Download and install Tailscale for your OS (Windows/macOS/Linux)
  3. Sign in with Google, Microsoft, GitHub, or Apple
  4. Confirm Tailscale shows your PC as Connected in the tray/menu bar
2

Enable MagicDNS

  1. Open the Tailscale admin dashboard: https://login.tailscale.com/admin/dns
  2. Enable MagicDNS
  3. Save changes
MagicDNS gives you an easy domain like yourname.ts.net, which Mixlar uses for HTTPS certificates.
3

Generate HTTPS certificates

  1. In the same Tailscale DNS page, scroll to the HTTPS Certificates section
  2. Enable a certificate for your PC
  3. Open Mixlar Control → Plugins → Web Controller → Remote Access
  4. Click Get Certificates to download and apply them
After this, Mixlar will show an HTTPS link such as:
https://yourname.ts.net:5000
4

Check available links in the Network tab

Go to the Network tab in the Web Controller plugin.You’ll see:
  • Local IP URL (home network only)
  • Local HTTP port
  • Tailscale HTTPS URL — this is the recommended link for the iOS app

​
3. Enable Toast Notifications (Optional)

Toast notifications let your Mixlar Mix display events such as Spotify changes, OBS status, calendar reminders, and custom API events.
1

Open API Receiver settings

In Mixlar Control, go to:
2

Configure the API Receiver

  • Leave the Port at the default 8889 (recommended)
  • Make sure Require API Key is enabled
  • Copy the generated API key (for example: FG55H-G92JK-23AFG-HS992-KH33L)
You’ll use this key in the iOS app.
The iOS app can connect without toast notifications,
but the API Receiver must be enabled if you want mobile-driven toasts.

​
4. Set Up the Mixlar iOS App

1

Install the app

Download Mixlar Connect from the iOS App Store.
2

Enter your server URL

When the app first opens, it will ask for a server link.You can use:The Tailscale URL allows secure access from anywhere.
3

Configure API settings in the app

In the app, go to Settings:
  • Paste your API key from the API Receiver
  • Set the API port to 8889 (or your custom port)
  • Save changes
4

Test a toast notification

In the iOS app, open the Broadcast & Notifications section and tap Test Toast Notification.A toast should appear on your Mixlar Mix display.
If it does, your iOS app, Web Controller, and API Receiver are all configured correctly.

​
Important Notes

  • The Web Controller plugin is required for the iOS app
  • Tailscale + HTTPS are required for secure remote access (not for local-only use)
  • Toast notifications are optional, but the API Receiver must be enabled if you want them
  • You can switch between local IP and Tailscale URL in the app at any time

​
Next steps

Tailscale details

Learn more about MagicDNS, certificates, and advanced remote access options.

Toast notification plugins

Configure OBS, Spotify, Calendar, Email, and other notification handlers.