dcts / OscRemoteControl

Control your computers keyboard and mouse remotely with your smartphone via TouchOSC. App build with processing (runs on Java).
2 stars 0 forks source link

OSC Remote Control

Control your computers keyboard and mouse remotely with your smartphone via TouchOSC. You can find a demonstration of the programm here. You will need:

Installation

Follow this step-by-step guide to install OscRemoteControl on your computer. There are two ways of running the OscRemoteControl on your computer:

1. Run OscRemoteControl with Java Runtime Environment (recommended)

  1. Install the java runtime environment. If you have java already installed on your machine the installer will recognize this and check for updates. If any updates are suggested, be sure to upgrade.
  2. Download this repository and run the executable for your operating system. For example, if you have a windows x64 OS, run oscRemoteControl.exe which is located inside executables/application.windows64/.
  3. If you see the following screen, you have successfully installed OscRemoteControl on your computer:

2. Run OscRemoteControl with Processing

  1. Download and install the processing programming environment for your operating system here.
  2. Install the oscP5 library for processing. This step is mandatory, since OscRemoteControl wont work without it.
  3. Open OscRemoteControl.pde with processing and run the scetch by pressing the play button in the top left corner.
  4. The installation was successful when you see the same screen as mentioned in 1.3.

Linking TouchOSC

Once the OscRemoteControl runs on your computer, you will need to download the TouchOSC app. You can download the app here:

To import the keyboard and mouse layout, you will additionaly need the TouchOSC Editor, which can be downloaded here (be sure to scroll down to the "downloads" section and choose the right operating system). Extract the downloaded .zip file and run the TouchOSC Editor. Inside the program go to Open and import the previously downloaded file TouchOSC-Layout\_RemoteControl.touchosc from this repository. You should now see the keyboard layout. To import this layout to your smartphone click on Sync and follow the instructions. You should now be able to switch between these 4 screens:

Once the layout is succesfully loaded, you will need to setup the ip-address and port inside your TouchOSC app. In the CONNECTIONS settings of the app, eneble OSC and insert the information shown by OscRemoteControl. Now you should be connected and able to control your keyboard and mouse via smartphone.

If you run into any issues feel free to open an Issue, I'm glad to help!