README.md

;;;; ;;;;      ;;;; // PC Remote Control
;  ; ;         ;
;;;; ;    ;;;; ;
;    ;    ;    ;
;    ;;;; ;    ;;;; // by malisipi

Did you need a remote control device for your PC?

We have a lot situation that require a remote control device in daily/work life.

• To make a presentation
• To see the time
• To adjust the volume of computer
• To control playing media
• To shutdown or lock the computer
• ...

There're a lot of reason to need it.

Watch Demo

Abilities

• Customizable
• Support for a lot of controller
• Cross-platform (Linux & Windows)
• 4-Digit display
• Free and Open-Source

Wiring Diagram

Used libraries & Softwares

• Javascript (Web - Chromium-base only)
  • Web APIs
    • Web Serial API
    • TextDecoder
    • TextEncoder
• Python (Desktop)
  • Common (Windows & Linux)
    • PySerial library -> BSD License (BSD)
  • Linux
    • pactl¹ cli program -> GPL v2
    • playerctl¹ cli program -> LGPL v3
• Arduino (C++)
  • SevSeg library -> MIT License
  • IRremote library -> MIT License

¹: Why is the project license not GPL?

• There are no linking and distributing. The program uses only the output of the cli program. And the program can work without the cli program.

FAQ

My controller is not working

• It's okey. You need to change button definations in arduino_driver/arduino_driver.ino.

Sound control is not working

• Only pipewire supported at linux. If you're using pipewire already, install pactl. In future, keyboard simulation fallback will be added.

Media controls is not working

• You need to install playerctl. In future, keyboard simulation fallback will be added.

I want to add X command

• Just add some code to python_driver/user_defined_commands.py to support X command. Also you can use python_driver/pre_defined_commands.py.

Which board/OS is supported atm?

Board

• It was tested on Arduino UNO rev3. However, it should work all Arduinos. If you was tested it on different Arduino, please report the support status.

OS

• It was tested on Windows 11. It should work every Windows release since Windows 7.
• It was tested on Arch Linux/Wayland/Pipewire. It should work every Linux distro that have Pipewire, playerctl, pactl.

License

This project is licensed by Mozilla Public License 2.0.