Go to file
Ry fab9f197b0 Update license 2022-10-26 18:20:55 -07:00
docs Add docs, add exception handling, rearrange some instrs 2022-10-26 18:03:00 -07:00
src Fix a few formatting things 2022-10-26 18:03:00 -07:00
.gitignore Generate fox32rom.h dynamically 2022-10-26 18:11:59 -07:00
LICENSE Update license 2022-10-26 18:20:55 -07:00
Makefile Generate fox32rom.h dynamically 2022-10-26 18:11:59 -07:00
README.md Update outdated build instructions and ignore src/fox32.rom 2022-08-30 16:20:44 -07:00

README.md

fox32

fox32 logo

fox32 (stylized in all lowercase) is a 32 bit fantasy computer architecture, with a custom operating system and user interface inspired by various classic computers.

Screenshot of fox32os

Getting Started

Note: This software is still very much in an early stage, and is currently more focused towards developers rather than end-users.

Stable releases are available on the Releases page.

Prebuilt binaries of the latest commit are also available on the GitHub Actions page.

Building

Download the latest release of fox32rom, and place the downloaded fox32.rom file into the src directory. Then simply run cargo build --release. The resulting binary will be saved as target/release/fox32. You can also run cargo run --release if you want to run it directly.

Usage

Passing files as arguments will mount those files as disks, in the order that the arguments were passed. The most common use case is passing the fox32os disk image as the first argument: fox32 fox32os.img

See encoding.md for information about the instruction set.

License

This project is licensed under the MIT license.