RemoteViewer WebRTC lets you view and control another PC over the internet. Connections run over WebRTC through a gateway server; you connect either with a one-time code or to a device registered to your account.
Host (shares its screen) · Viewer (connects). One app does both.
Account
An account is needed for My-devices / unattended. Code connect and Request-help work without login.
Key ideaUse a code for a quick one-off session; to reach a PC you manage anytime, register it to your account for unattended access.
2. Install & first run
Windows
1
Run the installer (RemoteViewerWebRTC-Setup-0.1.35.exe) and follow the wizard. A RemoteViewer icon appears on the desktop / Start menu.
2
On first launch you must accept the End-User License Agreement (EULA) before using the app.
3
If a Windows firewall prompt appears, click Allow (private/public networks).
Unsigned installerThe installer is not code-signed yet, so SmartScreen may warn. Click More info → Run anyway (an official certificate is planned).
AdministratorTo control UAC dialogs remotely, use Settings → Restart as administrator.
Linux (x64)
1
Extract the package (RemoteViewer-linux-x64-0.1.35.tar.gz) and run ./install.sh inside the folder. It installs to /opt/remoteviewer and sets up a menu entry, auto-update and the runtime libraries.
2
The installer also auto-configures the login-screen host so the PC is reachable even when logged out (both console and new-session modes). No extra command needed.
3
Launch RemoteViewer, log in, and register this PC for unattended access (My devices → Register this PC). The login-screen host then activates itself within seconds.
Full desktop (XFCE)For a full desktop (e.g. XFCE) in ‘New session’, install it on the target: sudo apt install xfce4. When present, you can pick the desktop type at connect time.
Opting outFor a headless/kiosk box that needs no login-screen access, install with RV_LOGIN_HOST=0 ./install.sh; for console-view only, RV_LOGIN_HOST=console ./install.sh.
3. Create an account & log in
To reach My devices or register this PC as an unattended host, you need an account first. Open the left Account tab.
Account tab — sign up or log in with email · password · organization
1
Enter your Email and Password. If you're new, also fill in Organization (sign up) and press Sign up.
2
If you already have an account, press Log in to sign in.
Gateway addressThe app ships with a preset gateway address, so you normally leave it as-is. The Change button beside it is reserved for future use and is currently disabled.
4. Ways to connect
Pick the method that fits your situation — some need a login, some don't.
Method
Tab
Login
Use for
Connect by code
Connect
No
Ad-hoc connect using a code someone gave you
Share this screen
Connect
No
Issue a code so someone can view your screen
Request / Start support
Connect
No
Remote support (get helped / help someone)
Connect to my device
My devices
Yes
Reach an unattended PC registered to your account, anytime
5. Quick connect (code · share)
The left Connect tab connects instantly with a code — no login required.
Connect tab — ① Share screen (issue a code) ② Connect by code
① Show my screen — Share this screen
1
Press Share this screen to generate a connection code. Use Copy code and give it to the other person.
2
When they connect with that code, your screen is shared. Close the window to end sharing.
② Connect to a screen — Connect by code
1
Press Connect by code and type the code the other side gave you.
2
Once connected, the remote screen opens in a new window (see the next chapter).
Remote supportRequest help is for the person getting help — type the supporter's code and your screen is shared, no login. The supporter issues the code with Start support (premium).
6. My devices & unattended
Register a PC you manage to your account for unattended access, and you can reach it anytime even with nobody there. Log in on the Account tab first.
My devices tab — ① status ② Wake ③ Connect selected
Register the PC that will accept
1
On the PC that will accept, go to My devices → Register this PC…. Name the device and it registers as an unattended host under your account.
2
A registered PC shows as 🟢 online while this app runs. If it has a connection password, a 🔑 appears next to its name.
Reach that PC from elsewhere
1
On the device you connect from, log in with the same account and open the My devices tab. Your registered devices are listed.
2
Pick a PC and press Connect selected. A password-protected device will prompt for its password.
Unattended agent (advanced)To keep a PC in unattended standby headlessly (no window), run it in agent mode (--rtc-agent). Handy for servers and kiosk PCs.
7. Wake-on-LAN
A PC that is off or asleep must be woken before you connect. RemoteViewer sends a magic packet to it through another online device on the same network (Wake-on-LAN).
1
Open My devices → WOL setup wizard. The wizard walks you step by step through the target's BIOS/power settings and MAC address (it can auto-apply the needed items with administrator rights).
2
When set up, pick the sleeping PC in My unattended devices and press 🔌 Wake. It turns 🟢 once it powers on, then you can connect.
RequirementsYou need at least one online device on the same LAN to send the packet, and Wake-on-LAN must be enabled in the target's BIOS and network adapter. The wizard checks these for you.
8. The remote-control window
Once connected, the remote desktop opens in a new window. Use your mouse & keyboard inside it to drive the remote PC.
Feature
How
Mouse & keyboard
Click and type inside the window; the remote PC follows.
Monitor
If the host has multiple monitors, pick which one to view from the window menu.
Quality HUD
The top of the window shows fps · latency (ms) · bandwidth so you can gauge the link.
Quality preset
Pick Speed · Standard · High (native) from the quality menu. In Auto mode (default) it raises quality on a fast link and lowers it when the link slows — switch Auto/Manual in Settings → Remote screen.
Remote audio
Use 🔊 Sound to hear the remote PC. Silent when nothing is playing there.
Camera
If the remote PC has a webcam, 📷 Camera shows it as a small picture-in-picture.
Chat
Exchange text messages with the other side via 💬 Chat.
Recording
⏺ Record saves what you are viewing to an MP4 file (mind privacy).
Files & clipboard
Move files and share text over the data channel (next chapter).
MultiView
Show several screens in one window at once (premium).
Connecting to LinuxConnecting to a Linux PC first shows a mode chooser (console / new session) — see chapter 11.
9. File transfer & shared folder
The host (the PC sharing its screen) has a shared folder that the viewer can browse. The host drops files there; the viewer downloads them from the file panel.
1
On the host, the share window has a 📂 Open shared folder button that opens that folder in the file manager. Copy the files you want to share into it.
2
The viewer browses that shared folder from the file panel of the remote window and downloads files.
3
When the viewer sends a file to the host, it lands in the host's received folder.
Folder locationThe shared folder is created at RemoteViewer\shared under your user profile. 📂 Open shared folder saves you memorizing the path.
10. Connect from the web viewer
You can also connect from a plain web browser with nothing installed. Open the gateway web address your organization gave you.
Web viewer — connect by code, or 🔑 log in and reach your devices
1
If you have a code, type it in the code box to connect right away (no login).
2
To reach an unattended device of yours, click 🔑 Log in (top-right) and log in with your account.
3
After login your devices appear. Pick a 🟢 online one and its screen opens right in the browser. A password-protected device prompts for its password.
The agent must be runningThe target PC must be running RemoteViewer (or the unattended agent) and show 🟢 online to appear in the list.
11. Linux: console & session modes
Connecting to a Linux PC offers two connection modes not found on other OSes. When a Linux host is set up with ./install.sh and registered, a mode chooser appears first.
Mode
What you see
Use for
View this PC (console)
Whatever is on the monitor now. If logged out, you see the login screen and can log in remotely.
Drive the one physical machine
New session (my own desktop)
Log in with an OS account of the PC and get your own fresh desktop, isolated from others.
Many users working at once
① Connect to the console
1
Pick ‘View this PC’s screen’ in the chooser. This is the usual choice.
2
The monitor's current screen opens. If it was logged out you see the login screen; log in and it follows you onto the desktop automatically.
② Connect to a new session
1
Pick ‘Open my own desktop’ and an OS login box appears. Enter the Linux account username/password of that PC (not your gateway account). If XFCE etc. is installed you can also pick the desktop type.
2
After login a ‘Preparing session…’ notice shows briefly — the PC is spawning a fresh desktop, so just wait a few seconds. It clears when the first frame arrives.
3
Your own desktop opens. Use the file manager, terminal and installed apps; it is fully isolated from other users' sessions.
No full desktop yetWithout a full desktop installed you get the lightweight built-in session (a window manager + terminal + file manager). For a richer one, sudo apt install xfce4 and reconnect.
Register firstConsole/session access needs the target Linux PC registered with its login-screen host running. ./install.sh sets this up, so a single first-time unattended registration is enough.
12. Settings, security & license
The Settings tab adjusts the selected device's security options and app behavior. Select a device on the My devices tab first, then change its options here.
Device management
Item
What it does
Security level
Restricts which connection methods that device accepts.
Allowed viewers
Only the accounts you list may connect to that device (allow-list).
Connection password
Sets or clears a password required to connect to the unattended device.
Remote screen, startup & reset
Auto quality
Auto (default) raises quality to ‘High’ on a fast link and lowers it when slow. Manual keeps exactly the preset you picked in the viewer.
Start on boot
Launch RemoteViewer at Windows startup (useful for unattended hosts).
Restart as administrator
Relaunch elevated so UAC dialogs can be controlled remotely.
Reset settings
Clears saved login, device registrations and app settings, and logs out.
Unattended cautionAn unattended PC accepts connections with nobody present. Always pair it with a connection password or allowed-viewers list, and enable it only when needed.
License & Info
For 100 days from first sign-up all features are free. After that, some premium features (MultiView, Start-support, …) require a license.
1
In Info → Register license key…, paste the key you were issued.
2
The Info tab also gathers the User manual, EULA, Check for updates and optional error reporting.
13. Troubleshooting FAQ
Symptom
Fix
Sign-up/login is ‘refused’
Check the gateway address on the Account tab is the default. If it's an internal-only address, you must be on that network.
My-devices list is empty
Make sure the target runs RemoteViewer (or the agent), is logged in with the same account, registered unattended, and shows 🟢. Press Refresh to refresh.
‘Wrong password’
Re-check that device's connection password (case-sensitive). Change it in Settings → Device management.
Wake (WOL) doesn't work
Ensure an online device on the same LAN can send the packet, and WOL is enabled in the target's BIOS and network adapter. The WOL setup wizard helps you check.
Screen slow or choppy
When connected, the status bar shows the path — direct (P2P/LAN) is fastest, while relay (TURN) goes through the internet relay and can be slower (a network where a direct path is blocked). Retry on a wired/stable connection.
Connection drops
Most drops auto-reconnect — a WiFi switch or brief outage recovers itself within seconds. If it persists, close the window and reconnect; if it keeps failing, confirm the app is allowed through your firewall.
Diagnosing why it won't connect
When the freeze notice appears, click [Open diagnostics] to open the session log (rv-session-diag.log) — it records this connection's path, loss, decoder and errors. It contains no screen content or credentials, so you can send it to support as-is.
HelpYou can reopen this document from Info → User manual inside the app.