Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 50 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# BitBox - Run VM in your browser

BitBox is linux shell in your browser by the power of WASM and [v86](https://github.com/copy/v86). It is a simple
application that allows you to run a linux shell in your browser. It is useful for running simple commands and testing
out things.

The VM image is based on [buildroot](https://buildroot.org/) - a minimal linux image with busybox and a few other
utilities. You can find my configuration for buildroot in
the [bitbox-buildroot](https://github.com/daipham3213/bitbox-buildroot)
repository.

## Libraries and tools used

- [v86](https://github.com/copy/v86)
- [xterm.js](https://github.com/xtermjs/xterm.js)
- [tailwindcss](https://tailwindcss.com/)
- [bun](https://bun.sh)
- [vite](https://vitejs.dev/)

# Requirements

- [bun](https://bun.sh)

# How to run

1. Clone this repository
```bash
git clone
```
2. Install dependencies
```bash
bun install
```
3. Run the server
```bash
bun run dev
```
4. After that, a new tab will be opened in your browser with the application running.
5. Enjoy!

# Limitations

- It's a bit slow. It is fine for running simple programs but as soon as you try to run anything that requires cpu it
will slow down immensely because the cpu is emulated by v86.
- No reliable package manager.

# Internet

- This VM uses copy's proxy for internet which is rate limited and does not support https
- Try not to use it. Instead, consider either manually uploading files or using your own proxy.