ZiomekOS v26.9.26

2026-10-03 11:34:14 +02:00
commit a6ebba2e95
38 changed files with 355582 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,92 @@
+# ZiomekOS
+
+![ZiomekOS Logo](resources/ziomekos/ZiomekOS.png "ZiomekOS")
+
+ZiomekOS is a custom operating system built on top of Linux From Scratch 12.4
+(System V).
+
+There's not much purpose to this project, really. I hit a writer's block in
+another project and needed a distraction. I also wanted to relive the days of
+daily driving Slackware.
+
+## Status
+
+At the time of writing, the OS is basically base LFS system, plus some stuff
+from BLFS (mostly things needed for Xorg and ALSA) with some extra software
+and tooling on top.
+
+The kernel is 6.16.1 (as specced in LFS book). The config was taken from
+Debian 13, modded to match LFS requirements and drivers needed to boot without
+initramfs.
+
+The bootlader is GRUB and the OS is configured with hybrid GPT+MBR to allow
+running both on BIOS and UEFI systems.
+
+The OS boots into Xorg, using WDM. I've chosen Window Maker as the window
+manager. I have a soft spot for WMaker. It used to be my main desktop back in
+Linux days. Also, it introduced me to the world of NeXT and subsequently
+Mac OS X :).
+
+Extra software on top of LFS and BLFS stuff is: WDM, Window Maker, wmclock,
+Archey4 and Chocolate Doom.
+
+The OS was built in a Proxmox VM on my homelab's app server. It's been verified
+to boot and work on my Acer Swift 14 Go laptop (UEFI) andHP8000 retro PC
+(BIOS).
+
+## Content of this repo
+
+This repo contains extra code I came up with while building the OS. The
+`packages/` directory contains code and resources for some of packages.
+`resources/` contains non-code resources (e.g. pixmaps) used in the system.
+`meta/` hosts code to generate the system's metadata by interpolating
+templates. I got annoyed by having to edit multiple files when bumping version
+numbers ;).
+
+## Screenshots
+
+![Boot (VM)](screenshots/01-Boot_VM.png "4c 8GB RAM VM with virtio SCSI, GPU and net")
+
+Boot (VM)
+
+![WDM](screenshots/02-WDM.png "Look at that WINGs UI :)")
+
+WDM
+
+![Desktop (VM)](screenshots/03-Desktop_VM.png "Window Maker is my fave window manager for X")
+
+Desktop (VM)
+
+![Desktop (Acer Swift 14 Go)](screenshots/04-Desktop_Swift14.png "The display is HiDPI but I could not make X use resolution other than native")
+
+Desktop (Acer Swift 14 Go) with glxgears (amdgpu)
+
+![Desktop (HP 8000)](screenshots/05-Desktop_HP8000.png "This is my Windows XP gaming box and the reason the OS is hybrid GPT+MBR")
+
+Desktop (HP 8000) with glxgears (nouveau)
+
+![Doom](screenshots/06-Doom.png "Chocolate Doom with Ultimate Doom WAD")
+
+Of course it runs Doom :)
+
+## Download
+
+The purpose of this thing was to build a Linux From Scratch ;). Of course
+there's no images to download :D.
+
+## License
+
+Unless indicated otherwise, all the code in this repo is licensed under MIT
+license.
+
+Portions of the code in this repository contain work derived from Linux From
+Scratch and Beyond Linux From Scratch projects. See `NOTICE.txt` for info on
+the license.
+
+Non-code resources in `resources/` are considered proprietary.
+
+## AI use indication
+
+ZiomekOS logos (both graphical and ASCII art) were created using gen AI tools.
+
+Some of the code was co-authored by Claude. The relevant files are tagged.