User manual
Install one app on each machine, sign in with the same email everywhere, and your machines find each other. This manual covers the current apps for Mac, Windows, Linux, iPhone and iPad, from the first sign-in to sharing a machine with someone for an hour.
Written for the November 2026 betas: Mac 0.4.56, Windows and Linux 0.8.49, iOS 0.2.26. Where a platform does something differently, it says so. Older builds won't have everything here, and much of it is new, so tell us if anything doesn't match what you see.
Step 1Install
Which app goes on a machine depends on whether you sit at it or only reach it.
The Mac apps need macOS 15 or later on an Apple Silicon Mac. The Windows apps need 64-bit Windows 10 or later on an Intel or AMD PC; see Windows notes for the SmartScreen prompt. SharpDesk is free for a limited time.
Step 2Sign in
- Open the app and enter your email. A 6-digit code arrives from
[email protected]. - Enter the code. This machine joins your account.
- Do the same on every machine, with the same email. Each machine then appears in the others' lists.
- On a Mac, PC, iPhone or iPad, approve the new device from one you already use.
There are no passwords, IP addresses or ports. On a Mac, iPhone or iPad you can add a passkey after the first sign-in, so later sign-ins don't need an email.
After the first sign-in, a Mac opens Set Up SharpDesk (Set Up SharpDesk Host in the Host app) and asks for:
- Screen Recording, so your other devices can see this Mac's screen.
- Accessibility, so your other devices can use its mouse and keyboard. On the Mac you sit at, it also lets SharpDesk measure a third-party viewer's window for Sharpen.
- Launch at Login, so the Mac is ready whenever you sign in.
Local Network and Available Before Sign-In are optional. You can change all of them later in System Settings.
Step 3Approve a new device
Your account keeps a list of the devices you trust. A new Mac, PC, iPhone or iPad joins that list only when a device already on it approves it. This stops someone who gets into your email from quietly adding their own computer.
On the new device
After sign-in it shows Approve this device from one of your other devices, with a six-digit code (for example 482 913) and a QR code.
On a device you already use
Check the name it shows, such as Approve “Reception PC” (Windows)?, then choose Approve. That device can now connect to every machine on your account.
Each code works once. If it's typed wrongly, the new device shows a fresh code; use that one.
A device already on your list that lost its security key, say after a reinstall, goes through the same steps. You'll see “name” lost its key. Approve its new one? Only say yes if that is really your device: it replaces the old key, and a device still using the old one stops working.
Machines that only host
SharpDesk Host on a Mac or PC, and the Linux agent, don't need a code. They prove who they are when they sign in, and the next time one of your Macs, PCs, iPhones or iPads is online it adds them by itself. Activity shows Added host name when that happens.
Step 4Connect to a machine
In SharpDesk for Mac, open the Machines window, select a machine and press Connect (⌘↩). Double-clicking a machine in the list does the same, and the menu-bar panel has a Connect button on each row.
The machine's picture opens in its own window, and you use it with your own pointer and keyboard. To end the session, choose Disconnect (⇧⌘E) or close the window.
On Windows, click Connect on the machine's card. On iPhone and iPad, tap the machine, then Connect. Linux boxes can be viewed on amd64; see View a Linux box in SharpDesk.
If the machine asks before letting anyone in (see Ask before connecting), you'll see Asking machine for permission… until someone there answers. If the toolbar says View only (set on the machine), that machine has Allow control turned off: you can watch, but not click or type.
Picking a display
Each machine's page has a Next session section, folded until you open it. Its Display choice sets what Connect shows:
Arrangement (Your default, Extend or Mirror) applies to a sharpened display: Extend adds it beside the host's own screens; Mirror shows the same desktop on them.
During a session, Display in the viewer's toolbar switches between the sharpened display, the machine's own screen, or a single screen. It appears when the host has two or more screens.
The toolbar also has Control (⇧⌘C) to turn your pointer and keyboard on or off, Blackout (⇧⌘B, Mac hosts only) to darken the host's own displays while you view it, and Full Screen. Hide Bar (⌥⌘T) in the View menu hides the toolbar. Anything not on the bar is under More, along with Customise Toolbar….
Keyboard and pointer
While your pointer is inside the picture and Control is on, every key goes to the far machine, including ⌘Tab, ⌘Space, ⌘W and ⌘Q. Media keys stay on your Mac. Move the pointer out of the picture to get your keyboard back.
The first time you type in a session, macOS needs to let SharpDesk see those shortcuts. A banner asks you to allow SharpDesk in Input Monitoring; click Grant….
If the Mac viewer's Keyboard button turns into an orange warning triangle, another app on your Mac is holding Secure Input, usually a password field. The button names the app; close that field and your shortcuts come back.
Shortcuts… in the More menu lets you remap keys for one machine.
Sound
Mac and Windows hosts send sound; Linux hosts don't. Turn it on with Sound in the toolbar; it starts off on a Mac viewer. To have it on by default for a machine, use the Sound switch in its Next session section. A Windows host goes silent while it's locked or at its sign-in screen.
FileVault restarts
A Mac with FileVault normally stops at the disk password after a restart, where SharpDesk can't reach it. If you choose to, you can save that password on the Mac in Settings → This Mac → FileVault restart recovery, so a restart comes back to the normal login window. Then, while connected, choose Arm FileVault Recovery from the Machine menu before you restart it.
Wake a sleeping machine
An offline machine offers Wake: in the ··· menu of its page on a Mac, as a button on its page on iPhone and iPad, and in the card's menu on Windows. Another of your machines on the same network sends the wake signal, and SharpDesk watches for 90 seconds for it to come back. If more than one could do it, you choose with Wake using.
It needs another machine on your account that is on and on the same network. The sleeping machine must have Wake on LAN turned on, and must have been online with SharpDesk at least once so SharpDesk knows how to reach it.
Record a session
Record saves what you see to a video file on the device you're viewing from. It's video only, with no sound, and the machine you're viewing is not told. Use Stop Recording to finish.
Movies/SharpDesk.Videos\SharpDesk.Send files and the clipboard
Sharing the clipboard and sending files need two switches, and both start off: one on the machine being reached, and one on the device you connect from. A machine that shares its clipboard also accepts files.
SharpDesk. Macs set up before October keep the setting they had.Downloads\SharpDesk.On the device you view from, turn on Share clipboard and files with this machine on the machine's page (Mac and iPhone/iPad), or Share Clipboard and Files in the viewer's toolbar (Share Clipboard on Windows). If the host's own switch is off, it says so and names the switch to turn on there.
On a Mac, send files by dragging them onto the viewer window, or with Send Files… in the toolbar's More menu. Files only, not folders. The confirmation says where they were saved. Anything your password manager marks as concealed is never copied across. Then send files by dragging them onto the viewer window, or with Send Files… in the toolbar's More menu. Files only, not folders.
The Windows viewer sends files too, with Send files… or by dragging them onto the window.
Files from the machine you're viewing
The person at a machine can send files to you while you're connected. Turn on Allow incoming files on the device you view from first; it's off by default, and nothing is ever opened for you.
SharpDesk/Incoming in your home folder.SharpDesk ▸ Incoming.Downloads\SharpDesk\Incoming.To send, on a Mac host use the Send Files… strip in the menu-bar panel; on a Windows host, Send Files… in the SharpDesk Host window; on Linux, sharpdesk-agent send file. These appear only while someone is viewing. If the viewer's switch is off, the sender sees They haven't turned on Allow incoming files.
Terminal
You can open a command line on a host. It runs as that host's user. It is off on every host until you turn it on there:
sharpdesk-agent config set allowTerminal true. See Linux configuration.On the Mac, choose Terminal… (⌃⌘T) from the Machine menu or the machine's ··· menu. It asks for Touch ID, or your login password on a Mac without Touch ID, before it opens. The item is greyed out for a host that hasn't allowed it.
Chat
While someone is connected, the two of you can send short text messages. In a viewer, use Chat in the bar; it shows a badge when there's something unread. Sent messages are marked Delivered once they've shown on the other side.
On a Mac host, a message appears in the menu-bar panel with Reply; the person there can also start a chat with Message the viewer. On a Windows host, a notification offers a reply box, and the SharpDesk Host window can start a chat too. A message stays on screen until it's dealt with. A Linux host shows a desktop notification and can't reply.
Chat is never stored. Messages show on screen and nowhere else: not on SharpDesk's servers, not in Activity, not on either machine. They're gone when the session ends.
Sharing with peopleWhich way to share?
There are two ways to bring in someone who doesn't have a SharpDesk account. They look alike, because both use a 12-digit code, but they go in opposite directions.
| Guest invite | Quick Connect | |
|---|---|---|
| Use it to | Let someone see one of your machines | See and fix their computer |
| Who starts it | You, with Invite a guest… | They download Quick Connect, and it shows a code |
| What gets sent | You send them a link | They read you a code |
| What they need | A web browser (or a SharpDesk app) | The Quick Connect app on their Mac or PC |
| Control | View only unless you allow control | You see and control their computer once they click Accept |
| Example | Showing the practice manager the booking screen | Helping a relative with their laptop |
In this manual, a guest is always someone looking at your machine through an invite.
Guest invites (web link)
An invite lets someone without a SharpDesk account see one of your machines for a short time, from a web browser. You make a link and send it however you like (Messages, email). Normally the first person to open it is your guest and it can't be used again; you can also let up to three people use the same link.
Making an invite
- Find Invite a guest…:
- Mac: the ··· menu on the machine's page, or the bottom of People in the viewer's toolbar while you're connected.
- iPhone and iPad: on the machine's page, or in the viewer's More sheet while you're connected.
- Windows: the machine card's ··· (More actions) menu.
- Choose the Kind:
- Assist (the default): they can join only while you're connected to that machine, and they leave when you disconnect. Use this when you're working together.
- Timed: they can stay for the whole session, even after you disconnect.
- Choose what they can do: View only (the default: they see the screen and can chat) or View and control (they can also use the mouse and keyboard). This choice is labelled Access on Mac and iPhone, and What they can do on Windows.
- If the machine can seat several people, choose Guests: 1, 2 or 3. Each guest uses the same link; one can control at a time and the others watch.
- Optionally fill in Who is it for?, such as “Mum” or “IT support”. The label shows on the machine while they're connected.
- Pick how long Link works for (10 minutes, or 5 minutes) and how long They can stay once they're in (30 minutes, 1 hour, 2 hours or 4 hours; 1 hour is the default). For Assist this is the longest they can stay.
- Choose Create Link. Send the link with Copy Link (or Share on iPhone), show them the QR code, or read out the 12 digits underneath for someone using Connect with Code… in a SharpDesk app.
The link looks like https://viewer.sharpdesk.app/#481203559170. The part after the # is the secret, and a browser never sends that part to any server, including SharpDesk's.
Your machine's page then lists the guest, for example Guest Mum · Waiting for the link to be opened · 7 min left · view only, and later Connected · 45 min left (or Connected · Until you disconnect · 45 min max for Assist).
What your guest sees
- They open the link in a current Safari, Chrome, Edge or Firefox. A page explains that someone has sent them a SharpDesk invite. Nothing connects until they press Join, so a link preview in a chat app can't use the invite up.
- After Join, the page shows its progress. With an Assist invite, they can only get in while you're connected to the machine. If your machine asks before connecting, it says Waiting for someone at machine to allow this connection.
- The picture appears. The bar at the top has Control and Keyboard (only if control is allowed), Full Screen, Chat and Leave. When other people are connected it also has People, Request control and Release control; see People.
The picture in a browser is a little slower and softer than in the SharpDesk apps. It suits a short look or helping out, not a day's work.
What a guest can and can't do
A guest can see the screen, hear its sound if the browser supports it, and chat with you. With View and control they can also use the mouse and keyboard, but only if the machine's own Allow control is on: the machine always has the last word.
A guest can never copy and paste, send or receive files, open a terminal, change the screen size, type stored passwords, or update or restart the machine. There's no setting to allow these.
If the machine has Ask before letting someone connect on, it asks when the guest arrives: Guest Mum (web link) wants to see this Mac. You invited them with a link. Allow it? If nobody answers within 30 seconds, the guest isn't let in.
Ending an invite
Press End beside the guest on the machine's page (on Windows, in the Invite a guest… window). Their page says The owner ended this session, and the link can't be used again. If you're connected too, Remove guest in People ends one guest; theirs says Machine's owner ended your session. An Assist guest leaves a few seconds after the last of your devices disconnects. Otherwise the invite ends by itself when its time is up, and the guest can press Leave at any time.
People: more than one viewer
Up to four people can be connected to one machine at once: you, your other devices and your guests. They all see the same picture, and one at a time is in control. While you watch on a Mac, iPhone or iPad, the pointer of whoever is in control is drawn on your picture. Quick Connect stays one to one, and machines on older builds take one viewer at a time.
People in the viewer's bar lists who's there, such as Daniel's Mac (you) and Guest Ana (web link), and who is In control. On iPhone and iPad it's a section in the Controls sheet.
Activity keeps a record of control changing hands and of people being removed.
Quick Connect
Quick Connect lets you help someone who has no SharpDesk account, on their own Mac or PC.
- Send them to sharpdesk.app/quick.html. They download Quick Connect, open it, and read you the 12-digit code it shows.
- Choose Connect with Code…:
- Mac: the Machine menu (
⇧⌘K), the toolbar, or the menu-bar panel. - iPhone and iPad: the + menu on the machine list.
- Windows: the gear (SharpDesk menu).
- Mac: the Machine menu (
- Type the code and choose Connect. Their screen asks them to Accept, and you see Waiting for them to accept….
- Once they accept, you see and control their computer. Their screen says who is connected, with an End button they can press at any time.
A code works once and expires after a few minutes; Quick Connect shows a New Code button when it does. Connect with Code needs you to be signed in. The same box also takes a guest invite's 12 digits or whole link.
Machines you hostPermissions for your devices
Every machine you can connect to has a group of switches called Permissions for your devices. They decide what anyone who connects to that machine may do, and that includes your own devices and your guests.
sharpdesk-agent config set …; see Linux configuration.Allow control: view only
With Allow control off, a machine is view only. People can connect and see the screen, and nothing more on that machine changes: no clicks or typing, no Type Password or Ctrl-Alt-Del, no Sharpen, Blackout or screen-size changes, no FileVault recovery. Their toolbar says View only (set on the machine), and it updates straight away if you flip the switch during a session.
Terminal, clipboard and files have their own switches, so turn those off too if you want a machine that can only be watched.
This is different from the Control button in a viewer's toolbar, which only pauses your own pointer and keyboard. The machine's switch wins.
Ask before letting someone connect
Turn this on for a machine that has people sitting at it, such as a reception PC. Whenever anyone connects, including you from your own devices, the machine shows a box: Daniel's iPad wants to connect. Allow it? with Allow and Deny.
- If nobody answers within 30 seconds, the answer is no. Allow needs a real click:
Escsays no, and on Windows so doesEnter, so a stray key press never lets someone in. - The box can't be clicked from the remote side, and it isn't shown in the picture being sent.
- On a Windows PC it also appears on the lock screen and the sign-in screen, so a locked PC can still be let in.
- One Allow covers one view. Opening a terminal, sending files, Type Password or Ctrl-Alt-Del each ask again. A brief network drop doesn't.
- After a Deny, that device's next tries are refused quietly for a minute, then for longer with each Deny, up to 15 minutes. An Allow clears this.
Only at certain times: on a Mac or PC, set When to Only between set hours and choose From and Until (09:00 to 18:00 to start with). Outside those hours your devices connect without asking. A session that started before the hours begin isn't cut off, but anything new it does will ask.
The hours use the machine's own clock, every day. To limit a Windows PC to certain days, run this from a Command Prompt:
"%ProgramFiles%\SharpDesk\sharpdesk-agent.exe" config set askBetweenHours "09:00-18:00 mon-fri"
Use always instead of the hours to ask every time again. Linux machines don't offer asking yet.
Who's connected right now
- On the machine itself: the Mac menu-bar panel says Being viewed by Daniel's iPad since 14:02, or Guest Mum (web link) for a guest, or Daniel's Mac and 2 others for several people, and who is in control. A Windows host shows the same in the SharpDesk Host window. A Linux host can run a hook when someone connects.
- In your machine list: a machine someone is using shows Being viewed from device with an eye.
Activity
Activity lists who connected to which of your machines, and what changed on your account, for the last 90 days. It's on Mac under Settings → Account → View Activity…, and on iPhone, iPad and Windows under Settings → Account → Activity. Filter it to one machine with the machine picker.
It records connections (Reception PC connected to Mac mini, marked invite for a guest or one-off for Quick Connect) and account changes: devices added or removed, hosts added automatically, passkeys, email changes, invites made and ended, control changing hands, people removed from a session, and account resets. It never records what was on screen, what was typed, chat, or where anyone connected from.
If you see a device you don't recognise, use Revoke… on its row. That signs it out of your account straight away, and it has to sign in again by email to come back. A session it has open is ended within a minute.
Needs attention
When a machine has been offline for over a day, has a SharpDesk update waiting, has updates and restarts switched off, or its last update or restart failed, the machine list shows a Needs attention filter with a count. On Mac and iPhone/iPad, open it to select machines and choose Update… or Restart… for all of them at once. SharpDesk does three at a time and waits for anyone using a machine to finish first. The Mac sheet also has Email me when it goes offline for each machine.
Hosting settings on a Mac
Settings → This Mac, in both SharpDesk and SharpDesk Host, has the permissions above and these:
Your accountDevices and removing them
On a Mac, Settings → Account → Devices lists every device on your account as Approved, Not approved or Removed, and shows Waiting for approval beside one that is asking. On iPhone and iPad it's Settings → Account → Devices. On Windows, an unapproved machine has a Not approved badge on its card.
- Removing a Mac, PC or Linux box. On a Mac, choose Remove name… from the machine's ··· menu or the Machine menu. On a Mac's own page it reads Remove This Mac….
- Removing a phone or tablet. On a Mac, use Remove… on its row in Settings → Account → Devices. You can also use Revoke… in Activity on any platform.
- What happens to a removed device. It is signed out at once, and any session it has open is ended. To come back, it signs in again by email and must be approved again.
- Adding a removed machine back. A removed host stays out even if it signs in again. Use Add Back… on its row.
- Signing out. Mac: Settings → Account → Sign Out…. Your machines stay on your account; this Mac stops hosting and stops listing them until you sign in again.
Passkeys
On a Mac, iPhone or iPad you can sign in with a passkey instead of waiting for an email code. After an email sign-in, SharpDesk offers once to Add a passkey. Manage them in Settings → Account → Passkeys with Add Passkey…, Rename… and Remove…. Adding one asks for an emailed code first, and you get an email whenever one is added. Passkeys sync to your other Apple devices through iCloud Keychain.
Removing a passkey doesn't sign any device out. Windows doesn't support passkeys; sign in there by email.
Changing your email
Settings → Account → Change Email… (Mac), Email (iPhone and iPad) or Change Email (Windows). Confirm it's you with a passkey or a code sent to your current address, then enter the new address and the code sent there. Your devices stay signed in, your passkeys keep working, and your old address is told about the change.
Signing in again every two years
A sign-in lasts two years. From 30 days before, the machine shows Sign in again before date to keep hosting working, and you get a reminder email. Choose Sign In (Sign In Again… on Windows) and enter the emailed code; nothing is signed out while you do. On Linux, run sharpdesk-agent login. If the date passes, the machine stops being reachable until someone signs in on it.
If you lose all your devices
Approvals come from your other devices, so losing every one of them needs a recovery step.
- With a passkey (Mac, iPhone, iPad): SharpDesk asks you to Make your passkey usable for recovery. Then, on a new device's approval screen, choose Bring it back… on a Mac, or Lost your other devices? Use your passkey on iPhone and iPad. Your machines trust the new device and forget the old ones; you approve each of your other devices again.
- Without one: the apps can't start a recovery yet. While approval is being rolled out, a new device you sign in to by email still works without being approved. If you're stuck, email [email protected].
A passkey recovery takes effect at once and can't be cancelled; you get an email and an entry in Activity saying it happened.
Your own viewerSharpen with your own viewer
If you prefer another viewer app, such as Screens, Apple Screen Sharing or a VNC client, SharpDesk can still make the picture sharp. It resizes a display on the host to fit your viewer's window, follows as you resize it, and shows nothing itself. The picture stays in your viewer app.
Macs can be sharpened this way, and Linux boxes on Hyprland or Omarchy. PCs can't: their sharpened display is viewed in SharpDesk.
- In the Machines window, select the machine and choose Sharpen only (for another viewer app) from its ··· menu.
- Connect your viewer to that machine as usual. Open Viewer on the machine's page launches it for you, once SharpDesk knows the host's network name. The menu beside it chooses Screen Sharing (Apple), Screens or Custom URL…, a URL with a
{host}placeholder for any other viewer. - SharpDesk sizes the host's display to your viewer window. Closing the viewer hands the display back, unless you've chosen to keep it sharpened (below). To hand it back yourself, choose Unsharpen.
While it runs, Machine Settings… (⌘I) has the Arrangement (Extend or Mirror), Black out host display, and Restore Displays.
Auto-sharpen when you connect a viewer
Settings → Sessions → Auto-sharpen when I connect a viewer. It is off by default. When it's on, SharpDesk watches for a viewer window pointed at one of your machines and sharpens that machine without you choosing it first.
Viewers it recognises: Screens, Apple Screen Sharing, RustDesk, Jump Desktop, VNC Viewer, Microsoft Remote Desktop, AnyDesk, TeamViewer and Parsec. Version suffixes such as “Screens 5” count too.
Mac-Mini-UK.local finds “Mac mini UK”.Also in Settings → Sessions: Match display under For new sessions picks Automatic or an entire screen of yours to match. After another viewer app disconnects picks Restore the host's display or Keep sharpened for up to 8 hours.
Size and following
Under More settings on the machine's page, or in Next session on a machine set to Sharpen only (for another viewer app):
Machine Settings… (⌘I) has the same Screen choice (Match the window or Fixed size) and Follows, which picks what is matched: the Frontmost window, an entire screen, or one window you name. Make this the default saves the choice for new sessions. If a session matched the wrong window, pin your viewer here.
The sharpdesk:// URL API
Anything that can open a URL, such as a Shortcut, a script or a launcher, can tell SharpDesk for Mac to sharpen a machine to an exact size.
sharpdesk://apply?width=1512&height=982 (1 to 8192 each)…&host=Mac%20Mini: a device name (any case) or device id. Without it, the selected machine, or the only one online.&scale=1 to 3 (default 2) · &mode=extend|mirror · &blackout=1|0. Without mode or blackout, the machine's remembered setting.sharpdesk://restore, with the same host parameter.From a terminal: open "sharpdesk://apply?width=1512&height=982&host=Mac%20Mini". An invalid value rejects the whole command. SharpDesk Host ignores these URLs.
An apply from a URL stops window-following, since you've given the exact size. To follow the window again, choose Match the window under Screen in Machine Settings (SharpDesk 0.4.21 or later).
x64 · Windows 10 or laterWindows notes
- SmartScreen. The installers are signed, but the apps are new, so your browser and SmartScreen may warn the first time. When the browser asks, choose Keep. If Windows says “Windows protected your PC”, click More info, then Run anyway.
- Sharpened display. The installer adds SharpDesk's own virtual display driver, so a PC can offer a sharpened display. You view it in SharpDesk; a PC can't be sharpened for a third-party viewer.
- Clipboard and files on a Windows host are off until you turn on Share the clipboard and files. Received files land in
Downloads\SharpDesk. - Host switches. In SharpDesk for Windows they're under the This PC button at the top of the window; in SharpDesk Host, in the window that opens from the tray. See Permissions for your devices.
- Not on Windows yet: passkeys.
- Sound and clipboard. The Windows viewer plays sound and shares the clipboard, and a Windows host sends sound except while locked. These need 0.8.49 at both ends.
Troubleshooting
The sign-in code doesn't arrive
Check spam for mail from [email protected], then use Resend. It unlocks 30 seconds after each use. Codes expire, so request a fresh one if in doubt.
I can't connect to a Linux box
Viewing a Linux box needs amd64, GStreamer and the agent's host binary. See View a Linux box in SharpDesk, which also says how to find the agent's own reason.
Keys go to the wrong machine
Keys go to the far machine while your pointer is inside the picture and Control is on. Move the pointer out to use your own Mac. If shortcuts like ⌘Tab stay on your Mac, allow SharpDesk in Input Monitoring.
Sharpen matched the wrong window
Open Machine Settings… (⌘I) and pin your viewer with Follows.
A Mac's screens look wrong after a session
On that Mac, open SharpDesk and choose Unsharpen (in the menu-bar panel, or Settings → This Mac → Screens). It puts the physical screens back and removes SharpDesk's virtual display, whatever state they are in.
“Virtual display unavailable: failed to create…”
Another virtual display already owns that Mac. In practice that is Apple Screen Sharing in High Performance mode, which runs its own. Switch that session to Standard mode, or disconnect it, and try again.
A new device says “Approve this device”
Open SharpDesk on a Mac, PC, iPhone or iPad you already use and choose Approve a device; see Approve a new device. If you have no other device, see If you lose all your devices.
I can see the screen but can't click or type
If the toolbar says View only (set on the machine), turn on Allow control on that machine. If it says Watching, someone else is in control; see People. Otherwise check the toolbar's Control button is on and your pointer is inside the picture.
It keeps saying “didn't accept the connection”
That machine has Ask before letting someone connect on, and nobody pressed Allow within 30 seconds. Ask someone there to watch for the box, or change its hours. After a Deny, wait a minute before trying again.
My guest's link doesn't work
A link works once, and only for the time you chose (5 or 10 minutes) until it's opened. If it was already used or has expired, their page says so: make a new one. If their browser is too old, ask them to use a current Safari, Chrome, Edge or Firefox; the link still works until it expires.
How the picture travels
SharpDesk finds the shortest route it can: across your own network if both machines are on it, directly over the internet if it can, or through SharpDesk's relay if nothing else works. Every route is encrypted end to end, so the relay can't see the picture. If a machine has Tailscale, SharpDesk uses that too. There's nothing to set up; the message no route is the only time SharpDesk suggests installing Tailscale.
Lite can't reach the remote Mac
Check that the two Macs can reach each other (same network, or VPN up), that BetterDisplay is running with its HTTP integration on, and that the URL uses port 55777.
What the messages mean
When a connection stops, SharpDesk says why in one sentence, with a button for the next step where there is one. The ones people ask about most:
| It says | What it means, and what to do |
|---|---|
| Machine is offline. | The machine isn't reachable: it's off, asleep, or has lost its internet. Try Wake or check its network; Connect comes back when it does. |
| Machine didn't accept the connection. | It asks before letting people in, and nobody pressed Allow. See Ask before connecting. |
| Waiting for someone at machine to allow this connection. | The machine is showing the Allow/Deny box. Someone there has 30 seconds. |
| View only (set on the machine) | The machine has Allow control off. You can watch but not click or type. |
| Approve this device from one of your other devices. | This device isn't on your account's list yet. See Approve a new device. |
| Another device is already controlling machine. | Someone else is using a machine that takes one viewer at a time. Wait for them to finish, or ask them to disconnect. |
| Machine is not allowed to record its own screen. | On that Mac, open System Settings → Privacy & Security → Screen Recording and turn SharpDesk on. |
| Machine is showing its lock screen or a security prompt. | A Windows PC is at its lock screen or an administrator prompt. Wait a moment, or use Type Password to sign in. |
| Its own screen still works. | The sharpened display couldn't be made this time. Connect to its own screen shows the machine's real screen instead. |
| Sign in again before date to keep hosting working | The two-yearly sign-in is due. See Signing in again. |
| This device was removed from your account. | Someone removed or revoked it. Sign in again by email, then have it approved. |
| There is no route between this network and machine's. | Both networks block every way SharpDesk tries. Installing Tailscale on both machines gives them a route. |
| The owner ended this session. / Machine's owner ended your session. / This invite has expired. | Seen by a guest. Ask the person who invited you for a new link. |
| This link has no room left. | Everyone the link allows is already in. Ask for another. |
| Machine is being used right now. | Seen by a guest when another connection has the machine and it can't seat them. Ask for a new link once they've finished. |
| Machine already has as many viewers as it can take. | The machine is full. Wait for someone to leave. |
| Machine didn't come back within 90 seconds. | Wake didn't work. Check it's plugged in and that Wake on LAN is on in its settings. |
Words we use
No accountSharpDesk Lite
The two pieces
Lite is the do-it-yourself version for BetterDisplay users. It needs no account: a small app on your Mac drives BetterDisplay on the remote one, directly over your own network or a VPN such as Tailscale.
Both Macs must be able to reach each other directly: the same network, or a VPN like Tailscale that gives the remote Mac a stable address.
Setting it up
- On the remote Mac, install BetterDisplay and turn on its HTTP integration in BetterDisplay's settings. The default port is
55777. Set an access token there if you want one; it is recommended outside your own network. - On your Mac, open Lite Client Helper and add a host: pick the BetterDisplay backend and enter the URL, for example
http://192.168.1.20:55777on a LAN orhttp://<tailscale-ip>:55777over Tailscale. Paste the token if you set one. - Pick the remote screen to manage and the viewer window to match, choose Extend or Mirror, and connect your viewer as usual.
Stuck? Write to [email protected]. A human reads it.