Skip to content

Commit

Permalink
added screenshots and text
Browse files Browse the repository at this point in the history
  • Loading branch information
pepsipu authored Jan 12, 2020
1 parent 66eba0c commit e333b21
Showing 1 changed file with 32 additions and 3 deletions.
35 changes: 32 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,33 @@
# xinOS
XIN Isn't NES: An operating system to mimic the days of the NES
# xinOS: XIN isn't NES!

This project is work in progress, and i'm uploading new code daily. Press "watch for releases" to see when I finish!
##### Main Menu


![Main Menu](https://i.imgur.com/mgvcyMW.png "Main Menu")

xinOS is a operating system to bring back the days of the NES. Utilizing 16 bit color graphics and the PC beep speaker for audion, it emulates the way NES games were played. You can load images, draw geometric shapes, and all sorts of complex features are available for xinOS. By default, there are 2 applications loaded on it (xinSnake and xinMusic), but you can write your own games in C and play them!

##### Snake
![Snake](https://i.imgur.com/tQgdJs6.png "Snake")

## How do I run it?
First off, download the xinOS image from the "releases" tab on GitHub. This is the actual image that the operating system is on

xinOS, being an operating system, can be burned onto a USB or Floppy drive and booted from (it works on ancient hardware, including the Commodore 64). Alternatively, if you'd like to emulate it, you can use the emulater "QEMU" (this is similar to VirtualBox or VMWare) or "Bochs". QEMU is the preferred emulator. To emulate it, run the following command:

```
qemu-system-i386 -fda <file path of the xinOS image here> -s -machine q35 -soundhw pcspk
```

If you've installed qemu but that qemu-system-i386 isn't found, you can run it with the generic QEMU command

```
qemu -fda ./build/xinos.img -s -machine q35 -soundhw pcspk
```

If you are running Bochs, a config is premade for you.

## I'd like to design some games for xinOS!
Awesome! xinOS provides a friendly interface for drawing pixels, squares, triangles, circles, and other geometric shapes (as well as text) onto the screen, as well as an interface for IO tasks, keyboards, and other tasks. You don't need to know a single thing about operating systems to write a game for xinOS. Though, you should know C.

As of now, there is no official documentation for making games. Right now, you should go look at the snake game as a reference, which is heavily commented. If you'd like to see fully fledged documentation, please star this project! I don't want to make documentation no one will use, so starring lets me know people want documentation to make games.

0 comments on commit e333b21

Please sign in to comment.