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
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