standardgalactic / bbcmicrobot

Runs your tweet on an 8-bit computer emulator

BBCMicroBot

A twitter bot that runs mentions on a BBC Micro emulator and responds with a tweet of 3 second, 50fps video after 30 seconds of emulated execution time.

Using the bot

You can try the bot now live at https://twitter.com/bbcmicrobot

For help running code on the bot please see the User Guide.

Background

The @bbcmicrobot gained fans like comedian Dara Ó Briain, science writer Ben Goldacre, and Raspberry Pi founder Eben Upton. The concept is simple - make a retrocomputer accessible over social media. The bot runs any tweet written in BBC BASIC (1982) a programming language developed by Sophie Wilson who later went on to create the ARM architecture.

The Twitter community rose to the challenge with some seriously creative and clever code within 280 character limit. Read more background on BBC Micro Bot here.

It started a Twitter code bot revolution! There's a guide to building emulators in the cloud in the Commodore 64 notes as well as full bot projects inspired by it including Auto Tweetcart for the pico8 and Kay Savetz's AppleIIbot, PC BASIC Bot and Atari8BitBot.

Contributing

Running your own bot instance

For development and testing you can run your own instance of the bot on a Linux machine. I've been running it on:

• Arm-based AWS instances (Ubuntu)
• Raspberry Pi 4 (Raspbian and Raspberry Pi OS)
• Apple Mac OS X

Installation

• Install Node.js v12.x
• Install ffmpeg (e.g. sudo apt install ffmpeg)
• Download or clone this BBCMicroBot repository and cd into the directory
• npm install

Local testing

To run a set of test tweets defined in test.js and output the video or image capture to the ./tmp/ folder. For each test a checksum of the last frame of emulator video is compared against a known good value. To run the tests type:

npm test

You should see output like the following:

[14/06/2020 09:06:49 ] [LOG]    Cli0: Running BASE2048 from @<TEST SERVER>
[14/06/2020 09:06:49 ] [LOG]    Cli0: Base 2048 decode
[14/06/2020 09:06:49 ] [LOG]    Cli0: Loading OS from roms/os.rom
[14/06/2020 09:06:49 ] [LOG]    Cli0: Loading ROM from roms/BASIC.ROM
[14/06/2020 09:06:49 ] [LOG]    Cli0: Loading ROM from roms/b/DFS-0.9.rom
[14/06/2020 09:06:49 ] [LOG]    Cli0: Loading ROM from roms/gxr.rom
[14/06/2020 09:06:59 ] [LOG]    Cli0: JSbeeb DONE in 9.807s 
[14/06/2020 09:07:01 ] [LOG]    Cli0: JSbeeb captured 150 frames (1 unique)
[14/06/2020 09:07:01 ] [LOG]    Cli0: Ffmpeg DONE in 0.172s 
[14/06/2020 09:07:01 ] [LOG]    Cli0: checksum: 80f830477fc1632c3f8a65702825f33b3d6c069e
[14/06/2020 09:07:01 ] [LOG]    Cli0: BASE2048 TEST - OK

In the tmp folder you should also see the test output files.

Interactive testing

The try subcommand allows you to run a BASIC program from a file. If the bot would have posted a replied it instead runs xdg-open with the video or image output filename as an argument, which should open it in a suitable viewer:

node client try someprogram.bas

If you omit the filename, it defaults to reading from stdin which is handy for one-liners:

echo '0MO.4:REP.V.RND(2)*45+2:U.0'|node client try

Connecting to a Twitter account

To run the bot on a Twitter account you need to apply for a Twitter developer account, generate API keys for your bot application and put them into a .env file to be accessed by tweet.js.

You can then run the bot with

npm start

Please refer to the https://developer.twitter.com if you are unfamiliar with these processes.

Thanks

Thanks to Matt Godbolt for the JSBeeb emulator that made this project possible and to all the @bbcmicrobot users for their support - I hope this source code is interesting or useful.