An attempt to port SmileBASIC to the desktop.
Find a file
2026-07-18 00:27:17 -04:00
README.md Update README.md 2026-07-18 00:27:17 -04:00

SmileBASIC-Desktop

An attempt to port SmileBASIC to the desktop.

This requires Docker to be install (e.g. sudo apt install docker.io).

Download the launcher and the sbqemu.tar from the Releases tab.

Install the launcher.

Install the sbqemu.tar image into Docker with docker load -i sbqemu.tar.

Run it with smilebasic-launcher.

Use the -p flag to launch the PasocomMini version.

Quick tap the tab key to free or lock the mouse to the window (locking the mouse to the window is needed for mouse controls). Long hold the tab key to toggle full screen mode (stretched). I chose the tab key because it seems not to be used in SmileBASIC-R. It does nothing, not even insert tab characters, whereas keys like Ctrl and Alt are used for the gamepad.

Use the -f flag to remove vsync, and use the -r flag to force it to render at a native resolution it wasn't intended for, such as -r 640x480 or -r 1920x1080.

Use smilebasic-sync [folder name] to sync programs in a particular folder with the workspace programs inside of the container, so that they will show up in SmileBASIC. You can also smilebasic-sync [tar file] if a program is distributed as a TAR.

Game Pads

It is possible to use game pads, as SmileBASIC just maps them internally to certain keys. For example, WASD is mapped to a left d-pad or control stick, and the arrow keys are mapped toaright d-pad or control stick, and thus if you map your controller to press those keys, then it will work properly within SmileBASIC.

Press F2 to open the main menu and then click BASIC (the first menu option), then OTHERS, then GAMEPAD, and this acts as a gamepad tester. Press keyboard keys to see which keys map to which gamepad buttons.

Currently, TABLET and TOUCH are not implemented.