Yaran_OS

KO | EN

gitlite — search

#json #machine-learning #c #anthropic #markdown #terminal #android #electron #claude-code #developer-tools

(★ 9)

Yaran OS – A lightweight 32-bit operating system kernel built from scratch in C & Assembly.

파일 탐색기

ZIP 다운로드

- - grub.cfg
- 2048.c
- breakout.c
- invaders.c
- minesweeper.c
- pacman.c
- snake.c
- tetris.c
- - main.c
- - idt.c
  - idt.h
  - isr.c
  - isr.h
  - isr_stubs.asm
  - keyboard.c
  - keyboard.h
  - pic.c
  - pic.h
  - pit.c
  - pit.h
  - port.h
  - power.c
  - power.h
  - vga.c
  - vga.h
- - shell.c
  - shell.h
- - vfs.c
  - vfs.h
- link.ld
- start.asm
- lib.c
- lib.h
- - 1.jpeg
  - 2.jpeg
  - 3.jpeg
  - 4.jpeg
  - 5.jpeg
  - 6.jpeg
  - 7.jpeg
- v1.0.jpeg
- v2.0.jpeg
- v3.1.jpeg
.gitignore
LICENSE
Makefile
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Yaran OS** یک سیستم‌عامل ۳۲ بیتی ماژولار و کاملاً تفریحی است که با زبان C و Assembly نوشته شده.  
ایدهٔ اصلی آن **سرگرمی و آموزش** توسعهٔ سیستم‌عامل‌های ساده است – درست مثل روزهای خوب گذشته!

همه چیز در **حالت متنی** (VGA Text Mode) اجرا می‌شود: یک پوستهٔ تعاملی با امکانات واقعی، یک فایل سیستم مجازی داخل RAM، و کلی بازی کلاسیک که می‌توانید مستقیماً از خط فرمان اجرا کنید.

---

## ✨ ویژگی‌های اصلی

- **کرنل ۳۲ بیتی محافظت‌شده (Protected Mode)**
- **پوستهٔ تعاملی (Shell)** با قابلیت تاریخچه (↑/↓) و ویرایش کامل خط
- **فایل سیستم مجازی (VFS)** در حافظه  
  (`list`, `sakhtan`, `neveshtan`, `khondan`, `pakf`, `virayesh`)
- **درایورهای سخت‌افزاری پایه** : VGA، کیبورد PS/2، تایمر PIT
- **مجموعه‌ای از بازی‌های جذاب CLI** :
  - 🐍 **Snake** – مار گرسنهٔ خاطره‌انگیز
  - 🧩 **2048** – پازل اعتیادآور اعداد
  - 🧱 **Tetris** – بلوک‌های چرخان همیشگی
  - 👻 **Pac-Man** – شکار روح‌ها در هزارتو
  - 👾 **Space Invaders** – نبرد با مهاجمان فضایی
  - 💣 **Minesweeper** – مین‌روب دقیق و دوست‌داشتنی
- **معماری کاملاً ماژولار** – هر بخش (VGA, Shell, VFS, Games) در پوشهٔ جداگانه قرار دارد.
- **ساخت و اجرای بسیار آسان** – فقط با یک `make` کل پروژه ساخته و آمادهٔ تست می‌شود.

---

## ⚙️ پیش‌نیازها (Parch / Arch Linux)

```bash
sudo pacman -S base-devel nasm grub xorriso mtools qemu-desktop
```

| بسته | کاربرد |
|------|--------|
| `base-devel` | کامپایلر C، binutils و make |
| `nasm` | اسمبلر (start.asm و isr_stubs.asm) |
| `grub` | بوت‌لودر + grub-mkrescue |
| `xorriso` | ساخت ISO |
| `mtools` | ابزارهای FAT برای GRUB |
| `qemu-desktop` | شبیه‌ساز برای تست |

---

## 🚀 ساخت و اجرا

```bash
git clone https://git.nulltux.ir/ahb1390/yaran-os.git
cd yaran-os
make clean && make
make run
```

پس از چند لحظه پنجرهٔ QEMU باز می‌شود و Yaran OS با لوگوی خود بوت می‌گردد.  
در خط فرمان `YaranOS>` می‌توانید این دستورات را اجرا کنید:

| دستور | عملکرد |
|------|--------|
| `komak` | نمایش راهنمای دستورات |
| `list` | نمایش فایل‌های موجود |
| `sakhtan <name>` | ساخت یک فایل جدید |
| `neveshtan <name> <matn>` | نوشتن متن در فایل |
| `khondan <name>` | خواندن محتوای فایل |
| `pakf <name>` | حذف فایل |
| `virayesh <name>` | ویرایش فایل |
| `snake` | بازی Snake |
| `2048` | بازی 2048 |
| `tetris` | بازی Tetris |
| `pacman` | بازی Pac-Man |
| `invaders` | بازی Space Invaders |
| `minesweeper` | بازی Minesweeper |
| `pak` | پاک کردن صفحه |
| `khorooj` | خاموش کردن سیستم |
| `naskheh` | نمایش نسخه |
| `tarikh` | نمایش تاریخ (Placeholder) |

---

## 📁 ساختار پروژه

```
yaran-os/
├── boot/grub/grub.cfg          # تنظیمات GRUB
├── kernel/
│   ├── start.asm               # راه‌انداز ۳۲ بیتی و پشته
│   ├── link.ld                 # اسکریپت لینکر
│   ├── core/main.c             # تابع main()
│   ├── drivers/                # درایورهای VGA, keyboard, ...
│   ├── vfs/                    # فایل سیستم مجازی
│   └── shell/                  # پوستهٔ تعاملی
├── lib/                        # توابع کتابخانه‌ای (رشته، اعداد، ...)
├── games/                      # بازی‌ها
│   ├── snake.c
│   ├── 2048.c
│   ├── tetris.c
│   ├── pacman.c
│   ├── invaders.c
│   └── minesweeper.c
└── Makefile                    # سیستم ساخت
```

---

## 📜 مجوز

این پروژه تحت مجوز **GNU General Public License v3.0** منتشر شده است.  
متن کامل مجوز در فایل [LICENSE](LICENSE) موجود است.

---

---
## 📎 چنل بله :
### 🔗 **[https://ble.ir/yaran_os](https://ble.ir/yaran_os)**

---

## هدف پروژه 
- هدف پروژه یادگیری gcc‌ ٫ مارک دان  و عمیق تر شدن در git ٫ کانفیگ grub بوده است 
- و در راستای این هدف تمامی کد های c و اسمبلی با DeepSeek V3 نوشته شده است 
---

Yaran_OS

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README