Help › Functions

The session: view, displays, special keys, system commands, connection

What you can set during a session and what the indicators mean.

FreemacOSWindowsiPhone & iPad · Coming soonWebAndroidLinux

View

Under View you choose Standard, Compact or Full Screen.

macOS

The shortcuts are ⌃⌥⌘1, ⌃⌥⌘2 and ⌃⌥⌘3. In full screen, ⌃⌥⌘F shows the toolbar.

For the size there is Fit to Window, Actual Size and Match Window. With the last one, the other Mac sets its resolution to your window.

The Compact viewThe Compact view

In full screen the screen edges belong to the other device: move quickly to the bottom or the top and its Dock and menu bar appear. Your Mac’s Dock and menu bar only join them when the pointer rests at the edge for a moment or pushes against it twice. You change this in the settings under Sessions with In full screen: this Mac's Dock and menu bar: Show after a delay (recommended), Never show or Show immediately. This applies while you control the device. ⌃⌥⌘1 or the toolbar always take you out of full screen.

Settings › General: “In full screen: this Mac’s Dock and menu bar” set to “Show after a delay”Settings › General: “In full screen: this Mac’s Dock and menu bar” set to “Show after a delay”

While you control the device there is only one pointer over the picture: your own, in the shape the other device shows right now (an I-beam over text, for example). It follows your hand without delay. When the other device moves its pointer itself, you see it there until you move your mouse again.

Windows

In full screen the session covers the taskbar. If Windows hides the taskbar automatically, it only appears when the pointer rests at its edge for a moment – quick moves there belong to the other device. You change this in the settings under Sessions with In full screen: this PC's taskbar: Show after a delay (recommended), Never show or Show immediately.

While you control the device there is only one pointer over the picture: your own, in the shape the other device shows right now (an I-beam over text, for example). It follows your hand without delay. When the other device moves its pointer itself, you see it there until you move your mouse again.

iPhone & iPad

With a mouse or trackpad on an iPad (and a mouse on an Android device) there is only one pointer over the picture: your own, in the shape the other device shows, as far as the system allows. On the iPad DeskRanger shows the other device’s shape at your pointer’s position; when the other device moves its pointer itself, you see it there until you move your mouse again. With a finger the other device’s pointer stays.

On iPhone and iPad the session fills the screen. The Standard, Compact and Full Screen views are not available there: the toolbar hides itself after a moment, and a small handle at the top edge brings it back.

Under More actions → Scaling you choose Fit to Window, Actual Size or Match Window. With Actual Size one point of the other device is one point of your screen; a larger screen can be moved, and Reset Zoom takes you back to Fit to Window. With Match Window the other device sets its resolution to your screen. If it cannot, or someone is working at its screen, the session says why, and the note also offers Turn On Privacy Mode. You zoom with two fingers as usual.

A running session with toolbar and side panelA running session with toolbar and side panel
The command search in a session, searched for “Scaling”: Fit, Actual Size, Match WindowThe command search in a session, searched for “Scaling”: Fit, Actual Size, Match Window
Notes from the other device over the picture: locked screen, Apple Screen Sharing and a refused resolution change with “Turn On Privacy Mode”Notes from the other device over the picture: locked screen, Apple Screen Sharing and a refused resolution change with “Turn On Privacy Mode”

Web

In the browser there is one view, plus the browser’s full screen mode (Full Screen in the bar). From 900 pixels of window width the bar has words beside the symbols: Control, Keys and Exchange; in full screen and in narrow windows it shows symbols only, and the tooltip names the word. A privacy mode that is on appears as the red capsule Privacy mode. The More menu has the same four groups as in the apps, as far as a browser can: views, the side panel, typing a password and session settings are not there. Under Picture size you choose Fit to Window, Actual Size or Match Window. With the last choice the other device sets its resolution to the area of the picture in your tab, even when you drag the window larger or smaller. If it cannot, the session says why.

While you control the device there is only one pointer over the picture: your own, in the shape the other device shows right now (an I-beam over text, for example). It follows your hand without delay. When the other device moves its pointer itself, you see it there until you move your mouse again. If a shape is too large for the browser, you see the other device's pointer at its own position instead.

A session in the browser: toolbar with display, privacy mode and clipboard, the desktops in the System menuA session in the browser: toolbar with display, privacy mode and clipboard, the desktops in the System menu

“… won't change its resolution: someone may be working at its screen. Privacy mode or a setting there allows it.”

A display is attached to the other Mac, and someone may be working at it. So that nobody's windows move around there, it only matches its resolution in privacy mode or when Match resolution for sessions is on in its settings under This Mac. After the session it restores the resolution.

“… has no screen attached – the resolution is fixed. A connected screen or DeskRanger’s virtual screen changes that.”

A Windows PC without a screen attached still shows a picture, but at a fixed size that your window cannot change. Match Window has no effect there. DeskRanger's virtual screen, a connected screen or an HDMI dummy plug in the graphics card change that; the section "A Windows PC without a screen" further down describes the way. The link What helps? in the note leads there.

Using your fingers (iPhone and iPad)

The mode button in the toolbar shows the mode's symbol and name and switches between three modes:

  • Direct: a tap clicks right under your finger. Good for large buttons, the iPad and devices with a touch screen.
  • Trackpad: your finger moves the pointer like on a laptop trackpad, and a tap clicks at the pointer. Good for small targets on the iPhone.
  • View only: nothing goes to the other device. You only move and zoom the picture.

Until you choose, DeskRanger suggests a mode: Trackpad on the iPhone, Direct on the iPad. With a mouse or trackpad at the iPad the pointer always acts directly, and the mode button is not shown. DeskRanger remembers the last mode for each device.

In Direct and Trackpad modes, these gestures control the other device: a tap clicks, two taps double-click, a two-finger tap is a right click. Touch and hold opens a loupe above your finger. When you lift, DeskRanger clicks exactly there, and a second finger right-clicks there. Tap, hold and drag drags, for example a window or a selection. Dragging with two fingers scrolls, pinching zooms the picture on your side, and a two-finger double tap zooms in or shows the whole screen again. While the picture is zoomed, one finger moves it in Direct mode. In View only mode, you only move and zoom your picture.

From 150 % zoom a small overview at the top right shows the whole screen and your part of it. Tap to jump there, drag to move. When the on-screen keyboard comes up, DeskRanger zooms the place you last tapped so it is readable above the keyboard and the key bar. When the keyboard goes, the old zoom comes back. Zoom, loupe and overview stay on your device; the other device does not notice them.

Hold the iPhone upright in Trackpad mode and it becomes a laptop: the picture sits at the top at full height and follows the pointer, and the trackpad area with Click and Right click is below. Turned sideways you see the whole screen.

With VoiceOver, DeskRanger announces the new mode and the zoom.

A Windows PC without a screen

A Windows PC without a screen attached shows a picture of a fixed size in the session, and your window cannot change it. That affects PCs in a cupboard, servers, virtual machines and PCs that only have another maker's virtual display. A note over the picture tells you so, with the link What helps? that leads here. There are two ways out:

  • DeskRanger's virtual screen. You set it up at the PC with one button: Settings → This PC → Virtual screen → Set Up…. After that DeskRanger creates a screen of its own, even before anyone signs in. It has the size of your window: Match Window works there as it does with a Mac, and the next time you connect, the size you used last is back. The note over the picture goes away as soon as the screen is up.
  • A real screen or an HDMI dummy plug. Windows then sees a real screen. This also helps on PCs where the virtual screen cannot be set up. PCs with an ARM64 processor do not have the virtual screen yet; there this is the way.

If no screen is attached to the PC, the virtual screen is the main screen as soon as it exists: the taskbar with the icons next to the clock, new windows and Windows' sign-in appear there, also before a session and between two sessions. DeskRanger switches off the graphics output with nothing attached, as Windows' “Second screen only” does, so no window opens where nobody can see it. If you make another display the main screen in Windows yourself, DeskRanger leaves it that way until the PC's displays change or the PC restarts. When a real screen comes, Windows brings back its own arrangement, and the real screen is the main screen.

It is different when DeskRanger cannot be sure that nobody sits in front of another display. That is the case for a screen that does not report its data (at a KVM switch, for example), for a virtual machine and for another vendor's virtual screen. Then the virtual screen is the main screen only for the session that uses it, that is, once it has the size of your window and nobody is working at the PC itself. When the session ends, the display that was the main screen before is the main screen again. Between two sessions DeskRanger changes nothing about it. The virtual machine's own display stays on, because someone may be watching it at the computer; the session's red frame shows there too. What you typed when signing in through DeskRanger does not count as someone working at the PC. If you open the DeskRanger window during a session, it appears on the screen your session shows.

A session that someone accepted at the PC gets no virtual screen. Someone is sitting in front of the PC's screen there, and DeskRanger then changes nothing about its displays. In such a session the picture keeps its size.

You do not have to walk to the PC. In a session on your own, unattended PC, the note over the picture carries the button Set up virtual screen. It asks DeskRanger on the PC to do exactly what Set Up… does there. Windows then asks twice: first “Yes” (may DeskRanger make changes to the PC?), then “Install” (the device software). In your own session you answer both prompts right in the picture; in a session that someone accepted at the PC there is no button, and the person at the PC answers. The button only shows where the PC can set the driver up. If the line below it says someone has to be signed in at the PC, sign in – that works from the session too – and choose the button again. The same goes if DeskRanger has to be open on the PC: open it there and choose the button again. If it does not work, DeskRanger on the PC shows why under Settings → This PC → Virtual screen.

Windows

This is how you set up the virtual screen:

  1. At the PC, open Settings → This PC and choose the button Set Up… at Virtual screen.
  2. Windows asks whether DeskRanger may make changes to the PC. Choose "Yes". This needs an administrator account of the PC.
  3. Windows then asks whether you would like to install the device software. Choose "Install".

That is all. After a few seconds the choice appears in the same place, and a PC without a screen gets its virtual one. DeskRanger never installs the driver by itself, not even with an update: it always takes your click and Windows' two prompts. You answer the prompts at the PC or from a session from one of your own devices. In a session that someone accepted at the PC, the person at the PC answers them.

If you decline one of the two prompts, or DeskRanger was installed unattended, for example by IT without questions, DeskRanger keeps working without the virtual screen, and you can set it up later in the same place.

If the PC has no screen, DeskRanger shows the note This PC has no screen there once, with the button Set Up Virtual Screen…. It leads the same way.

If it does not work, the reason is under the row, and Try Again starts a new attempt. If the button is missing, the switch Reachable before login and while the screen is locked on the same page is off: turn it on first, because the virtual screen belongs to that service.

After that you choose in the same place when the virtual screen exists:

  • Automatic (the default): only while the PC has no screen. When a real screen comes, DeskRanger takes its own away after a few seconds, and when the real screen goes, it comes back.
  • Always: also beside a real screen. It then only joins.
  • Never: never. An existing virtual screen is removed.

The line below says what size the virtual screen has right now. Only an administrator of the PC can change the choice. With Remove… you take the driver off the PC again; Windows asks for an administrator once. While a connection is using the virtual screen, the link is greyed out; it works again as soon as that connection has ended.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Hidden window

macOS

While the session window is minimised, fully covered or on another desktop, the other device stops sending the picture after a second. That saves its computing power and, on the go, your data. The session carries on, sound and control too, and nothing changes on the other device. Show the window again and a fresh picture arrives at once. To switch this off, go to Sessions in Settings and turn off Pause the picture while the window is hidden.

Windows

While the session window is minimised, the other device stops sending the picture after a second. That saves its computing power and, on the go, your data. The session carries on, sound and control too, and nothing changes on the other device. Bring the window back and a fresh picture arrives at once. A window that other windows merely cover keeps its picture, because Windows does not tell an app about that. To switch this off, go to Sessions in Settings and turn off Pause the picture while the window is hidden.

iPhone & iPad

While DeskRanger is not in front on your iPhone or iPad, for example in the app switcher, behind another app or with Control Centre open, the other device stops sending the picture after a second. That saves its computing power and your data. The session carries on for a short time in the background, and a fresh picture arrives at once when you come back. To switch this off, go to Sessions in Settings and turn off Pause the picture while the window is hidden.

Web

While the tab with the session is out of sight, for example behind another tab or in a minimised browser window, the other device stops sending the picture after a second. That saves its computing power and your data. The session carries on, and a fresh picture arrives at once when you open the tab again. To switch this off, go to Sessions in Settings and turn off Pause the picture while the window is hidden. The choice is kept in this browser.

Android

While you are away from the app or the phone is locked, the other device stops sending the picture after a second. That saves its computing power and your data. When you come back, a fresh picture arrives at once. To switch this off, go to Sessions in Settings and turn off Pause the picture while the window is hidden.

Linux

While the session window is minimised or hidden, for example on another workspace, the other device stops sending the picture after a second. That saves its computing power and your data. The session carries on, sound and control too, and a fresh picture arrives at once when you show the window. A window that other windows merely cover keeps its picture unless your desktop reports it as hidden. To switch this off, go to Sessions in Settings and turn off Pause the picture while the window is hidden.

Several displays

If the other device has several displays, you pick one of them or All displays. Next Display moves on, on the Mac also with ⌃⌥⌘D.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the browser you pick the display in the bar’s Display menu or under Display in the More menu. It appears as soon as the other device has more than one display. The browser has no All displays.

Desktops

If the other device reports its desktops, they are listed under Desktops, numbered as they are there. The one shown is marked. If you pick another, DeskRanger switches there with the other system’s shortcuts.

iPhone & iPad

On iPhone and iPad they are in the More actions menu and in the command search. Find Command… is there too. You type part of a name, for example “Desktops”, and DeskRanger shows the matching commands.

The command search in a session, searched for “Desktops”The command search in a session, searched for “Desktops”

Web

In the browser the desktops are in the More menu under Desktops.

The bar

macOS

The bar at the top of the session window always has the same parts, left to right: the other device's name with the connection dot, Display n (only with several displays), Control, Keys, Exchange, the sound symbol, More actions, full screen and End session. From about 900 points of window width the word stands beside the symbol; in a narrower window, or in the Compact or Full Screen view, only the symbols stay and a tooltip names the word. While Privacy Mode is on, a red badge stands beside them.

Keys opens a window with six large tiles for the other device's system, for example Mission Control, Spotlight and Lock Screen on a Mac, Start menu, Search and Task Manager on a Windows PC, or Settings and Files on a Linux computer. Under each tile are the keys that act there, by name. More key combinations are under More below, plus the desktops and the switch for system shortcuts. Exchange opens the side panel with clipboard and files.

The More actions menu has four groups: Picture, commands for the other device, Exchange and Session. Show keyboard shortcuts shows every shortcut of this session with the names of the keys. In the command palette (⌃⌥⌘K) you also find every command by everyday words: "ctrl alt del" leads to a Windows PC's security options. On the Mac, "Find Command…" at the top of the menu opens a small search field under the button; under "Exchange" there is "Sound" when the session has sound.

Windows

The bar at the top of the session window always has the same parts, left to right: the other device's name with the connection dot, Display n (only with several displays), Control, Keys, Exchange, the sound symbol, More actions, full screen and End session. From about 900 pixels of window width the word stands beside the symbol; in a narrower window, or in the Compact or Full Screen view, only the symbols stay and a tooltip names the word with its keys. While Privacy Mode is on, a red badge stands beside them.

Keys opens a window with six large tiles for the other device's system, for example Mission Control, Spotlight and Lock Screen on a Mac, Start menu, Search and Task Manager on a Windows PC, or Settings and Files on a Linux computer. Under each tile are the keys that act there, by name. More key combinations are under More below, plus the desktops and the switch for system shortcuts. Exchange opens the side panel with clipboard and files.

The More actions menu starts with "Find Command…" and then has four groups: Picture, commands for the other device, Exchange and Session. Show keyboard shortcuts shows every shortcut of this session with the names of the keys. In the command palette (Ctrl+Alt+Shift+K) you also find every command by everyday words: "ctrl alt del" leads to a Windows PC's security options. Under "Exchange" there is "Sound" when this session has sound: a switch that shows whether the sound plays here.

iPhone & iPad

This function is coming soon to iPhone & iPad.

On Linux the bar has the same parts and the same words: the other device's name with the connection dot, Display n (only with several displays), Control, Keys, More actions, full screen and End session. You open the side panel there with the sidebar button in the window's header bar. The words stand beside the symbols from about 900 pixels of window width. Keys opens the same window with tiles and key caps, and the More actions menu has the four groups; only what Linux can already do is listed, so there is no greyed-out dead entry for the rest.

The side panel

macOS

Exchange in the bar opens the side panel beside the picture; in the Compact and Full Screen views it is a drawer over the picture. While transfers run, the button shows their number.

Windows

Exchange in the bar opens the side panel beside the picture. While transfers run, the button shows their number.

iPhone & iPad

This function is coming soon to iPhone & iPad.

The side panel has three parts:

  • Files: a drop zone, Send Files…, the shared folders and a row for every transfer of this session. More under Transfer files.
  • Clipboard: the Share Clipboard switch and the last copied texts. More under Share the clipboard.
  • Connection: a card with connection, latency, picture, data rate, resolution and the session's duration. The same values are under Session details.

On iPhone and Android the session has the sheet behind the handle for this (see “Key bar on the phone”); in the browser the console has its own bar and transfer list.

Key bar on the phone

iPhone & iPad

This function is coming soon to iPhone & iPad.

Android

You switch the key bar on in the sheet behind the handle at the top with the switch “Special keys”. It sits above the on-screen keyboard and shows the keys with the names the *other* device uses: a Windows PC gets Esc, Tab, Ctrl, Alt, Win and Shift, a Mac gets esc, ⇥ tab, control, option, ⌘ command and ⇧ shift. Next to them are the arrow keys, and on the right actions in words such as Copy, Paste and Undo. They send the shortcut the other device understands, so you never need to know whether it is Ctrl+C or ⌘C. What does not fit on a narrow screen moves behind “⋯”.

Tap a modifier key once and it applies to the next key only. Tap it twice quickly and it stays down until you tap it again, shown with a line under the key. While a modifier is down, a row above the bar suggests the usual combinations in words. The small arrow beside the arrow keys opens Home, End, PgUp, PgDn and F1 to F12.

When a hardware keyboard is attached, DeskRanger hides the key bar; every key goes to the other device.

Tips. In your first session on a phone or tablet a card shows the four gestures and the mode you are in. After that, at most one short tip per session appears, at the moment it helps, and never while you are typing. Got it closes it; Don't show again switches the tips off.

The sheet behind the handle. Besides the connection and the input mode, the sheet shows up to five large tiles for what you do in a session: Display (only with several displays), Keys, Files, Clipboard and Privacy mode. A switch tile shows whether it is on. Below it, a short list holds the picture size, the control switch and the further settings. Which tiles appear and whether they work is decided as on the Mac and Windows; a shared app offers only Files and Clipboard.

If you have switched the tips off, you bring them back under Sessions with Show tips again. A second tap close to the first on a small control also shows the loupe tip.

First-time hints

DeskRanger explains new things once and quietly: at most one hint per session, never while you type, and each only the first time. On a phone or tablet the first session shows a card with the gestures (see “Using your fingers”).

macOS

On the Mac, the first time you see the new bar (see “The bar”), a short hint appears under it: “The bar has words now: Control, Keys, Exchange …”. Show keyboard shortcuts opens the list of this session’s keyboard shortcuts, Don't show again switches all hints off, and the cross, or waiting about 20 seconds, closes it. The first time you later control a Windows PC, a hint tells you what the ⌘ key does there and where to change it: under Keys.

macOS

If you switched the hints off or want to see them once more, open Settings under Sessions and, in Tips, choose Show again (Show tips again). The hints come back from the next session.

Windows

On a Windows PC, the first time you see the bar (see “The bar”), the same short hint appears under it: “The bar has words now: Control, Keys, Exchange …”. Show keyboard shortcuts opens the list of this session’s keyboard shortcuts, Don't show again switches all hints off, and the cross, or waiting about 20 seconds, closes it.

Windows

If you switched the hints off or want to see them once more, open Settings under Sessions and, in Tips, choose Show again (Show tips again). The hints come back from the next session.

iPhone & iPad

This function is coming soon to iPhone & iPad.

On Linux the same hint appears the first time the bar shows its words: “The bar has words now: Control, Keys …”. Show keyboard shortcuts opens the list of the session’s keyboard shortcuts, Don't show again switches the hints off, and the cross, or waiting about 20 seconds, closes it. If you switched the hints off or want to see them once more, open Settings and, in Tips, choose Show again (Show tips again). The hints come back from the next session.

Special keys

Under Special Keys you send key combinations your own device would otherwise keep for itself. The list follows the other device’s system. A Mac gets a Mac’s names and shortcuts, for example Mission Control with ⌃↑. A Windows PC gets Windows’ own: Lock screen with Win+L, Task View with Win+Tab, Virtual desktop left with Win+Ctrl+←, plus Start menu and Run…. Next to each entry you see the key combination the other device receives.

An Android phone or tablet has no special keys of its own: it has its system commands instead (see below), and your keyboard works there as usual.

A Mac has no Ctrl-Alt-Del: there More offers the system commands instead, such as Force Quit…. The keys for each entry stand beside it as named keys, such as "⌘ Command + Tab", never as a string of symbols. Your keyboard says what your keys do on the other device. If both devices run the same system it only says that the same key does the same.

The other device says which system it runs when you connect. If it is unknown, for example with an older version reached by support code, the menu offers only Ctrl-Alt-Del. DeskRanger never guesses a system, because a wrong shortcut can do something entirely different there.

With your own keyboard

macOS

On a Windows PC, ⌘ acts as the Windows key, ⌥ as Alt and ⌃ as Ctrl. So ⌘L locks the PC like Win+L, and ⌘R opens Run. Shortcuts macOS keeps for itself, such as ⌘⇥ for Win+Tab, only go across with Send system shortcuts to the device. Shortcuts with ⌃⌥⌘ always stay with DeskRanger.

Mac keyboardWindows PC
⌘Windows key
⌥Alt
⌃Ctrl
⌘LWin+L (lock)
⌘⇥Win+Tab (with “Send system shortcuts …”)

Under ⌘ acts on PCs as you can choose Ctrl key instead: then ⌘ acts as Ctrl on the PC and ⌃ as the Windows key, and ⌘C, ⌘V and ⌘Z work as on the Mac. You find the choice in Settings under Sessions and, while you control a PC, in the toolbar’s special keys. It applies to every PC. The shortcuts in Special Keys always send the PC’s own keys.

Sessions settings: “⌘ acts on PCs as” set to the Ctrl keySessions settings: “⌘ acts on PCs as” set to the Ctrl key

Windows

On a Mac, the Windows key acts as ⌘, Alt as ⌥ and Ctrl as ⌃. Under Command key (⌘) on Macs you can choose Ctrl key instead: then Ctrl+C copies on the Mac too. Windows always keeps Ctrl+Alt+Del and Win+L for this PC. For the other computer, take them from Special Keys.

Windows keyboardMac
Windows key⌘ (with the Ctrl key as ⌘: ⌃)
Alt⌥
Ctrl⌃ (with the Ctrl key as ⌘: ⌘)
Ctrl+Alt+Del, Win+Lonly from the menu

iPhone & iPad

On iPhone and iPad, the special keys are in the key bar’s menu. Find Command… knows them too. When you control a Windows device with a keyboard from an iPad, you choose in this menu and in Settings under ⌘ acts on PCs as whether ⌘ acts as Windows key (default) or as Ctrl key.

Web

In the browser Keys in the bar opens the window Keys and system commands: six tiles for the common things, each with the other system’s keys as named key caps (for example Win L), and under More the other system commands and special keys. A Mac is listed without Ctrl-Alt-Del.

When you connect a PC to a Mac or a Mac to a PC, you choose in the same window under Your keyboard which key acts as ⌘: Windows key (default) or Ctrl key. With the Ctrl key, Ctrl+C copies on the Mac too, and from a Mac ⌘C copies on the PC too. The browser remembers the choice.

Key bar, iPad keyboard and tips (iPhone and iPad)

The key bar sits above the on-screen keyboard and shows the keys with the names the *other* device uses: a Windows PC gets Esc, Tab, Ctrl, Alt, Win and Shift, a Mac gets esc, ⇥ tab, control, option, ⌘ command and ⇧ shift. Next to them are the arrow keys, and on the right actions in words such as Copy, Paste and Undo. They send the shortcut the other device understands, so you never need to know whether it is Ctrl+C or ⌘C. A Linux computer gets the same actions as a Windows PC (Ctrl+C, Ctrl+V); a terminal there copies with Ctrl+Shift+C, which you press yourself. What does not fit on a narrow screen moves behind “⋯”.

Tap a modifier key once and it applies to the next key only. Tap it twice quickly and it stays down until you tap it again, shown with a line under the key. While a modifier is down, a row above the bar suggests the usual combinations in words. Tap the small arrow beside the arrow keys for Home, End, PgUp, PgDn and F1 to F12.

The “⋯” in the bar opens a sheet: at the top the connection and its encryption, the magnifier searches all commands, then large tiles for display, keys, files, clipboard, privacy mode and, where it applies, password, and below them the short list of settings.

iPad with a keyboard. As soon as a hardware keyboard is attached, DeskRanger hides the key bar and the touch controls; every key goes to the other device. The commands are in the menu bar of iPadOS under Session, the same list as in the sheet. Without the keyboard the touch controls return. There is no question to answer.

Tips. In your first session on a phone or tablet a card shows the four gestures and the mode you are in. After that, at most one short tip per session appears, at the moment it helps, and never while you are typing. Got it closes it; Don't show again switches the tips off. You find the gestures again at any time under “⋯” › Gestures.

Screenshot of the window

Screenshot of active window asks the other device to save a picture of its active window there. A notice then says which window and under which name, or why it did not work. The picture stays on the other device.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the browser the command is in the window Keys and system commands (Keys in the bar).

System commands

Under System commands you ask the other device to run a command of its system. It runs the command itself, even if someone changed the keyboard shortcuts there. This list also follows the other device’s system:

  • A Mac offers a Mac’s commands, for example Mission Control, Show Dock and Control Center.
  • A Windows PC offers Windows’ own, with their names: Start menu, Search, Task View, Show desktop, Switch app, File Explorer, Settings and Task Manager. Under More follow Notifications, Quick settings, Taskbar, Emoji & Symbols, Snipping Tool and Lock screen.
  • An Android phone or tablet offers its own six, all at a glance: Back, Home screen, Overview, Notifications, Quick settings and Screenshot. The phone runs them with its own system functions. There is no screen lock there, because the transmission ends when the screen locks. While a protected window is in front, such as a permission prompt, or when remote control is off on the phone, a command is not possible and the session tells you.

When the phone uses gesture navigation, its swipe gestures at the edge of the picture work too, just as on the phone itself: a swipe up from the bottom edge (or a click on the line at the very bottom) takes you to the home screen. If you pause for a moment at the end of the swipe before letting go, the overview opens. A swipe in from the left or right edge goes one step back. Anything else that starts there stays an ordinary swipe or tap. These gestures follow the same rules as the system commands: they do not work in front of a protected window, and nothing happens when remote control is off on the phone. With three-button navigation you simply tap the buttons.

  • A Linux computer offers its own system commands, such as Settings, File Explorer, Lock screen and Restart…. If the system is unknown, for example with an older version reached by support code, only general commands are available, those that have the same name everywhere: Show desktop, Search, Switch app, Screenshot tool and Lock screen.

Restart… is under More on every system. It works only when the device is reachable before login, too – otherwise it would be offline after the restart, and the command is greyed out. It always asks first. If the device then waits for the FileVault password or the BitLocker PIN, the question shows the three steps Restart, Password at the Mac or PIN at the PC, and Back online. The other device then shows a notice with Cancel briefly; apps with unsaved documents ask there first.

Shut Down… is under More on a Mac, a Windows PC and a Linux computer too, right after Restart…. It works in a session with control from one of your own devices, also without access before login, and it always asks first: afterwards the computer cannot be reached until someone switches it on there. On a Mac and a PC the other device first shows the same ten-second notice with Cancel as for a restart; apps with unsaved documents ask there first. On a Windows PC it needs the background service.

Log Out… is under More on a Mac, a Windows PC and a Linux computer, between Restart… and Shut Down…. It ends the signed-in person's session; the computer stays on and then shows its sign-in screen. Like the restart it works only when the device can be reached before login too – otherwise the command is greyed out – and only in a session with control from one of your own devices. It always asks first. On a Mac and a PC the other device first shows the same ten-second notice with Cancel as for a restart; apps with unsaved documents ask there first. On a Windows PC it needs the background service.

“Restart Studio?” with the steps Restart, Password at the Mac, Back online“Restart Studio?” with the steps Restart, Password at the Mac, Back online

Restart once without the password prompt

DeskRanger offers this second choice on the Mac, the Windows PC, Linux, iPhone, iPad and Android phones and tablets, in the released apps as well. It shows only when the computer you control announces the function; otherwise there is no such button and the question looks as usual. The same applies to the PIN variant below.

When the Mac has FileVault on and allows it, the question for Restart… offers a second choice: Restart once without the password prompt. It appears only in a session with control from one of your own devices with unattended access, and only when nobody else is signed in at the Mac.

Your device remembers the Mac's key along the way. So the second choice appears from your second session with this Mac on, and with DeskRanger Secure already in the first. If the Mac later shows a different key, the question says “This device has a new key – was it set up again?” instead. Only click Yes, set up again if you set the Mac up again; otherwise another device could be posing as it. Until then the second choice is not offered. The session itself carries on as usual.

  1. Choose Restart once without the password prompt, then Continue….
  2. Pick the user whose FileVault password you know and type the password.
  3. Click Restart. The Mac checks the password. If it is wrong, nothing is quit, and the Mac shows a notification.
  4. A notice with a countdown and Cancel runs at the Mac. Then the Mac quits its apps as a restart from the Apple menu does. If an app asks about unsaved changes you see it in the session; the session names the apps that are still open. If apps stay open the Mac does not restart, and you can close them and try again. Whoever is at the Mac can still cancel while the apps quit. If someone at the Mac pauses the session or takes control back, the restart is called off.
  5. The Mac starts up to the login screen and is reachable again without anyone typing the password at the Mac. You then sign in as usual.

This covers exactly one restart. The password is stored nowhere, not even in the keychain. It travels encrypted end to end through the session to the Mac; our servers do not see it. After too many wrong passwords, the function stays locked until someone signs in at the Mac.

Restart once without the PIN (Windows PC)

When the PC has BitLocker with a PIN (or a startup key) and allows it, the question for Restart… offers a second choice here too: Restart once without the PIN. It appears only in a session with control from one of your own devices with unattended access.

  1. Choose Restart once without the PIN, then Continue….
  2. Click Restart. You enter no user and no password. Windows' prompt (UAC) appears at the PC; an administrator must confirm it there. The session waits until then.
  3. A notice with a countdown and Cancel runs at the PC. Then the PC quits its apps. If an app asks about unsaved changes you see it in the session; the session names the apps that are still open. If apps stay open the PC does not restart, and you can close them and try again.
  4. The PC restarts once without asking for the PIN, up to the sign-in screen, and is reachable again. You then sign in as usual. At the next restart BitLocker asks for the PIN again.

This covers exactly one restart. Nothing is stored and no PIN is sent.

The Linux app asks the same way, with the same second choice and the same sheets, when the computer you control is a Mac or a Windows PC that offers it.

Lock screen asks first. If you could not get back in afterwards, the command is greyed out and the reason is shown below it. On a Windows PC it works when Reachable before login and while the screen is locked is on there: afterwards you see the lock screen and type the PIN or password there. If someone at the device accepted your session, the command is greyed out on Mac and Windows, with the line “Locking only works in your own, unattended session.” below it. From such a session you could only look at a locked screen, not unlock it. In your own sessions nothing changes. When a command is offered as a system command, the same key is left out of Special Keys, so nothing appears twice.

If your Windows PC uses a Microsoft account and Windows Hello, sign in at the sign-in screen with the PIN or the password. Do not choose “I forgot my PIN” from afar: afterwards Windows' own secret store can become unusable for that user. Reset the PIN at the PC itself instead.

Restart DeskRanger on the other device

If DeskRanger hangs on the other device but the device itself runs, you restart only DeskRanger, not the device. On a Mac, a Windows PC or a Linux computer, open the keys window in the session and choose the row Restart DeskRanger … under More. On an iPhone, iPad or Android device you find the same row at the bottom of the sheet System commands (the ⌘ symbol in the session). It appears only when the device offers it and your session may control. It works only from one of your own devices, never with a support code and never from another account.

  1. DeskRanger asks the other device what is running and names, in a window, every other session that ends, with the device's name and kind (screen, terminal or files). When nothing else runs, it says: No other session is running there.
  2. Click Restart DeskRanger. This is the only question.
  3. DeskRanger on the other device restarts after a few seconds. Your session ends too. Connect again afterwards as usual. The device itself does not restart, and its apps keep running. On a Linux computer, whoever is signed in there sees a notification naming the device of yours that is restarting DeskRanger.

If no answer comes, for instance because the connection just broke, the window offers Try again. A second try does not restart twice. The restart is limited: after several restarts in a short time the window names the time from which it works again. On the other device an entry stays that says DeskRanger was restarted, and from which device.

If the other device is a Mac or Windows PC, whoever sits at its screen sees a notification naming which of your devices is restarting DeskRanger. Your other devices also report that DeskRanger was restarted on that device, and from which device. The device you restart from does not report it again, and a second try after a broken connection reports nothing twice.

Typing a password into the other device

Under More you find Type password. It lists the entries from Passwords that belong to this device: the ones you linked to it first, then entries whose name or website names it. A click types the password into the field that has the cursor on the other device. It works when you control the device, including its login screen.

The password goes straight to the other device as typed characters. It never lands on your clipboard or the other device's clipboard, and DeskRanger does not show it. If Passwords is not set up on this device yet, this place shows Set up passwords …; a click opens the set-up. If Passwords is locked, the menu offers Unlock passwords …; if you set an extra password, it opens the Passwords page in the main window, where you type it. A note under the toolbar says what happened: the password was typed, or why nothing was typed. DeskRanger types the whole password or nothing: if the other device cannot type one of its characters, it types none.

If control is switched off, Type password stays in the list, greyed out, with the note "Turn on Control to use this". Without Passwords set up the entry is not there.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Linux

On Linux Type password opens a small window with the entries for this device; a click types the password. If your passwords are locked, Unlock passwords … takes you to the Passwords page in the main window, where you type the PIN for passwords. The note on what happened shows over the picture for a few seconds.

The other device types with its own keyboard layout, so special characters arrive as you saved them. An older DeskRanger there cannot do that. Then DeskRanger sends key presses for this computer's keyboard layout and says so in the note: if the other device uses another layout, the password may arrive wrong. Update DeskRanger there to avoid this.

Sound

macOS

During a session you can hear what the other device plays, but only when the person at that device allows it. The toolbar button Sound shows the state:

  • Mute sound while sound plays.
  • Unmute sound when it is off and the other device is one of your own: one click switches it on.
  • Ask for sound when it is off and someone else decides: your click only asks, and the person at the device answers.

Between your own devices, sound plays from the start; Mute sound only mutes it on your side.

At the other device, sound is off until its owner ticks Share sound in the question that opens the session, or switches it on later in the live menu. Everything that device plays is heard, calls and notifications included; the live indicator names Sound for as long as it flows. The owner can switch it off at any time, and you cannot switch it on against their wish. Sound never comes from a microphone, and it pauses while a password or a confirmation with a code is shown at the other device, or while its screen is locked; after the unlock it plays again by itself, with the switch as it was.

Sound is not possible in a session where only apps are shared, when screen recording is not allowed on the other Mac, and at the login screen.

Windows

During a session you can hear what the other device plays, but only when the person at that device allows it. The toolbar button Sound shows the state and appears only when the other device can send sound:

  • Mute sound while sound plays: this mutes it on your side only, nothing changes at the other device. One more click plays it again at once.
  • Unmute sound when it is off and the other device is one of your own: one click switches it on.
  • Ask for sound when it is off and someone else decides: your click only asks, and the person at the device answers.

At the other device, sound is off until its owner ticks Share sound in the question that opens the session, or switches it on later in the live indicator. On your own devices it plays from the start. Everything that device plays is heard, calls and notifications included; the live indicator names Sound for as long as it flows. The owner can switch it off at any time, and you cannot switch it on against their wish. Sound never comes from a microphone, and it pauses while a password, the Windows prompt or a confirmation with a code is shown at the other device.

Sound is not possible in a session where only apps are shared, and on a device without a sound output.

iPhone & iPad

On the iPhone and iPad you find Sound in the session's More actions menu. It shows the state as on the Mac: Mute sound, Unmute sound or Ask for sound, and appears only when the other device can send sound.

When you share your own screen, the other end hears what runs on the device, but only when the person there allows it. On one of your own devices, sound is on when you share; you can untick Share sound beforehand and switch it off while sharing. For a person with a support code it is off until you choose Allow with sound in the notification. The microphone is never shared, and the sound pauses while a password or a confirmation with a code is shown on the device.

Web

In the browser you hear the other device's sound with Sound in the bar’s Exchange menu: it works as in the apps (Mute sound, Unmute sound, Ask for sound), and the sound starts only after a click or key press in the session, because the browser requires it. If your browser cannot play the sound, the button stays grey.

Android

During a session you can hear what the other device plays, but only when the person at that device allows it. In the session’s “More” menu the row Sound shows the state: Mute sound (mute locally), Unmute sound or Ask for sound. With someone else’s device your tap only asks, and the person at the device answers.

When your Android device shares its own screen, sound is off until you tick Share sound in the question that opens the session or switch it on later in the live window. Only then does Android ask for the permission to record audio; it never comes up during set-up. What the device plays is heard, notifications included; a microphone is never recorded. The live window and the notification name Sound for as long as it flows, and you can switch it off at any time. It pauses while a password or a confirmation code is shown.

Limits: apps that exclude their sound from capture (calls and some streaming apps) stay silent. Needs Android 10 or newer.

The connection

The dot next to the device name shows the quality: green for Good connection, yellow for Fair connection, red for Poor connection. The details say whether the session runs Direct (P2P) or Via relay. Both are end-to-end encrypted. Why a relay sometimes?

iPhone & iPad

On iPhone and iPad you tap the device name in the toolbar for this. If frames get lost, it is said next to the delay, for example “120 ms · 6 % loss”. Under Latency the details show the dot as well.

The toolbar with a yellow quality dot and “120 ms · 6% loss”The toolbar with a yellow quality dot and “120 ms · 6% loss”

If the picture looks soft, the details name the main reason in one line under Sharpness, for example that the other computer encodes smaller than its screen, that the data rate hits a limit, or that your view scales the picture by an uneven factor. The line appears only while such a reason applies.

With Best quality a Mac sends the colours at full resolution when the device you watch on can show them: another Mac, an iPhone or iPad, a Windows PC with the “HEVC Video Extensions” from the Microsoft Store, or a browser that reports it (such as Chrome). Coloured text, code with syntax colours and thin lines then stay sharp, also while something moves. It costs a little more data. If one side cannot do it, the session simply goes on as before. Windows PCs, Linux and Android do not send this way yet.

Linux and Android show the colours as usual even with Best quality: their video decoders cannot do full colour resolution, so a Mac does not send it to them.

If the other device reports something, for example a locked screen, the login screen, Apple Screen Sharing, a Windows PC without a screen or a prompt waiting there, it appears as a note over the picture.

If a session ends because DeskRanger on the other device could not hide its codes in time, it did not confirm there that no six-digit codes are visible any more, so the picture was never shown. Trying again usually works; otherwise open DeskRanger there once more.

If the window says %1$@ can't show its screen right now: %2$@ with a reason, a part of DeskRanger on the other device could not take the session, for example because an update is being installed there, a part is restarting or no display is available. When DeskRanger is updating there or a part is restarting, the window tries again by itself and shows DeskRanger on … is restarting … meanwhile. For the other reasons, Reconnect helps once the reason is fixed there.

Connection details: direct or through a relay, end-to-end encryptedConnection details: direct or through a relay, end-to-end encrypted

Saving data

Data saver reduces resolution, frame rate and data rate. You switch it in the settings and in the session menu with Automatic, On or Off. Automatic turns it on by itself on a phone in a cellular or metered network and tells you in one line; on a computer it stays off. While it is on, or the network is metered, DeskRanger asks before sending large files.

When clicks and keys do nothing

DeskRanger deliberately keeps remote control away from some places on the other device, so nobody can decide from afar who controls it. While such a place is in front, your clicks, swipes and keys don’t arrive there. The session then says why, over the picture. The note goes away as soon as the other device takes input again. It only names the kind, never the name of a window or app.

  • On an Android phone: DeskRanger itself, permission and installation prompts, the screen recording prompt and the settings that decide who may control the device – accessibility, device admin apps, special app access, screen lock and security. Control doesn’t work while the phone is locked either.
  • On a Windows PC: windows of programs that run with administrator rights, and Windows’ protected screen with the lock screen or an administrator prompt. If Reachable before login and while the screen is locked is switched on at the PC and you connect from a device of the same account without a question (Let my devices connect without asking), you see and control these places too – whether or not DeskRanger is open there.
  • On a Mac: the locked screen and the login screen, when your session may only watch there.
  • On a Linux computer: if the person there allowed only watching in their desktop's sharing prompt (remote control off), control does not work in this session. Connect again; they then switch on remote control in the dialog. More

Switch to another app or window, on a phone for example with Home screen. Or ask the person at the other device to answer the prompt or unlock the device.

A session with an Android phone: over the picture the note that DeskRanger is open there and control is blockedA session with an Android phone: over the picture the note that DeskRanger is open there and control is blocked

When the connection drops

If the connection drops briefly, for example when switching to mobile data, DeskRanger continues the same session. Nobody at the other device has to agree again. If that does not work, you see Connection ended and can Reconnect.

macOS

The ended window or card says why the session ended, for example that the device is offline or that the connection broke, and offers Reconnect right there.

iPhone & iPad

The ended window or card says why the session ended, for example that the device is offline or that the connection broke, and offers Reconnect right there.

If part of the picture is lost on the way, the session stays smooth: the picture does not freeze until a whole new one arrives, it only catches up on the missing part. You do not have to set anything.

When a computer shows no picture

If a Mac, Windows or Linux computer with the background service accepted two sessions in a row and neither showed a picture, the computer makes a note in its own log and sends one diagnostic notice, if you have agreed to diagnostic notices. You do not have to do anything. The note helps support find a broken screen capture. A session in which the other side hid its window or hung up early does not count.

Back to the device list

On the Mac and on Windows every session has its own window. To look at the device list in between, for a second session for example, choose Show Device List in the toolbar's More menu or in the command palette. The main window comes to the front, and the session keeps running in its window. If you had closed the main window, DeskRanger opens it again.

macOS

On the Mac you can also:

  • Click the DeskRanger icon in the Dock while DeskRanger is already in front. The first click from another app brings the DeskRanger windows forward as usual, the second one the device list.
  • Choose Dashboard in the Window menu or press ⌘0. The main window comes to the front and shows the Dashboard. While you control a device, ⌘0 goes to the other device; the menu still works.
  • Right-click the Dock icon: it lists your open sessions by device name and Dashboard.

Windows

On Windows the taskbar has an entry for it: right-click the DeskRanger icon, then Dashboard; Ctrl+0 also opens the Dashboard while the main window is in front. The entry also brings the main window back from the notification area.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the browser every session runs in its own tab, and the tab carries the device’s name. Show Device List in the bar’s More menu opens the device list in a tab of its own or brings that tab back, and the session keeps running. If you close a session’s tab, the session ends.

If you open a device that is already connected in another tab of the same browser, DeskRanger asks: Continue Here ends the session in the other tab and continues it here.

View a shared iPhone or iPad

When an iPhone or iPad of your account shares its screen with this device, DeskRanger opens the session by itself, for viewing: View only. iOS does not allow control.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the browser the session opens in the tab that is connected to DeskRanger right now. If a session already runs there, it stays: a notice names the iPhone, and View opens it in a new tab.

All sessions at a glance

Under Active Sessions you see every session of your account and can end each one. A chain through your own devices counts as one session.

Locked screen and a restart on your device

On a Mac or Windows PC with the background service, you can connect to your own locked device if it is set up to be reached without anyone there. Any request that needs consent at the device (for example from another account) is declined while the screen is locked.

If DeskRanger on your device restarts or crashes during a session, the newly built screen connection takes over from the old one at once; the other device does not wait for the old one to time out, and the display size is handed over. An iOS device that shares its screen does not support this; for the Windows Store edition it is planned.

Was this helpful?

Checked for version 0.1.0 · as of 2026-11-13