Documentation

Everything you need to install BD Remote App and start connecting safely.

1. Install

Download BD Remote App from the Download page and run BDRemoteApp.exe. It opens to the sign-in screen — there is nothing to configure.

The app keeps itself up to date: if a newer version is required, it will prompt you to download the update before continuing.

2. Sign in (name + email)

On the home screen, enter your name and email and click Send code. A 6-digit one-time code is emailed to you — enter it to continue. This same step works the first time (it creates your account) and every time after.

3. Your ID & session password

After the code is verified, the app shows your 9-digit User ID and a session password.

  • Your User ID is permanent — it stays the same, and it’s how others reach this PC.
  • Your password refreshes on every login — it’s a fresh, temporary key each session.

Share your ID + current password only with someone you want to let control this PC.

4. Share your PC (host)

On the main screen, click Go online as host. Your PC is now reachable by your ID. When someone requests access, an Approve / Deny dialog appears.

Nothing is shared until you click Approve. Deny to reject the request.

5. Connect to a PC (viewer)

Enter the other PC’s Partner ID and its current password, then click Connect. Once the owner approves, a window opens showing their screen and your mouse and keyboard control that PC. Close the window to end the session.

6. Security

  • Sign-in is by email one-time code — no reusable login password to leak.
  • The connect password refreshes every login (a temporary session key).
  • Every session still requires explicit owner approval.
  • Passwords are stored hashed; session tokens expire automatically.
  • Only approve people you trust — an approved viewer has full control.

7. For administrators

The server is PHP + MySQL and runs on XAMPP or cPanel. After deploying, initialise the database once via install/setup.php, then manage users, sessions and messages from the admin panel. To roll out a mandatory update, raise CLIENT_MIN_VERSION in config.php and publish the new build — older clients are then forced to update.

See the project README.md for full deployment steps.

8. Troubleshooting

“Cannot reach server”

Check the Server address, and that the server is online and reachable from your network.

Didn’t get the email code

Check spam. On a fresh server, the administrator must configure email (SMTP) for codes to send.

“That PC is busy”

A host serves one viewer at a time. Try again once the current session ends.