NoNameOS

Note: This screenshot is from v0.3.1. The latest version (v0.4.0) has more commands, games, and tools not shown here.

A pure C++ hobbyist operating-system simulation featuring an interactive shell, virtual filesystem with metadata, 4 built-in games, and developer tools — all contained in a single source file. No external dependencies. No framework. Just compile and run.

---

Note: NoNameOS is not a real operating system. It is a C++ simulation that mimics an OS environment with a shell, virtual filesystem, games, and built-in tools.

---

Table of Contents

• Features
• What's New in v0.4.0
• Quick Start
• Build Instructions
• Command Reference
  • Filesystem Commands
  • System Commands
  • Tools
• Games
• Custom Maps
• Platform Requirements
• Contributing
• License

---

Features

Category	What You Get
Interactive Shell	Command prompt with 25+ commands, command history, and context-aware help
Virtual Filesystem	Create, read, delete files and directories with sizes & creation timestamps
Games (4 built-in)	AsciiDash runner, Guess the Number, Trivia Quiz, and a Text Adventure RPG
System Tools	Text editor (nano), calculator (calc), system info (cfetch)
Utilities	grep search, find, cowsay, history, echo file writer, and more

---

What's New in v0.4.0

• 11+ new commands: pwd, whoami, date, history, grep, find, cfetch, touch, nano, calc, cowsay, and more
• 3 new games: guess (Guess the Number), trivia (Trivia Quiz), adventure (Text RPG)
• Enhanced ls -l with file sizes and creation timestamps
• Improved VFS tracking file metadata
• Command history — use history to view past commands
• Easy compilation: single-file build, no external dependencies beyond a C++ compiler and POSIX headers

---

Quick Start

git clone https://github.com/Mark44928/NoNameOS.git
cd NoNameOS
g++ -O3 NoNameOS.cpp -o nonameos
./nonameos

---

Build Instructions

NoNameOS is written in pure C++ and uses POSIX headers. It compiles on any Linux-based system with a C++ compiler.

Android (Termux)

pkg install clang
clang++ -O3 NoNameOS.cpp -o nonameos
./nonameos

Debian / Ubuntu

sudo apt update && sudo apt install g++
g++ -O3 NoNameOS.cpp -o nonameos
./nonameos

Fedora

sudo dnf install gcc-c++
g++ -O3 NoNameOS.cpp -o nonameos
./nonameos

Arch Linux

sudo pacman -S gcc
g++ -O3 NoNameOS.cpp -o nonameos
./nonameos

---

Command Reference

Filesystem

Command	Usage	Description
ls	ls	List files in current directory
ls -l	ls -l	Long listing with sizes and timestamps
cd	cd <dir>	Change directory (.. for parent, / for root)
mkdir	mkdir <name>	Create a new directory
touch	touch <file>	Create an empty file
cat	cat <file>	Display file contents
echo	echo <file> <content>	Write content to a file
rm	rm <name>	Remove a file or directory
pwd	pwd	Print current working directory
grep	grep <pattern> <file>	Search for a pattern in a file
find	find <name>	Find files by name

System

Command	Usage	Description
whoami	whoami	Show current user
date	date	Show current date and time
history	history	Show command history
cfetch	cfetch	Display system info (like neofetch)
clear	clear	Clear the screen
help	help	Show all available commands
exit	exit	Exit NoNameOS

Tools

Command	Usage	Description
nano	nano <file>	Built-in line-by-line text editor
calc	calc <expr>	Calculator (e.g. calc 2+3*4, supports + - * /)
cowsay	cowsay [msg]	ASCII cow with a speech bubble

---

Games

AsciiDash (play)

A side-scrolling obstacle runner. Jump over ^ obstacles with the SPACE key.

play                # Run default map "Stereo Madness"
play jumper.gmd     # Run a custom map from the VFS

Guess the Number (guess)

Guess a random number between 1 and 100. You get unlimited attempts.

guess

Trivia Quiz (trivia)

Answer 5 multiple-choice questions about computers and technology.

trivia

Text Adventure (adventure)

A dungeon RPG with HP and gold. Explore left or right, find treasure, fight monsters, and survive.

adventure

---

Custom Maps

Create your own AsciiDash maps using ^ for obstacles and _ for flat ground:

mkdir /geometry
echo /geometry/mymap.gmd ____^^____^^^^____^___^
play mymap.gmd

The default map jumper.gmd is pre-loaded in /geometry/.

---

Platform Requirements

• Linux (Termux on Android, Debian, Ubuntu, Fedora, Arch, etc.)
• A C++ compiler (g++ or clang++)
• POSIX-compatible system (uses <termios.h>, <unistd.h>, <fcntl.h>)
• Windows is not supported due to POSIX-only dependencies

---

Perfect For

• C++ learners exploring OS concepts without kernel-level complexity
• Students studying filesystems, shells, and process simulation
• Hackers wanting a terminal sandbox with games and tools
• Termux users looking for a fun single-file project to compile and run

---

Contributing

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m "Add my feature")
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

Ideas for contributions:

• Add more games (snake, minesweeper, etc.)
• Add more built-in tools (text-based paint, calendar, etc.)
• Improve the AsciiDash engine
• Add color themes
• Add a man command with detailed docs

---

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

You Might Also Like

• Termux TUI Package Store - Interactive fzf-powered package browser for Termux
• Anti-Bloatware List - Debloat rooted Android TV sticks

---

If you like NoNameOS, give it a star! It helps others discover the project.