/FoxOS

The FoxOS main repository

Primary LanguageMakefileMIT LicenseMIT

FoxOS

Hits License: MIT Discord Automatic Release

Our goal is to develop an operation system that focuses on the terminal, performance and reliability. We hope to provide you with a functional, performant and stable OS. And we do that together, everyone can help!

screenshot

Building

Before you build the project, you need to clone the submodules. To do so, run git submodule update --init --recursive.

To build this OS, you need one of these:

  • A 64 bit Ubuntu or Debian based OS so you can install the following packages with apt: sudo apt install graphicsmagick-imagemagick-compat mtools lbzip2 curl bison flex gcc g++ unzip dosfstools automake build-essential nasm qemu-utils gdisk git. We recommend you run toolchain.sh to build binaries that will be compatible with FoxOS.
  • WSL (Windows Subsystem for Linux) with Ubuntu installed and the same things as above.
  • Our Docker image. You can run it like this: docker run -it --rm -v /dev:/dev --privileged ghcr.io/theultimatefoxos/foxos-toolchain:latest. An easy way to have this setup would be to open a command line or terminal window at a directory on your host machine with FoxOS cloned and run this: docker run -it --rm -v /dev:/dev --privileged -v $PWD:/root/FoxOS ghcr.io/theultimatefoxos/foxos-toolchain:latest to mount it at /root/FoxOS.
  • An Intel Mac. You need to make sure to have these commands: curl, zip/unzip, make, brew, and gcc. First run: brew install mtools, brew install gdisk, and then run toolchain_mac.sh.

Then simply run one of the following:

  • make: build the project.
  • make img: package the .img file.
  • make mac-img: package the .img file on an Intel Mac.
  • make docker-img: package the .img file in Docker.
  • make run: To build and run FoxOS. (Will not work on Mac)

The following alias command can be used to make your life easier: alias mkfox="make USER_CFLAGS=\"-DDEBUG -DMEMORY_TRACKING -DBOOTINFO -fsanitize=undefined -DUBSAN_SUPRES_TYPE_MISSMATCH\""

Other make commands

  • make usb: build a bootable USB. The USB must be formatted with FAT32!
  • make losetup: build a script to be able to run losetup without root permissions.
  • make clean: clear all the built files.
  • make debug: build and debug using deno.
  • make run-dbg: start a screen for QEMU so you can debug using gdb.
  • make vmdk: build a .vmdk file.
  • make vdi: build a .vdi file.
  • make qcow2: build a .qcow2 file.
  • make vbox-setup setup a VirtualBox VM (only works on Linux)

Contributing

Feel free to fix a bug, implement a feature or any other change you think would be good. If you want to contact us, join our Discord, we are there to help with any question you may have. Or you can create an issue. If you don't know what to implement you can take a look at our TODO list.

Running

To run this OS, you can either use a VM or a bootable USB. See the building section for more info on how to build them. How to start:

  • QEMU: Use make run to build and launch QEMU with the correct configuration.
  • VirtualBox: Use make qcow2 to build a .qcow2 image file and create a VM to which you add this .qcow2. Then you need to enable EFI under "System" in your VM's config. Then run it!

If you want to add documentation on running this OS on a different emulator, feel free to do so.

Our Discord

Here is the link to our Discord.