VMOS Cast Product Manual

VMOS Cast is a free desktop application that brings the live screens of multiple Android devices onto one computer for side-by-side monitoring, with mouse and keyboard control back to each device. No application is installed on the phones and no account is required. Video and input stay on the local network and never pass through a cloud server.

Every screenshot in this manual is taken from the released application. For first-time setup, see Quick Start; this page is the full reference. Installers are listed on the Release History page.

1 Interface Overview

The window has four areas, matching the screenshot above from left to right and top to bottom:

1VMOS CastAll DevicesHelp CenterWebsiteContact UsLanguageSettingsVersion

2All DevicesSelectedAdd Device · New GroupGroup AGroup BDefault GroupMove · Remove

3AllInvertBatchGroup ControlMulti-viewSearchStatusScaleSize

4

1 top bar · 2 sidebar · 3 toolbar · 4 device wall

Area	What it does
Top bar	Help Center, website, Contact Us (live chat / Telegram group / email), language, settings, version
Sidebar	All Devices / Selected / group tree, Add Device, New Group; Move and Remove appear at the bottom once devices are selected; the width is draggable and is kept for next launch
Toolbar	Select All, Invert, Clear, Batch, Group Control, Multi-view; on the right: search, status filter, Scale, window size
Device wall	One live picture per device. Click the picture to open the focus window, click anywhere else on the card to select it

The interface ships in 21 languages — click the language button in the top bar; the dropdown lays them out in three columns without scrolling. Arabic and Urdu mirror the whole layout right-to-left, while device pictures keep their original orientation.

For extended monitoring sessions, switch to the dark theme (Settings → Appearance → Theme):

2 Connecting Devices

TIP

USB works out of the box; nothing additional has to be installed on the computer. Android 7 is the oldest supported version. LAN and USB connections use the same compatible device service, deployed automatically on first connection without a manual phone installation. Capture and encoder capabilities can vary by ROM.

The connection method is determined by the type of device:

iPhone / iPadScreen MirroringStarted on the phone · no way to add it here

Android phone · first timeUSB cableUSB debugging on · tap Allow on the phone

Android phone · already on USBLocal networkAdd LAN connection, then unplug the cable

Android phone · Android 11+Wireless debuggingSix-digit pairing code · no cable needed

Cloud phone / network connection enabledLocal networkEnter IP:5555, or scan a subnet

Choosing a connection method

Click Add Device in the sidebar and pick a connection method:

2.1 USB cable

Use this the first time a physical Android phone is connected. Follow the three steps shown; the device appears on the wall as soon as it is plugged in:

2.2 LAN connection

An Android phone connected over both USB and LAN keeps two cards, with control available in both focus windows. Screen power state is shared; closing one window does not close the other. Gestures from the two windows cannot interleave. When the serial number or cloud-device identifier matches, group-control targets and batch operations are deduplicated by physical device.

For cloud phones, and for physical phones that already have a network connection enabled, enter the address directly:

• Ports 1–65535 are supported; an IP with no port is treated as 5555. One address per line; commas also work
• After Add is clicked, each address is probed: reachable entries are ticked automatically, no response entries (powered off or offline) cannot be added yet, and pairing required entries open the pairing flow when clicked
• The dialog footer selects a group, so new devices are filed on arrival
• Added addresses are saved and reconnect automatically on the next launch

2.3 Network discovery

When the IP is unknown, use Network discovery: enter a subnet and click Scan. Scanning with no subnet listens for device broadcasts only:

Results are grouped by source. Tick the required entries and add them together with any manually entered addresses. Devices already on the wall are marked as added and are not listed again.

2.4 Physical phones require a cable on first connection

A physical Android phone must be connected by cable the first time — network connections are disabled by default, so entering an IP alone will not work. Connect once by cable, enable the wireless connection, and the cable can be removed:

1. On the phone, open Settings → About phone and tap Build number seven times to unlock developer options
2. Settings → Developer options → USB debugging → on
3. Connect the cable; when the phone asks "Allow USB debugging?", tick "Always allow" and accept
4. In the app, right-click that USB device card → Add LAN connection
5. Once the success message appears and the new card is online or showing a picture, remove the cable

The original USB card is not replaced — both cards remain on the wall.

When the phone reboots, a connection enabled through Add LAN connection is lost and has to be enabled over the cable again; a device paired through wireless debugging reconnects on its own. Cloud phones ship with it enabled and are unaffected.

2.5 Wireless debugging pairing (Android 11+)

The random port shown on the phone's Developer options → Wireless debugging page (for example 192.168.x.x:37xxx) uses an encrypted protocol that requires pairing. It differs from port 5555 and cannot be added as an ordinary address, but the app can complete the pairing:

1. Click the Wireless debugging card on the empty state, or click "pairing required" in the scan results
2. On the phone, open Settings → Developer options → Wireless debugging → Pair device with pairing code and leave that dialog open
3. On the computer, enter the IP:port and the six-digit code from the phone's dialog, then click Pair
4. Close the dialog on the phone (leave wireless debugging on); the device joins the wall a few seconds later

Pairing is required once only; the device reconnects automatically on the same network afterwards.

2.6 iPhone / iPad

iPhone and iPad can connect in two ways: start wireless mirroring from the phone on the same reachable network, or connect the phone by cable for USB mirroring. Either method creates a card on the device wall; click its picture to open an independent display. iPhone does not enter Android Multi-view.

Wireless mirroring

1. Put the phone and computer on the same reachable local network.
2. Open Add Device → iPhone / iPad → Wireless and note the receiver name.
3. Open Control Center on the phone, select Screen Mirroring, and choose that receiver.
4. When the picture appears on the wall, click it to open the independent display.

USB mirroring

For first use, follow the illustrated USB guide. The complete path is four steps:

1. Choose Add Device → iPhone / iPad → USB, connect and unlock the phone, then trust the computer.

2. On Windows, install or repair Apple device support when prompted. macOS does not require this step.

3. On Windows, install the capture driver for this phone if the page reports that it is not ready, and approve the administrator prompt.

4. Viewing the USB picture does not require Developer Mode. Check or reveal Developer Mode only when USB or Wi-Fi control is needed.

macOS “Camera” permission

macOS groups USB iPhone screen capture under Camera permission. The client explains the purpose before requesting access; it does not capture the computer camera. If denied, open System Settings to grant access or use wireless mirroring.

Multi-device, control, driver and compatibility details

The independent iPhone display prioritizes the incoming source resolution instead of downscaling the relay for a smaller window. iPhone does not participate in multi-view; actual sharpness and smoothness still depend on the mirroring source, encoder, and computer load. Android's display quality and bitrate settings do not control iPhone mirroring.

For USB and wireless mirroring on Windows, the wall preview and independent display of the same video source share one video decoder. Source dimensions and phone control coordinates are preserved, while rendering follows the window's physical display pixels. Wall previews have a maximum long edge of 640 pixels; enlarging a display redraws it as needed instead of keeping a full phone-sized drawing buffer for a small window. Display scaling does not change the incoming resolution, bitrate or control coordinates, and opening or closing Control method does not start another cast. USB and wireless connections remain separate sources; this does not automatically merge identities or share decoding across those connections.

Closing one phone's display releases that window's video resources while its wall preview continues. Ending that USB or wireless video session releases its video resources; other sources keep their own pictures and control. For multiple devices, let the phones join the wall, then open the displays you need to operate. Test capacity with moving pictures on the actual computer.

Apple devices are not added, and there is no field for an iPhone's IP — the direction is reversed: the iPhone sends its screen to the computer.

1. Make sure the iPhone and computer are on the same reachable local network; the computer may use Ethernet
2. In the app, switch to the Add Device → iPhone / iPad tab (the first visit turns the receiver on and remembers it)
3. On the iPhone, swipe down from the top-right corner to open Control Center
4. Tap Screen Mirroring (the two overlapping rectangles)
5. Pick the computer name shown on that tab

iPhone / iPad support independent mirroring and management, without multi-view, Android group control or batch commands. Viewing does not require Bluetooth. On Windows and macOS, choose Enable control in the independent display and follow the illustrated pairing guide; Linux is view-only. Losing Bluetooth leaves mirroring running. Closing the display preserves wall thumbnails. Inactive records can still be selected, renamed, moved or removed. Configure Auto-Lock on the phone.

On every iPhone or iPad, choose the same receiver name shown on the Add Device page in Screen Mirroring. Each incoming phone gets its own video session and device card, without pre-created numbered entries or a fixed two/eight-entry pool. Open separate displays for the phones; one sender stopping or disconnecting does not interrupt the others. Usable capacity depends on computer decoding resources, memory and LAN bandwidth, not an unlimited-device guarantee. Names are not unique identities. An unidentified connection belongs only to its current session, and an old connection cannot receive another phone’s picture. USB mirroring remains per-device.

Multiple-device Wi-Fi / USB control: Phones with compatible input services can use independent Wi-Fi or USB control in their own displays; there is no client-wide one-phone lock. Prepare and trust each phone separately. For wireless video, explicitly confirm the input target on first selection even if there is only one candidate; names and connection order cannot establish identity. Stopping one display’s control leaves other phones unaffected. If the same phone appears in both USB and wireless displays, only one window may own its developer input channel at a time to prevent duplicate input; stop that window’s control before switching. Wi-Fi capacity does not establish Bluetooth capacity.

Bluetooth control (Windows / macOS): Each computer controls one iPhone over Bluetooth at a time. Select and confirm the target in its display; other displays cannot start Bluetooth control until the current owner stops. Multi-device mirroring and USB / Wi-Fi control of other phones are unaffected.

Changing the Bluetooth phone: Stop control in the original display, disconnect this computer in that phone’s Settings → Bluetooth, then connect and confirm the new phone. Closing a display or switching methods releases software control, not the system Bluetooth connection or pairing record. Routinely forgetting the device is unnecessary.

Stopping and releasing control: Stopping, switching or closing a display releases only that window’s keys, contacts and target ownership. Other phones are unaffected. When no display is using or preparing Bluetooth, the service exits immediately and does not remain in the Dock or advertise in the background. Reopening a display restores the last successful USB or Wi-Fi route for that phone; Bluetooth still requires an explicit prepare action and target confirmation. Only one phone may use Bluetooth control at a time.

Avoid controlling the wrong phone: After target confirmation, that display sends taps, swipes and keys only to that Bluetooth connection. If it disconnects, input stops for that route rather than moving to a remaining phone; ordinary status updates do not change the binding. If multiple phones are already connected and cannot be distinguished, temporarily disconnect one phone’s Bluetooth without forgetting its pairing, observe which entry disappears, then reconnect and confirm.

Bluetooth names and saved bindings: On Windows and macOS, when available, the list shows the system Bluetooth name and the last eight connection-identifier characters; unnamed peers show a Bluetooth control label and suffix. Duplicate names remain separate targets and never automatically match a screen. After verifying the correct phone, choose “Confirmed this phone — remember”. Reopening the same video identity only preselects that target; choose Connect this device to confirm. Offline or busy targets never cause another phone to be selected. Changed video or Bluetooth identities require confirmation again; anonymous sessions are not remembered. Forget screen binding clears only this preference, not system pairing or active control.

Confirm before switching: Bluetooth, USB and Wi-Fi buttons only choose a draft method, and the dropdown only chooses a target. They do not disconnect active control. Use Connect this device or Switch to this method in the footer to apply; check the error message if connection fails. Closing discards unconfirmed selections without changing the active connection. The display titlebar stays visible; long content scrolls inside the dialog, detailed setup instructions expand on demand, and footer actions remain visible.

An idle USB / Wi-Fi route shows “Control not connected” without a spinner. “Connecting” appears only after confirmation; duplicate requests for that route are disabled while it connects.

If the client reports missing USB components, reinstall the complete client. This does not mean Developer Mode is off; repeatedly toggling it or reinstalling phone drivers will not restore missing client files.

After USB is unplugged, the large view shows the disconnected state in the picture area; its title-bar close button remains accessible. A USB disconnection does not require stopping Screen Mirroring on the phone.

Multiple USB iPhones on Mac: Capture initializes one phone at a time; established streams run concurrently, without a fixed device-count limit. A capture-source validation failure stops that stream instead of displaying another source’s frames in its card. If a picture does not match its label, stop control for that window and export logs; renaming the card is not a fix.

Bluetooth connection service: Starting the client or ordinary mirroring does not start Bluetooth. When needed, open Control Method → Bluetooth Control in that phone’s display and explicitly prepare it, connect the phone to the shown computer name, then select and confirm the target. Closing setup, stopping control, or closing the last Bluetooth display exits the service immediately. Allow iPhone Bluetooth connections is the master switch; turning it off does not affect USB/Wi-Fi control or delete system pairings.

Guidance by method: Bluetooth has expandable pairing and phone settings instructions. USB and Wi-Fi show Developer Mode status directly, without an empty Bluetooth guide. Select a target first; enabled devices need no repeat setup. Disabled devices require phone-side setup; unknown does not mean enabled. Connect and trust the target over USB to reveal the switch or check Developer Mode. Enabling, restarting and passcode confirmation remain phone-side actions.

Two cards for the same phone: USB and wireless mirroring do not expose a common, verifiable physical identity, so their video sources remain separate instead of being merged by name or model. Rename the sources to distinguish them. A single incoming source also joins the wall automatically. A known source keeps its management record on reconnect; an anonymous wireless connection exists only for that session and is removed on disconnect, without retaining its alias or group across sessions.

Multi-device validation boundary

Bluetooth control is limited to one phone per computer at a time on both Windows and macOS. This does not restrict multi-device mirroring. Mirroring and USB / Wi-Fi control capacity depend on devices, computer resources and network conditions; no fixed or unlimited capacity is promised.

:::

Apple device capabilities depend on the desktop operating system:

Desktop OSMirroringControlWindows✓Not yet supportedmacOS✓✓ one-time Bluetooth pairingLinux✓Not yet supported

iPhone / iPad capabilities · pairing steps are in chapter 9

3 The Device Wall

3.1 Managing iPhone / iPad records

After its first cast, an iPhone or iPad appears in both the sidebar and the device wall. Its record remains after casting stops and shows “Not mirroring”:

1. Click a live picture to open the independent display; clicking an inactive picture shows the mirroring guide.
2. Click the name area below the card or its sidebar row to select, search, or move it to a group.
3. Right-click the card to set a client alias, view device information, move it, or remove its record.

Aliases and groups survive restarts. Removing the record does not shut down the phone; starting Screen Mirroring again adds it back. iPhone and iPad do not join Android batch operations, Group Control, or Multi-view.

3.2 Selecting devices

Click anywhere on a card outside the picture to select it; the whole card gains a blue border. Clicking a row in the sidebar does the same, and the two stay in sync:

Select All and Invert apply only to the devices visible after filtering. Scale offers centre-crop, fit-whole and fit-width; the window size slider resizes cards live — resizing rebuilds the wall pictures only and never drops an open focus window.

3.3 Right-click menu

Right-click a device card:

Item	What it does
Rename	Give the device an alias; leave blank to restore the default name
Device details	See 3.4
Add LAN connection	USB devices only — converts the USB connection to wireless
Delete device	LAN devices only; also clears the saved address so it will not reconnect next launch
Reboot	Streaming stops and reconnects automatically once the device is back, usually within a minute
Shut down	The device cannot be powered on again remotely — the power button has to be pressed on the device itself

Reboot and Shut down are disabled while a device is offline. If the card reads "Connection failed", wait for it to recover before using them.

3.4 Device details

Click any value to copy it; the raw JSON can be copied as well. When a newer device-side version is available, an Update button appears: the app first confirms the device is not in use by another focus window or another computer, and never interrupts a picture that is being watched in order to update.

3.5 Rename

3.6 Search and status filter

The search box on the right of the toolbar filters by model or IP while typing. Next to it, Status is a multi-select dropdown, and every entry carries a live count:

Online · Connecting · Screen off · Not castable · Failed · Offline

Statuses combine with OR, and the filter as a whole combines with search and groups using AND. Counts are computed over the set already narrowed by search and group, so the number in the dropdown is exactly the number of cards shown. The status filter is not saved: status is momentary, and reopening the app still restricted to "offline only" would suggest the devices had been lost.

4 Groups

Select devices, then click New Group in the sidebar:

• Click a group name to show only that group; click it again (or All devices) to return
• Move to Group moves the selection into another group, and can create one in the same step
• Deleting a group moves its devices to the default group — it never deletes or disconnects them

Groups and search filter the display only; pictures keep running. Multi-view follows groups — changing a group's members changes the multi-view.

5 Batch Operations

Select devices and click Batch in the toolbar:

Results are returned device by device. Every selected device is acted on and none are silently skipped; a device that cannot be reached reports an explicit failure and reason.

Files and apps

Install APKPush FileUninstallScreenshot

Info and commands

Run CommandCopy Info

System keys

HomeBack

At the bottom of the sidebar, not in this panel

MoveRemove

How the batch panel is grouped

5.1 Batch install

Supports apk / apks / apkm / xapk; drag files in or click to upload. Multiple files are queued:

An older installed version is overwritten with the selected version (application data is kept when the signature matches).

5.2 Batch uninstall

Batch uninstall cannot be undone. Confirm the package name and verify on one or two devices before running it on the whole group.

5.3 Run Command

Runs on all selected devices in parallel, with built-in templates in three categories; one click fills in the command:

Offline devices are excluded automatically with a notice. When the run finishes, success, failure and output are listed per device, and the run can be repeated.

5.4 Copy Info

Copies information about the selected devices as text in a single step, for records or spreadsheets:

5.5 Push files

Files are placed in /sdcard/Download on the device — "My Files → Internal storage → Download" on the phone. They are registered with the system media store automatically, so they appear in Downloads immediately, and each device reports the path the file was written to.

5.6 Batch screenshot

Batch screenshots and the Shot button in the focus window toolbar save to the same location: Settings → Streaming Settings → Screenshot location. The file is written on click, with no save dialog.

• Default location: VMOS Cast inside the computer's Pictures folder (created on the first screenshot)
• File names include the device name and timestamp (for example Pixel 7 Pro-20260827-161105.jpg), so files never overwrite each other
• After a batch: "Saved N/M screenshots" plus the full folder path
• With nothing selected: a prompt to select devices first
• A device that fails is listed by name · usually because its screen is off, or it is on a page that blocks screen capture
• "Screenshot folder is not writable": the folder was deleted or moved, or its location is not writable · select another folder in Settings

6 Group Control

Batch operations synchronise actions. To synchronise gestures — taps, swipes and drags across several devices:

1. Select two or more devices that are already showing a picture
2. Click Group Control in the toolbar
3. The first device opens as the master, with "Group Control · syncing N devices" at the top
4. Every tap, swipe and drag in the master window is mirrored to the other selected devices in real time

Group control synchronises gestures on the picture only. Keyboard input reaches the master device and is not forwarded to the followers; to perform the same operation across a set of devices, use batch operations.

7 Focus Window

Click a device's picture to open a dedicated high-definition window; the wall behind it remains visible:

The title bar shows the device name and ID (click to copy), preceded by a platform icon (Apple / Android). Top right: pin, minimise, maximise, close, and a button that switches the window style.

Device name · device IDPin · Minimise · Maximise · Close

Picture area
click · drag · wheel · keyboard

Vol +Vol −SleepRotateShotTerminal

BackHomeRecents

Focus window layout (Standard style, Android device)

Input	Effect
Click	Tap the device screen
Click and drag	Swipe or drag
Scroll wheel	Scroll inside the device
Right / middle click	Back / Home while awake; wake while the screen is off
Keyboard	Sends text or keys to the focused field; IME input is supported, with active Pinyin shown at the bottom of the mirrored screen
Bottom row	Back / Home / Recents
Esc	Close the window (the wall connection stays up)

The right-hand toolbar holds volume up/down, screen off / wake (following the device's current state), rotate, screenshot, Terminal and Quality. Quick replies appears when WeChat is foreground and its plugin is enabled. Only one of Terminal, Quality or Quick replies is expanded at a time. The window extends to the right to preserve the phone picture; switching tools does not add more panels.

Quality for this display: Original is the default, bounded by local hardware decoding. You can choose Smooth, Balanced, Clear (1920 px), or Custom. The long-edge choices are Original / 720 / 1280 / 1920 pixels; FPS choices are Match device / 15 / 30 / 60; bitrate choices are 1 / 2 / 4 / 8 / 12 Mbps. The Original preset also restores Full Screen FPS and Bitrate from Settings; other presets explicitly override these values. Applying rebuilds only this focus window's video session, not global defaults or multi-view panes. Failed changes attempt to restore the previous configuration. The panel shows actual video dimensions and applied limits; FPS and bitrate are not live measurements.

The iPhone display uses the same right-hand toolbar. Its control entry shows the active method (Bluetooth, USB or Wi-Fi) and reconnects the last method with one click after a disconnect; screenshots and copying the current picture remain available. USB or Wi-Fi LAN control also provides Home, App Switcher and an optional Touch trail. These three tools disappear for Bluetooth control because that channel cannot perform those system actions. Android navigation keys are not shown at the bottom of an iPhone display.

The window matches the picture's aspect ratio and scales proportionally when its edges are dragged, so the picture is never stretched.

Three window styles (Settings → Cast window → Focus window, applied the next time a focus window is opened):

Standard · title bar, toolbar, navigation keys

Minimal · narrow title bar only

Immersive · picture only; the title bar appears at the top edge

The three window styles

The button in the title bar switches the current window only, without changing the default.

Terminal panel: the Terminal button opens a command line for that device (a standard 80 columns wide) and widens the window so the picture is not covered.

Select text and press Cmd+C (Ctrl+Shift+C on Windows / Linux) to copy to the computer clipboard; Ctrl+C still interrupts the running command.

Focus-open badge: devices with an open focus window show a small screen icon in the top-left of their card. Clicking that device's picture again brings the existing window to the front rather than opening a second one.

8 Multi-view

To view every device in a group in a single window, click the monitor icon on the right of a group row in the sidebar, or select the group from the Multi-view dropdown in the toolbar:

• Every pane is directly clickable. Auto arrange considers both workspace width and height, using each picture's actual aspect ratio for portrait, landscape and mixed layouts, ordered left to right and then top to bottom. It prioritises fitting every device fully inside the visible area, scaling panes down and allowing unused space instead of cropping pictures to fill the window
• Android panes request the device's original picture by default. Resizing a pane changes only its display size, not the source resolution. With many devices, lower Full Screen FPS or Bitrate in Settings to reduce load
• Quick replies are available only in the Android single-device window toolbar, not in Multi-view.
• Drag a pane by its title bar. Slight contact leaves other panes still. A target swaps into the drag-start position only when more than half covered and both panes fit without overlap. Otherwise positions stay unchanged; panes are not pushed down or globally rearranged
• The × on a pane's title bar removes it for this session; the expand button opens that device in its own focus window
• Pane titles can show either the model name or the connection name. Auto arrange is enabled by default and continuously responds to window and device-orientation changes. Dragging or resizing a pane enters manual layout; click Auto arrange to restore automatic control
• Clicking empty workspace or switching to another window clears the active pane. On Windows, clicking the window title or the empty part of its title bar also clears selection while preserving native window dragging. On macOS, use empty workspace, switch windows or drag the window; a title-bar click without dragging is not covered

TIP

Scrolling the wheel inside a pane scrolls that device. When the layout is taller than the window, use the scrollbar on the right.

9 Controlling an iPhone

Windows and macOS can select Bluetooth, USB or Wi-Fi LAN control in the independent display; Linux is view-only. Bluetooth requires compatible hardware, while USB / Wi-Fi requires trust, Developer Mode and a successful in-app check. Mirroring and control are separate: a visible picture does not mean the control channel is connected.

When switching control methods, the app stops the previous control channel and waits for it to exit before enabling the selected channel. If shutdown fails, it does not silently fall back to the old channel. Closing the independent display stops that window’s Bluetooth, USB or Wi-Fi control without stopping wall mirroring, removing Bluetooth pairing or requiring USB unplugging. Reopening restores that phone’s last successful USB/Wi-Fi route; Bluetooth never starts automatically and still requires explicit preparation and target confirmation.

9.1 Set up control

1. Choose Enable control beside the independent display. Follow the illustrated guide to open Bluetooth settings on the phone and select the displayed device name.
2. Verify and accept any pairing prompts. A valid pairing can reconnect without deleting it every time.
3. Explicitly select this display’s Bluetooth connection entry. For same-name phones, connect one at a time and observe the new entry instead of guessing by name. Only one display may use Bluetooth control at a time; stop the original display’s control before switching phones.
4. Enable Settings › Accessibility › Zoom, choose Full Screen Zoom and turn the Zoom Controller off. If magnified, double-tap with three fingers to restore normal size while leaving Zoom enabled.
5. Test a tap in a safe location and confirm that only the intended phone responds. Closing the guide does not stop mirroring.

9.2 Controls

Action	Method
Tap	Left-click the target in the picture
Drag	Hold the left button, move, then release
Vertical scrolling	Use the vertical wheel or drag
App Switcher	Drag up from the bottom-center to the middle, pause, then release
Keyboard	Focus the phone input first; use an English computer input source

Screenshot saves the current iPhone picture to the configured screenshot folder, while Copy places it on the computer clipboard. Once USB / Wi-Fi control is connected, Home and App Switcher are available, and Touch trail can show the current tap or drag path. These three tools are hidden for Bluetooth control. If control disconnects, the control entry shows the previous method and reconnects it with one click; when reconnection fails, the method selector and troubleshooting guide open automatically.

Leaving the window releases contacts and keys. Use the phone input method for Chinese. Computer Chinese composition or paste, landscape, multi-touch, hover, horizontal wheel, iOS group control, app installation and file transfer are not supported. Gesture behavior depends on phone system and accessibility settings.

9.3 Troubleshooting

• Confirm the picture is live. If frozen, stop Screen Mirroring on the phone and reconnect before clicking.
• Check Bluetooth, keep Zoom enabled at normal picture size and complete the guide's tap verification.
• If the computer cannot be discovered, check its Bluetooth permissions and switch, then reopen setup.
• Forget an old pairing only when it has actually become invalid or reports unsupported, then pair again.

10 Plugins and WeChat Quick Replies

Select Plugins in the top bar to open the Plugin Center. From here you can browse built-in features, install a local plugin, or read the custom-plugin documentation. Opening this page does not interrupt active mirroring sessions.

10.1 WeChat Quick Replies

Open WeChat Enhancement under Browse Plugins to enable the feature and manage frequently used replies. No extra app is installed on the phone.

1. Enable WeChat Enhancement, then add, edit, or import replies on the plugin page.
2. Open a WeChat chat in a controllable Android focus window; Quick Replies appears on the right.
3. Fill replaces the input-box text only. Send replaces the text and sends it. Confirm the current conversation first.
4. Use the phone's WeChat screen as the source of truth. If the connection is uncertain, verify the result instead of clicking repeatedly.

Replies are stored locally. Export files contain their full text, so keep them private. Landscape, split screen, cloned-app containers, non-Chinese WeChat interfaces, and third-party themes are not fully covered. If the input box or Send button cannot be identified safely, the app does not click or retry automatically.

10.2 Install a Custom Plugin

Drag a .zip or .vmosplugin file into the Plugin Center, or use Install in the top-right corner. New plugins start disabled: review the author, supported platforms, and permissions before enabling one. User plugins can be disabled or removed; built-in plugins cannot be removed.

Developer Docs provides searchable offline documentation and a sample-plugin download. Plugins currently use declarative configuration and do not execute arbitrary scripts; device text-injection capabilities are Android-only. See Custom Plugin Development for the complete format.

11 Settings

Click the gear icon in the top bar. Settings are split into Appearance and Cast window:

Setting	Description
Theme mode	Light, Dark, or System
Theme color	A preset colour or a custom one
Main window size	Compact, Standard, or Wide — applied and remembered immediately
Minimise to system tray on close	See below
Thumbnail size	Display size of each tile on the wall; synced with the toolbar size slider and applied immediately
Focus initial size	See below
iOS control pointer speed	Tracking speed of the iPhone pointer while the cursor is locked; applies immediately
Focus window	Standard, Minimal, or Immersive; applies the next time a device is opened

The interface language is switched from the top bar, not from Settings.

Closing the window (Appearance → Minimise to system tray on close):

• Unchecked (default): closing the window quits the application entirely, leaving no background process
• Checked: closing hides the main window to the system tray; the application keeps running and devices stay connected. Click the tray icon to restore it. To quit completely, right-click the tray icon → Quit

Focus initial size (20%–200%) does not affect quality or resolution — it sets the starting window size the next time a single device is opened. It accounts for both the long and the short edge, so an ultra-wide display does not open as a flat strip. Windows already open are unaffected.

The focus and multi-view title bars include a bulb-shaped Keep awake button. While lit, supported Android devices stay awake as if user activity were continuing. The device runtime refreshes user activity every four seconds so the normal timeout is prevented before the display turns off; it does not change screen-timeout settings or repeatedly turn the screen off and wake it again. In a mixed multi-view, unsupported devices are skipped without blocking other devices, and a notice appears when Keep awake is enabled or disabled. If a device stops accepting the operation while it is running, the button resets automatically and a notice appears. Selecting Turn screen off disables Keep awake first, then turns the display off. Turning Keep awake off or closing the window stops it immediately, and it is not remembered.

Streaming Settings and About:

Setting	Default	What it does
Device List FPS	—	Refresh rate of the small pictures on the main screen. 1 fps is the lightest; 10/15/20/30 fps switch to continuous video and apply immediately
Pause list picture while full screen is open	Off	Pauses wall thumbnails for devices shown full screen and resumes them when the window closes
Full Screen FPS	60	Configured FPS limit for Android focus and multi-view windows. "Match device" removes only this configured limit; actual FPS still depends on the device, computer decoding and rendering capacity, and network
Full Screen Bitrate	8 Mbps	Higher is sharper but uses more bandwidth
Channels	All on	Video / audio / control. Turning video off leaves audio and control; turning control off makes the session view-only
Screenshot location	System Pictures folder	Where batch and focus-window screenshots are saved

Full Screen FPS, Full Screen Bitrate and Channels take effect the next time a device is opened; windows already open are unaffected.

TIP

Stuttering: lower Full Screen Bitrate (8 → 4 → 2 Mbps); if it still stutters, drop Full Screen FPS to 30 or 15. Blurry: first check whether the focus window's Quality panel is set to 720 / 1280 / 1920; choose Original for the device's source resolution. If it is already Original but compression is visible, raise Full Screen Bitrate to 12 Mbps. More responsive: on a high-refresh device, set Full Screen FPS to "Match device". Device List FPS is independent of those two: if the main screen is slow, change Device List FPS; if a full-screen view is slow, change the other two. To avoid duplicate traffic on a constrained network, enable Pause list picture while full screen is open. The wall thumbnail then pauses while the device is in a focus or multi-view window and resumes when it closes. This setting is off by default.

These parameters apply to Android devices only; an iPhone or iPad sends its picture over Screen Mirroring and is unaffected.

12 Device Status Reference

The six wall states, matching the Status filter one to one:

Online

Picture refreshing normally

Connecting

The picture is being established

Screen is off

Screen off

Screen powered down · wake it from the focus window

Not castable

Not castable

The page blocks screen recording, so the system hides it

Failed

Connection failed

The device is there; this connection has not come up

Device offline

Offline

The device is gone · powered off, unplugged, or off the network

Failed means the device is still there; offline means it is not

Status	Meaning	What to do
Connecting	The picture is being established	A few seconds is normal
Device offline	Added but currently unreachable (powered off, different network, wrong address)	The device is retained and the picture is restored once it returns, without constant retries. To drop it, select the card and click Remove selected
Connection failed	The device is online, but the picture has not been established	Wait about half a minute — the app reconnects automatically. Remove and re-add only if it keeps failing
Connection timed out	Repeated reconnects produced no picture	Check the device, or restart it and reopen
Restricted by system security	The device is on a page with screen-capture protection	See below
Screen off	The device's screen is off	Wake it on the device, or use Wake screen in the focus window
Mirroring / Not mirroring	iPhone only: whether the device is currently mirroring	"Not mirroring" is not a disconnection — start mirroring again and it returns
Video is off	The video channel has been disabled	Turn it back on in Settings → Streaming Settings

About "Restricted by system security": in addition to lock screens, payment and banking pages, copyright-protected video playback pages also enable capture protection, and Android blocks such pages from being mirrored. This is system behaviour, not a fault in the application.

The focus window switches to a degraded picture: still visible and still clickable (a lock-screen PIN can be typed directly in the window), at a lower frame rate. It returns to live automatically when the device leaves that page, and a "Restore live view" control is available. On a few devices even the degraded picture is unavailable, and only then does the card read "Restricted by system security".

TIP

In both states the device remains connected, and clicking the card still opens the focus window to show the message.

13 Using Several Computers at Once

The same device can be mirrored by any number of computers at the same time.

• Each computer's connection, windows and input session are isolated, and all of them can operate the device — tapping, system keys, typing, installing and uploading never wait on a "control token"
• Every computer sees the device's screen-on, screen-off and security states in real time
• Closing the app on one computer releases only its own connection and does not affect the others; the device-side service shuts down after the last client leaves
• The device-side control port is not exposed to the local network — it is reachable only through the connection the application establishes

14 Updates, Support, and Diagnostic Logs

Checking for updates: the app checks in the background after launch and shows a dialog only once a new version is confirmed and its release notes are complete. The dialog lists what changed and offers View Full Release Notes and Ignore this version — ignoring silences that one version, while later ones still prompt. Update now shows a real percentage, downloaded/total size, speed and time remaining; restart to finish installing. Updates can also be checked manually under Settings → About.

Contact Support

Contact Support in the top bar offers online support, Telegram, and email:

Choosing an option prepares diagnostic logs in the background without blocking contact. Logs may include device identifiers, computer paths, and fault context; continue only if you are willing to share that information. Telegram never sends a group message automatically.

Export Diagnostic Logs

When something goes wrong, use Settings → About → Export Logs:

1. Open Settings → About and select Export Logs.
2. After upload succeeds, copy the diagnostic ID shown on the page and include it when contacting support.
3. If upload fails, the logs exceed 20 MB, or no local logs are available, save the ZIP as instructed and send it manually.

The bundle contains computer logs, device-side logs, and system diagnostics. With many connected devices, the 10 most recently active devices are collected; offline devices do not slow the export down.

On macOS, Share Logs alongside it builds the same bundle and opens the system share sheet directly.

When reporting a problem, include the computer's operating system and version, the connection method, the device model and Android version, plus a description and screenshots. See How to report a problem.

15 Quick Reference

Goal	Route
Connect a physical phone for the first time	Enable USB debugging → connect the cable and allow → right-click the card → Add LAN connection → remove the cable
Connect a phone without a cable	Android 11+ wireless debugging pairing (six-digit code)
Add many cloud phones	Add Device → paste addresses in bulk, or scan a subnet → tick → Add
Mirror an iPhone	iPhone / iPad tab → Control Center on the phone → Screen Mirroring → select this computer
Install one package across a batch	Create a group → open it → Select All → Batch → Batch install
View a whole group in one window	Monitor icon on the group row → Multi-view
Sync gestures across devices	Select 2+ devices → Group Control
Monitor devices for long periods	Filter by group → smaller thumbnails → lower Device List FPS → dark theme
Fix a stuttering picture	Settings → Streaming Settings → lower Full Screen Bitrate, then Full Screen FPS
Report a problem	Settings → About → Export Logs → send the zip with screenshots

Windows USB mirroring: Do not select Stop Mirroring in iPhone Control Center → Screen Mirroring, as USB mirroring may not resume. If this happens, restart the iPhone, unlock it, then unplug and reconnect USB. A frozen last frame does not prove the connection is healthy. Do not repeatedly repair the connection or reinstall drivers.

Wi-Fi preparation saves pairing, but does not mean control is connected. After unplugging USB and starting wireless mirroring, select the paired phone in its large window and confirm the connection; pairing is not required again each time. Reconnection first tries that phone’s last authenticated LAN endpoint, then rediscovers it if necessary, always verifying identity. If connection fails temporarily, keep the phone unlocked on the same LAN and retry. Wireless video and control are separate channels.