Remote control your computer using the remote-control server. This server enables you to control your computer from your phone. The project was initially created to control a Raspberry Pi connected to a TV via mobile device.
- Download the latest release for your platform from the releases page.
- Extract the archive to a folder of your choice.
- Run the executable:
- linux:
./remote-control-server - macos:
./remote-control-server - windows:
remote-control-server.exe
- linux:
- Install bun.js if you haven't already.
- git clone this repository.
- Navigate to the project directory.
- Run
bun installto install dependencies. - Mobile Setup:
- Ensure your mobile device is connected to the same network as the server.
- Start the server:
- For HTTP:
bun server.mjs - For HTTPS with self-signed certificates:
bun server.mjs -s
- For HTTP:
- The default browser will open with a QR code.
- Scan it with your mobile device to access the remote control UI.
- To enable the mobile debug console on the controller page, open the URL with
?debug, for examplehttp://<server-ip>:3000/index.html?debug.
Each push to main, including merges, triggers GitHub Actions to build release bundles for Linux, macOS, and Windows.
- Release tags and release names use the version from
package.json, for examplev0.0.11. - Assets are published as platform-specific archives containing the executable and the required
public/files.
Before merging to
main, dobun run pub, to update package.json and package-lock.json with the new version. The GitHub Actions workflow will then use this version to create the release.