Go to file
2022-09-16 00:27:23 -07:00
.github/workflows Move fox32.rom into the src folder 2022-08-18 23:18:27 -07:00
docs Rework the paging system a little bit, add FLP instr., bump ver to 0.5.0 2022-09-13 17:34:37 -07:00
src Hack memory writes to use longjmp if a page fault occurs 2022-09-16 00:27:23 -07:00
.gitignore Update outdated build instructions and ignore src/fox32.rom 2022-08-30 16:20:44 -07:00
build.rs Don't fail to build if building outside of a git repo 2022-08-18 23:16:26 -07:00
Cargo.lock Rework the paging system a little bit, add FLP instr., bump ver to 0.5.0 2022-09-13 17:34:37 -07:00
Cargo.toml Rework the paging system a little bit, add FLP instr., bump ver to 0.5.0 2022-09-13 17:34:37 -07:00
LICENSE Add LICENSE 2022-01-31 01:51:26 -08:00
README.md Update outdated build instructions and ignore src/fox32.rom 2022-08-30 16:20:44 -07:00

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.