Add global remote controls and a real time livestream to your projects
- Share a link and let others take the controls one by one
- Forward the livestream to Twitch or YouTube (optional)
- No hardware required, a phone can be used as a camera
- Arduino and Raspberry Pi tutorials available
- Desktop and mobile browser support, no apps, no signups
It works by decorating existing functions and class methods to respond to user input:
import botafar j = botafar.Joystick("W","A","S","D") @j.on_left def turn_left(): print("left!") @j.on_right def turn_right(): print("right!") # ...@j.on_up, on_down, on_center botafar.run()
Check botafar.com for currently online bots!
Let's suppose you have a Python project, main.py, where you have defined two functions
def greet(): print("hello") def target(): print("world") greet() target()
When you run main.py it calls those functions, and prints "hello" and "world" to the terminal:
$ python main.py hello world
You want be able to share a link through which people can remotely call these functions on your hardware, and see the results in real life through a low-latency livestream (and optionally, on Twitch or YouTube as well).
botafar enables you to do all these things.
Add remote controls and livestreaming
- Install the library (help)
pip install --upgrade botafar
On some Debian based operating systems such as Raspberry Pi OS, on you need to have libSRTP and other related network dependencies installed to be installed as well:
sudo apt install libnss3 libnspr4 libsrtp2-1 -y
- Modify main.py:
- Import botafar
- Create a control,
Joystickin this example, and bind 4 keys from keyboard to it
- Use decorators (@-symbol) to select functions to call on user input
import botafar j = botafar.Joystick("W","A","S","D") @j.on_left def greet(): print("hello") @j.on_right def target(): print("world") botafar.run()
- Execute the main.py file, and open the returned link in browser. Note that this browser can be on other device, for example the Python program can run on a Raspberry Pi and the browser setup is done on a desktop PC's browser (help).
$ python main.py Bot running, connect at https://botafar.com/abcde-fghij-klmno
- From the browser, press the Try controls -button. Now when you press A and D keys from a keyboard or a touch screen, texts "hello" and "world" get printed on terminal.
$ python main.py Bot running, connect at https://botafar.com/abcde-fghij-klmno hello world hello world
Choose a stream source from the browser. It can be a webcam, a phone or a screen share (help).
Give your bot a name and switch it to public
The browser now shows a direct link to your bot you can share with anyone in the world! Others can press keyboard or touch screen to print "hello" and "world" to the terminal, and see the prints through a low-latency livestream.
If you got stuck, have an idea or you found a bug, write about it on the GitHub discussions forum. This tool is still under development, and all feedback is appreciated.
Keep reading if you want to learn how to:
- Use more botafar features such as printing text to livestream directly
- Remote control servos and LEDs with Arduino or Raspberry Pi
- Forward the livestream to Twitch or Youtube through OBS
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.