snakeware

Python-based Linux distro for x86-64 and RPi
git clone git://squid-tech.com/snakeware.git
Log | Files | Refs | README

commit 7975d82ae862e7a7d6767f15558f39de7795a5a4
parent fe1155fddc8e674835fac0bb9e5200cba177c667
Author: Josh Moore <jxm5210@g.rit.edu>
Date:   Fri, 12 Jun 2020 01:56:27 -0400

Merge pull request #116 from callmepavo/master

Add VirtualBox instructions to README
Diffstat:
MREADME.md | 26++++++++++++++++++++++----
1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md @@ -31,7 +31,7 @@ The rpi4 image can be flashed to an SD card and run on your Raspberry Pi 4, with To run snakeware on QEMU: -1. [Download and Install QEMU](https://www.qemu.org/download/). Supports Linux, OSX, and Windows. +1. [Download and install QEMU](https://www.qemu.org/download/). Supports Linux, macOS, and Windows. 2. Open your terminal/command prompt. 3. Navigate to the directory/folder where the snakeware image image was downloaded. 4. Launch the snakeware ISO using a script similar to this: @@ -53,7 +53,26 @@ exec qemu-system-x86_64 \ ``` 5. Wait for it to load. 6. You will be be taken to a Python environment/shell. -7. Launch snakewm with either of the following Python commands: + +### VirtualBox + +To run snakeware on VirtualBox: + +1. [Download and install VirtualBox](https://www.virtualbox.org/wiki/Downloads). Supports Linux, macOS, and Windows. +2. Open and create a new virtual machine with `Type: Linux` and `Version: Other Linux (64-bit)`. +3. Set virtual hard disk size and RAM (recommended 2GB) to your liking. +4. After snakeware VM is created, open vm settings, go to `Storage`. +5. Click small disk icon next to `Controller: IDE`, then `Add`. +6. Add `snakeware.iso` and click `Choose` +7. Go to `Display` and set `Graphics Controller: ` to `VBoxVGA` +8. Click `Okay` and then `Start` to run VM. +9. You will be loaded into a Python environment/shell. + +### Launching snakewm + +To load snakewm from Python shell: + +1. Launch snakewm with either of the following Python commands: ``` >>> snakewm ``` @@ -62,8 +81,7 @@ or >>> from snakewm.wm import SnakeWM >>> SnakeWM().run() ``` -8. To open the app menu press the left WinKey (Left CMD key ⌘ on macOS). - +2. To open the app menu press the left WinKey (Left CMD key ⌘ on macOS). ## Building The snakeware build system is based on buildroot. See the `snakeware/` directory in this repo for resources and