BoluDOS

"The words "boludo" and "pelotudo" have their origin in the gaucho war, when the common soldiers were sent to fight against the raiders, the boludo was sent first, who handled a boleadora made of three or four balls the size of a tennis ball, and in second place went the pelotudo, with a boleadora made of two larger balls." - https://etimologias.dechile.net/?boludo

BoluDOS' name is a combination of the words "boludo" and "DOS", or "Disk Operating System", as it is a ComputerCraft operating system which can interact with the disk of the machine.

The repo is called "brainfuckOS" because this OS is based around the popular esolang "Brainfuck". The source code of the kernel/interpreter is written in Lua, with the OS being written in C, which is compiled to Brainfuck using c2bf.

Currently, the OS is not really an operating system, as it still runs on top of CraftOS, but in the future a bios will be made to run using UnBios so it can be a completely independent OS.

The current version of the OS is "BoluDOS -[----->+<]>--."

The OS file structure is:

.
└── /
    ├── bfroot/ # Root of the system
    │   └── bin/ # Commands that can be called anywhere (cd and ls are integrated into the shell directly)
    │       ├── append.bf
    │       ├── cp.bf
    │       ├── del.bf
    │       ├── mkdir.bf
    │       ├── mv.bf
    │       ├── read.bf
    │       ├── screenfetch.bf
    │       └── write.bf
    ├── bfk.lua # Brainfuck interpreter / kernel
    └── main.bf # Main shell

The Brainfuck side of the OS interacts with the CC side by using syscalls. Those are described on this wiki page: https://piguman3.github.io/boludos/syscalls.html

Installation:

Replicate the file structure, copying all the files to a CC compatible system, and run bfk main.bf to launch the main shell.

OR

Use the installer on pinestore: https://pinestore.cc/projects/120/boludos

Screenfetch demo

How do I compile programs for this?

Here's a couple of steps: (Using Linux/WSL)

1. git clone this repo
2. git clone the c2bf repo into your clone of this repo
3. Follow the instructions on the c2bf repo on how to build the binary

To compile the OS, simply run make.

To add your own programs, create a new C source file, go to the Make file and add your C source file's name to the list of sources to compile. c2bf syntax is weird, so I recommend looking at example code (specially for for loops and variable types) Here's some example code for a program that prints "Hello world":

#include "lib.h"
#include "syslib.h"

f(print, "Hello world\n"); // Uses a macro because strings can't be used as function arguments in c2bf

To run programs from the bin folder, you can type their name without their filetype. mv filea fileb

To run programs relative to the current folder the filetype needs to be included. bin/mv.bf filea fileb

For more examples you can check out the base programs the OS comes with.

---

This repository is licensed under the MIT License found in the LICENSE file in the root directory.