https://github.com/neilmunday/pespad

PESPad allows you to use any device that can run a web browser to be used as a control pad for a Linux based operating systems. All you need to do is install PESPad onto your Linux system.
https://github.com/neilmunday/pespad

Last synced: 9 days ago
JSON representation

PESPad allows you to use any device that can run a web browser to be used as a control pad for a Linux based operating systems. All you need to do is install PESPad onto your Linux system.

• Host: GitHub
• URL: https://github.com/neilmunday/pespad
• Owner: neilmunday
• License: gpl-3.0
• Created: 2014-10-09T20:44:25.000Z (about 10 years ago)
• Default Branch: main
• Last Pushed: 2021-04-01T12:11:37.000Z (over 3 years ago)
• Last Synced: 2024-10-11T19:46:46.451Z (about 1 month ago)
• Language: JavaScript
• Size: 578 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
pespad

======

PESPad allows you to use any device that can run a web browser to be used as a control pad for a Linux based operating systems. For example, you can use your mobile phone and tablet as separate controllers!!

![PESPAD GUI](http://www.mundayweb.com/html/_images/pespad.png)

Installation

------------

Install the python-pip package for your distribution first (if you don't have it already).

Then install the python-uinput module (if you don't have it already):

    sudo pip install python-uinput

Download PESPad:

    git clone git://github.com/neilmunday/pespad

Install PESPad (for operating systems using systemd):

    sudo mkdir /opt/pespad

    cd pespad

    sudo cp -r pespad.py web /opt/pespad

    sudo cp systemd/pespad.service /etc/systemd/system/pespad.service

Enabling PESPad Service

-----------------------

To start PESPad:

    sudo systemctl start pespad.service

To stop PESPad:

    sudo systemctl stop pespad.service

To start PESPad at boot time:

    sudo systemctl enable pespad.service

To disable PESPad at boot time:

    sudo systemctl disable pespad.service

Changing the port that PESPad listens on

----------------------------------------

By default, the PESPad service will lisent on port 80 of your Linux system. To change the port, please edit /etc/systemd/system/pespad.service and change the port number specified by the "-p" option to pespad.py in the ExecStart line.

Debugging

---------

To enable debug messages, please edit /etc/systemd/system/pespad.service and add "-v" to the Exec start line. Then restart the pespad service:

    sudo systemctl restart pespad.service

The log file can be found at: /var/log/pespad.log

Using PESPad

------------

Now that you have the PESPad service running, on your mobile/tablet point your web browser to http://YOUR_SERVER_IP and you should be presented with the PESPad GUI. Note: if you have instructed PESPad to use a port other than port 80, use the URL: http://YOUR_SERVER_IP:PORT

At the top left of the GUI, press the "Connect" button. All being well, you should now have a working joystick device!

To confirm, on your Linux system examine the contents of /dev/input and you should see a "js" device for each modbile/table that you have connected.

Enjoy!

Notes:

-----

After 30 minutes of inactivity a joystick will be automatically disconnected.

Acknowledgements:

-----------------

* HTTP server code based on code from: http://blog.wachowicz.eu/?p=256

* Daemon class based on code from: http://www.jejik.com/articles/2007/02/a_simple_unix_linux_daemon_in_python/

* Sencha for their SenchaTouch 1.1 JavaScript framework