Linux Remote Control

Turn any device into a complete remote control for your GNU/Linux.

How to install lrc-client

Firefox OS

1 - Visit the app page on Firefox Marketplace for your device.

https://marketplace.firefox.com/app/linux-remote-control

2 - Click on Install button.

3 - Install lrc-server

Android

1 - Install Firefox 29 or higher on your Android.

https://play.google.com/store/apps/details?id=org.mozilla.firefox

2 - Visit the app page on Firefox Marketplace for your Android with Firefox.

https://marketplace.firefox.com/app/linux-remote-control

3 - Click on Install button.

4 - Install lrc-server

Other systems

1 - Download this repository and unzip

unzip linux-remote-control-master.zip

2 - Make a .deb package of the project

dpkg-deb -b linux-remote-control-master/ lrc.deb

3 - Install .deb package

sudo dpkg -i lrc.deb

4 - Move /opt/lrc-client directory to your device or to directory of your choice (if you prefer you can leave here)

sudo mv /opt/lrc-client your-directory/lrc-client

5 - Start lrc-server

node /opt/lrc-server/lrc.js

or

nodejs /opt/lrc-server/lrc.js

6 - Open the index.html of your-directory/lrc-client in a browser, add your server and have fun

How to install lrc-server

1 - Download the lrc.deb package onto you GNU/Linux system.

wget http://www.linuxremotecontrol.com/lrc-ffos.deb

2 - Install .deb package.

sudo dpkg -i lrc-ffos.deb

3 - Start lrc-server.

node /opt/lrc-server/lrc.js

or

nodejs /opt/lrc-server/lrc.js

If an error occurs during installation of the package, run the following command.

sudo apt-get install -f

Or open .deb package by graphic interface (double click on the lrc-ffos.deb file)

Configuration

Linux-remote-control will work out-of-the-box in most cases. However, if you wish to change the default settings (for instance, if you wish to use another music player than Rhythmbox), just modify the configuration file in /opt/lrc-server/node_modules/configuration.js

Start the server on computer boot

If you wish to have the Linux Remote Control server to be always available, just add a cron job on reboot :

$ crontab -e
# Add this cron job
@reboot node /opt/lrc-server/lrc.js

Firewall issues

The default ports for the server are 3000 for HTTP requests and 3001 for WebSockets. You might want to open those ports (at least when you are not on a public network) with tools such as firewall-config.

Dependences

The Linux Remote Control depends on some softwares to work correctly. Bellow is a list of this softwares.

Installed with lrc.

• Node.js (Express) (to execute commands on GNU/Linux)
• Xdotool (to execute most commands, like play, pause, mute, etc.)
• Xbacklight (to control backlight)

Usually already installed on GNU/Linux.

• Totem Movie Player (to control the video)

One of the following music players.

• Rhythmbox
• moc

Bugs

The project still has some bugs that you can fix.

• Click by tapping the touchpad;
• Organize and modularize my dirty Javascript =/;

License

GNU GENERAL PUBLIC LICENSE V2