Installation

You can get the latest release here, or use git to get the zip from GitHub.

spectacleOS is available for all UNIX-like operating systems that can support Python and rlwrap.

For the graphical start, I recommend downloading the Mukta font.

It is recommended to grab the latest release from the releases page (Rather than using git), because those will be the most up-to-date. Learn More

MacOS

Recommended for better user experience (And the program won't work without it): rlwrap

You might wanna get all this:

brew install rlwrap cmake make python3 git ruby

To install Python, run brew install python3. I know brew is really slow (if you haven't updated it in a while), but unless you know a better way to get Python, it's the only way.

You can use cURL to download the repo. Depending on your internet speed, it might download painfully slowly. Sorry 'bout that.

curl -Lo spectacleos.zip https://github.com/aarikpokras/spectacleos/archive/refs/heads/master.zip && chmod -R 755 spectacleos spectacleos/bin

Make sure you rename the spectacleos-master folder to 'spectacleos'.

Linux and Others

You probably have most of this already, but:

sudo apt-get install rlwrap cmake make build-essential python3 git ruby

curl -Lo spectacleos.zip https://github.com/aarikpokras/spectacleos/archive/refs/heads/master.zip && chmod -R 755 spectacleos spectacleos/bin && chmod -R 755 spectacleos spectacleos/bin

Make sure you rename the spectacleos-master folder to 'spectacleos'.

Running

Detailed instructions

Please make sure that you are in the spectacleos directory before running any executables.

If you just downloaded it, run chmod -R 755 spectacleos in the folder that contains spectacleOS.

cd into the spectacleos directory.

Run ./first-time and follow the instructions.

You can open menu.html for a graphical menu.

For information on the Migration Assistant, refer to the wiki.

To run, run ./specs start. Syntax

Made by a real person, for real people.