Support

Find answers to common questions, troubleshoot connectivity issues, and learn about platform-specific details.

Connectivity General FAQ macOS Issues Contact Us

Troubleshooting

Connectivity

Lysoniq uses an advanced connectivity system designed to keep your devices connected with minimal intervention. In most cases, temporary disconnections are resolved automatically.

How Lysoniq stays connected

Lysoniq is designed to maintain a stable connection between your devices with minimal intervention. If a connection drops due to a brief WiFi interruption or a device going to sleep, Lysoniq will detect the issue and attempt to reconnect automatically within seconds. For device discovery, Lysoniq uses multiple methods to ensure your devices can find each other reliably across different network setups. If automatic recovery isn't resolving the issue, tap Refresh Connections in the app to perform a full reset of the discovery system.

If a connection drops, give it 15–20 seconds to reconnect on its own before troubleshooting manually.

Manual troubleshooting

If automatic recovery doesn't resolve the issue, work through these steps in order.

01 Basic Checks

Check that the app is updated to the latest version on all devices.

Ensure all devices are on the same WiFi network.

Ensure the app is open and in the foreground on all devices.

Check that Local Network permission is enabled for Lysoniq. Go to Settings → Privacy & Security → Local Network and make sure Lysoniq is toggled on.

02 Quick Fixes

Toggle WiFi off and back on for the device that isn't connecting.

Force-quit the app on the problem device and relaunch it.

If a device was recently on a different network (e.g. came home from cellular), toggle WiFi to force it onto the correct network.

03 Router & Network Issues

Restart your WiFi router — this resolves most persistent connection issues, especially on mesh networks.

If you use a mesh WiFi system (Google Nest, Eero, Orbi, etc.) and devices aren't discovering each other, try restarting your router. Some mesh configurations can occasionally prevent devices from seeing each other until the router is restarted.

Check if your router has "AP isolation" or "client isolation" enabled — this blocks device-to-device communication and must be disabled for Lysoniq to work.

Some routers have separate 2.4GHz and 5GHz networks. Ensure all devices are on the same band or SSID.

If using a VPN on any device, try disabling it — VPNs can prevent local network discovery.

04 Firewall & Security

On Mac, check System Settings → Network → Firewall — ensure Lysoniq is allowed to accept incoming connections.

Corporate or managed networks may block the local network traffic that Lysoniq relies on. Lysoniq may not work on these networks.

05 Still Not Working?

Try connecting all devices to a mobile hotspot as a test. If they connect there, the issue is likely with your router or network configuration.

If none of the above helps, open Lysoniq on the source device and non-connecting device, and go to Settings → Send Log & Crash Report. This sends us a diagnostic log which can help us identify the issue. Feel free to include a brief description of the problem in the email that opens. You can also contact us directly if you have any questions.

FAQ

General Questions

Do I need an Apple Music subscription?
Yes, an active Apple Music subscription is required. Lysoniq is a client for Apple Music — it uses your existing subscription to play music. One subscription covers all your devices.
Does Lysoniq collect personal data?
No. We do not collect personal information. Anonymous analytics may be used to improve functionality. See our Privacy Policy for details.
Which device should I use as my source?
We recommend an iPhone or iPad as your primary source device. They support Hi-Res Lossless playback (up to 24-bit/192kHz) with the correct settings in Apple Music. macOS has some limitations (detailed below) and Apple TV caps at 24-bit/48kHz.
Is Lysoniq a subscription?
No. Lysoniq is a one-time purchase. You pay once and get all future updates included. Install it on any devices linked to your App Store account.
Can I use Lysoniq with multiple devices at the same time?
Yes. One device acts as the source (connected to your DAC/amp) and any number of other devices can act as controllers. All controllers stay fully synced — browse, queue, skip, and adjust from any of them.
What audio quality does each device support?
iPhone & iPad: Up to 24-bit/192kHz (Hi-Res Lossless) via a wired USB connection to a compatible DAC.

Mac: Up to 24-bit/96kHz (Hi-Res) via your audio interface.

Apple TV: Up to 24-bit/48kHz (Lossless) via HDMI.

Platform-Specific

macOS Known Issues

These issues are caused by limitations in Apple's MusicKit framework on macOS. They do not affect iOS or tvOS. We monitor Apple's updates closely and will improve Mac support as new capabilities become available.

Some playlists are missing
This can happen when your Mac's music library is out of sync with iCloud. Toggling the Sync Library setting off and on will force a refresh. Here's how:
  1. Open the Music app on your Mac.
  2. From the menu bar, click Music → Settings (or Preferences on older macOS).
  3. Go to the General tab.
  4. Uncheck Sync Library and confirm when prompted.
  5. Wait a few seconds, then check Sync Library again to re-enable it.
  6. Give it a minute or two to re-sync, then relaunch Lysoniq.
Playlists aren't editable on Mac
This is a limitation of Apple's MusicKit framework on macOS — playlist editing capabilities that are available on iOS are not yet exposed on Mac. We'll add this as soon as Apple makes it available.
Brief gap in playback when using auto sample-rate switching
When Lysoniq automatically changes the audio sample rate to match the next track, macOS briefly resets the audio output. This causes a short pause while your DAC switches to the new rate. This is normal behaviour on macOS — iOS and tvOS handle this natively without any gap.
Audio quality display may not match what's playing
Apple's MusicKit on macOS doesn't expose streaming quality metadata (this is available on iOS and tvOS). Lysoniq works around this by assuming the highest quality format available for each track. For the most accurate display, ensure Hi-Res Lossless streaming is enabled in your Apple Music Playback settings and Dolby Atmos is turned off.
Dolby Atmos limited to 2 channels
Apple's MusicKit framework currently limits Dolby Atmos output to two channels on Mac. This is an Apple-side limitation — we'll update Lysoniq when Apple expands this capability.

Still need help?

We typically respond within 24 hours.

Email info@lysoniq.app

You can also join the discussion at r/Lysoniq