remote-slide-changer

A utility for zoom meetings for cases where there are more than one speaker sharing the same slides sending a simple set of keypresses (arrow keys and space) over the internet. Could be used as a slide changer in presentations, or as a tool to synchronize movie watching remotely with friends.

It follows a client-server-host structure, where server propagates messages from clients to hosts using group identifiers, and the host actuates keypresses based on messages received from the server. The client is a simple web ui, pictured above.

Usage

host

To use the host script, run it with either:

sudo python3 remoteSlideChanger.py

or if you want to assign your groupid without the hassle of cli-ui:

sudo python3 remoteSlideChanger.py replace-me-with-your-host-identifier

The script will now receive keypresses from clients connected to the server with the same identifier. To stop execution, use ctrl+c.

Root access is required for the script because of the keyboard module

client

After setting up the host, connect to the server using the same identifier as with the host. Then use the keypad to activate keypresses on the host/hosts.

If you don't want to setup your own server, I have a client/server combo running here.

Minimum installation

For minimal installation, only the host script has to be downloaded. Python3 and a few dependencies are necessary, install them with:

sudo pip3 install asyncio websockets keyboard

Then run the script as was defined in the usage section.

Full installation

Clone the repo or download the .zip file and extract it

git clone https://github.com/sainigma/remote-slide-changer.git

host

Install dependencies:

pip3 install asyncio websockets keyboard

Change uri in remote-slide-changer/host/remoteSlideChanger.py to point at the port your server is listening, both ws and wss addresses work.

If you wish to change which keys the host presses on client actions, change the values for keyboardactions dict in remote-slide-changer/host/remoteSlideChanger.py. Available keypresses here.

server

Assuming you have npm installed, move to remote-slide-changer/server and:

npm install

Before running the server, create a .env JSON file at the root of the server and set following variables:

{
  "privateKey": "./key.pem",
  "certificate": "./cert.pem",
  "port": "1234",
  "wss": True
}

Then, run the server with

npm run start

client

Move to remote-slide-changer/client, create a .env file and add the following entry:

WSOCK=wss://your-address-here.com:1234

Then build and move the frontend with:

cd client
npm install
npm run build
mv /build /path-to-your-server/finaldestination