yashtazor / Fire-OS

Fire OS is a minature Operating System made with COSMOS and C# in Visual Studio.

Fire OS

A miniature Operating System made with COSMOS and C# in Visual Studio.

Setting up the environment

Prerequisites

These have to be installed before installing COSMOS.

1. Visual Studio
2. Visual Studio Workload: .NET Core Tools
3. .NET Framework 4.6.2 Developer Pack
4. VMWare Player

Note

1. I haven't mentioned the versions here because it is advised to use the latest version of it at the time of you viewing this project.
2. COSMOS only works with VMWare Player. So, VirtualBox, etc won't work.

After installing all the pre-requisites, install COSMOS from here. Make sure VS is not running. https://github.com/CosmosOS/Cosmos/releases/tag/Userkit_20190628

Now, if COSMOS installed for you, great! Skip to the next part.
If not, don't worry. We were in a similar situation and here is a work-around for it.

1. Clone this repository
   https://github.com/CosmosOS/Cosmos
2. Run the install-VS2019.bat file from the repository
3. Simply import any demo project from the 'Demos' folder in VS.

Now, VS automatically detects the missing files and stuff and does the installing for you. Just go through the setup.

More help in installation can be found here
https://www.gocosmos.org/docs/install/

Features

Here is what our OS can do in a nutshell!

1. Security features like locking the system with a password.
2. Run programs like text editor, calculator, XnO game, music player & a basic GUI.
3. Implements a FAT file system (not ExFAT).
4. Implements simple system commands.

Commands List

The commands are divided in 3 parts as 'Program' commands, 'File System' commands & 'System' commands.

1. Program Commands
   programs
   Lists all the programs available.

2. File System Commands
   fstats
   Gives the summary of the file system like space free, all files & directories, etc.
   md
   Creates a directory at the current path.
   cd
   Changes the directory to the specified folder.
   curr
   Returns the current path.
   ls
   Lists all the files & folder in the current path.
   df
   Deletes a specified file provided it exists.
   dd
   Deletes a specified folder provided it exists.
   cp
   Copies a file to a specified directory provided both the file and new directory exists.
   mv
   Moves a file to a specified directory provided both the file and new directory exists.
   search
   Search for a file or folder in the current directory.

3. System Commands
   cls
   Clears the screen.
   echo
   Echos a string to the screen.
   version
   Returns the version of the current build.
   dnt
   Returns the current date & time.
   lock
   Locks the system.
   restart
   Restarts the OS.
   shutdown
   Shuts down the OS.
   about
   Returns information about the OS.

How to run?

The steps involved are

1. Clone this repository.
2. Open in VS.
3. Open the OSProject.sln file.
4. Click COSMOS button on the top in VS.

This would build and open the running OS in VMWare Player.

Credits

Some of the modules of this project weren't created by us. We've listed the features & their creators here.

1. Music Player by Original COSMOS Creators
   https://github.com/CosmosOS/Cosmos/tree/master/Demos/BeepDemo

2. Basic GUI Implementation by Original COSMOS Creators
   https://github.com/CosmosOS/Cosmos/tree/master/Demos/CosmosGraphicSubsystem

Created by Yash Dekate and Ayanabha Jana.