📖 User Guide

Welcome to TeamX

TeamX is a secure remote desktop application that lets you access and control computers from anywhere. Connect to a remote machine to provide support, access your work PC, or collaborate in real time.

End-to-end WebRTC
Windows & Web
Unattended Access
🖥️
Host
Your computer is shared. Others can view and control your screen.
  • Share your TeamX ID or PIN
  • Approve or deny connection requests
  • Set an unattended access password
  • See who is connected
👁️
Viewer
You connect to and control another machine remotely.
  • Connect using a 9-digit TeamX ID
  • Connect using a 6-digit PIN code
  • Control mouse and keyboard
  • Transfer files and chat

⬇️ Installation

Download and install the TeamX desktop app on any Windows machine you want to host or view from.

1
Download the installer
Download TeamX Setup 1.0.0.exe from your TeamX server's download page or from the link provided by your administrator.
2
Run the installer
Double-click the downloaded .exe file. Windows may show a security prompt — click Run anyway to proceed. The installation takes about 30 seconds.
3
Launch TeamX
TeamX appears in your Start Menu and desktop. On first launch, you will be taken to the sign-in screen.
ℹ️
System Requirements
Windows 10 or Windows 11 (64-bit). No additional software required — the installer is self-contained.

👤 Create an Account

You need a TeamX account to sign in and use the app.

1
Open the sign-in screen
Launch TeamX. The sign-in screen appears automatically.
2
Click "No account? Create one"
Below the Sign In button you will find a link to open the registration form.
3
Fill in your details
Enter your Display Name, Email, and Password. Confirm the password and click Create Account.
4
Await admin approval
New accounts may require approval from an administrator before you can sign in. You will receive confirmation once your account is approved.
You can also register via the web portal at your TeamX server URL.

🔑 Sign In

1
Enter your email and password
Use the email and password you registered with.
2
Two-Factor Authentication (if enabled)
If 2FA is enabled on your account, you will be prompted to enter the 6-digit code from your authenticator app (e.g. Google Authenticator).
3
You're in
After signing in, the main TeamX home screen appears. Your TeamX ID and session PIN are shown on the left panel.
ℹ️
Stay Signed In
TeamX can remember your credentials using secure OS-level encryption. You won't need to sign in every time unless you explicitly sign out.

🖥️ Starting a Hosted Session

When you open TeamX and sign in, hosting starts automatically. Your machine is ready to receive connections — no extra steps needed.

Your Identifiers

IdentifierFormatUse
TeamX ID 9 digits (e.g. 123 456 789) Permanent. Give this to anyone who needs long-term access to your machine.
Session PIN 6 digits (e.g. 847 291) Changes each session. Use for one-time or quick-support connections.

Approving Connections

When a viewer requests to connect, a consent popup appears on your screen. You can Allow or Deny the request. The request times out automatically if not answered.

⚠️
Only share your ID and PIN with trusted people
Anyone with your TeamX ID or current PIN can request access to your screen. They still need your approval unless unattended access is configured.

📋 Sharing Your TeamX ID or PIN

1
Find your IDs on the home screen
After signing in, the left panel shows your TeamX ID (9 digits) and your active Session PIN (6 digits).
2
Click the ID to copy it
Clicking either number copies it to your clipboard. Share it with the viewer via chat, email, or phone.
3
Viewer enters the ID and connects
The viewer enters the ID or PIN in their TeamX app and clicks Connect. You will see an approval popup.
💡
TeamX ID vs PIN: Use your TeamX ID for regular contacts who connect to your machine often. Use the Session PIN for one-time quick-support calls — it refreshes each session so old PINs won't work.

🔒 Unattended Access

Unattended access lets viewers connect to your machine even when you are not present — without needing you to approve the request manually.

Setting Up Unattended Access

1
Open Settings
Click the Settings (⚙) icon in the top-right of the TeamX home screen.
2
Enable "Unattended Access"
Toggle on Allow Unattended Access. Your machine will now auto-approve connections without requiring your manual approval.
3
Set a Session Password (recommended)
In the Unattended Session Password field, enter a password. Viewers must supply this password to connect automatically. Without a password, the approval popup will still appear.
4
Click Save
Your unattended settings are saved. TeamX will auto-start with Windows to maintain always-on availability.
⚠️
Always set a Session Password for unattended access
Without a password, anyone with your TeamX ID can connect automatically when unattended mode is on. A strong password ensures only authorised viewers can connect.

How Unattended Connection Works

ScenarioWhat Happens
Unattended ON + Password set + Correct passwordAuto-connects immediately
Unattended ON + Password set + Wrong passwordConnection denied automatically
Unattended ON + No password setManual approval popup shown
Unattended OFFManual approval popup always shown

🔗 Connect by TeamX ID

Use the 9-digit TeamX ID to connect to a specific machine. This ID is permanent for that device.

1
Go to the Connect panel
On the TeamX home screen, find the Connect to Remote section on the right panel.
2
Enter the TeamX ID
Type the 9-digit ID (spaces are ignored) in the TeamX ID field.
3
Enter Session Password (if required)
If the host has set an unattended session password, enter it in the Session Password field. Leave blank if no password is set.
4
Click Connect
TeamX connects to the remote machine. You will see a waiting screen while the host approves (or auto-approves if unattended access is configured).

🔢 Connect by 6-Digit PIN

Use the 6-digit PIN for quick one-time connections. The PIN is shown on the host's screen and changes each session.

1
Get the PIN from the host
Ask the host to read their Session PIN from their TeamX home screen.
2
Enter the PIN
On the Connect panel, switch to the Connect by PIN tab and type the 6-digit code.
3
Click Connect
TeamX looks up the active session and connects. The host sees an approval popup.
ℹ️
The PIN is valid for the current session only. Once the session ends, a new PIN is generated.

🖱️ Session Controls

Once connected, the session window shows the host's screen and a toolbar at the top.

ButtonAction
🖱 Control / View OnlyToggle between controlling the remote mouse/keyboard and view-only mode. Click on the remote screen to activate control.
🖥 MonitorsSwitch between multiple monitors on the host machine.
💬 ChatOpen the chat panel to send text messages to the host.
📁 FilesSend a file to the host machine.
⏺ RecordStart/stop recording the session to a local file.
✕ DisconnectEnd the session and close the window.

⌨️ Mouse & Keyboard Control

Activating Control

When the session opens you are in View Only mode by default. To start controlling the remote machine:

1
Click once on the remote screen
The first click activates control mode. The cursor changes to indicate you are now controlling the remote machine.
2
Use mouse and keyboard normally
All mouse clicks, scrolling, and keypresses are forwarded to the host machine in real time.
3
Click "🖱 Control" to toggle off
Click the Control button in the toolbar to return to view-only mode.
💡
Keyboard shortcuts work even if you click a toolbar button and the remote screen loses focus. TeamX captures all keypresses globally while control mode is active (except when you are typing in a TeamX input field).

📁 File Transfer

Send files to the host machine directly within the session — no need for external file sharing services.

1
Click 📁 Files in the toolbar
The file transfer button opens a native file picker dialog.
2
Select a file
Browse to the file you want to send and click Open.
3
Transfer completes
A progress bar appears during transfer. The file is saved to the Downloads folder on the host machine.

💬 Chat

Send text messages to the host during a session without interrupting the screen sharing.

1
Click 💬 Chat in the toolbar
The chat panel slides in from the right side of the screen.
2
Type your message and press Enter
Messages appear on both the viewer's and host's screens in real time.
ℹ️
Unread messages show a badge counter on the Chat button so you don't miss anything while focused on the remote screen.

🖥️ Multi-Monitor Support

If the host machine has multiple monitors, you can switch between them during the session.

1
Click 🖥 Monitors in the toolbar
A panel opens showing thumbnail previews of each available monitor on the host machine.
2
Click a monitor thumbnail
The stream switches to the selected monitor instantly.

⏺ Session Recording

Record the session as a video file saved to your local machine.

1
Click ⏺ Record to start
Recording begins immediately. A red indicator appears in the toolbar.
2
Click ⏹ Stop to end recording
The recording is saved to your Downloads folder as a .webm video file.

⚙️ Settings

Access settings by clicking the ⚙ gear icon in the top-right corner of the home screen.

SettingDescription
Allow Unattended Access When enabled, viewers can connect without requiring your manual approval each time.
Unattended Session Password Password viewers must enter to connect to your machine automatically. Strongly recommended when unattended mode is on.
Auto-Share on Login Automatically starts a session when TeamX opens, so your TeamX ID is always active.
Blank Screen on Connect Blanks your physical monitor when a viewer connects, for privacy.
Lock Screen on Connect Locks the Windows session when a viewer connects.
Disable Wallpaper Temporarily removes the desktop wallpaper during a session to improve streaming performance.
View-Only Mode When enabled as a viewer, you can watch the remote screen but cannot control it.

🔧 Troubleshooting

Cannot connect — "Connection denied" message

The host manually denied the request, or a wrong session password was entered. Ask the host to approve the request again, and verify you have the correct session password.

Cannot connect — stuck on "Waiting for approval"

The host may have stepped away. If unattended access is not configured, the request will time out automatically. Ask the host to check their screen for an approval popup.

Video freezes during session

This usually indicates a poor network connection between you and the host. TeamX will attempt to reconnect automatically. If it persists, disconnect and reconnect.

Mouse clicks and keyboard are not working

  • Make sure you have clicked once on the remote screen to activate control mode.
  • Check that the toolbar shows "🖱 Controlling" (not "View Only").
  • Ensure you are running the latest version of the TeamX installer.
  • Try disconnecting and reconnecting.

Black screen instead of remote desktop

The host may have enabled "Blank Screen on Connect" in settings for privacy. The host's physical display is intentionally blacked out — this is normal.

Session password prompt even though I entered the correct password

Verify there are no leading or trailing spaces in the password. Passwords are case-sensitive. Ask the host to double-check the password they configured in Settings.

💡
Still stuck?
Contact your TeamX administrator or check that both machines are running the latest version of the desktop app.

❓ Frequently Asked Questions

Is my session encrypted?

Yes. All session video and data travel over WebRTC, which uses DTLS-SRTP encryption end-to-end. Your session traffic is never stored or inspected by the server.

Can multiple people view the same screen?

Yes. Multiple viewers can connect to the same host simultaneously. Each viewer can be granted full control or view-only access.

What is the difference between TeamX ID and Session PIN?

Your TeamX ID is a permanent 9-digit identifier assigned to your device. Your Session PIN is a temporary 6-digit code that changes every session. Use the TeamX ID for regular access and the PIN for one-time quick-support.

Does TeamX work when I'm not on the same network?

Yes. TeamX uses a TURN relay server to establish connections across different networks and firewalls. No port forwarding is required on either machine.

Will TeamX run in the background?

Yes. TeamX minimises to the system tray when you close the window. A right-click on the tray icon gives you quick access to open the app or exit completely.

How do I sign out?

Click the sign-out icon in the top-right corner of the home screen. This ends your current session and returns you to the sign-in screen.

Can I use TeamX from a web browser?

Yes. A web viewer is available for viewing sessions from a browser without installing the desktop app. However, the full desktop app is required to host a session.