How to use this page
Each entry below is a symptom written the way you would type it into a search bar. Open the one that matches what you are seeing — the likely cause and the fix are inside. Symptoms are grouped into four categories: connection, video, audio, and input. Start with connection if pairing is failing, otherwise jump to the closest match.
The client cannot reach the host
Pairing problems are nearly always a network or permission issue, not a bug in Remio. Walk these in order — most sessions come back on the first or second step.
SYM-01 Why can't my Remio client find the host on the same network?
LIKELY CAUSE
The two devices are on different Wi-Fi networks, the host is missing Screen Recording or Local Network permission, or a firewall is silently dropping the discovery packets.
FIX
- Confirm both devices are on the same Wi-Fi network — guest networks and 5 GHz / 2.4 GHz radios on some routers count as separate networks.
- Check the Remio icon is showing in the Mac menu bar. If not, launch the host.
- Open System Settings → Privacy & Security → Screen Recording, confirm Remio Host is enabled, then quit and relaunch the host.
- On iOS, open Settings → Remio → Local Network and make sure it is on.
- If a firewall like Little Snitch is running, allow Remio Host to accept incoming connections.
Remio can also reach hosts over the internet via relay. As long as both devices are signed in, the connection is routed automatically when local discovery fails.
SYM-02 Why does my Remio connection keep dropping or reconnecting?
LIKELY CAUSE
The Mac is going to sleep, the client is roaming between access points, or a VPN is breaking the peer-to-peer path mid-session.
FIX
- Open System Settings → Energy on the host and enable Prevent automatic sleeping while the display is off.
- If you are using a VPN, disconnect it during pairing — VPNs commonly interfere with the direct path.
- Stay near a single access point while connected. Hand-offs between routers will close the session.
- In Remio settings, try switching between direct and relay mode to see which is more stable on your network.
- Where possible, connect the Mac by Ethernet for the most reliable session.
Remio prefers a direct peer-to-peer connection on the local network for lowest latency. When the direct path fails, the session transparently falls back to an encrypted relay.
The stream looks wrong
If you can see the host but it does not feel right — choppy, delayed, or stuck on a black frame — the cause is almost always network bandwidth or a missing display permission.
SYM-03 Why does my Remio stream feel laggy or choppy?
LIKELY CAUSE
The network path between the two devices is the bottleneck — weak Wi-Fi signal, a 2.4 GHz radio, a saturated link, or a forced relay are all common reasons.
FIX
- Move closer to the router and prefer the 5 GHz band on both devices — 2.4 GHz simply does not have the headroom for a remote desktop session.
- Lower the streaming quality in Remio settings. Drop from 4K to 1080p, or from 60 fps to 30 fps, until the stream stabilises.
- Close bandwidth-heavy apps in the background — video streaming, large downloads, and live calls all compete.
- For the best stability, connect the host by Ethernet. A wired host alone resolves the majority of laggy sessions.
- Confirm both devices are on the same local network so Remio uses the direct P2P path, not the relay.
Plan for at least 5 Mbps for 1080p and 20 Mbps for 4K. Below those bands the encoder will keep up but the network cannot.
SYM-04 Why is my Remio stream stuck on a black screen?
LIKELY CAUSE
The host connected successfully but cannot read pixels from the display. This is almost always the Screen Recording permission, especially after a macOS update.
FIX
- Open System Settings → Privacy & Security → Screen Recording.
- Confirm Remio Host is in the list and enabled. If it is not in the list, drag the Remio Host app in from
/Applications. - If it is already enabled, toggle it off and on — recent macOS updates can quietly invalidate the grant.
- Quit the host fully from the menu bar and relaunch it.
- If the screen is still black, remove Remio from the Screen Recording list, re-add it, and relaunch.
Screen Recording is the only macOS permission Remio cannot work around. Without it the host can pair but has nothing to send.
Audio is missing or wrong
Audio is captured from the Mac's system output and streamed to the client. If it is missing, the question is whether the Mac is producing audio in the first place — and whether the client is set up to play it.
SYM-05 Why is there no audio coming through my Remio session?
LIKELY CAUSE
The Mac is muted, the client is on silent mode, the audio output device is misrouted, or the host has not received audio capture permission.
FIX
- Check the Mac is not muted and the volume is turned up.
- Confirm the Mac's output is going to the speakers you expect — open System Settings → Sound → Output and pick the right device.
- On iOS, flip the silent mode switch and raise the device volume.
- Open System Settings → Privacy & Security on the Mac and confirm Remio Host has permission to capture audio.
- If audio still does not arrive, quit and relaunch the host so it re-initialises the capture tap.
Some DRM-protected apps deliberately block their audio from being captured. This is by design and not a Remio bug.
Keyboard or pointer is not working
Input requires its own macOS permission: Accessibility. Without it, you will see the host fine but every click and keystroke is dropped.
SYM-06 Why is my keyboard or mouse input not working in Remio?
LIKELY CAUSE
The Accessibility permission has not been granted to Remio Host, or it was revoked after a macOS update.
FIX
- Open System Settings → Privacy & Security → Accessibility.
- Confirm Remio Host is listed and the toggle is on.
- If it is already on, toggle it off and back on to re-arm the permission.
- After a macOS update, remove Remio from the list with the minus button, re-add it from
/Applications, and relaunch the host. - Restart Remio Host whenever you change the permission.
Accessibility is what lets Remio translate taps and keystrokes from the client into real mouse and keyboard events on the Mac. Without it, the picture comes through but you cannot interact.
If nothing above matches
For anything more unusual, the host writes a diagnostic log you can attach to a support email. Run the command below on the Mac and the most recent host log will be revealed in Finder.
open ~/Library/Containers/com.remio.server/Data/Library/Caches/Logs/
Send the latest file to support@remio.net along with a one-line description of what you were trying to do. We typically reply within a business day.