From 78f57404ce9fd2126e5632b6739377ea3b5266ad Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 15:04:53 +0700
Subject: [PATCH 01/37] docs: add initial document
---
README.md | 442 +++---------------------------------------------------
1 file changed, 17 insertions(+), 425 deletions(-)
diff --git a/README.md b/README.md
index f0ce4d6..1a8585f 100644
--- a/README.md
+++ b/README.md
@@ -1,430 +1,22 @@
-
- 
-
+# DMCaramOS - better CaramOS
+### What's this fork added:
+This fork added, and will add:
-CaramOS
+- More built-in packages
+- Bug fixes, performance updates.
+- Dependency updates
+- Upstream feature, OTA
+- More!!
+### Why choose this fork?
+- You want something that the upstream is doesn't have.
+- More QoL (or not)
-
- Sweet & Simple Linux — Hệ điều hành Linux ngọt ngào cho người Việt
-
-
-
- Caram = Carambola = Trái khế — 5 cánh như ngôi sao trên quốc kỳ, gắn liền với tuổi thơ người Việt
-
-
-
- English · VNLF · Website
-
-
-
- Phát triển bởi: VNLF · MRD · Kỳ Nguyễn
-
-
----
-
-## CaramOS là gì?
-
-**CaramOS** là bản phân phối Linux dựa trên **Linux Mint 22.3 Cinnamon**
-(Ubuntu 24.04 LTS), được thiết kế đặc biệt cho **người dùng Việt Nam**.
-Dự án vẫn build theo hướng **ISO remaster**, nhưng từ giai đoạn `1.0.11`
-trở đi mọi thay đổi sau phát hành được chuẩn hoá qua **CaramOS OTA**.
-
-> [!IMPORTANT]
-> **Phiên bản hiện tại:** `1.0.12` — **Open Beta**.
-> CaramOS đã chuyển sang mô hình cập nhật bằng OTA. Nếu bạn đang dùng
-> CaramOS `1.0.1`, hãy cài Trung tâm cập nhật bằng lệnh:
->
-> ```bash
-> curl -fsSL https://caramos.vietnamlinuxfamily.net/install-caramos-ota.sh | sudo bash
-> ```
->
-> Sau khi cài xong, mở **Trung tâm cập nhật CaramOS** từ Start Menu để nâng
-> hệ thống lên bản mới nhất.
-
-> [!NOTE]
-> Dành cho developer/contributor: từ bây giờ không code trực tiếp các thay đổi
-> hệ thống vào `config/hooks/live/` nếu thay đổi đó cần đến được máy user đã cài.
-> Hãy viết migration trong `packages/caramos-ota`. Xem hướng dẫn phát triển OTA:
-> [packages/caramos-ota/README.md](packages/caramos-ota/README.md).
-
-Mục tiêu của CaramOS là phổ thông hoá Linux — giúp người dùng Việt chuyển từ
-Windows sang Linux dễ hơn, có sẵn giao diện thân thiện, bộ gõ tiếng Việt,
-trình duyệt, ứng dụng văn phòng và các tiện ích quen thuộc.
-
-## Tính năng nổi bật
-
-| Tính năng | Mô tả |
-|---|---|
-| **Dựa trên Linux Mint 22.3** | Nền Ubuntu 24.04 LTS ổn định, desktop Cinnamon quen thuộc |
-| **Giao diện CaramOS** | Branding CaramOS, boot menu/Plymouth, logo, wallpaper, panel và theme được tuỳ biến |
-| **Tiếng Việt mặc định** | Locale Việt Nam, timezone Asia/Ho_Chi_Minh, font Be Vietnam Pro |
-| **Bộ gõ tiếng Việt** | Fcitx5 + Lotus được cài và cấu hình sẵn |
-| **Google Chrome** | Trình duyệt phổ biến được cài sẵn |
-| **WPS Office** | Bộ ứng dụng văn phòng thân thiện với người dùng chuyển từ Windows |
-| **Zalo** | Zalo AppImage được cài sẵn và có shortcut ngoài Desktop |
-| **Cinnamon Delight + Tela/Bibata** | Theme, icon và cursor hiện đại, nhẹ, dễ nhìn |
-| **Neofetch/Fastfetch CaramOS** | Logo ASCII màu và OS identity đồng bộ theo version CaramOS |
-| **Build linh hoạt** | Dev build nhanh bằng `lz4`, release build nhỏ hơn bằng `xz`, hỗ trợ Docker |
-
-
- 
-
-
-## Trải nghiệm CaramOS
-
-Từ boot menu đến desktop, CaramOS được tuỳ biến đồng bộ để mang lại cảm giác
-thân thiện, hiện đại và sẵn sàng cho người dùng Việt Nam.
-
-| Bước | Hình ảnh |
-|---|---|
-| **1. GRUB boot menu**
Chọn live session hoặc cài đặt CaramOS. | 
|
-| **2. Startup loading**
Màn hình khởi động/Plymouth branding. | 
|
-| **3. Desktop**
Giao diện Cinnamon đã tuỳ biến theme, icon, panel và wallpaper. | 
|
-| **4. Neofetch**
Thông tin hệ thống và nhận diện CaramOS trong terminal. | 
|
-
-## Công nghệ sử dụng
-
-| Thành phần | Công nghệ / vai trò hiện tại |
-|---|---|
-| **Base ISO** | Linux Mint 22.3 Cinnamon 64-bit |
-| **Ubuntu base** | Ubuntu 24.04 LTS / noble |
-| **Desktop** | Cinnamon + LightDM theo Linux Mint base |
-| **Build method** | ISO remaster: extract → customize → OTA bootstrap → repack |
-| **Build scripts** | Bash + Makefile, tách module trong `scripts/` |
-| **OTA model** | `caramos-ota` version migration-driven OTA |
-| **Migration runner** | `caramos-ota-update` chạy timestamp migrations chưa apply theo ledger |
-| **Update Center** | `caramos-ota-notifier` + `pkexec caramos-ota --upgrade --yes` |
-| **Developer workflow** | Thay đổi hệ thống sau release phải vào `packages/caramos-ota` migration |
-| **Legacy hooks** | `config/hooks/live/` chỉ dùng cho bootstrap/build-time nền tảng, không là nơi phát triển feature OTA mới |
-| **Overlay** | `config/includes.chroot/` chứa file nền cần có trong ISO/rootfs |
-| **Compression dev** | SquashFS `lz4` |
-| **Compression release** | SquashFS `xz` |
-| **Theme / Icon / Cursor** | Cinnamon Delight, Tela Circle/Cinnamon Delight Icons, Bibata |
-| **Font / Input** | Be Vietnam Pro, Fcitx5 + Lotus |
-| **Apps phổ biến** | Google Chrome, WPS Office, Zalo AppImage |
-
-## Cấu trúc dự án
-
-```text
-./
-├── build.sh # Script build chính
-├── Makefile # Target build/dev/release/debug
-├── scripts/ # Module build ISO
-│ ├── config.sh # Version ISO, base migration version, mirror, output
-│ ├── utils.sh # Log, deps, download ISO, mount helpers
-│ ├── extract.sh # Mount ISO + rsync + unsquashfs
-│ ├── customize.sh # Chroot + packages + overlay + hooks + OTA bootstrap
-│ ├── ota_bootstrap.sh # Build caramos-ota .deb và chạy migration vào ISO rootfs
-│ ├── repack.sh # mksquashfs + xorriso
-│ ├── boot_config.sh # Boot menu + Plymouth branding
-│ ├── overlay.sh # Copy config/includes.chroot vào rootfs
-│ ├── chroot_shell.sh # Debug chroot
-│ └── debug_iso.sh # Kiểm tra ISO/boot branding
-├── config/ # Lớp bootstrap ISO/rootfs
-│ ├── packages.txt # Packages nền cài thêm khi build ISO
-│ ├── hooks/live/ # Hook build-time legacy, hạn chế thêm logic mới
-│ └── includes.chroot/ # Overlay copy trực tiếp vào rootfs trước OTA bootstrap
-├── packages/ # Debian packages do CaramOS duy trì
-│ └── caramos-ota/ # Trung tâm cập nhật + migration runner + migration data
-│ ├── debian/changelog # Version package OTA publish qua PPA
-│ ├── usr/bin/ # caramos-ota, notifier, update runner
-│ └── usr/lib/python3/dist-packages/
-│ └── caramos_ota_update/migrations/
-│ ├── migration.json # Index version migration
-│ └── vX_Y_Z/ # Migration cho từng release
-├── landing/ # Landing page caramos.vietnamlinuxfamily.net
-├── docs/ # Tài liệu vận hành/release tracking
-├── assets/ # Logo/banner/source assets
-├── Dockerfile # Docker builder
-└── docker-compose.yml # Docker build entrypoint
-```
-
-> [!IMPORTANT]
-> `config/hooks/live/` không còn là nơi chính để phát triển cập nhật hệ thống.
-> Nếu thay đổi cần áp dụng cho máy người dùng đã cài CaramOS, hãy viết migration
-> trong `packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/`.
-
-## Version & release model
-
-CaramOS dùng mô hình version giống Linux kernel: **version nằm trong source tree**,
-không lấy tag làm nguồn duy nhất.
-
-Version được khai báo trong [scripts/config.sh](scripts/config.sh):
-
-```bash
-CARAMOS_VERSION_MAJOR=1
-CARAMOS_VERSION_MINOR=0
-CARAMOS_VERSION_PATCH=1
-CARAMOS_VERSION_EXTRA=""
-CARAMOS_CODENAME="Open Beta"
-CARAMOS_VERSION="${CARAMOS_VERSION_MAJOR}.${CARAMOS_VERSION_MINOR}.${CARAMOS_VERSION_PATCH}${CARAMOS_VERSION_EXTRA}"
-```
-
-Version này được dùng cho:
-
-- tên ISO: `CaramOS--cinnamon-amd64.iso`
-- boot menu/boot branding
-- `/etc/os-release`
-- `/etc/lsb-release`
-- `/etc/linuxmint/info`
-- `neofetch` / `fastfetch`
-- GitHub Release artifact
-
-Khi release production, Git tag phải khớp version trong source.
-Ví dụ source version là `1.0.1` thì tag hợp lệ là:
-
-```bash
-v1.0.1
-```
-
-Nếu tag không khớp, GitHub Actions sẽ fail trước khi build release.
-
-## Cập nhật OTA
-
-CaramOS đã chuyển sang mô hình **OTA-first**. ISO mới vẫn được phát hành, nhưng
-máy đã cài từ bản cũ không cần cài lại: user chỉ cần cài `caramos-ota`, sau đó
-Update Center/OTA sẽ nâng hệ thống lên version mới nhất bằng chuỗi migration đã
-review.
-
-User đang ở CaramOS `1.0.1` chạy:
-
-```bash
-curl -fsSL https://caramos.vietnamlinuxfamily.net/install-caramos-ota.sh | sudo bash
-```
-
-Flow cập nhật:
-
-```text
-systemd timer
- └── caramos-ota --check
- ├── cập nhật package caramos-ota nếu repo có bản mới
- ├── resolve migration chain
- └── ghi /var/lib/caramos-ota/state.json
-
-Update Center
- └── user xác nhận
- └── pkexec caramos-ota --upgrade --yes
- └── caramos-ota-update chạy từng migration
-```
-
-Nguyên tắc chính:
-
-- Timer chỉ check/chuẩn bị state, không tự mở GUI và không tự apply migration.
-- Migration chỉ chạy khi user xác nhận trong desktop session hoặc admin chạy CLI.
-- Logic thay đổi hệ thống nằm trong `packages/caramos-ota`, không nhét vào hook.
-- Developer muốn thêm update sau release phải viết OTA migration có version rõ ràng.
-- ISO build cũng dùng chính OTA migration chain để đưa rootfs lên version mới nhất.
-
-Xem chi tiết hướng dẫn phát triển OTA: [packages/caramos-ota/README.md](packages/caramos-ota/README.md).
-
-## Build ISO local
-
-Khi build ISO, CaramOS không chỉ copy overlay/hook rồi đóng gói lại. Build flow
-sẽ tự build package `caramos-ota`, cài package này vào rootfs và chạy toàn bộ
-OTA migration chain từ `CARAMOS_MIGRATION_BASE_VERSION` tới version mới nhất
-trước khi repack ISO.
-
-Nói ngắn gọn: **ISO build ra đã là bản mới nhất**, còn OTA là đường nâng cấp cho
-máy user đã cài từ ISO cũ.
-
-Cài dependency build trên Ubuntu/Mint/Debian:
-
-```bash
-sudo apt update
-sudo apt install squashfs-tools xorriso rsync wget curl isolinux syslinux-common syslinux-utils
-```
-
-Build dev đầy đủ, nén `lz4` để test nhanh:
-
-```bash
-make build
-```
-
-Build release local, nén `xz` để ISO nhỏ hơn:
-
-```bash
-make release VERSION=x.y.z
-```
-
-Build từ ISO Mint có sẵn:
+If you want **unmodified, original version**, you're going wrong place. **This fork is not for you**.
+Original project: https://github.com/VietNam-Linux-Family/CaramOS
+### How to update this OS by OTA?
+If you installed OS `.iso` file. Run this command:
```bash
-make build ISO=linuxmint-22.3-cinnamon-64bit.iso
+curl -fsSL https://raw.githubusercontent/dryfish09/DMCaramOS/main/install-caramos-ota.sh | sudo bash
```
-
-Trong quá trình `customize`, script sẽ chạy:
-
-```text
-extract base ISO
- → install packages + overlay + build-time hooks
- → build/install bundled caramos-ota
- → caramos-ota-update --from "$CARAMOS_MIGRATION_BASE_VERSION" --target latest
- → repack squashfs + ISO
-```
-
-## Make targets
-
-| Lệnh | Mục đích |
-|---|---|
-| `make build` | Build dev đầy đủ, nén `lz4` |
-| `make release VERSION=x.y.z` | Build release, nén `xz` |
-| `make prepare` | Bung ISO/rootfs ra `build/` để sửa nhanh |
-| `make customize-only` | Chạy packages, overlay và hooks trong rootfs |
-| `make overlay` | Chỉ copy `config/includes.chroot` vào rootfs |
-| `make quick` | Prepare nếu cần, overlay, repack squashfs và ISO |
-| `make repack` | Đóng gói lại squashfs và ISO từ work tree hiện có |
-| `make iso-only` | Chỉ tạo lại ISO từ `build/custom` |
-| `make boot-only` | Chỉ áp dụng boot menu, GRUB và Plymouth branding |
-| `make shell` | Vào chroot `build/squashfs` để debug thủ công |
-| `make debug-iso` | Kiểm tra boot menu/Plymouth/branding của ISO |
-| `make clean` | Xoá build/cache/output ISO |
-| `make clean-work` | Xoá work tree, giữ cache extract |
-| `make clean-cache` | Xoá cache extract/work tree |
-| `make docker-build` | Build dev trong Docker |
-| `make docker-release` | Build release trong Docker |
-| `make docker-clean` | Clean build bằng Docker |
-
-Sau lần build/prepare đầu tiên:
-
-- Nếu sửa file bootstrap ISO như wallpaper, asset hoặc overlay nền: dùng `make overlay` rồi `make quick`.
-- Nếu sửa package/migration OTA: build/test trong [packages/caramos-ota](packages/caramos-ota/) trước, sau đó chạy `make customize-only` hoặc build lại ISO để OTA bootstrap áp dụng migration vào rootfs.
-- Không thêm feature mới vào hook chỉ để cập nhật máy user đã cài; hãy viết OTA migration.
-
-```bash
-make customize-only
-make quick
-```
-
-Nếu chỉ sửa boot menu/Plymouth:
-
-```bash
-make boot-only
-make iso-only
-```
-
-Debug trong chroot:
-
-```bash
-make shell
-```
-
-## Docker build
-
-Dùng Docker nếu máy không phải Ubuntu/Mint/Debian phù hợp:
-
-```bash
-make docker-build
-```
-
-Release build trong Docker:
-
-```bash
-make docker-release
-```
-
-## GitHub Actions release
-
-Workflow CI nằm ở [.github/workflows/build.yml](.github/workflows/build.yml).
-
-- Push/PR vào branch `main` hoặc `develop`: build dev ISO bằng `./build.sh`.
-- Push tag `v*`: kiểm tra tag khớp source version, build release bằng `./build.sh --release`, tạo `SHA256SUMS`, upload artifact và tạo GitHub Release.
-
-Quy trình release `1.0.1`:
-
-```bash
-# 1. Bump version trong scripts/config.sh nếu cần
-# CARAMOS_VERSION_MAJOR=1
-# CARAMOS_VERSION_MINOR=0
-# CARAMOS_VERSION_PATCH=11
-
-# 2. Commit và merge vào main
-git add scripts/config.sh
-git commit -m "[release] bump CaramOS to 1.0.11"
-git push
-
-# 3. Sau khi merge main
-git checkout main
-git pull origin main
-git tag v1.0.11
-git push origin v1.0.11
-```
-
-GitHub Release sẽ đính kèm:
-
-```text
-CaramOS-1.0.11-cinnamon-amd64.iso
-SHA256SUMS
-```
-
-## Cài đặt cho người dùng cuối
-
-### 1. Tải ISO
-
-Tải ISO từ trang GitHub Releases của dự án sau khi có bản phát hành.
-
-### 2. Ghi ra USB
-
-Linux/macOS:
-
-```bash
-sudo dd if=CaramOS-1.0.12-cinnamon-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync
-```
-
-Hoặc dùng Balena Etcher/Ventoy trên mọi hệ điều hành.
-
-### 3. Boot và cài đặt
-
-1. Khởi động lại máy, vào BIOS/UEFI bằng F2/F12/Del/Esc tuỳ máy.
-2. Chọn boot từ USB.
-3. Chọn live session hoặc **Cài đặt CaramOS**.
-4. Làm theo hướng dẫn cài đặt trên màn hình.
-
-## Đóng góp
-
-Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết thêm về kiến trúc OTA-first,
-quy trình build/test và hướng dẫn đóng góp.
-
-Quy ước nhanh:
-
-| Task | Vị trí |
-|---|---|
-| Cập nhật máy user đã cài | `packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/` |
-| Phát triển/troubleshoot OTA | `packages/caramos-ota/` |
-| Thêm package nền cho ISO mới | `config/packages.txt` |
-| Sửa overlay nền của ISO | `config/includes.chroot/` |
-| Hook build-time bắt buộc | `config/hooks/live/` — hạn chế, không dùng thay OTA migration |
-| Sửa version ISO | `scripts/config.sh` |
-| Theo dõi chỗ cần bump version | `docs/release-version-tracking.md` |
-| Sửa landing page | `landing/src/main.jsx` |
-| Sửa workflow release | `.github/workflows/build.yml` |
-
-## Contributors
-
-Cảm ơn tất cả thành viên đã đóng góp cho CaramOS trên GitHub.
-
-
-
- 
-
-
-
-## Giấy phép
-
-CaramOS là phần mềm mã nguồn mở theo giấy phép [GPL-3.0](LICENSE).
-
-## Cảm ơn
-
-- [Linux Mint](https://linuxmint.com/) — Base distro tuyệt vời
-- [Ubuntu](https://ubuntu.com/) — Nền tảng LTS ổn định
-- [VNLF (Vietnam Linux Family)](https://vietnamlinuxfamily.net) — Cộng đồng Linux Việt Nam
-- [DrMcC0y](https://github.com/DrMcC0y) — Cinnamon Delight theme/icons
-- [vinceliuice](https://github.com/vinceliuice) — Tela Circle icons
-- [ful1e5](https://github.com/ful1e5) — Bibata cursor
-- Cộng đồng Linux/FOSS Việt Nam
-
----
-
-
- CaramOS — Sweet & Simple Linux
- Made with love by Vietnam Linux Family
-
+After, Open **CaramOS Update Center (Vietnamese: "Trung tâm cập nhật CaramOS"** from start menu to start upgrade version.
From dae955e2a615b0619b0529c34869f5b1605fddd1 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 15:06:47 +0700
Subject: [PATCH 02/37] Update README.md
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 1a8585f..54a0030 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,6 @@ Original project: https://github.com/VietNam-Linux-Family/CaramOS
### How to update this OS by OTA?
If you installed OS `.iso` file. Run this command:
```bash
-curl -fsSL https://raw.githubusercontent/dryfish09/DMCaramOS/main/install-caramos-ota.sh | sudo bash
+curl -fsSL https://raw.githubusercontent.com/dryfish09/DMCaramOS/refs/heads/main/install-caramos-ota.sh | sudo bash
```
After, Open **CaramOS Update Center (Vietnamese: "Trung tâm cập nhật CaramOS"** from start menu to start upgrade version.
From 7417d0c0727b73e8bea27aa318ae945d91d2b084 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 15:21:59 +0700
Subject: [PATCH 03/37] ci: make ci runs in all branchs and bump action version
---
.github/workflows/build.yml | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 0e885d5..e31ebf8 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -1,8 +1,8 @@
-name: Build CaramOS ISO
+main: Build CaramOS ISO
on:
push:
- branches: [main, develop]
+ branches: ['*']
tags:
- 'v*'
pull_request:
@@ -65,7 +65,7 @@ jobs:
run: sha256sum CaramOS-*.iso > SHA256SUMS
- name: Upload ISO artifact
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v6
with:
name: CaramOS-ISO
path: |
From 23ce172179c3e5be1c2b297bfde118855c3988b9 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 15:31:59 +0700
Subject: [PATCH 04/37] feat: add more logging, fix bugs in script, add
validation for ISO ARG, more
---
build.sh | 69 ++++++++++++++++++++++++++++++++------------------------
1 file changed, 39 insertions(+), 30 deletions(-)
diff --git a/build.sh b/build.sh
index 0e538c6..2680c44 100755
--- a/build.sh
+++ b/build.sh
@@ -1,15 +1,15 @@
#!/bin/bash
# ============================================================
# CaramOS Build Script
-# Remaster từ Linux Mint ISO → CaramOS ISO
+# Remaster from Linux Mint ISO to CaramOS ISO
#
# Usage:
-# sudo ./build.sh # Dev build (lz4, nhanh)
-# sudo ./build.sh --release # Release build (xz, nhỏ)
-# sudo ./build.sh /path/to/mint.iso # Dùng ISO có sẵn
-# sudo ./build.sh --clean # Dọn build cũ
-# sudo ./build.sh --quick # Overlay + repack nhanh
-# sudo ./build.sh --shell # Vào chroot để test/sửa
+# sudo ./build.sh # Dev build (lz4, fast)
+# sudo ./build.sh --release # Release build (xz, small)
+# sudo ./build.sh /path/to/mint.iso # Use existing ISO
+# sudo ./build.sh --clean # Clean old build
+# sudo ./build.sh --quick # Overlay + quick repack
+# sudo ./build.sh --shell # Enter chroot to test/fix
# ============================================================
set -e
@@ -17,7 +17,6 @@ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
source "$SCRIPT_DIR/scripts/config.sh"
source "$SCRIPT_DIR/scripts/utils.sh"
source "$SCRIPT_DIR/scripts/extract.sh"
-# Cấu hình debug boot: xoá quiet/splash, đổi tên distro, tắt plymouth
source "$SCRIPT_DIR/scripts/boot_config.sh"
source "$SCRIPT_DIR/scripts/overlay.sh"
source "$SCRIPT_DIR/scripts/customize.sh"
@@ -35,13 +34,16 @@ for arg in "$@"; do
--release)
SQUASHFS_COMP="xz"
SQUASHFS_OPTS="-b 1M -Xdict-size 100% -noappend"
- info "Release mode: nén xz (chậm hơn, ISO nhỏ hơn)"
+ info "Release mode: xz compression (slower, smaller ISO)"
;;
--debug-boot)
DEBUG_BOOT=1
- info "Debug boot: hiện kernel log, tắt quiet/splash"
+ info "Debug boot: show kernel log, disable quiet/splash"
;;
- --prepare|--boot-only|--overlay-only|--customize-only|--shell|--repack-only|--iso-only|--quick|--clean|--clean-work|--clean-cache|--help|-h)
+ --help|-h)
+ MODE="help"
+ ;;
+ --prepare|--boot-only|--overlay-only|--customize-only|--shell|--repack-only|--iso-only|--quick|--clean|--clean-work|--clean-cache)
MODE="${arg#--}"
;;
*)
@@ -50,65 +52,72 @@ for arg in "$@"; do
esac
done
-# --- Clean/help modes không cần tải/resolve ISO ---
case "$MODE" in
- help|-h)
+ help)
print_dev_help
exit 0
;;
clean)
- info "Dọn dẹp build..."
+ info "Cleaning build..."
safe_remove_work_dirs
rm -rf "$WORK_DIR/cache" "$WORK_DIR/cache_iso" CaramOS-*.iso ./*.log
- ok "Đã dọn xong. (Mint ISO giữ lại)"
+ ok "Cleanup complete. (Mint ISO preserved)"
exit 0
;;
clean-work)
- info "Dọn work tree (giữ cache)..."
+ info "Cleaning work tree (preserving cache)..."
safe_remove_work_dirs
- ok "Đã xoá work tree, cache vẫn giữ lại."
+ ok "Work tree removed, cache preserved."
exit 0
;;
clean-cache)
- info "Dọn toàn bộ build cache/work tree..."
+ info "Cleaning all build cache/work tree..."
safe_remove_work_dirs
rm -rf "$WORK_DIR/cache" "$WORK_DIR/cache_iso"
- ok "Đã xoá cache/work tree."
+ ok "Cache/work tree removed."
exit 0
;;
esac
-# --- Kiểm tra ---
+if [ -n "$ISO_ARG" ] && [ ! -f "$ISO_ARG" ]; then
+ error "ISO file does not exist: $ISO_ARG"
+ exit 1
+fi
+
check_root
install_deps
install_gum
+check_disk_space
-# --- Trap: tự động dọn mount khi build thất bại ---
cleanup_on_fail() {
[ "${BUILD_OK:-0}" = "1" ] && return 0
echo ""
- echo -e "\033[0;31m[ERROR ]\033[0m Build thất bại! Đang dọn mount an toàn..."
- umount_chroot
+ echo -e "\033[0;31m[ERROR ]\033[0m Build failed! Cleaning up mounts safely..."
+
+ umount "$WORK_DIR/squashfs/dev/pts" 2>/dev/null || true
+ umount "$WORK_DIR/squashfs/dev" 2>/dev/null || true
+ umount "$WORK_DIR/squashfs/proc" 2>/dev/null || true
+ umount "$WORK_DIR/squashfs/sys" 2>/dev/null || true
+ umount "$WORK_DIR/squashfs" 2>/dev/null || true
umount "$WORK_DIR/mnt" 2>/dev/null || true
if [ "$CLEAN_OUTPUT" = true ]; then
safe_remove_work_dirs || true
else
- echo -e "\033[1;33m[ WARN ]\033[0m Giữ lại build dirs để bạn kiểm tra/sửa tiếp."
+ echo -e "\033[1;33m[ WARN ]\033[0m Preserving build directories for inspection/repair."
fi
}
-trap cleanup_on_fail EXIT
+trap cleanup_on_fail EXIT INT TERM
-# --- ISO input ---
resolve_iso "$ISO_ARG"
validate_customized_rootfs() {
+ [ -d "$WORK_DIR/squashfs" ] || return 1
[ -f "$WORK_DIR/squashfs/etc/caramos-customized" ] || return 1
chroot "$WORK_DIR/squashfs" /bin/bash -c "test -f /etc/dconf/db/local && test -f /etc/xdg/autostart/caramos-theme.desktop && test -f /etc/xdg/autostart/plank.desktop && test -d /etc/skel/.config/plank/dock1 && test -d /usr/share/cinnamon/applets/Cinnamenu@json && find /usr/share/cinnamon/applets/Cinnamenu@json -name settings-schema.json -print -quit | grep -q . && test -f /usr/share/plymouth/themes/caramos/caramos.plymouth"
}
-# --- Header ---
print_header
case "$MODE" in
@@ -149,7 +158,7 @@ case "$MODE" in
ensure_work_tree
step_boot_config
if ! validate_customized_rootfs; then
- warn "Work tree chưa customize đầy đủ hoặc marker cũ không hợp lệ. Chạy customize trước khi repack."
+ warn "Work tree not fully customized or marker is invalid. Running customize before repack."
rm -f "$WORK_DIR/squashfs/etc/caramos-customized" 2>/dev/null || true
step_customize
else
@@ -158,7 +167,7 @@ case "$MODE" in
step_repack
;;
*)
- error "Mode không hỗ trợ: $MODE. Chạy sudo ./build.sh --help để xem hướng dẫn."
+ error "Unsupported mode: $MODE. Run sudo ./build.sh --help for instructions."
;;
esac
@@ -166,7 +175,7 @@ BUILD_OK=1
case "$MODE" in
shell|prepare|boot-only|overlay-only|customize-only)
- ok "Hoàn tất mode: $MODE"
+ ok "Completed mode: $MODE"
;;
*)
print_result
From d150964e74be875f30655aae605f760696d57d3e Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 15:34:01 +0700
Subject: [PATCH 05/37] ci: fix ci syntax error
---
.github/workflows/build.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index e31ebf8..788e0ef 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -1,4 +1,4 @@
-main: Build CaramOS ISO
+name: Build CaramOS ISO
on:
push:
From af2c8c4dbcc1807c73bdfd7125d2dcf7b203827c Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 15:40:52 +0700
Subject: [PATCH 06/37] fix: add missing function
---
build.sh | 28 ++++++++++++++++++++++++++++
1 file changed, 28 insertions(+)
diff --git a/build.sh b/build.sh
index 2680c44..7deeb02 100755
--- a/build.sh
+++ b/build.sh
@@ -29,6 +29,34 @@ ISO_ARG=""
CLEAN_OUTPUT=false
DEBUG_BOOT=0
+check_disk_space() {
+ local required_space=10000000
+ local paths_to_check=("$WORK_DIR" "$SCRIPT_DIR")
+
+ for check_path in "${paths_to_check[@]}"; do
+ if [ ! -d "$check_path" ]; then
+ warn "Directory does not exist: $check_path, skipping disk space check"
+ continue
+ fi
+
+ local available_space=$(df "$check_path" 2>/dev/null | awk 'NR==2 {print $4}')
+
+ if [ -z "$available_space" ]; then
+ warn "Cannot determine available disk space for $check_path"
+ continue
+ fi
+
+ if [ "$available_space" -lt "$required_space" ]; then
+ local available_gb=$((available_space/1024/1024))
+ local required_gb=$((required_space/1024/1024))
+ error "Insufficient disk space in $check_path. Need at least ${required_gb}GB, currently have ${available_gb}GB"
+ exit 1
+ fi
+
+ info "Disk space OK for $check_path: $((available_space/1024/1024))GB available"
+ done
+}
+
for arg in "$@"; do
case "$arg" in
--release)
From 67c530da301e5e9ecb68f98baead46ae1cb8f48d Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:04:48 +0700
Subject: [PATCH 07/37] feat: add more packages
---
config/packages.txt | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/config/packages.txt b/config/packages.txt
index 9af9191..fd22f21 100644
--- a/config/packages.txt
+++ b/config/packages.txt
@@ -8,3 +8,23 @@ flameshot
tlp
#19
copyq
+copyq-doc
+tlp-rdw
+network-manager
+gimp
+gnome-sushi
+peek
+meld
+chrome-gnome-shell
+upower
+zip
+unzip
+gdebi
+gnome-tweaks
+git
+ubuntu-restricted-extras
+remmina
+vim
+neovim
+docker.io
+gh
From bffa239a9d4b3fb64a55b51f14bfe965ffa97230 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:08:56 +0700
Subject: [PATCH 08/37] Update version to release
---
scripts/config.sh | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/scripts/config.sh b/scripts/config.sh
index d3351c4..aad7574 100644
--- a/scripts/config.sh
+++ b/scripts/config.sh
@@ -12,7 +12,7 @@ else
fi
# CaramOS product version. `make release VERSION=x` stamps this value.
-CARAMOS_VERSION="1.0.16.1"
+CARAMOS_VERSION="1.0.0"
CARAMOS_CODENAME="Open Beta"
# Version metadata ban đầu ghi vào rootfs trước khi chạy OTA bootstrap.
From 9558168bcd1711b691f75fed2b3317771a4cb094 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:10:44 +0700
Subject: [PATCH 09/37] Delete
packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center
directory
---
.../manifest.json | 19 -
.../migration.py | 356 -----------------
.../tracker-control-center.md | 358 ------------------
3 files changed, 733 deletions(-)
delete mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json
delete mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py
delete mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/tracker-control-center.md
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json
deleted file mode 100644
index 65cd814..0000000
--- a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "schema": 2,
- "codename": "noble",
- "channel": "stable",
- "severity": "feature",
- "size": "ota feature",
- "title": "Thêm Trung tâm điều khiển CaramOS",
- "summary": "Cài applet Control Center thử nghiệm để gom các thao tác nhanh ở góc phải panel.",
- "release_notes_vi": [
- "Thêm applet caramos-control-center@caramos cho Cinnamon panel.",
- "Bật applet Control Center trên panel cho các user desktop đang có phiên đăng nhập.",
- "Bỏ các applet mạng, âm thanh và pin mặc định đã được Control Center thay thế; giữ nguyên mọi applet khác và vị trí hiện có."
- ],
- "release_notes_en": [
- "Add the caramos-control-center@caramos applet to the Cinnamon panel.",
- "Enable Control Center for desktop users with an active session.",
- "Remove stock network, sound, and power applets replaced by Control Center while preserving every other applet and its existing position."
- ]
-}
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py
deleted file mode 100644
index e107522..0000000
--- a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py
+++ /dev/null
@@ -1,356 +0,0 @@
-"""Timestamp migration for 1.0.13: install CaramOS Control Center applet."""
-
-from __future__ import annotations
-
-import ast
-import json
-import os
-import pwd
-import shutil
-import subprocess
-import tempfile
-from pathlib import Path
-
-from caramos_ota_update.context import MigrationContext
-
-DESCRIPTION = "Install CaramOS Control Center Cinnamon applet"
-
-APPLET_UUID = "caramos-control-center@caramos"
-REPLACED_APPLET_UUIDS = frozenset(
- {
- "network@cinnamon.org",
- "sound@cinnamon.org",
- "power@cinnamon.org",
- }
-)
-SOURCE_APPLET_DIR = Path("/usr/share/caramos-ota/applets") / APPLET_UUID
-TARGET_APPLET_DIR = Path("/usr/share/cinnamon/applets") / APPLET_UUID
-REQUIRED_APPLET_FILES = ("applet.js", "metadata.json", "stylesheet.css")
-PANEL_DCONF_FILE = Path("/etc/dconf/db/local.d/01-caramos-task17-panel")
-CINNAMON_SECTION = "org/cinnamon"
-DEFAULT_ENABLED_APPLETS = (
- "['panel1:left:0:Cinnamenu@json:0', "
- "'panel1:center:0:grouped-window-list@cinnamon.org:1', "
- "'panel1:right:0:systray@cinnamon.org:2', "
- "'panel1:right:1:notifications@cinnamon.org:5', "
- "'panel1:right:2:calendar@cinnamon.org:7', "
- "'panel1:right:3:caramos-control-center@caramos:0']"
-)
-
-
-def _validate_applet(directory: Path) -> None:
- if not directory.is_dir():
- raise RuntimeError(f"applet source directory not found: {directory}")
- if directory.is_symlink():
- raise RuntimeError(f"applet source must not be a symlink: {directory}")
-
- for name in REQUIRED_APPLET_FILES:
- path = directory / name
- if not path.is_file() or path.is_symlink():
- raise RuntimeError(f"applet source requires regular file: {path}")
-
- try:
- metadata = json.loads((directory / "metadata.json").read_text(encoding="utf-8"))
- except Exception as exc:
- raise RuntimeError(f"cannot read applet metadata: {exc}") from exc
- if not isinstance(metadata, dict) or metadata.get("uuid") != APPLET_UUID:
- raise RuntimeError(f"applet metadata UUID must be {APPLET_UUID!r}")
-
-
-def _clear_directory(directory: Path) -> None:
- for child in directory.iterdir():
- if child.is_dir() and not child.is_symlink():
- shutil.rmtree(child)
- else:
- child.unlink()
-
-
-def _copy_directory_contents(source: Path, target: Path) -> None:
- target.mkdir(parents=True, exist_ok=True)
- for child in source.iterdir():
- destination = target / child.name
- if child.is_dir() and not child.is_symlink():
- shutil.copytree(child, destination)
- else:
- shutil.copy2(child, destination, follow_symlinks=False)
-
-
-def _install_applet(context: MigrationContext) -> None:
- _validate_applet(SOURCE_APPLET_DIR)
- TARGET_APPLET_DIR.parent.mkdir(parents=True, exist_ok=True)
- if TARGET_APPLET_DIR.is_symlink():
- raise RuntimeError(f"applet target must not be a symlink: {TARGET_APPLET_DIR}")
- if TARGET_APPLET_DIR.exists() and not TARGET_APPLET_DIR.is_dir():
- raise RuntimeError(f"applet target must be a directory: {TARGET_APPLET_DIR}")
-
- staging_root = Path(tempfile.mkdtemp(prefix=f".{APPLET_UUID}.", dir=TARGET_APPLET_DIR.parent))
- staging_dir = staging_root / APPLET_UUID
- backup_dir = staging_root / "previous"
- target_existed = TARGET_APPLET_DIR.exists()
- try:
- shutil.copytree(SOURCE_APPLET_DIR, staging_dir)
- _validate_applet(staging_dir)
- if target_existed:
- shutil.copytree(TARGET_APPLET_DIR, backup_dir, symlinks=True)
-
- TARGET_APPLET_DIR.mkdir(parents=True, exist_ok=True)
- try:
- _clear_directory(TARGET_APPLET_DIR)
- _copy_directory_contents(staging_dir, TARGET_APPLET_DIR)
- _validate_applet(TARGET_APPLET_DIR)
- except Exception:
- _clear_directory(TARGET_APPLET_DIR)
- if target_existed:
- _copy_directory_contents(backup_dir, TARGET_APPLET_DIR)
- else:
- TARGET_APPLET_DIR.rmdir()
- raise
- finally:
- shutil.rmtree(staging_root, ignore_errors=True)
-
- context.log(f"installed Cinnamon applet: {TARGET_APPLET_DIR}")
-
-
-def _user_environment(username: str, uid: int, home: Path) -> dict[str, str]:
- env = os.environ.copy()
- env.update(
- {
- "HOME": str(home),
- "USER": username,
- "LOGNAME": username,
- }
- )
-
- runtime_dir = Path(f"/run/user/{uid}")
- if runtime_dir.is_dir() and (runtime_dir / "bus").exists():
- env.update(
- {
- "DISPLAY": os.environ.get("DISPLAY", ":0"),
- "XAUTHORITY": str(home / ".Xauthority"),
- "XDG_RUNTIME_DIR": str(runtime_dir),
- "DBUS_SESSION_BUS_ADDRESS": f"unix:path={runtime_dir}/bus",
- }
- )
- else:
- env.pop("DBUS_SESSION_BUS_ADDRESS", None)
-
- return env
-
-
-def _desktop_users() -> list[tuple[str, int, Path]]:
- users: list[tuple[str, int, Path]] = []
- for user_info in pwd.getpwall():
- if user_info.pw_uid < 1000 or user_info.pw_dir in ("", "/nonexistent"):
- continue
- home = Path(user_info.pw_dir)
- if not home.is_dir():
- continue
- users.append((user_info.pw_name, user_info.pw_uid, home))
- return sorted(users, key=lambda item: item[1])
-
-
-def _run_gsettings(user: str, env: dict[str, str], args: list[str]) -> subprocess.CompletedProcess[str]:
- command = ["runuser", "-u", user, "--"]
- if "DBUS_SESSION_BUS_ADDRESS" not in env:
- command.extend(["dbus-run-session", "--"])
- command.extend(["gsettings", *args])
- return subprocess.run(
- command,
- check=False,
- capture_output=True,
- text=True,
- env=env,
- )
-
-
-def _update_blueman_plugins(plugin_list: str) -> str | None:
- """Disable only Blueman's tray icon while preserving all other plugins."""
-
- value = plugin_list.strip()
- if value.startswith("@as "):
- value = value[4:].lstrip()
- try:
- parsed = ast.literal_eval(value)
- except (SyntaxError, ValueError):
- return None
- if not isinstance(parsed, list) or any(not isinstance(entry, str) for entry in parsed):
- return None
- for plugin in ("ShowConnected", "StatusIcon"):
- disabled = f"!{plugin}"
- if disabled not in parsed:
- parsed.append(disabled)
- return f"[{', '.join(repr(entry) for entry in parsed)}]"
-
-
-def _update_enabled_applets(enabled_applets: str) -> str | None:
- """Replace redundant stock indicators with Control Center atomically.
-
- Existing entries keep their text, order, and position fields. Both the
- four-field and five-field Cinnamon formats are accepted; unknown top-level
- list formats are rejected without changing user settings.
- """
-
- value = enabled_applets.strip()
- if not value.startswith("[") or not value.endswith("]"):
- return None
-
- try:
- parsed = ast.literal_eval(value)
- except (SyntaxError, ValueError):
- return None
- if not isinstance(parsed, list) or any(not isinstance(entry, str) for entry in parsed):
- return None
-
- inner = value[1:-1].strip()
- if inner and not parsed:
- return None
-
- entries: list[str] = []
- has_control_center = False
- for entry in parsed:
- parts = entry.split(":", 4)
- uuid = parts[3] if len(parts) >= 4 else None
- if uuid in REPLACED_APPLET_UUIDS:
- continue
- entries.append(entry)
- if uuid == APPLET_UUID:
- has_control_center = True
-
- if not has_control_center:
- positions = [
- int(parts[2])
- for entry in entries
- for parts in [entry.split(":", 4)]
- if len(parts) >= 4
- and parts[0] == "panel1"
- and parts[1] == "right"
- and parts[2].isdigit()
- ]
- next_position = max(positions, default=-1) + 1
- entries.append(f"panel1:right:{next_position}:{APPLET_UUID}:0")
-
- quoted = [repr(entry) for entry in entries]
- return f"[{', '.join(quoted)}]"
-
-
-def _updated_dconf_text(source: str) -> str:
- """Update Control Center defaults while preserving unrelated config."""
-
- lines = source.splitlines()
- section_start = None
- section_end = len(lines)
- for index, line in enumerate(lines):
- stripped = line.strip()
- if stripped == f"[{CINNAMON_SECTION}]":
- section_start = index
- continue
- if section_start is not None and index > section_start and stripped.startswith("[") and stripped.endswith("]"):
- section_end = index
- break
-
- if section_start is None:
- if lines and lines[-1].strip():
- lines.append("")
- lines.extend((f"[{CINNAMON_SECTION}]", f"enabled-applets={DEFAULT_ENABLED_APPLETS}"))
- return "\n".join(lines) + "\n"
-
- key_index = None
- for index in range(section_start + 1, section_end):
- if lines[index].strip().startswith("enabled-applets="):
- key_index = index
- break
- if key_index is None:
- lines.insert(section_end, f"enabled-applets={DEFAULT_ENABLED_APPLETS}")
- return "\n".join(lines) + "\n"
-
- current = lines[key_index].split("=", 1)[1].strip()
- updated = _update_enabled_applets(current)
- if updated is None:
- raise RuntimeError(f"unexpected enabled-applets format in {PANEL_DCONF_FILE}")
- lines[key_index] = f"enabled-applets={updated}"
- return "\n".join(lines) + "\n"
-
-
-def _atomic_write_text(path: Path, content: str, mode: int) -> None:
- path.parent.mkdir(parents=True, exist_ok=True)
- descriptor, staging_name = tempfile.mkstemp(prefix=f".{path.name}.", dir=path.parent)
- os.close(descriptor)
- staging = Path(staging_name)
- try:
- staging.write_text(content, encoding="utf-8")
- staging.chmod(mode)
- os.replace(staging, path)
- finally:
- staging.unlink(missing_ok=True)
-
-
-def _update_system_defaults(context: MigrationContext) -> bool:
- if PANEL_DCONF_FILE.is_symlink():
- raise RuntimeError(f"dconf defaults must not be a symlink: {PANEL_DCONF_FILE}")
- if PANEL_DCONF_FILE.exists() and not PANEL_DCONF_FILE.is_file():
- raise RuntimeError(f"dconf defaults must be a regular file: {PANEL_DCONF_FILE}")
- source = PANEL_DCONF_FILE.read_text(encoding="utf-8") if PANEL_DCONF_FILE.exists() else ""
- updated = _updated_dconf_text(source)
- if updated == source:
- context.log("Control Center already enabled in system dconf defaults")
- return False
- context.log(f"enable Control Center in system dconf defaults: {PANEL_DCONF_FILE}")
- if not context.dry_run:
- mode = PANEL_DCONF_FILE.stat().st_mode & 0o777 if PANEL_DCONF_FILE.exists() else 0o644
- _atomic_write_text(PANEL_DCONF_FILE, updated, mode)
- return True
-
-
-def _apply_to_user(context: MigrationContext, username: str, uid: int, home: Path) -> None:
- env = _user_environment(username, uid, home)
-
- current = _run_gsettings(username, env, ["get", "org.cinnamon", "enabled-applets"])
- if current.returncode != 0:
- context.log(f"warning: could not read Cinnamon applets for {username}: {current.stderr.strip()}")
- else:
- updated_applets = _update_enabled_applets(current.stdout)
- if updated_applets is None:
- context.log(f"warning: unexpected enabled-applets format for {username}; skip Control Center panel update")
- elif updated_applets == current.stdout.strip():
- context.log(f"kept existing Control Center panel layout for user: {username}")
- else:
- result = _run_gsettings(username, env, ["set", "org.cinnamon", "enabled-applets", updated_applets])
- if result.returncode == 0:
- context.log(f"enabled Control Center and removed redundant network, sound, and power applets for: {username}")
- else:
- context.log(f"warning: could not update Control Center panel for {username}: {result.stderr.strip()}")
-
- plugins = _run_gsettings(username, env, ["get", "org.blueman.general", "plugin-list"])
- if plugins.returncode != 0:
- context.log(f"warning: could not read Blueman plugins for {username}: {plugins.stderr.strip()}")
- return
- updated_plugins = _update_blueman_plugins(plugins.stdout)
- if updated_plugins is None:
- context.log(f"warning: unexpected Blueman plugin-list format for {username}; keep current plugins")
- return
- if updated_plugins == plugins.stdout.strip():
- context.log(f"kept Blueman tray icon disabled for user: {username}")
- return
- result = _run_gsettings(username, env, ["set", "org.blueman.general", "plugin-list", updated_plugins])
- if result.returncode == 0:
- context.log(f"disabled redundant Blueman tray icon for user: {username}")
- else:
- context.log(f"warning: could not disable Blueman tray icon for {username}: {result.stderr.strip()}")
-
-
-def run(context: MigrationContext) -> None:
- """Install and enable the CaramOS Control Center applet."""
-
- if context.dry_run:
- context.log(f"[dry-run] copy {SOURCE_APPLET_DIR} to {TARGET_APPLET_DIR}")
- _update_system_defaults(context)
- context.log("[dry-run] enable Control Center and remove redundant network, sound, and power applets for all desktop users")
- return
-
- _install_applet(context)
- defaults_changed = _update_system_defaults(context)
- if defaults_changed:
- context.run_command(["dconf", "update"], allow_fail=True)
-
- for username, uid, home in _desktop_users():
- _apply_to_user(context, username, uid, home)
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/tracker-control-center.md b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/tracker-control-center.md
deleted file mode 100644
index 961a850..0000000
--- a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/tracker-control-center.md
+++ /dev/null
@@ -1,358 +0,0 @@
-# 🧾 TRACKER — CaramOS Control Center Applet giống Ubuntu Quick Settings
-
-> Tracker triển khai cho `20260715090258_install_control_center\`: nâng applet `caramos-control-center@caramos`
-> từ menu tile tạm bợ sang trung tâm điều khiển giống Ubuntu Quick Settings.
->
-> Nguyên tắc quan trọng: migration cài Control Center và bỏ đúng ba applet mặc định
-> `network@cinnamon.org`, `sound@cinnamon.org`, `power@cinnamon.org`; không rewrite
-> layout panel, không ghi đè dconf toàn cục, giữ nguyên mọi applet khác và position hiện có.
-
----
-
-## 🔖 1. THÔNG TIN CHUNG
-
-| Trường | Giá trị |
-| --- | --- |
-| **ID** | CARAMOS-OTA-CC-001 |
-| **Tên task** | Xây dựng CaramOS Control Center giống Ubuntu Quick Settings |
-| **Loại** | Desktop UX / Cinnamon Applet / OTA Migration |
-| **Độ ưu tiên** | High |
-| **Mức ảnh hưởng** | Medium-High |
-| **Trạng thái tổng thể** | Code Complete — chuyển sang test/fix-only |
-| **Người phụ trách** | dungleviet |
-| **Người yêu cầu** | CaramOS maintainer |
-| **Reviewer** | TBD |
-| **Ngày tạo** | 2026-07-02 |
-| **Cập nhật lần cuối** | 2026-07-29 |
-| **Target release** | CaramOS OTA 1.0.13\ |
-| **Branch / PR** | TBD |
-
-### 1.1 Trạng thái phase
-
-| Phase | Tên phase | Trạng thái | Ghi chú |
-| --- | --- | --- | --- |
-| 0 | Chốt scope và nguyên tắc an toàn | Done | Control Center thay đúng network/sound/power; giữ applet và layout còn lại. |
-| 1 | Trace Ubuntu Quick Settings / CaramOS applets | Done | Đã scan VM CaramOS và source applet Cinnamon có sẵn. |
-| 2 | Thiết kế kiến trúc applet Cinnamon | Done | Backend contract và lifecycle đã chốt cho v1.0.13. |
-| 3 | Implement panel indicator gộp | Done | Cụm network/VPN/mic/volume/battery reload pass trên Cinnamon 6.6.4. |
-| 4 | Implement popup Quick Settings | Done | Sliders, tiles, inline details, empty/error fallback code complete. |
-| 5 | Kết nối audio/mic | Done | Cvc volume/mute, output/input selector, hotplug signals và no-device guard. |
-| 6 | Kết nối brightness | Blocked | Code DBus + capability gating xong; VM không có backlight thật. |
-| 7 | Kết nối Wi-Fi/VPN/network | Blocked | NetworkManager details/libnm/async VPN xong; hardware/auth/captive matrix còn cần test. |
-| 8 | Kết nối power/battery/night light | Blocked | UPower signals/estimate/AC/UPS summary xong; laptop/UPS thật còn cần test. |
-| 9 | Style giống Ubuntu nhưng hợp CaramOS | Blocked | Light/dark/high-contrast/focus code xong; visual/a11y matrix còn cần test. |
-| 10 | Packaging + migration an toàn | Blocked | Atomic/fail-closed + unit tests pass; full `.deb` lifecycle chưa chạy. |
-| 11 | Verification trên VM | In Progress | Reload pass; static/unit pass; chuyển sang test/fix-only. |
-
----
-
-## 🧠 2. BỐI CẢNH VÀ VẤN ĐỀ
-
-### 2.1 Hiện trạng
-
-Applet hiện tại chỉ là menu tĩnh gồm các tile mở settings/app riêng lẻ. Nó chưa có giá trị như Control Center thật vì:
-
-- không hiển thị trạng thái hiện tại;
-- không điều khiển nhanh volume/mic/brightness;
-- không gom indicator trên panel;
-- không có submenu Wi-Fi/VPN/Bluetooth;
-- UX chưa giống Ubuntu Quick Settings.
-
-### 2.2 Yêu cầu mới
-
-Làm Control Center giống Ubuntu Quick Settings:
-
-- Trên panel gom một cụm indicator gồm pin, loa, mic, Wi-Fi/network, VPN, Bluetooth nếu ổn định.
-- Click cụm indicator sẽ mở popup.
-- Popup có slider loa, mic, ánh sáng.
-- Popup có tile/submenu Wi-Fi, VPN, Bluetooth.
-- Popup có Power Mode, Night Light/Dark Style nếu hỗ trợ.
-- Popup có Lock, Settings, Power.
-
-### 2.3 Bài học từ lỗi trước
-
-Không được dùng migration để cấu hình lại toàn bộ panel.
-
-Migration `20260715090258_install_control_center\` chỉ được phép:
-
-1. copy applet vào `/usr/share/cinnamon/applets/`;
-2. atomically bỏ đúng `network@cinnamon.org`, `sound@cinnamon.org`, `power@cinnamon.org` và append Control Center nếu chưa có;
-3. giữ nguyên text, thứ tự và position của mọi applet khác;
-4. không sửa `panels-height`;
-5. không sửa `panel-zone-*`;
-6. không ghi `/etc/dconf/db/local.d/...` cho layout panel;
-7. không reload Cinnamon cưỡng bức.
-
----
-
-## 🎯 3. MỤC TIÊU
-
-```text
-Panel indicator compact
-└── Popup Quick Settings
- ├── Battery pill/status
- ├── Volume slider
- ├── Microphone slider
- ├── Brightness slider
- ├── Wi-Fi tile + submenu
- ├── VPN tile + submenu
- ├── Bluetooth tile
- ├── Power mode
- ├── Night Light / Dark Style
- └── Lock / Settings / Power
-```
-
-### 3.1 Mục tiêu kỹ thuật
-
-- Applet chạy ổn trên Cinnamon của CaramOS/Linux Mint 22 base.
-- Không crash GJS/Cinnamon.
-- Không phá panel hiện có.
-- Có graceful fallback nếu thiếu API hoặc command.
-- UI cập nhật trạng thái định kỳ nhẹ.
-- Không hardcode cấu hình riêng của một máy test.
-
-### 3.2 Ngoài phạm vi v1
-
-- Không viết daemon riêng nếu chưa cần.
-- Không thay NetworkManager UI đầy đủ.
-- Không implement full GNOME Shell Quick Settings internals.
-- Không ép mọi máy phải có brightness/mic/VPN nếu phần cứng không hỗ trợ.
-- Không sửa global Cinnamon layout.
-
----
-
-## 🧩 4. THIẾT KẾ DỰ KIẾN
-
-| File | Vai trò |
-| --- | --- |
-| `usr/share/caramos-ota/applets/caramos-control-center@caramos/applet.js` | Logic applet Cinnamon/GJS |
-| `usr/share/caramos-ota/applets/caramos-control-center@caramos/stylesheet.css` | Style popup/panel |
-| `usr/share/caramos-ota/applets/caramos-control-center@caramos/metadata.json` | Metadata Cinnamon applet |
-| `usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center\/migration.py` | Cài applet tối thiểu |
-
-### 4.1 Nguyên tắc applet.js
-
-- Không subclass trực tiếp `St.Button` theo kiểu gây lỗi GType.
-- Tạo UI bằng factory functions.
-- Không shell command với input người dùng không validate.
-- Command cố định, allow-list rõ ràng.
-- Poll interval vừa phải, ví dụ 2-5 giây cho status nhẹ.
-
-### 4.2 Backend control sau scan VM
-
-Kết quả scan read-only trong CaramOS VM cho thấy không nên nhúng nguyên applet có sẵn vào Control Center. Các applet Cinnamon hiện hữu có lifecycle/menu/actor riêng, nếu instantiate bên trong applet khác dễ double signal, conflict actor/menu hoặc crash Cinnamon. Hướng an toàn là reuse pattern/API nội bộ có chọn lọc.
-
-| Tính năng | Backend chọn cho v1 | Fallback | Ghi chú scan |
-| --- | --- | --- | --- |
-| Volume output | `Cvc.MixerControl` giống `sound@cinnamon.org` | mở `cinnamon-settings sound` | `sound@cinnamon.org` có `VolumeSlider`, `get_default_sink()`, `stream.push_volume()`. |
-| Microphone | `Cvc.MixerControl` giống `sound@cinnamon.org` | disabled nếu không có source | `sound@cinnamon.org` có `_inputVolumeSection`, `get_default_source()`. |
-| Brightness | DBus `org.cinnamon.SettingsDaemon.Power.Screen` | disabled/mở `cinnamon-settings display` | `brightnessctl` không có trong VM; `power@cinnamon.org` dùng `GetPercentageRemote/SetPercentageRemote`. |
-| Battery | `UPowerGlib` | `upower`/ẩn nếu không có pin | VM có `/org/freedesktop/UPower/devices/battery_BAT0`. |
-| Night Light | `Gio.Settings` schema `org.cinnamon.settings-daemon.plugins.color` | mở settings | key: `night-light-enabled`. |
-| Wi-Fi | libnm `NM.Client`, AP objects và active connection | `cinnamon-settings network` cho secured-unsaved/enterprise/hidden | Reuse API/pattern từ `network@cinnamon.org`; không parse `nmcli` text. |
-| VPN | async bounded `nmcli` profile query/action theo UUID | mở network settings | Multi-profile VPN/WireGuard; background refresh không kích spinner. |
-| Bluetooth | BlueZ Adapter1/Device1/Battery1 | `blueman-manager`/`bluetoothctl` fallback | Owner watch reconnect; pairing agent vẫn deferred. |
-| Lock | `cinnamon-screensaver-command --lock` | disabled nếu thiếu command | command cố định, không nhận input user. |
-| Power | `cinnamon-session-quit --power-off` | disabled nếu thiếu command | command cố định, không nhận input user. |
-
-### 4.3 UX tham khảo Ubuntu 24.04
-
-Cần trace từ máy Ubuntu hiện tại:
-
-- layout cụm indicator trên top bar;
-- popup width/spacing/radius;
-- pill button selected/disabled states;
-- slider style;
-- arrow submenu pattern;
-- cách hiển thị battery percent;
-- cách gom Wi-Fi/VPN/volume/mic.
-
-Không copy code GNOME Shell nếu license/API không phù hợp; chỉ tham khảo UX và hành vi.
-
----
-
-## 🛠️ 5. KẾ HOẠCH TRIỂN KHAI
-
-### Phase 0 — Chốt scope an toàn
-
-- [x] Applet chỉ bổ sung Control Center, không thay panel layout.
-- [x] Migration không ghi dconf defaults.
-- [x] Migration bỏ đúng icon `sound@cinnamon.org`, `network@cinnamon.org`, `power@cinnamon.org` đã được Control Center thay thế.
-- [x] Mọi applet khác giữ nguyên thứ tự và position.
-
-### Phase 1 — Scan CaramOS applets hiện có
-
-- [x] Đọc `org.cinnamon enabled-applets` trên VM sạch.
-- [x] Xác nhận panel cũ có `systray`, `network`, `sound`, `notifications`, `power`, `calendar`.
-- [x] Scan source `sound@cinnamon.org`.
-- [x] Scan source `power@cinnamon.org`.
-- [x] Scan source `nightlight@cinnamon.org`.
-- [x] Scan source `network@cinnamon.org`.
-- [x] Xác nhận command/backend có sẵn: `pactl`, `nmcli`, `bluetoothctl`, `blueman-manager`, `upower`, `gdbus`, `busctl`.
-- [x] Xác nhận `brightnessctl` và `powerprofilesctl` không có trong VM.
-
-### Phase 2 — Thiết kế backend v1 an toàn
-
-- [x] Không nhúng nguyên applet Cinnamon có sẵn.
-- [x] Reuse pattern/API từ `sound@cinnamon.org` cho volume/mic.
-- [x] Reuse pattern/API từ `power@cinnamon.org` cho brightness/battery.
-- [x] Reuse `Gio.Settings` từ `nightlight@cinnamon.org` cho Night Light.
-- [x] Để Wi-Fi/VPN full submenu sang phase sau vì `network@cinnamon.org` quá lớn/rủi ro.
-
-### Phase 3 — Prototype UI Quick Settings
-
-- [x] Dựng panel indicator compact.
-- [x] Dựng popup quick settings giống Ubuntu.
-- [x] Dựng volume slider.
-- [x] Dựng mic slider.
-- [x] Dựng brightness slider capability-gated.
-- [x] Dựng Wi-Fi/VPN/Bluetooth tiles và inline lists.
-- [x] Dựng Lock/Settings/Power buttons.
-- [x] Style giống Ubuntu nhưng dùng màu CaramOS.
-- [x] Reload applet trên Cinnamon 6.6.4 không có lỗi mới.
-
-### Phase 4 — Kết nối backend ít rủi ro
-
-- [x] Volume output bằng `Cvc.MixerControl`.
-- [x] Microphone bằng `Cvc.MixerControl`.
-- [x] Battery percent bằng UPower command + sysfs fallback; UPower DBus còn roadmap.
-- [x] Night Light toggle bằng `Gio.Settings`.
-- [x] Brightness bằng DBus `org.cinnamon.SettingsDaemon.Power.Screen`, ẩn nếu no-backlight/proxy.
-
-### Phase 5 — Network / Wi-Fi / VPN
-
-- [x] Wi-Fi radio/AP/SSID state dùng libnm `NM.Client` object model.
-- [x] Wi-Fi scan dùng `request_scan()` và AP signals.
-- [x] Saved/open Wi-Fi action dùng libnm connection/AP objects.
-- [x] Secured-unsaved/enterprise/hidden mở native Cinnamon Settings/keyring flow.
-- [x] Disconnect Wi-Fi dùng active connection object, không SSID text.
-- [x] VPN/WireGuard list nhiều profile, action theo UUID và async refresh.
-- [x] Ethernet/multiple-adapter details, default route, IP/gateway/DNS/carrier/speed.
-- [x] Captive/limited connectivity state và native browser/settings handoff.
-- [ ] BLOCKED — Wi-Fi hardware/SSID edge-case/auth-failure matrix.
-- [ ] DEFERRED — VPN confirmation bằng NetworkManager active-connection signal; v1 dùng bounded async refresh.
-
-### Phase 6 — Packaging + migration
-
-- [ ] Đóng gói applet files vào `.deb`.
-- [x] Migration cài applet bằng staging, validate và restore khi lỗi.
-- [x] Migration atomically bỏ stock network/sound/power và append Control Center nếu chưa có.
-- [x] Không ghi dconf layout.
-- [x] Không reload Cinnamon cưỡng bức.
-
-### Phase 7 — Verification
-
-- [ ] `./tools/caramos-ota-testkit.sh compile` pass.
-- [ ] `./tools/caramos-ota-testkit.sh validate` pass.
-- [ ] `make ship` pass trên VM sạch.
-- [ ] `make test` pass.
-- [ ] Sau reboot, panel có Control Center, không còn stock network/sound/power, applet khác giữ nguyên.
-- [ ] Kiểm tra `~/.xsession-errors` không có lỗi applet.
-
-### Phase 8 — Sau v1.0.13\, nếu applet đủ ổn
-
-- [ ] Cân nhắc full Wi-Fi list bằng `NM.Client`.
-- [ ] Cân nhắc VPN list/toggle bằng `NM.Client`.
-- [x] Stock network/sound/power đã được thay trong migration Control Center đang phát triển; không đụng icon khác.
-
-## ✅ 6. ACCEPTANCE CRITERIA
-
-### 6.1 Không phá hệ thống
-
-- [ ] Chỉ mất stock network/sound/power; systray/notifications/calendar/custom applet giữ nguyên.
-- [ ] Không đổi chiều cao panel.
-- [ ] Không đổi icon size panel toàn cục.
-
-### 6.2 Applet mới có giá trị thật
-
-- [ ] Có panel indicator gộp.
-- [ ] Popup giống Ubuntu Quick Settings về cấu trúc.
-- [ ] Volume slider hoạt động.
-- [ ] Mic slider hoạt động hoặc disabled rõ ràng.
-- [ ] Brightness slider hoạt động hoặc disabled rõ ràng.
-- [ ] Wi-Fi/VPN hiển thị trạng thái thật.
-- [ ] Lock/Settings/Power hoạt động.
-
-### 6.3 Migration an toàn
-
-- [x] Chỉ thêm `caramos-control-center@caramos` nếu chưa có.
-- [x] Bỏ đúng UUID stock network/sound/power bằng một lần `gsettings set`.
-- [x] Không rewrite toàn bộ `enabled-applets` bằng layout hardcode.
-- [x] Nếu `enabled-applets` format lạ thì skip, không sửa.
-- [x] Dry-run không sửa hệ thống.
-
----
-
-## 🧪 7. LỆNH TEST DỰ KIẾN
-
-```bash
-./tools/caramos-ota-testkit.sh compile
-./tools/caramos-ota-testkit.sh validate
-make ship
-```
-
-Trong VM:
-
-```bash
-cd /tmp/caramos-ota-e2e
-make test
-gsettings get org.cinnamon enabled-applets
-tail -n 200 ~/.xsession-errors
-```
-
-Kiểm tra không có:
-
-```text
-Failed to evaluate 'main' function on applet
-Could not create applet object
-Tried to construct an object without a GType
-```
-
----
-
-## 🧯 8. ROLLBACK PLAN
-
-Nếu applet gây lỗi, chỉ xoá riêng entry:
-
-```text
-caramos-control-center@caramos
-```
-
-Không reset toàn bộ layout.
-
-Có thể xoá applet files:
-
-```bash
-sudo rm -rf /usr/share/cinnamon/applets/caramos-control-center@caramos
-```
-
-Reload Cinnamon thủ công nếu cần:
-
-```bash
-nohup cinnamon --replace >/tmp/cinnamon-replace.log 2>&1 &
-```
-
----
-
-## 📝 9. SESSION LOG
-
-| Ngày | Nội dung | Trạng thái |
-| --- | --- | --- |
-| 2026-07-02 | Tạo tracker cho Control Center giống Ubuntu Quick Settings. | Planning |
-| 2026-07-02 | Scan CaramOS VM: panel cũ có `systray`, `network`, `sound`, `notifications`, `power`, `calendar`; backend có `pactl`, `nmcli`, `bluetoothctl`, `blueman-manager`, `upower`; không có `brightnessctl`, `powerprofilesctl`. | Done |
-| 2026-07-02 | Scan source Cinnamon applets: chọn `Cvc.MixerControl` cho volume/mic, Cinnamon Power DBus + `UPowerGlib` cho brightness/battery, `Gio.Settings` cho Night Light; Wi-Fi/VPN full submenu để phase sau. | Done |
-| 2026-07-03 | Stabilize applet v1: thêm guard thiếu backend, chuyển Wi-Fi/VPN/Bluetooth sang read-only/settings fallback, giảm màu cam trong style. | Done |
-| 2026-07-29 | Thêm NetworkManager/BlueZ state, async VPN, libnm Wi-Fi AP/actions, brightness capability gating, lifecycle cleanup và migration atomic/fail-closed. Reload pass trên Cinnamon 6.6.4; VM không có Wi-Fi/backlight hardware. | In Progress |
-| 2026-07-29 | Code freeze: Ethernet/multi-adapter details, UPower signal backend, audio mute/selectors, session capability/native confirmation, theme/a11y/focus, static tests. `node --check`, `git diff --check`, 13 unit/static tests và VM reload pass. | Code Complete |
-
----
-
-## 🚧 10. VIỆC CẦN LÀM NGAY TIẾP THEO
-
-Feature freeze. Chỉ test/fix:
-
-1. Chạy `compile`, `validate`, package content và full `.deb` lifecycle.
-2. Test hardware matrix: Wi-Fi/auth/captive portal, Bluetooth, laptop battery/backlight/UPS, audio hotplug.
-3. Test session cancel/inhibitor/logout/restart/shutdown; không tự kích hoạt destructive action trong smoke tự động.
-4. Test keyboard/screen reader/high-contrast/large text, bốn orientation, multi-monitor/HiDPI.
-5. Mọi lỗi mới ghi test/evidence rồi fix; không thêm feature P2/optional vào v1.0.13\.
From 45f95d794eb0e77bf3c3d08c5717ecd90db379e1 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:22:36 +0700
Subject: [PATCH 10/37] Restore
---
.../manifest.json | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
create mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json
new file mode 100644
index 0000000..65cd814
--- /dev/null
+++ b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/manifest.json
@@ -0,0 +1,19 @@
+{
+ "schema": 2,
+ "codename": "noble",
+ "channel": "stable",
+ "severity": "feature",
+ "size": "ota feature",
+ "title": "Thêm Trung tâm điều khiển CaramOS",
+ "summary": "Cài applet Control Center thử nghiệm để gom các thao tác nhanh ở góc phải panel.",
+ "release_notes_vi": [
+ "Thêm applet caramos-control-center@caramos cho Cinnamon panel.",
+ "Bật applet Control Center trên panel cho các user desktop đang có phiên đăng nhập.",
+ "Bỏ các applet mạng, âm thanh và pin mặc định đã được Control Center thay thế; giữ nguyên mọi applet khác và vị trí hiện có."
+ ],
+ "release_notes_en": [
+ "Add the caramos-control-center@caramos applet to the Cinnamon panel.",
+ "Enable Control Center for desktop users with an active session.",
+ "Remove stock network, sound, and power applets replaced by Control Center while preserving every other applet and its existing position."
+ ]
+}
From 49b3717c6d3688ccfba27fe85ba98133ce7b3e40 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:23:28 +0700
Subject: [PATCH 11/37] Restore
---
.../migration.py | 356 ++++++++++++++++++
1 file changed, 356 insertions(+)
create mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py
new file mode 100644
index 0000000..e107522
--- /dev/null
+++ b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/20260715090258_install_control_center/migration.py
@@ -0,0 +1,356 @@
+"""Timestamp migration for 1.0.13: install CaramOS Control Center applet."""
+
+from __future__ import annotations
+
+import ast
+import json
+import os
+import pwd
+import shutil
+import subprocess
+import tempfile
+from pathlib import Path
+
+from caramos_ota_update.context import MigrationContext
+
+DESCRIPTION = "Install CaramOS Control Center Cinnamon applet"
+
+APPLET_UUID = "caramos-control-center@caramos"
+REPLACED_APPLET_UUIDS = frozenset(
+ {
+ "network@cinnamon.org",
+ "sound@cinnamon.org",
+ "power@cinnamon.org",
+ }
+)
+SOURCE_APPLET_DIR = Path("/usr/share/caramos-ota/applets") / APPLET_UUID
+TARGET_APPLET_DIR = Path("/usr/share/cinnamon/applets") / APPLET_UUID
+REQUIRED_APPLET_FILES = ("applet.js", "metadata.json", "stylesheet.css")
+PANEL_DCONF_FILE = Path("/etc/dconf/db/local.d/01-caramos-task17-panel")
+CINNAMON_SECTION = "org/cinnamon"
+DEFAULT_ENABLED_APPLETS = (
+ "['panel1:left:0:Cinnamenu@json:0', "
+ "'panel1:center:0:grouped-window-list@cinnamon.org:1', "
+ "'panel1:right:0:systray@cinnamon.org:2', "
+ "'panel1:right:1:notifications@cinnamon.org:5', "
+ "'panel1:right:2:calendar@cinnamon.org:7', "
+ "'panel1:right:3:caramos-control-center@caramos:0']"
+)
+
+
+def _validate_applet(directory: Path) -> None:
+ if not directory.is_dir():
+ raise RuntimeError(f"applet source directory not found: {directory}")
+ if directory.is_symlink():
+ raise RuntimeError(f"applet source must not be a symlink: {directory}")
+
+ for name in REQUIRED_APPLET_FILES:
+ path = directory / name
+ if not path.is_file() or path.is_symlink():
+ raise RuntimeError(f"applet source requires regular file: {path}")
+
+ try:
+ metadata = json.loads((directory / "metadata.json").read_text(encoding="utf-8"))
+ except Exception as exc:
+ raise RuntimeError(f"cannot read applet metadata: {exc}") from exc
+ if not isinstance(metadata, dict) or metadata.get("uuid") != APPLET_UUID:
+ raise RuntimeError(f"applet metadata UUID must be {APPLET_UUID!r}")
+
+
+def _clear_directory(directory: Path) -> None:
+ for child in directory.iterdir():
+ if child.is_dir() and not child.is_symlink():
+ shutil.rmtree(child)
+ else:
+ child.unlink()
+
+
+def _copy_directory_contents(source: Path, target: Path) -> None:
+ target.mkdir(parents=True, exist_ok=True)
+ for child in source.iterdir():
+ destination = target / child.name
+ if child.is_dir() and not child.is_symlink():
+ shutil.copytree(child, destination)
+ else:
+ shutil.copy2(child, destination, follow_symlinks=False)
+
+
+def _install_applet(context: MigrationContext) -> None:
+ _validate_applet(SOURCE_APPLET_DIR)
+ TARGET_APPLET_DIR.parent.mkdir(parents=True, exist_ok=True)
+ if TARGET_APPLET_DIR.is_symlink():
+ raise RuntimeError(f"applet target must not be a symlink: {TARGET_APPLET_DIR}")
+ if TARGET_APPLET_DIR.exists() and not TARGET_APPLET_DIR.is_dir():
+ raise RuntimeError(f"applet target must be a directory: {TARGET_APPLET_DIR}")
+
+ staging_root = Path(tempfile.mkdtemp(prefix=f".{APPLET_UUID}.", dir=TARGET_APPLET_DIR.parent))
+ staging_dir = staging_root / APPLET_UUID
+ backup_dir = staging_root / "previous"
+ target_existed = TARGET_APPLET_DIR.exists()
+ try:
+ shutil.copytree(SOURCE_APPLET_DIR, staging_dir)
+ _validate_applet(staging_dir)
+ if target_existed:
+ shutil.copytree(TARGET_APPLET_DIR, backup_dir, symlinks=True)
+
+ TARGET_APPLET_DIR.mkdir(parents=True, exist_ok=True)
+ try:
+ _clear_directory(TARGET_APPLET_DIR)
+ _copy_directory_contents(staging_dir, TARGET_APPLET_DIR)
+ _validate_applet(TARGET_APPLET_DIR)
+ except Exception:
+ _clear_directory(TARGET_APPLET_DIR)
+ if target_existed:
+ _copy_directory_contents(backup_dir, TARGET_APPLET_DIR)
+ else:
+ TARGET_APPLET_DIR.rmdir()
+ raise
+ finally:
+ shutil.rmtree(staging_root, ignore_errors=True)
+
+ context.log(f"installed Cinnamon applet: {TARGET_APPLET_DIR}")
+
+
+def _user_environment(username: str, uid: int, home: Path) -> dict[str, str]:
+ env = os.environ.copy()
+ env.update(
+ {
+ "HOME": str(home),
+ "USER": username,
+ "LOGNAME": username,
+ }
+ )
+
+ runtime_dir = Path(f"/run/user/{uid}")
+ if runtime_dir.is_dir() and (runtime_dir / "bus").exists():
+ env.update(
+ {
+ "DISPLAY": os.environ.get("DISPLAY", ":0"),
+ "XAUTHORITY": str(home / ".Xauthority"),
+ "XDG_RUNTIME_DIR": str(runtime_dir),
+ "DBUS_SESSION_BUS_ADDRESS": f"unix:path={runtime_dir}/bus",
+ }
+ )
+ else:
+ env.pop("DBUS_SESSION_BUS_ADDRESS", None)
+
+ return env
+
+
+def _desktop_users() -> list[tuple[str, int, Path]]:
+ users: list[tuple[str, int, Path]] = []
+ for user_info in pwd.getpwall():
+ if user_info.pw_uid < 1000 or user_info.pw_dir in ("", "/nonexistent"):
+ continue
+ home = Path(user_info.pw_dir)
+ if not home.is_dir():
+ continue
+ users.append((user_info.pw_name, user_info.pw_uid, home))
+ return sorted(users, key=lambda item: item[1])
+
+
+def _run_gsettings(user: str, env: dict[str, str], args: list[str]) -> subprocess.CompletedProcess[str]:
+ command = ["runuser", "-u", user, "--"]
+ if "DBUS_SESSION_BUS_ADDRESS" not in env:
+ command.extend(["dbus-run-session", "--"])
+ command.extend(["gsettings", *args])
+ return subprocess.run(
+ command,
+ check=False,
+ capture_output=True,
+ text=True,
+ env=env,
+ )
+
+
+def _update_blueman_plugins(plugin_list: str) -> str | None:
+ """Disable only Blueman's tray icon while preserving all other plugins."""
+
+ value = plugin_list.strip()
+ if value.startswith("@as "):
+ value = value[4:].lstrip()
+ try:
+ parsed = ast.literal_eval(value)
+ except (SyntaxError, ValueError):
+ return None
+ if not isinstance(parsed, list) or any(not isinstance(entry, str) for entry in parsed):
+ return None
+ for plugin in ("ShowConnected", "StatusIcon"):
+ disabled = f"!{plugin}"
+ if disabled not in parsed:
+ parsed.append(disabled)
+ return f"[{', '.join(repr(entry) for entry in parsed)}]"
+
+
+def _update_enabled_applets(enabled_applets: str) -> str | None:
+ """Replace redundant stock indicators with Control Center atomically.
+
+ Existing entries keep their text, order, and position fields. Both the
+ four-field and five-field Cinnamon formats are accepted; unknown top-level
+ list formats are rejected without changing user settings.
+ """
+
+ value = enabled_applets.strip()
+ if not value.startswith("[") or not value.endswith("]"):
+ return None
+
+ try:
+ parsed = ast.literal_eval(value)
+ except (SyntaxError, ValueError):
+ return None
+ if not isinstance(parsed, list) or any(not isinstance(entry, str) for entry in parsed):
+ return None
+
+ inner = value[1:-1].strip()
+ if inner and not parsed:
+ return None
+
+ entries: list[str] = []
+ has_control_center = False
+ for entry in parsed:
+ parts = entry.split(":", 4)
+ uuid = parts[3] if len(parts) >= 4 else None
+ if uuid in REPLACED_APPLET_UUIDS:
+ continue
+ entries.append(entry)
+ if uuid == APPLET_UUID:
+ has_control_center = True
+
+ if not has_control_center:
+ positions = [
+ int(parts[2])
+ for entry in entries
+ for parts in [entry.split(":", 4)]
+ if len(parts) >= 4
+ and parts[0] == "panel1"
+ and parts[1] == "right"
+ and parts[2].isdigit()
+ ]
+ next_position = max(positions, default=-1) + 1
+ entries.append(f"panel1:right:{next_position}:{APPLET_UUID}:0")
+
+ quoted = [repr(entry) for entry in entries]
+ return f"[{', '.join(quoted)}]"
+
+
+def _updated_dconf_text(source: str) -> str:
+ """Update Control Center defaults while preserving unrelated config."""
+
+ lines = source.splitlines()
+ section_start = None
+ section_end = len(lines)
+ for index, line in enumerate(lines):
+ stripped = line.strip()
+ if stripped == f"[{CINNAMON_SECTION}]":
+ section_start = index
+ continue
+ if section_start is not None and index > section_start and stripped.startswith("[") and stripped.endswith("]"):
+ section_end = index
+ break
+
+ if section_start is None:
+ if lines and lines[-1].strip():
+ lines.append("")
+ lines.extend((f"[{CINNAMON_SECTION}]", f"enabled-applets={DEFAULT_ENABLED_APPLETS}"))
+ return "\n".join(lines) + "\n"
+
+ key_index = None
+ for index in range(section_start + 1, section_end):
+ if lines[index].strip().startswith("enabled-applets="):
+ key_index = index
+ break
+ if key_index is None:
+ lines.insert(section_end, f"enabled-applets={DEFAULT_ENABLED_APPLETS}")
+ return "\n".join(lines) + "\n"
+
+ current = lines[key_index].split("=", 1)[1].strip()
+ updated = _update_enabled_applets(current)
+ if updated is None:
+ raise RuntimeError(f"unexpected enabled-applets format in {PANEL_DCONF_FILE}")
+ lines[key_index] = f"enabled-applets={updated}"
+ return "\n".join(lines) + "\n"
+
+
+def _atomic_write_text(path: Path, content: str, mode: int) -> None:
+ path.parent.mkdir(parents=True, exist_ok=True)
+ descriptor, staging_name = tempfile.mkstemp(prefix=f".{path.name}.", dir=path.parent)
+ os.close(descriptor)
+ staging = Path(staging_name)
+ try:
+ staging.write_text(content, encoding="utf-8")
+ staging.chmod(mode)
+ os.replace(staging, path)
+ finally:
+ staging.unlink(missing_ok=True)
+
+
+def _update_system_defaults(context: MigrationContext) -> bool:
+ if PANEL_DCONF_FILE.is_symlink():
+ raise RuntimeError(f"dconf defaults must not be a symlink: {PANEL_DCONF_FILE}")
+ if PANEL_DCONF_FILE.exists() and not PANEL_DCONF_FILE.is_file():
+ raise RuntimeError(f"dconf defaults must be a regular file: {PANEL_DCONF_FILE}")
+ source = PANEL_DCONF_FILE.read_text(encoding="utf-8") if PANEL_DCONF_FILE.exists() else ""
+ updated = _updated_dconf_text(source)
+ if updated == source:
+ context.log("Control Center already enabled in system dconf defaults")
+ return False
+ context.log(f"enable Control Center in system dconf defaults: {PANEL_DCONF_FILE}")
+ if not context.dry_run:
+ mode = PANEL_DCONF_FILE.stat().st_mode & 0o777 if PANEL_DCONF_FILE.exists() else 0o644
+ _atomic_write_text(PANEL_DCONF_FILE, updated, mode)
+ return True
+
+
+def _apply_to_user(context: MigrationContext, username: str, uid: int, home: Path) -> None:
+ env = _user_environment(username, uid, home)
+
+ current = _run_gsettings(username, env, ["get", "org.cinnamon", "enabled-applets"])
+ if current.returncode != 0:
+ context.log(f"warning: could not read Cinnamon applets for {username}: {current.stderr.strip()}")
+ else:
+ updated_applets = _update_enabled_applets(current.stdout)
+ if updated_applets is None:
+ context.log(f"warning: unexpected enabled-applets format for {username}; skip Control Center panel update")
+ elif updated_applets == current.stdout.strip():
+ context.log(f"kept existing Control Center panel layout for user: {username}")
+ else:
+ result = _run_gsettings(username, env, ["set", "org.cinnamon", "enabled-applets", updated_applets])
+ if result.returncode == 0:
+ context.log(f"enabled Control Center and removed redundant network, sound, and power applets for: {username}")
+ else:
+ context.log(f"warning: could not update Control Center panel for {username}: {result.stderr.strip()}")
+
+ plugins = _run_gsettings(username, env, ["get", "org.blueman.general", "plugin-list"])
+ if plugins.returncode != 0:
+ context.log(f"warning: could not read Blueman plugins for {username}: {plugins.stderr.strip()}")
+ return
+ updated_plugins = _update_blueman_plugins(plugins.stdout)
+ if updated_plugins is None:
+ context.log(f"warning: unexpected Blueman plugin-list format for {username}; keep current plugins")
+ return
+ if updated_plugins == plugins.stdout.strip():
+ context.log(f"kept Blueman tray icon disabled for user: {username}")
+ return
+ result = _run_gsettings(username, env, ["set", "org.blueman.general", "plugin-list", updated_plugins])
+ if result.returncode == 0:
+ context.log(f"disabled redundant Blueman tray icon for user: {username}")
+ else:
+ context.log(f"warning: could not disable Blueman tray icon for {username}: {result.stderr.strip()}")
+
+
+def run(context: MigrationContext) -> None:
+ """Install and enable the CaramOS Control Center applet."""
+
+ if context.dry_run:
+ context.log(f"[dry-run] copy {SOURCE_APPLET_DIR} to {TARGET_APPLET_DIR}")
+ _update_system_defaults(context)
+ context.log("[dry-run] enable Control Center and remove redundant network, sound, and power applets for all desktop users")
+ return
+
+ _install_applet(context)
+ defaults_changed = _update_system_defaults(context)
+ if defaults_changed:
+ context.run_command(["dconf", "update"], allow_fail=True)
+
+ for username, uid, home in _desktop_users():
+ _apply_to_user(context, username, uid, home)
From c3d60891dbd62a8715dfa4a606d81c97e15b293c Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:25:25 +0700
Subject: [PATCH 12/37] Remove step in build strps
---
.github/workflows/build.yml | 11 -----------
1 file changed, 11 deletions(-)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 788e0ef..e64ad4d 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -39,17 +39,6 @@ jobs:
path: linuxmint-22.3-cinnamon-64bit.iso
key: mint-iso-22.3-cinnamon
- - name: Verify release tag matches source version
- if: startsWith(github.ref, 'refs/tags/v')
- run: |
- source scripts/config.sh
- TAG_VERSION="${GITHUB_REF_NAME#v}"
- echo "Source version: ${CARAMOS_VERSION}"
- echo "Tag version: ${TAG_VERSION}"
- if [ "${TAG_VERSION}" != "${CARAMOS_VERSION}" ]; then
- echo "::error::Release tag ${GITHUB_REF_NAME} does not match CARAMOS_VERSION=${CARAMOS_VERSION}"
- exit 1
- fi
- name: Build CaramOS ISO
run: |
From b959e852595bd58c90ca4b9bf48cd5f990bbef71 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:26:03 +0700
Subject: [PATCH 13/37] Delete unecessary files
---
README_EN.md | 265 ---------------------------------------------------
1 file changed, 265 deletions(-)
delete mode 100644 README_EN.md
diff --git a/README_EN.md b/README_EN.md
deleted file mode 100644
index 41183ad..0000000
--- a/README_EN.md
+++ /dev/null
@@ -1,265 +0,0 @@
-
-
-
-
-CaramOS
-
-
- Sweet & Simple Linux — A Linux distro made for Vietnamese users
-
-
-
- Caram = Carambola — the starfruit, whose 5 points mirror the star on Vietnam's flag, a fruit tied to every Vietnamese childhood
-
-
-
- Tiếng Việt · VNLF · Website
-
-
----
-
-### What is CaramOS?
-
-**CaramOS** is a Linux distribution based on **Linux Mint 22.3 Cinnamon**
-(Ubuntu 24.04 LTS), designed specifically for **Vietnamese users**. The project
-is still built as an **ISO remaster**, but starting with `1.0.11`, all
-post-release system changes are standardized through **CaramOS OTA**.
-
-> [!IMPORTANT]
-> **Current version:** `1.0.12` — **Open Beta**.
-> CaramOS has moved to an OTA update model. If you are currently running
-> CaramOS `1.0.1`, install the Update Center with:
->
-> ```bash
-> curl -fsSL https://caramos.vietnamlinuxfamily.net/install-caramos-ota.sh | sudo bash
-> ```
->
-> After installation, open **CaramOS Update Center** from the Start Menu to
-> upgrade your system to the latest version.
-
-> [!NOTE]
-> For developers/contributors: from now on, do not implement system changes
-> directly in `config/hooks/live/` if those changes must reach already-installed
-> user machines. Write migrations in `packages/caramos-ota` instead. See the OTA
-> development guide: [packages/caramos-ota/README.md](packages/caramos-ota/README.md).
-
-Our mission is to make Linux easier for Vietnamese users moving from Windows:
-familiar desktop defaults, Vietnamese input ready out of the box, a browser,
-office tools, and practical daily-use utilities.
-
-### Key Features
-
-| Feature | Description |
-|---|---|
-| **Linux Mint 22.3 base** | Stable Ubuntu 24.04 LTS foundation with the familiar Cinnamon desktop |
-| **CaramOS branding** | Customized boot menu, Plymouth, logo, wallpaper, panel and theme |
-| **Vietnamese-first defaults** | Vietnamese locale, Asia/Ho_Chi_Minh timezone and Be Vietnam Pro fonts |
-| **Vietnamese input** | Fcitx5 + Lotus installed and configured by default |
-| **Google Chrome** | Popular browser included out of the box |
-| **WPS Office** | Office suite friendly to users migrating from Windows |
-| **Zalo** | Zalo AppImage included with a desktop shortcut |
-| **Cinnamon Delight + Tela/Bibata** | Modern theme, icons and cursor with a clean desktop experience |
-| **Neofetch/Fastfetch identity** | CaramOS ASCII logo and synchronized OS identity/version metadata |
-| **OTA updates** | `caramos-ota` delivers post-ISO updates through reviewed version migrations |
-| **Flexible builds** | Fast dev builds with `lz4`, smaller release builds with `xz`, Docker supported |
-
-
-
-
-
-### CaramOS Experience
-
-From boot menu to desktop, CaramOS is consistently branded to feel friendly,
-modern, and ready for Vietnamese users out of the box.
-
-| Step | Screenshot |
-|---|---|
-| **1. GRUB boot menu**
Select the live session or start the installer. | |
-| **2. Startup loading**
Customized Plymouth startup branding. | |
-| **3. Desktop**
Cinnamon desktop with CaramOS theme, icons, panel, and wallpaper. | |
-| **4. Neofetch**
CaramOS system identity shown directly in the terminal. | |
-
-### Installation
-
-1. Download ISO from [caramos.vietnamlinuxfamily.net](https://caramos.vietnamlinuxfamily.net)
-2. Flash to USB with [Balena Etcher](https://etcher.balena.io) or `dd`
-3. Boot from USB, follow the installer
-
-### OTA Updates
-
-CaramOS has moved to an **OTA-first** model. New ISO images are still released,
-but machines installed from older ISOs do not need to reinstall: users install
-`caramos-ota`, then Update Center/OTA upgrades the system to the latest version
-through a reviewed migration chain.
-
-Users currently on CaramOS `1.0.1` should run:
-
-```bash
-curl -fsSL https://caramos.vietnamlinuxfamily.net/install-caramos-ota.sh | sudo bash
-```
-
-```text
-systemd timer
- └── caramos-ota --check
- ├── updates the caramos-ota package when the repository has a newer build
- ├── resolves the migration chain
- └── writes /var/lib/caramos-ota/state.json
-
-Update Center
- └── user confirms the update
- └── pkexec caramos-ota --upgrade --yes
- └── caramos-ota-update runs each migration
-```
-
-Important rules:
-
-- The timer checks/prepares state; it does not open the GUI or apply migrations.
-- Migrations run only after user confirmation or an explicit admin CLI command.
-- System-changing logic lives in `packages/caramos-ota`, not in build hooks.
-- Developers adding post-release changes must write versioned OTA migrations.
-- ISO builds use the same OTA migration chain to bring the rootfs to latest.
-
-See [packages/caramos-ota/README.md](packages/caramos-ota/README.md) for the OTA
-architecture and developer workflow.
-
-### Tech Stack
-
-| Component | Technology / current role |
-|---|---|
-| **Base ISO** | Linux Mint 22.3 Cinnamon 64-bit |
-| **Ubuntu base** | Ubuntu 24.04 LTS / noble |
-| **Desktop** | Cinnamon + LightDM from the Linux Mint base |
-| **Build method** | ISO remaster: extract → customize → OTA bootstrap → repack |
-| **Build scripts** | Bash + Makefile, split into modules under `scripts/` |
-| **OTA model** | `caramos-ota` version migration-driven OTA |
-| **Migration runner** | `caramos-ota-update` runs unapplied timestamp migrations using the ledger |
-| **Update Center** | `caramos-ota-notifier` + `pkexec caramos-ota --upgrade --yes` |
-| **Developer workflow** | Post-release system changes go into `packages/caramos-ota` migrations |
-| **Legacy hooks** | `config/hooks/live/` is for bootstrap/build-time foundations, not new OTA features |
-| **Overlay** | `config/includes.chroot/` stores base files copied into the ISO/rootfs |
-| **Dev compression** | SquashFS `lz4` |
-| **Release compression** | SquashFS `xz` |
-| **Theme / Icons / Cursor** | Cinnamon Delight, Tela Circle/Cinnamon Delight Icons, Bibata |
-| **Font / Input Method** | Be Vietnam Pro, Fcitx5 + Lotus |
-| **Popular apps** | Google Chrome, WPS Office, Zalo AppImage |
-
-### Build ISO
-
-When building an ISO, CaramOS does not only copy overlays/hooks and repack the
-image. The build flow automatically builds the `caramos-ota` package, installs
-it into the rootfs, and runs the full OTA migration chain from
-`CARAMOS_MIGRATION_BASE_VERSION` to the latest version before repacking.
-
-In short: **the ISO is built as the latest state**, while OTA is the upgrade path
-for users already installed from older ISOs.
-
-Install build dependencies on Ubuntu/Mint/Debian:
-
-```bash
-sudo apt update
-sudo apt install squashfs-tools xorriso rsync wget curl isolinux syslinux-common syslinux-utils
-```
-
-Run a dev build:
-
-```bash
-make build
-```
-
-Run a release build:
-
-```bash
-make release VERSION=x.y.z
-```
-
-Build from an existing Mint ISO:
-
-```bash
-make build ISO=linuxmint-22.3-cinnamon-64bit.iso
-```
-
-During `customize`, the build runs:
-
-```text
-extract base ISO
- → install packages + overlay + build-time hooks
- → build/install bundled caramos-ota
- → caramos-ota-update --from "$CARAMOS_MIGRATION_BASE_VERSION" --target latest
- → repack squashfs + ISO
-```
-
-Common `make` targets:
-
-| Command | Purpose |
-|---|---|
-| `make build` | Full dev build with fast `lz4` compression |
-| `make release VERSION=x.y.z` | Release build with smaller but slower `xz` compression |
-| `make prepare` | Extract the ISO/rootfs into `build/` for fast iteration |
-| `make customize-only` | Run package installation, overlay copy, and chroot hooks |
-| `make boot-only` | Apply only boot menu, GRUB, and Plymouth branding |
-| `make overlay` | Copy only `config/includes.chroot` into the rootfs |
-| `make quick` | Prepare if needed, overlay, then repack squashfs and ISO |
-| `make repack` | Repack squashfs and ISO from the existing work tree |
-| `make iso-only` | Recreate only the ISO from `build/custom` |
-| `make shell` | Enter the `build/squashfs` chroot for manual debugging |
-| `make debug-iso` | Print boot menu/Plymouth diagnostics |
-| `make clean` | Remove build/cache/output ISO artifacts |
-| `make docker-build` | Run a dev build inside Docker |
-| `make docker-release` | Run a release build inside Docker |
-
-Fast iteration after the first build/prepare:
-
-- If you changed bootstrap ISO files such as wallpaper, assets or base overlay:
- run `make overlay` then `make quick`.
-- If you changed OTA packages/migrations: build/test under
- [packages/caramos-ota](packages/caramos-ota/) first, then run
- `make customize-only` or rebuild the ISO so OTA bootstrap applies the
- migrations into the rootfs.
-- Do not add new user-facing updates to hooks just to reach already-installed
- machines; write an OTA migration.
-
-```bash
-make customize-only
-make quick
-```
-
-### Contributing
-
-We welcome contributions! See [CONTRIBUTING_EN.md](CONTRIBUTING_EN.md) for the
-OTA-first contribution workflow.
-
-**You can help with:**
-- Bug reports and feature suggestions via [Issues](https://github.com/VN-Linux-Family/CaramOS/issues)
-- Wallpaper, icon, theme, and branding design
-- Testing ISO and OTA updates on different hardware or VM snapshots
-- Documentation and translations
-- Writing safe OTA migrations, package changes, build scripts, and base overlays
-
-### Contributors
-
-Thanks to everyone who has contributed to CaramOS on GitHub.
-
-
-
-
-
-
-
-### License
-
-CaramOS is open-source software licensed under [GPL-3.0](LICENSE).
-
-### Acknowledgments
-
-- [Linux Mint](https://linuxmint.com/) — Outstanding base distribution
-- [Ubuntu](https://ubuntu.com/) — Stable LTS foundation through Linux Mint
-- [VNLF (Vietnam Linux Family)](https://vietnamlinuxfamily.net) — Vietnamese Linux community
-- [vinceliuice](https://github.com/vinceliuice) — Tela icons and Linux desktop theming ecosystem
-- Fcitx5 and Lotus contributors — Vietnamese input method support
-
----
-
-
- CaramOS — Sweet & Simple Linux
- Made with love by Vietnam Linux Family
-
From 44b195b72ed3a4c4be157a27ef1355751711a1ad Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 16:26:34 +0700
Subject: [PATCH 14/37] Delete CaramOS Project Finalization.md
---
CaramOS Project Finalization.md | 3359 -------------------------------
1 file changed, 3359 deletions(-)
delete mode 100644 CaramOS Project Finalization.md
diff --git a/CaramOS Project Finalization.md b/CaramOS Project Finalization.md
deleted file mode 100644
index 7927e71..0000000
--- a/CaramOS Project Finalization.md
+++ /dev/null
@@ -1,3359 +0,0 @@
-# Chat Conversation
-
-Note: _This is purely the output of the chat conversation and does not contain any raw data, codebase snippets, etc. used to generate the output._
-
-### User Input
-
-vì sao hiện tại có nhiều loại linux như vậy
-
-### Planner Response
-
-Đây là một câu hỏi rất hay! Có nhiều bản phân phối Linux (distro) như vậy vì một số lý do chính:
-
-## 1. **Linux là mã nguồn mở (Open Source)**
-Bất kỳ ai cũng có thể lấy mã nguồn của **Linux kernel** (nhân Linux) về, chỉnh sửa, thêm phần mềm, và tạo ra một bản phân phối riêng. Đây là quyền được bảo đảm bởi giấy phép **GPL (GNU General Public License)**.
-
-## 2. **Linux chỉ là nhân (kernel), không phải hệ điều hành hoàn chỉnh**
-Bản thân Linux chỉ là **kernel** — phần lõi quản lý phần cứng. Để thành một hệ điều hành dùng được, cần thêm:
-- Shell (bash, zsh…)
-- Trình quản lý gói (apt, dnf, pacman…)
-- Desktop Environment (GNOME, KDE, XFCE…)
-- Các phần mềm ứng dụng
-
-→ Mỗi tổ chức/cộng đồng chọn **tổ hợp khác nhau** → ra đời các distro khác nhau.
-
-## 3. **Mục đích sử dụng khác nhau**
-
-| Mục đích | Ví dụ distro |
-|---|---|
-| 🖥️ Người dùng phổ thông | Ubuntu, Linux Mint, Zorin OS |
-| 🏢 Doanh nghiệp / Server | Red Hat (RHEL), SUSE, Rocky Linux |
-| 🔒 Bảo mật / Pentest | Kali Linux, Parrot OS |
-| 📦 Nhẹ, máy cũ | Lubuntu, Puppy Linux, Tiny Core |
-| 🎓 Học tập / Tùy biến sâu | Arch Linux, Gentoo, LFS |
-| 🎮 Gaming | SteamOS (dựa trên Arch) |
-| 📱 Di động | Android (dùng Linux kernel!) |
-| 🖧 Embedded / IoT | OpenWrt, Yocto |
-
-## 4. **Triết lý và cộng đồng khác nhau**
-- **Debian**: ổn định, tự do phần mềm tuyệt đối
-- **Fedora**: công nghệ mới nhất, do Red Hat tài trợ
-- **Arch**: đơn giản, rolling release, người dùng tự xây dựng
-- **Ubuntu**: dễ dùng, hướng đến số đông
-
-Mỗi cộng đồng có **triết lý riêng** về cách một hệ điều hành nên hoạt động.
-
-## 5. **Cây phả hệ distro**
-
-Hầu hết các distro đều phát sinh từ vài "gốc" chính:
-
-```
-Linux Kernel
-├── Debian ──→ Ubuntu ──→ Linux Mint, Pop!_OS, Zorin OS
-├── Red Hat ──→ Fedora ──→ CentOS, Rocky Linux, AlmaLinux
-├── Slackware ──→ openSUSE
-├── Arch ──→ Manjaro, EndeavourOS, SteamOS
-├── Gentoo ──→ ChromeOS (một phần)
-└── Independent: NixOS, Void Linux, Alpine
-```
-
-## 6. **Tóm lại**
-
-> Nhiều distro Linux tồn tại vì **tự do phần mềm cho phép**, **nhu cầu đa dạng đòi hỏi**, và **cộng đồng khác nhau mong muốn** những thứ khác nhau. Đây không phải nhược điểm — mà là **sức mạnh** của hệ sinh thái Linux: luôn có một distro phù hợp cho mọi nhu cầu. 🐧
-
-Bạn có muốn tìm hiểu thêm về distro nào cụ thể không?
-
-### User Input
-
-mình muốn dựng 1 bản linux cho người Việt, kiểu phổ thông hoá việc sử dụng linux thì thế nào, do hiện tại các người dùng windows toàn là dùng app crack
-
-### Planner Response
-
-Đây là một ý tưởng rất có giá trị và thực tế! Mình phân tích chi tiết cho bạn:
-
-## 🎯 Vấn đề cốt lõi
-
-Người dùng Windows ở Việt Nam dùng crack vì:
-1. **Bản quyền đắt** (Office 365 ~1.3tr/năm, Windows ~3-4tr)
-2. **Thói quen** — quen giao diện Windows từ nhỏ
-3. **Phần mềm chuyên ngành** chỉ có trên Windows
-4. **Không biết có lựa chọn khác** hợp pháp và miễn phí
-
-→ Linux giải quyết được điểm 1 và 4, nhưng cần giải quyết điểm 2 và 3.
-
----
-
-## 🛠️ Chiến lược xây dựng "Linux cho người Việt"
-
-### Cách 1: **Tùy biến từ distro có sẵn** (Khuyến nghị)
-
-Không cần xây từ đầu. Lấy một base distro tốt rồi Việt hoá + customize:
-
-| Base distro | Ưu điểm | Nhược điểm |
-|---|---|---|
-| **Linux Mint** | Giao diện giống Windows nhất, ổn định | Dựa trên Ubuntu LTS, hơi cũ |
-| **Zorin OS** | Đẹp, chuyển đổi layout như Windows/macOS | Bản Pro mất phí |
-| **Ubuntu** | Cộng đồng lớn nhất, nhiều tài liệu tiếng Việt | GNOME nặng hơn |
-| **Fedora** | Công nghệ mới, ổn định | Ít thân thiện người mới |
-
-> **Gợi ý tốt nhất**: Dùng **Linux Mint** hoặc **Ubuntu** làm base.
-
-### Cách 2: **Remix/Spin** (cách các nước khác đã làm)
-
-Nhiều nước đã làm tương tự:
-- 🇨🇳 **Deepin** (Trung Quốc) — UI cực đẹp, dựa trên Debian
-- 🇰🇷 **HamoniKR** (Hàn Quốc) — dựa trên Linux Mint
-- 🇮🇳 **BOSS Linux** (Ấn Độ) — chính phủ tài trợ
-- 🇹🇷 **Pardus** (Thổ Nhĩ Kỳ) — dùng trong cơ quan nhà nước
-
----
-
-## 📋 Những gì cần làm cụ thể
-
-### 1. **Việt hoá toàn diện**
-- Giao diện 100% tiếng Việt ngay từ cài đặt
-- **Bộ gõ tiếng Việt** (fcitx5-lotus) cài sẵn, hoạt động ngay
-- Font chữ Việt đẹp mặc định (Google Noto, Be Vietnam Pro)
-- Hướng dẫn sử dụng bằng tiếng Việt tích hợp sẵn
-
-### 2. **Cài sẵn phần mềm thay thế**
-
-| Nhu cầu | Windows (crack) | Linux (miễn phí, hợp pháp) |
-|---|---|---|
-| Soạn thảo văn bản | MS Office | **LibreOffice** (hoặc OnlyOffice) |
-| Duyệt web | Chrome | **Firefox / Chrome** |
-| Xem phim | KMPlayer | **VLC** |
-| Chỉnh ảnh | Photoshop | **GIMP** / **Krita** |
-| Chat | Zalo | **Zalo Web** (PWA) hoặc Wine |
-| Gọi video | Zoom | **Zoom** (có bản Linux) |
-| Đọc PDF | Foxit | **Evince / Okular** |
-| Nén file | WinRAR | **File Roller** (tích hợp sẵn) |
-| Kế toán | MISA | ⚠️ Chưa có — đây là rào cản lớn |
-
-### 3. **Giao diện thân thiện**
-- Desktop layout giống Windows (taskbar dưới, Start menu trái)
-- **Không dùng terminal** trong mọi thao tác cơ bản
-- App Store đồ hoạ (Software Center) để cài thêm phần mềm
-- Tích hợp sẵn công cụ backup, cập nhật dễ dùng
-
-### 4. **Giải quyết "pain points" đặc thù Việt Nam**
-- 🏦 **Internet Banking**: Hầu hết ngân hàng VN dùng web → OK trên Linux
-- 💬 **Zalo**: Chạy qua Zalo Web PWA hoặc Wine
-- 🖨️ **Máy in**: Driver máy in phổ biến (Canon, HP, Epson) cài sẵn
-- 🎮 **Gaming**: Steam + Proton hỗ trợ khá nhiều game rồi
-- 📝 **Kê khai thuế**: Phần mềm HTKK của Tổng cục Thuế chỉ chạy trên Windows → cần Wine hoặc VM
-
----
-
-## ⚠️ Thách thức thực tế
-
-### Rào cản lớn nhất:
-1. **Phần mềm kê khai thuế (HTKK)** — bắt buộc cho doanh nghiệp, chỉ có Windows
-2. **MISA / phần mềm kế toán** — chưa có bản Linux
-3. **Zalo desktop** — chưa có bản Linux chính thức
-4. **Một số phần mềm ngân hàng** yêu cầu plugin ActiveX (IE only)
-5. **Game online Việt Nam** — hầu hết chỉ chạy trên Windows
-
-### Giải pháp trung gian:
-- Tích hợp sẵn **Wine** hoặc **Bottles** để chạy app Windows
-- Cài sẵn **VirtualBox** với image Windows nhẹ cho các app bắt buộc
-- Hướng dẫn dual-boot dễ hiểu
-
----
-
-## 🚀 Lộ trình gợi ý
-
-```
-Phase 1: MVP (2-3 tháng)
-├── Chọn base: Linux Mint Cinnamon
-├── Việt hoá giao diện + bộ gõ
-├── Cài sẵn phần mềm thay thế
-├── Tạo ISO cài đặt
-└── Thử nghiệm với nhóm nhỏ
-
-Phase 2: Cộng đồng (3-6 tháng)
-├── Website + diễn đàn hỗ trợ tiếng Việt
-├── Video hướng dẫn YouTube
-├── Tài liệu chuyển đổi từ Windows
-└── Thu thập feedback
-
-Phase 3: Mở rộng (6-12 tháng)
-├── Giải quyết pain points (Zalo, HTKK...)
-├── Hợp tác với cộng đồng Linux VN (VNLF, VFOSSA)
-├── Tiếp cận trường học, cơ quan nhà nước
-└── Xây dựng đội ngũ maintainer
-```
-
----
-
-## 💡 Công cụ để bắt đầu
-
-- **Linux Mint Debian Edition (LMDE)** hoặc **Ubuntu** làm base
-- **Cubic** — tool tạo custom Ubuntu ISO (GUI, dễ dùng)
-- **Linux Live Kit** — tạo Live USB từ hệ thống đang chạy
-- **Calamares** — installer đẹp, dễ tùy biến
-
----
-
-## Tóm lại
-
-> Xây một "Linux cho người Việt" hoàn toàn khả thi bằng cách **remix từ Linux Mint/Ubuntu**, tập trung vào **Việt hoá + cài sẵn phần mềm + giao diện quen thuộc**. Rào cản lớn nhất không phải kỹ thuật mà là **hệ sinh thái phần mềm đặc thù VN** (HTKK, Zalo, MISA). Giải pháp là dùng Wine/VM làm cầu nối trong giai đoạn chuyển đổi.
-
-Bạn muốn mình đi sâu vào phần nào? Ví dụ:
-1. **Hướng dẫn tạo custom ISO** từ Linux Mint?
-2. **Thiết kế giao diện/branding** cho distro?
-3. **Lập kế hoạch chi tiết** hơn cho dự án?
-
-### User Input
-
-tôi có sẵn VNLF rồi
-
-### Planner Response
-
-Tuyệt vời! Bạn đã có **VNLF (Vietnam Linux Family)** — vậy là đã có sẵn **cộng đồng và thương hiệu**, đây là lợi thế cực lớn mà nhiều dự án distro khác không có.
-
-## Với VNLF, bạn có thể ra mắt "VNLF Linux" hoặc "VNLF OS"
-
-### 🔥 Lợi thế sẵn có:
-- ✅ **Cộng đồng** — đã có người dùng, có kênh truyền thông
-- ✅ **Thương hiệu** — VNLF đã được biết đến trong giới Linux VN
-- ✅ **Kinh nghiệm** — team đã hiểu người dùng Linux Việt cần gì
-- ✅ **Nội dung** — đã có tài liệu, fun facts, sự kiện để quảng bá
-
-### 🎯 Hướng đi cụ thể cho VNLF OS:
-
-**Concept**: Một bản **Linux Mint Remix** (hoặc Ubuntu Remix) mang thương hiệu VNLF, tối ưu cho người Việt chuyển từ Windows sang.
-
-**Tên gợi ý**:
-- **VNLF OS** — đơn giản, dễ nhớ
-- **Sen Linux** — biểu tượng hoa sen Việt Nam 🪷
-- **Lạc Linux** — từ Lạc Việt
-
-**Những gì cần tùy biến**:
-
-```
-VNLF OS = Linux Mint (base)
- + Branding VNLF (wallpaper, logo, boot splash, icon)
- + Lotus cài sẵn, bật sẵn
- + Font tiếng Việt đẹp mặc định
- + LibreOffice tiếng Việt
- + Zalo Web PWA pinned sẵn
- + Wine/Bottles cài sẵn
- + Welcome App hướng dẫn người mới (tiếng Việt)
- + Repo/PPA riêng của VNLF (nếu cần)
-```
-
-### 📦 Quy trình tạo ISO cụ thể:
-
-```bash
-# Cách 1: Dùng Cubic (GUI, dễ nhất)
-sudo apt install cubic
-# → Mở Cubic, chọn ISO gốc Linux Mint
-# → Chỉnh sửa trong chroot environment
-# → Xuất ISO mới
-
-# Cách 2: Dùng Linux Live Kit
-# → Cài Linux Mint lên máy/VM, tùy biến xong
-# → Chạy Linux Live Kit để đóng gói thành ISO
-
-# Cách 3: Dùng Linux Mint Build System (chuyên nghiệp hơn)
-# → Fork repo mint-iso trên GitHub
-# → Tùy biến build scripts
-```
-
-### 📣 Chiến lược phổ biến qua VNLF:
-
-1. **"Thử trước, không cần cài"** — Tạo Live USB, người dùng boot thử mà không ảnh hưởng Windows
-2. **"Cài song song"** — Hướng dẫn dual-boot chi tiết bằng tiếng Việt
-3. **"Máy cũ hồi sinh"** — Target máy tính cũ, chạy Windows chậm → cài VNLF OS nhanh hơn
-4. **Workshop tại sự kiện VNLF** — Hướng dẫn cài trực tiếp
-5. **Video YouTube** — Series "Chuyển từ Windows sang VNLF OS"
-
-### 🏫 Target audience ưu tiên:
-
-| Nhóm | Lý do |
-|---|---|
-| **Sinh viên** | Không có tiền mua bản quyền, cần Office + coding |
-| **Quán net/cà phê** | Tiết kiệm chi phí license |
-| **Cơ quan nhà nước nhỏ** | Chính sách khuyến khích PMTDNM |
-| **Người dùng máy cũ** | Windows 11 không hỗ trợ máy cũ |
-| **Dev/IT** | Đã quen Linux, cần bản Việt hoá tốt |
-
----
-
-Bạn muốn mình giúp phần nào trước? Ví dụ:
-1. **Tạo bản custom ISO** đầu tiên?
-2. **Thiết kế branding** (wallpaper, logo, boot splash) cho VNLF OS trên Figma?
-3. **Viết Welcome App** hướng dẫn người mới?
-4. **Lập project plan chi tiết** để trình bày với cộng đồng VNLF?
-
-### User Input
-
-khái niệm remix trong linux là gì
-
-### Planner Response
-
-## "Remix" trong Linux là gì?
-
-**Remix** là một bản phân phối Linux được **tạo ra từ một distro gốc** (base distro), với các thay đổi về giao diện, phần mềm cài sẵn, cấu hình mặc định — nhưng **vẫn dùng chung hệ thống gói và kho phần mềm (repo)** của distro gốc.
-
-### Hình dung đơn giản:
-
-```
-🏠 Distro gốc = Căn nhà thô (nền móng, kết cấu, hệ thống điện nước)
-🎨 Remix = Căn nhà đã trang trí (sơn tường, nội thất, bố trí khác)
- → Cùng nền móng, nhưng trải nghiệm khác
-```
-
-### So sánh các cấp độ tùy biến:
-
-| Cấp độ | Tên gọi | Thay đổi gì | Ví dụ |
-|---|---|---|---|
-| **1. Cấu hình** | Customization | Đổi hình nền, theme, font | Bạn tự chỉnh máy mình |
-| **2. Remix** | Remix / Spin | Đổi bộ phần mềm mặc định, branding, cấu hình sẵn. **Vẫn dùng repo gốc** | Ubuntu Cinnamon Remix, Kubuntu |
-| **3. Derivative** | Dẫn xuất | Có thể thêm repo riêng, patch riêng, **vẫn tương thích** base | Linux Mint (dựa trên Ubuntu) |
-| **4. Fork** | Nhánh rẽ | Tách hẳn, **phát triển độc lập**, có thể không tương thích ngược | Devuan (fork Debian, bỏ systemd) |
-
-### Remix **giữ nguyên**:
-- ✅ Kernel của distro gốc
-- ✅ Kho phần mềm (repository) gốc
-- ✅ Trình quản lý gói (apt, dnf...)
-- ✅ Chu kỳ cập nhật của distro gốc
-
-### Remix **thay đổi**:
-- 🎨 Branding (tên, logo, wallpaper, boot splash)
-- 📦 Bộ phần mềm cài sẵn mặc định
-- 🖥️ Desktop Environment (ví dụ: đổi GNOME → KDE)
-- ⚙️ Cấu hình mặc định (ngôn ngữ, bộ gõ, theme...)
-- 📖 Tài liệu hướng dẫn riêng
-
-### Ví dụ thực tế:
-
-```
-Ubuntu (gốc)
-├── Kubuntu (Remix: đổi GNOME → KDE)
-├── Xubuntu (Remix: đổi GNOME → XFCE)
-├── Lubuntu (Remix: đổi GNOME → LXQt, nhẹ hơn)
-├── Ubuntu Studio (Remix: thêm phần mềm sáng tạo)
-├── Ubuntu Kylin (Remix: Việt hoá cho Trung Quốc)
-└── VNLF OS 🇻🇳 (Remix: Việt hoá cho Việt Nam ← cái bạn muốn làm!)
-```
-
-### Tại sao nên làm Remix thay vì Fork?
-
-| | Remix | Fork |
-|---|---|---|
-| **Độ khó** | ⭐ Thấp | ⭐⭐⭐⭐⭐ Rất cao |
-| **Bảo trì** | Dễ — cập nhật theo base | Khó — phải tự maintain mọi thứ |
-| **Bảo mật** | Nhận patch từ base tự động | Phải tự vá |
-| **Đội ngũ cần** | 2-5 người | 20+ người |
-| **Thời gian ra MVP** | 1-3 tháng | 1-2 năm |
-
----
-
-### 👉 Với VNLF:
-
-Làm **Remix** từ Linux Mint hoặc Ubuntu là lựa chọn **thông minh nhất**:
-- Nhanh ra sản phẩm
-- Ít nguồn lực bảo trì
-- Người dùng vẫn được hưởng toàn bộ hệ sinh thái Ubuntu/Mint
-- Tập trung vào **giá trị riêng**: Việt hoá + trải nghiệm người Việt
-
-Khi cộng đồng đủ lớn, có thể nâng lên **Derivative** (thêm repo riêng của VNLF với các package đặc thù).
-
-### User Input
-
-rồi, tôi có vietnamlinuxfamily.net, giờ tôi muốn lập 1 team viết các phần mềm cho linux lên vietnamlinuxfamily.net, tôi muốn đặt subdomain cho nó thì đặt là gì cho hợp lý
-store.vietnamlinuxfamily.net hay exploer.vietnamlinuxfamily.net hay gì khác
-
-### Planner Response
-
-Hay lắm! Đây là câu hỏi quan trọng vì subdomain nên **rõ nghĩa, dễ nhớ, và chuyên nghiệp**. Phân tích cho bạn:
-
-## So sánh các lựa chọn
-
-| Subdomain | Ý nghĩa | Nhận xét |
-|---|---|---|
-| `store.vnlf.net` | Cửa hàng | ❌ Gợi liên tưởng "mua bán", không phù hợp với FOSS miễn phí |
-| `explore.vnlf.net` | Khám phá | ⚠️ Mơ hồ, không rõ là phần mềm hay nội dung blog |
-| **`apps.vnlf.net`** | Ứng dụng | ✅ **Rõ ràng nhất** — ai cũng hiểu ngay là nơi tìm phần mềm |
-| `software.vnlf.net` | Phần mềm | ✅ Rõ nghĩa nhưng dài hơn |
-| `hub.vnlf.net` | Trung tâm | ⚠️ Hơi chung chung |
-| `lab.vnlf.net` | Phòng thí nghiệm | ⚠️ Gợi ý thử nghiệm, chưa ổn định |
-| `dev.vnlf.net` | Phát triển | ❌ Nghe như dành cho dev, không phải end user |
-
-## 🏆 Khuyến nghị: **`apps.vietnamlinuxfamily.net`**
-
-Lý do:
-1. **Ngắn gọn, dễ nhớ** — chỉ 4 ký tự
-2. **Ai cũng hiểu** — quen thuộc từ App Store, Google Play
-3. **Không gợi ý "mua bán"** — phù hợp phần mềm miễn phí/mã nguồn mở
-4. **Chuẩn ngành** — nhiều tổ chức lớn dùng:
- - `apps.gnome.org` (GNOME)
- - `apps.kde.org` (KDE)
- - `apps.apple.com` (Apple)
- - `apps.microsoft.com` (Microsoft)
-
-## Mở rộng thêm — Hệ thống subdomain cho VNLF:
-
-```
-vietnamlinuxfamily.net ← Trang chủ, giới thiệu cộng đồng
-├── apps.vnlf.net ← 🆕 Kho phần mềm do VNLF phát triển
-├── docs.vnlf.net ← Tài liệu, hướng dẫn tiếng Việt
-├── forum.vnlf.net ← Diễn đàn hỏi đáp
-├── os.vnlf.net ← Trang tải VNLF OS (distro remix)
-├── blog.vnlf.net ← Bài viết, tin tức
-└── git.vnlf.net ← Gitea/Forgejo self-hosted (nếu cần)
-```
-
-## Về "team viết phần mềm"
-
-Nếu đây là team **phát triển** phần mềm (source code, issue tracking...), bạn cần thêm:
-
-| Mục đích | Giải pháp |
-|---|---|
-| **Quản lý source code** | GitHub org `github.com/vnlf` hoặc self-host `git.vnlf.net` (Gitea/Forgejo) |
-| **Showcase cho user** | `apps.vietnamlinuxfamily.net` — trang web giới thiệu + link tải |
-| **Phân phối package** | PPA (Ubuntu) hoặc Flatpak repo riêng |
-
-→ **`apps.*`** là mặt tiền cho người dùng, còn source code nên để trên GitHub/Gitea riêng.
-
----
-
-Bạn muốn mình giúp **dựng trang `apps.vietnamlinuxfamily.net`** luôn không? Có thể làm một landing page giới thiệu các phần mềm mà VNLF team phát triển.
-
-### User Input
-
-denuvo, kernel level anticheat, drm
-mấy cái này là gì
-
-### Planner Response
-
-Ba khái niệm này đều liên quan đến **bảo vệ phần mềm/game**, và cũng là **rào cản lớn nhất** khi chơi game trên Linux. Giải thích từng cái:
-
----
-
-## 1. 🔒 DRM (Digital Rights Management)
-
-**DRM = Quản lý bản quyền số** — công nghệ **chống sao chép, crack** phần mềm/game/nhạc/phim.
-
-```
-Bạn mua game → DRM kiểm tra "bạn có quyền chạy không?" → Cho phép/Từ chối
-```
-
-**Ví dụ DRM phổ biến:**
-
-| DRM | Dùng ở đâu | Trên Linux? |
-|---|---|---|
-| **Steam DRM** | Game Steam | ✅ Chạy tốt qua Proton |
-| **Denuvo** | Game AAA (xem bên dưới) | ⚠️ Một số chạy, một số không |
-| **Adobe DRM** | eBook, PDF | ❌ Khó |
-| **Widevine** | Netflix, Spotify | ✅ Hỗ trợ trên Chrome/Firefox |
-| **FairPlay** | Apple Music, iTunes | ❌ Không |
-
-> **Tranh cãi**: Nhiều người cho rằng DRM **chỉ gây khó cho người mua thật**, còn người crack thì vẫn crack được.
-
----
-
-## 2. 🛡️ Denuvo (Anti-Tamper)
-
-**Denuvo** là một loại DRM **cấp cao nhất** cho game, do công ty Áo **Denuvo Software Solutions** phát triển.
-
-### Cách hoạt động:
-```
-Game thường:
- Code game → Chạy trực tiếp
-
-Game có Denuvo:
- Code game → [Denuvo mã hoá + obfuscate] → Phải giải mã realtime khi chạy
- → Kiểm tra license online định kỳ
- → Phát hiện debugger/cheat tool → Từ chối chạy
-```
-
-### Tại sao gamer ghét Denuvo:
-- 🐌 **Giảm hiệu năng** — thêm lớp giải mã khi chạy, tốn CPU
-- 🌐 **Cần internet** — kiểm tra license online (dù game offline)
-- 💀 **Game chết khi server Denuvo ngừng** — không còn xác thực được
-- 🐧 **Rào cản lớn trên Linux** — nhiều game Denuvo từ chối chạy qua Proton/Wine
-
-### Trên Linux:
-| Tình trạng | Ví dụ |
-|---|---|
-| ✅ Chạy được | Hogwarts Legacy, Resident Evil Village |
-| ❌ Không chạy | Một số game do Denuvo phát hiện Wine/Proton → block |
-
-> Nhiều game **bỏ Denuvo** sau vài tháng phát hành (vì lúc đó đã bán đủ), và game thường chạy nhanh hơn sau khi gỡ.
-
----
-
-## 3. ⚔️ Kernel-Level Anti-Cheat
-
-**Anti-cheat chạy ở cấp kernel** — phần mềm chống gian lận (**hack/cheat**) trong game online, nhưng chạy ở **tầng sâu nhất** của hệ điều hành.
-
-### Tầng hoạt động:
-
-```
-┌─────────────────────────────┐
-│ Ứng dụng (User Space) │ ← Game, trình duyệt, app thường
-├─────────────────────────────┤
-│ Kernel (Nhân hệ điều hành) │ ← Driver, quản lý bộ nhớ, phần cứng
-│ 🛡️ ANTI-CHEAT CHẠY Ở ĐÂY │ ← Có quyền truy cập MỌI THỨ
-├─────────────────────────────┤
-│ Phần cứng (Hardware) │
-└─────────────────────────────┘
-```
-
-### Anti-cheat phổ biến:
-
-| Anti-Cheat | Game dùng | Hỗ trợ Linux? |
-|---|---|---|
-| **EAC** (Easy Anti-Cheat) | Fortnite, Apex Legends, Rust | ✅ Có (từ 2021, nhờ Steam Deck) |
-| **BattlEye** | PUBG, DayZ, Rainbow Six | ✅ Có (từ 2021) |
-| **Vanguard** (Riot) | Valorant, League of Legends | ❌ **Không** — từ chối Linux hoàn toàn |
-| **nProtect GameGuard** | Game Hàn Quốc | ❌ Không |
-| **FACEIT Anti-Cheat** | CS2 competitive | ❌ Không |
-
-### Tại sao gây tranh cãi:
-
-1. **Bảo mật**: Chạy ở kernel = có quyền **như virus/rootkit** — đọc mọi dữ liệu, kiểm soát mọi tiến trình
-2. **Quyền riêng tư**: Quét **toàn bộ** phần mềm đang chạy, file hệ thống
-3. **Ổn định**: Bug trong kernel driver có thể gây **BSOD** (màn hình xanh)
-4. **Linux**: Kernel-level anti-cheat dựa vào Windows kernel API → **rất khó port sang Linux**
-
-### Riot Vanguard (Valorant) — Case study:
-
-```
-- Chạy từ lúc BẬT MÁY (không phải lúc mở game)
-- Quét mọi driver, process đang chạy
-- Block driver "đáng ngờ"
-- TỪ CHỐI hoàn toàn Linux/VM/Wine
- → Lý do: sợ cheat tool chạy ở tầng host bên ngoài VM
-```
-
-> Đây là lý do **Valorant không thể chơi trên Linux**, và đây cũng là rào cản lớn nhất cho Linux gaming.
-
----
-
-## Tóm lại — Ảnh hưởng đến Linux:
-
-```
-DRM (chung) → Hầu hết OK trên Linux nhờ Proton
-Denuvo → 50/50, tuỳ game
-Kernel Anti-Cheat → Rào cản LỚN NHẤT cho Linux gaming
- ├── EAC, BattlEye → ĐÃ hỗ trợ Linux (nhờ Valve/Steam Deck)
- └── Vanguard → KHÔNG và có lẽ sẽ KHÔNG BAO GIỜ
-```
-
-### Tin tốt cho VNLF:
-- **Steam Deck** (chạy Arch Linux) đã buộc EAC + BattlEye hỗ trợ Linux
-- **Valve** đang lobby các nhà phát triển game bật Linux support
-- Xu hướng đang **tốt dần lên** cho Linux gaming
-
-Bạn muốn tìm hiểu thêm về khía cạnh nào không? Ví dụ cách **Proton/Wine** bypass DRM, hoặc danh sách game nào chạy được trên Linux?
-
-### User Input
-
-sài bottle r tạo shortcut 🐧
-
-### Planner Response
-
-Nice! 🐧 **Bottles** là lựa chọn rất tốt — giao diện đẹp, dễ dùng hơn Wine thuần rất nhiều.
-
-## Mẹo với Bottles:
-
-### Tạo shortcut đẹp hơn:
-Bottles tự tạo `.desktop` file khi bạn add shortcut, nằm ở:
-```
-~/.local/share/applications/
-```
-→ App sẽ hiện trong **Start Menu / App Launcher** như app Linux bình thường.
-
-### Một số tips:
-
-| Tip | Chi tiết |
-|---|---|
-| 🎮 **Gaming bottle** | Dùng preset "Gaming" — tự bật DXVK, VKD3D, Gamemode |
-| 💼 **Software bottle** | Dùng preset "Software" — cho app văn phòng, công cụ |
-| 🔀 **Tách bottle** | Mỗi app nên có bottle riêng — tránh conflict DLL |
-| 🖼️ **Đổi icon** | Click phải shortcut → đổi icon cho đẹp, dễ nhận biết |
-| 📂 **Backup** | Bottles hỗ trợ export/import bottle → chia sẻ cho người khác trong VNLF |
-
-### Bottles vs các tool khác:
-
-```
-Bottles ✅ GUI đẹp, dễ dùng, Flatpak, quản lý nhiều bottle
-Lutris ✅ Database game lớn, script cài tự động
-PlayOnLinux ❌ Cũ, ít update
-Wine thuần ⚠️ Mạnh nhưng phải CLI, khó cho người mới
-```
-
-> **Ý tưởng cho VNLF OS**: Cài sẵn Bottles + hướng dẫn tiếng Việt cách chạy app Windows phổ biến (Zalo, HTKK, game...) — đây sẽ là điểm bán hàng lớn cho người chuyển từ Windows sang! 🪷
-
-Bạn đang chạy app gì qua Bottles vậy?
-
-### User Input
-
-zalo chạy qua bottles được không
-
-### Planner Response
-
-## Zalo trên Linux — Có thể, nhưng có lưu ý
-
-### Cách 1: ✅ **Zalo Web (Khuyến nghị nhất)**
-
-Không cần Bottles, chạy native trên trình duyệt:
-
-```
-https://chat.zalo.me
-```
-
-- ✅ Nhắn tin, gọi thoại, gọi video OK
-- ✅ Gửi file, hình ảnh OK
-- ✅ Không cần cài gì thêm
-- 💡 **Tạo PWA** (Progressive Web App) để có trải nghiệm như app native:
- - Chrome → `⋮` → "Install app" / "Cài đặt ứng dụng"
- - → Có icon riêng trên desktop, mở trong cửa sổ riêng
-
-### Cách 2: ⚠️ **Zalo Desktop qua Bottles/Wine**
-
-Chạy **được**, nhưng:
-
-| Tính năng | Trạng thái |
-|---|---|
-| Đăng nhập | ✅ OK |
-| Nhắn tin | ✅ OK |
-| Gửi file/ảnh | ✅ OK |
-| Gọi thoại | ⚠️ Không ổn định — audio qua Wine hay lỗi |
-| Gọi video | ❌ Thường không hoạt động |
-| Cập nhật | ⚠️ Có thể bị lỗi khi Zalo tự update |
-| Hiệu năng | ⚠️ Nặng hơn so với bản Windows gốc |
-
-### Cách cài Zalo qua Bottles (nếu muốn thử):
-
-```
-1. Mở Bottles → Tạo bottle mới (preset: "Software")
-2. Tải file ZaloSetup.exe từ zalo.me
-3. Trong bottle → "Run Executable" → chọn ZaloSetup.exe
-4. Cài đặt bình thường
-5. Sau khi cài xong → tạo shortcut
-```
-
-**Lưu ý cấu hình bottle:**
-- Bật **DXVK** (cho rendering)
-- Windows version: **Windows 10**
-- Có thể cần cài thêm dependencies: `dotnet48`, `vcredist2019`
-
-### Cách 3: 🐳 **Zalo qua Flatpak (community)**
-
-Cộng đồng có build sẵn:
-```bash
-# Kiểm tra trên Flathub
-flatpak search zalo
-```
-→ Thường là wrapper của Zalo Web, nhưng đóng gói sẵn, tiện hơn.
-
----
-
-## So sánh tổng quan:
-
-| Cách | Dễ cài | Ổn định | Gọi thoại | Gọi video |
-|---|---|---|---|---|
-| **Zalo Web PWA** | ⭐⭐⭐ | ⭐⭐⭐ | ✅ | ✅ |
-| **Bottles/Wine** | ⭐⭐ | ⭐⭐ | ⚠️ | ❌ |
-| **Flatpak (community)** | ⭐⭐⭐ | ⭐⭐⭐ | ✅ | ✅ |
-
-## 💡 Khuyến nghị cho VNLF OS:
-
-> Cài sẵn **Zalo Web PWA** (pin trên taskbar) là giải pháp **tốt nhất** cho người dùng phổ thông. Đầy đủ tính năng, không cần Wine, không bị lỗi. Khi nào Zalo ra bản Linux chính thức thì chuyển sang.
-
-Bạn đang dùng Zalo cách nào trên máy Linux hiện tại?
-
-### User Input
-
-Flatpak (community) cái này là cái gì
-
-### Planner Response
-
-## Flatpak là gì?
-
-**Flatpak** là một hệ thống **đóng gói và phân phối phần mềm** cho Linux — giống như **App Store** nhưng cho mọi distro Linux.
-
-### Hình dung đơn giản:
-
-```
-Trước khi có Flatpak:
- Ubuntu dùng .deb (apt install)
- Fedora dùng .rpm (dnf install)
- Arch dùng .pkg (pacman install)
- → Mỗi distro một kiểu, dev phải đóng gói 3-4 lần 😩
-
-Có Flatpak:
- Dev đóng gói 1 LẦN → chạy trên MỌI distro ✅
-```
-
-### So sánh với thứ bạn đã biết:
-
-| Thế giới | "App Store" | Gói cài đặt |
-|---|---|---|
-| 📱 Android | Google Play | `.apk` |
-| 📱 iOS | App Store | `.ipa` |
-| 🪟 Windows | Microsoft Store | `.exe` / `.msi` |
-| 🐧 **Linux** | **Flathub** | **`.flatpak`** |
-
-### Flathub = "App Store" của Flatpak
-
-```
-🌐 https://flathub.org
-```
-
-Đây là kho phần mềm Flatpak lớn nhất, có hàng nghìn app:
-
-| App | Có trên Flathub? |
-|---|---|
-| Firefox | ✅ |
-| Chrome | ✅ |
-| VS Code | ✅ |
-| Discord | ✅ |
-| Spotify | ✅ |
-| OBS Studio | ✅ |
-| GIMP | ✅ |
-| Steam | ✅ |
-| Bottles | ✅ (bạn đang dùng!) |
-| LibreOffice | ✅ |
-
-### Tại sao Flatpak hay?
-
-```
-┌──────────────────────────────────────────────┐
-│ App (VD: Firefox) │
-│ ┌────────────────────────────────────────┐ │
-│ │ Tất cả thư viện cần thiết (sandbox) │ │ ← App mang theo
-│ │ Runtime, dependencies │ │ mọi thứ nó cần
-│ └────────────────────────────────────────┘ │
-│ Flatpak Runtime │
-├──────────────────────────────────────────────┤
-│ Ubuntu / Fedora / Mint / Arch / bất kỳ │ ← Chạy trên mọi distro
-└──────────────────────────────────────────────┘
-```
-
-| Ưu điểm | Chi tiết |
-|---|---|
-| 🌍 **Chạy mọi distro** | Cài 1 lần, chạy khắp nơi |
-| 🔒 **Sandbox** | App bị cách ly, an toàn hơn |
-| 🔄 **Tự cập nhật** | Không cần chờ distro update |
-| 📦 **Không conflict** | Mỗi app có dependencies riêng |
-| 🏪 **Flathub** | Kho app tập trung, dễ tìm |
-
-| Nhược điểm | Chi tiết |
-|---|---|
-| 💾 **Tốn dung lượng** | Mỗi app mang theo dependencies riêng |
-| 🐌 **Khởi động hơi chậm** hơn app native | Do sandbox |
-| 🔐 **Quyền truy cập** | Đôi khi cần cấp thêm quyền (file, USB...) |
-
-### "Community" nghĩa là gì?
-
-Khi mình nói **Flatpak (community)** cho Zalo, nghĩa là:
-
-```
-Zalo CHÍNH THỨC → Do VNG (công ty Zalo) phát triển → ❌ Không có bản Linux
-Zalo COMMUNITY → Do CỘNG ĐỒNG Linux tự đóng gói → ⚠️ Không chính thức
- (thường là wrapper của Zalo Web)
-```
-
-→ Hoạt động được, nhưng **không phải VNG** làm, nên có thể thiếu tính năng hoặc bị lỗi.
-
-### Cài đặt Flatpak:
-
-```bash
-# Trên Ubuntu/Mint (nếu chưa có)
-sudo apt install flatpak
-
-# Thêm Flathub
-flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
-
-# Cài app (ví dụ)
-flatpak install flathub com.spotify.Client
-flatpak install flathub com.usebottles.bottles
-```
-
----
-
-### 💡 Cho VNLF OS:
-
-> Nên cài sẵn **Flatpak + Flathub** trong VNLF OS. Người dùng mới chỉ cần mở Software Center → tìm app → bấm Install. Đơn giản như Google Play! Và nếu VNLF phát triển app riêng, cũng có thể **publish lên Flathub** hoặc tạo **repo Flatpak riêng** của VNLF.
-
-Còn thắc mắc gì thêm không? 🐧
-
-### User Input
-
-tôi muốn remix lại 1 bản linux
-có thể cài được nhiều app windows, UI/UX dễ dùng nhất có thể, các tính năng thông minh,
-
-tóm lại: tôi muốn phổ thông hoá linux, người dùng thì không quan tâm đến core, chỉ quan tâm đến máy yếu vẫn chạy được, hđh dễ dùng, nhanh nhạy,....
-
-bạn hiểu ý tôi chứ, cần gì muốn hỏi không
-
-### Planner Response
-
-Mình hiểu rõ ý bạn! Tóm lại vision của bạn là:
-
-> **Một bản Linux "Just Works"** — người dùng phổ thông bật máy lên, dùng được ngay, không cần biết gì về Linux. Giống như cách họ dùng Windows, nhưng **miễn phí, nhẹ hơn, nhanh hơn, và hợp pháp**.
-
----
-
-## ✅ Mình hiểu — đây là các yêu cầu cốt lõi:
-
-| Yêu cầu | Ý nghĩa |
-|---|---|
-| 🪶 **Máy yếu vẫn chạy** | RAM 2-4GB, CPU cũ → cần DE nhẹ |
-| 🎨 **UI/UX dễ dùng** | Quen thuộc như Windows, không cần terminal |
-| 🪟 **Chạy app Windows** | Zalo, Office, game cơ bản → Wine/Bottles tích hợp sẵn |
-| ⚡ **Nhanh nhạy** | Boot nhanh, mở app nhanh, không lag |
-| 🧠 **Tính năng thông minh** | Auto-update, backup, app store dễ dùng |
-| 🇻🇳 **Việt hoá** | Tiếng Việt 100%, bộ gõ sẵn |
-
----
-
-## Mình có một số câu hỏi để định hình dự án tốt hơn:
-
-### 1. **Đối tượng chính là ai?**
-- a) Học sinh / sinh viên?
-- b) Nhân viên văn phòng?
-- c) Người dùng gia đình (lướt web, xem phim, chat)?
-- d) Tất cả?
-
-### 2. **Cấu hình máy tối thiểu bạn muốn hỗ trợ?**
-- a) 2GB RAM, CPU 2 nhân (máy rất cũ, ~2010)
-- b) 4GB RAM, CPU 4 nhân (máy cũ, ~2015)
-- c) Tuỳ mình quyết?
-
-### 3. **Tên distro?**
-- Dùng VNLF OS? Hay bạn đã có tên khác trong đầu?
-
-### 4. **Desktop Environment — giao diện nào?**
-
-| DE | Giống | RAM cần | Đẹp | Dễ dùng |
-|---|---|---|---|---|
-| **Cinnamon** | Windows nhất | ~500MB | ⭐⭐⭐ | ⭐⭐⭐ |
-| **XFCE** | Windows cũ | ~300MB | ⭐⭐ | ⭐⭐⭐ |
-| **Budgie** | Chrome OS | ~450MB | ⭐⭐⭐ | ⭐⭐⭐ |
-| **KDE Plasma** | Windows 11 | ~450MB | ⭐⭐⭐⭐ | ⭐⭐⭐ |
-
-→ Bạn thích hướng nào? Hay mình chọn giúp?
-
-### 5. **Base distro?**
-- a) **Linux Mint** — ổn định nhất, quen thuộc nhất
-- b) **Ubuntu LTS** — cộng đồng lớn nhất
-- c) **Debian** — nhẹ nhất, ổn định nhất, nhưng phần mềm cũ hơn
-- d) Bạn đã có lựa chọn?
-
-### 6. **Bạn muốn bắt đầu từ mức nào?**
-- a) Mình lên **blueprint/spec chi tiết** cho toàn bộ dự án trước?
-- b) Hay bắt tay vào **build ISO đầu tiên** luôn?
-
----
-
-Trả lời mấy câu này xong mình sẽ lên **kế hoạch chi tiết** cho dự án! 🐧
-
-### User Input
-
-1, đối tượng là tất cả
-2, b
-3, cứ để VNOS
-4, budgie
-5, ubuntu lts
-6, a -> lên brief
-
-*Edited relevant file*
-
-*Edited relevant file*
-
-### User Input
-
-tôi chưa có kiến thức gì về việc tạo 1 os mới, là mình lấy cái image từ docker về xong build vào hả
-
-### Planner Response
-
-Câu hỏi rất hay! Để mình giải thích **cách tạo ra một bản Linux remix** một cách dễ hiểu nhất:
-
-## Không phải Docker — Hiểu đúng quy trình
-
-Docker **không phải** cách tạo OS. Docker chỉ là công cụ chạy container (môi trường ảo nhẹ). Quy trình tạo OS remix như sau:
-
-### Hình dung đơn giản:
-
-```
-Bạn muốn mở quán phở riêng, nhưng không cần nuôi bò, trồng lúa, xây nhà từ đầu.
-
-Thay vào đó:
-1. Thuê mặt bằng có sẵn → Lấy ISO Ubuntu có sẵn
-2. Trang trí lại quán → Đổi theme, wallpaper, logo
-3. Chọn thực đơn riêng → Chọn phần mềm cài sẵn
-4. Đặt tên quán, làm bảng hiệu → Branding VNOS
-5. Mở cửa phục vụ → Phát hành ISO cho mọi người tải
-```
-
-## Quy trình thực tế (từng bước):
-
-### Bước 1: Tải ISO gốc
-```
-Tải file Ubuntu Budgie .iso (khoảng 3GB)
-→ Đây là "nguyên liệu thô"
-```
-
-### Bước 2: "Mổ" ISO ra bằng công cụ
-```
-Dùng tool như Cubic (có giao diện đồ hoạ, rất dễ):
-
-┌─────────────────────────────────────┐
-│ Cubic mở ISO ra │
-│ → Bạn thấy toàn bộ hệ thống │
-│ → Như đang đứng TRONG cái máy tính │
-│ → Muốn cài gì, xoá gì tuỳ ý │
-└─────────────────────────────────────┘
-```
-
-### Bước 3: Tuỳ biến (phần vui nhất)
-```
-Trong Cubic, bạn có 1 cửa sổ Terminal:
-
-$ apt install vlc ← Cài VLC
-$ apt install libreoffice ← Cài LibreOffice
-$ apt install bottles ← Cài Bottles
-$ apt remove thunderbird ← Xoá app không cần
-$ cp wallpaper.jpg /usr/share/backgrounds/ ← Thêm hình nền
-... (nhiều thao tác khác)
-```
-
-### Bước 4: Đóng gói lại thành ISO mới
-```
-Cubic tự đóng gói lại → Ra file VNOS.iso (~3.5GB)
-```
-
-### Bước 5: Test
-```
-Mở VirtualBox → Tạo máy ảo → Boot từ VNOS.iso → Xem chạy OK không
-```
-
-### Bước 6: Phát hành
-```
-Upload VNOS.iso lên website → Người dùng tải về → Ghi ra USB → Cài máy
-```
-
-## Minh hoạ rõ hơn:
-
-```
-ISO Ubuntu gốc VNOS ISO (sau khi remix)
-┌──────────────┐ ┌──────────────┐
-│ Ubuntu │ │ VNOS │
-│ GNOME desktop│ ──Cubic──► │ Budgie desktop│
-│ English │ │ Tiếng Việt │
-│ Firefox │ │ Firefox │
-│ Thunderbird │ │ VLC │
-│ Ubuntu theme │ │ LibreOffice │
-│ │ │ Bottles │
-│ │ │ Zalo PWA │
-│ │ │ VNOS theme │
-└──────────────┘ └──────────────┘
-```
-
-## Có 3 cách chính để build:
-
-| Cách | Tool | Độ khó | Dùng khi nào |
-|---|---|---|---|
-| **1. Cubic** | GUI (đồ hoạ) | ⭐ Dễ nhất | Bắt đầu, học, thử nghiệm |
-| **2. live-build** | CLI (lệnh) | ⭐⭐⭐ Trung bình | Chuyên nghiệp, reproducible |
-| **3. Chỉnh trên máy thật → đóng gói** | Linux Live Kit | ⭐⭐ | Nhanh, trực quan |
-
-## Khuyến nghị cho bạn:
-
-> **Bắt đầu bằng Cubic** — vì nó có giao diện đồ hoạ, từng bước rõ ràng, không cần biết nhiều về Linux. Sau khi quen rồi thì chuyển sang `live-build` để tự động hoá.
-
-### Bạn cần gì để bắt đầu:
-1. **Một máy chạy Ubuntu/Linux** (hoặc VM)
-2. **Cài Cubic**: `sudo apt install cubic`
-3. **Tải ISO Ubuntu Budgie** gốc
-4. **Ổ cứng trống ~20GB** để Cubic làm việc
-
----
-
-Bạn muốn mình **hướng dẫn step-by-step cài Cubic và build ISO đầu tiên** không? Hoặc còn thắc mắc gì thêm về quy trình?
-
-### User Input
-
-muốn custom kiểu, khi nào boots mới cài mấy cái phần mềm á
-
-### Planner Response
-
-Hiểu rồi! Bạn muốn **ISO nhẹ**, rồi khi người dùng cài xong và **boot lần đầu** thì hệ thống **tự cài phần mềm** cho họ. Đúng không?
-
-## So sánh 2 cách:
-
-```
-Cách 1: Nhồi hết vào ISO (mặc định)
-┌─────────────┐ ┌─────────────┐
-│ ISO 3.5GB │ ──► │ Cài xong │ → Dùng luôn
-│ Có sẵn mọi │ │ Có đủ app │
-│ app bên trong│ │ │
-└─────────────┘ └─────────────┘
-
-Cách 2: Cài khi first boot (cái bạn muốn) ✅
-┌─────────────┐ ┌─────────────┐ ┌─────────────┐
-│ ISO 1.5GB │ ──► │ Cài xong │ ──► │ First boot │
-│ Nhẹ, chỉ có │ │ Hệ thống │ │ "Đang thiết │
-│ core OS │ │ cơ bản │ │ lập VNOS..." │
-└─────────────┘ └─────────────┘ │ ████░░ 60% │
- │ Cài VLC... │
- │ Cài Office..│
- └─────────────┘
- │
- ┌──────▼──────┐
- │ Xong! Dùng │
- │ được rồi 🎉 │
- └─────────────┘
-```
-
-## Cách hoạt động kỹ thuật:
-
-### 1. Tạo script `vnos-first-boot.sh`
-```bash
-#!/bin/bash
-# Script này chạy 1 lần duy nhất khi boot lần đầu
-
-# Cài phần mềm
-apt install -y vlc libreoffice bottles firefox ...
-
-# Cấu hình tiếng Việt
-# Cài font, bộ gõ...
-
-# Đánh dấu "đã chạy rồi" → không chạy lại lần sau
-touch /etc/vnos-first-boot-done
-```
-
-### 2. Đăng ký chạy khi boot bằng **systemd service**
-```ini
-# /etc/systemd/system/vnos-first-boot.service
-[Unit]
-Description=VNOS First Boot Setup
-ConditionPathExists=!/etc/vnos-first-boot-done ← Chỉ chạy nếu chưa done
-
-[Service]
-ExecStart=/usr/local/bin/vnos-first-boot.sh
-
-[Install]
-WantedBy=multi-user.target
-```
-
-### 3. Kết hợp GUI hiển thị tiến trình
-Thay vì chạy script im lặng, hiện **cửa sổ đẹp** cho user thấy:
-
-```
-┌─────────────────────────────────────────┐
-│ 🪷 Chào mừng đến với VNOS │
-│ │
-│ Đang thiết lập hệ thống cho bạn... │
-│ │
-│ ✅ Cài đặt bộ gõ tiếng Việt │
-│ ✅ Cài đặt LibreOffice │
-│ 🔄 Đang cài VLC Media Player... │
-│ ⬜ Cài đặt Bottles │
-│ ⬜ Cấu hình giao diện │
-│ │
-│ ████████████░░░░░░░ 60% │
-│ │
-│ ⏱️ Còn khoảng 5 phút │
-│ 💡 Cần kết nối Internet │
-└─────────────────────────────────────────┘
-```
-
-## Ưu & nhược điểm:
-
-| | Nhồi vào ISO | First Boot Install |
-|---|---|---|
-| **ISO size** | 3-4 GB | 1.5-2 GB |
-| **Tải nhanh hơn** | ❌ | ✅ |
-| **Cài offline** | ✅ Được | ❌ Cần internet |
-| **Cài xong dùng ngay** | ✅ | ❌ Phải chờ 5-15 phút |
-| **Luôn có app mới nhất** | ❌ | ✅ Tải bản mới nhất |
-| **Phụ thuộc mạng** | Không | Có |
-
-## 💡 Gợi ý tốt nhất: **Kết hợp cả hai**
-
-```
-ISO chứa:
-├── Core OS (Budgie, driver, font, bộ gõ) ← Bắt buộc, trong ISO
-├── LibreOffice, Firefox, VLC ← Quan trọng, trong ISO
-└── First Boot sẽ cài thêm:
- ├── Bottles + Wine ← Nặng, tải sau
- ├── Flatpak apps ← Tải sau
- ├── Cập nhật bảo mật mới nhất ← Tải sau
- └── Tuỳ chọn thêm (user chọn trong Welcome)← Tải sau
-```
-
-→ Vậy **ISO vẫn dùng được offline** (có đủ app cơ bản), nhưng **khi có mạng sẽ cài thêm** cho đầy đủ!
-
----
-
-Bạn muốn đi theo hướng nào:
-1. **Nhồi hết vào ISO** (đơn giản nhất, dùng được offline)?
-2. **First boot install** (ISO nhẹ, cần mạng)?
-3. **Kết hợp** (khuyến nghị)?
-
-### User Input
-
-driver là vấn đề nan giải, như thằng ubuntu 22 tôi bữa cài lắp card wifi vào có chạy được đâu
-
-### Planner Response
-
-Đúng rồi! Driver WiFi là **nỗi đau kinh điển** của Linux. Giải thích cho bạn hiểu tại sao và cách giải quyết cho VNOS:
-
-## Tại sao WiFi hay lỗi trên Linux?
-
-```
-Windows:
- Nhà sản xuất (Realtek, Broadcom...) → Viết driver cho Windows → Cài sẵn
- → Cắm vào là chạy ✅
-
-Linux:
- Nhà sản xuất → KHÔNG viết driver cho Linux (hoặc viết dở) 😤
- → Cộng đồng phải tự reverse-engineer viết driver
- → Mất thời gian, có khi thiếu tính năng
-```
-
-### Chip WiFi nào hay lỗi nhất:
-
-| Hãng | Tình trạng trên Linux |
-|---|---|
-| **Intel** | ✅ Hỗ trợ tốt nhất — Intel tự viết driver open source |
-| **Qualcomm/Atheros** | ✅ Tốt — driver mở |
-| **MediaTek** | ⚠️ Khá — đang cải thiện |
-| **Realtek** | ❌ **Tệ nhất** — driver thường phải cài thêm, hay lỗi |
-| **Broadcom** | ❌ Tệ — cần driver proprietary |
-
-> **Card WiFi bạn bị lỗi trên Ubuntu 22** khả năng **90% là Realtek hoặc Broadcom**.
-
-## Nguyên nhân cụ thể:
-
-```
-Ubuntu ISO mặc định chỉ chứa driver MỞ (open source)
- │
- Chip Intel │ Chip Realtek/Broadcom
- Driver mở ✅ │ Driver mở ❌ (không có hoặc lỗi)
- Chạy ngay │ Cần driver ĐÓNG (proprietary)
- │ → Phải cài thêm
- │ → Nhưng không có WiFi thì tải driver BẰNG GÌ? 🤦
- │ (vòng lặp chết: cần mạng để cài driver mạng)
-```
-
-## Cách giải quyết cho VNOS:
-
-### 1. **Nhồi tất cả driver vào ISO** (quan trọng nhất!)
-
-```bash
-# Trong quá trình build ISO, cài sẵn:
-
-# Driver WiFi proprietary
-linux-firmware # Firmware cho hầu hết chip
-broadcom-sta-dkms # Broadcom
-rtl8821ce-dkms # Realtek 8821CE (rất phổ biến)
-rtl88x2bu-dkms # Realtek 88x2BU (USB WiFi)
-rtl8812au-dkms # Realtek 8812AU (USB WiFi)
-
-# GPU driver
-nvidia-driver-xxx # NVIDIA (tuỳ chọn)
-```
-
-→ Người dùng **cắm là chạy, không cần tải thêm gì**.
-
-### 2. **Bật "Additional Drivers" sẵn**
-
-Ubuntu có tool `ubuntu-drivers` tự phát hiện phần cứng:
-
-```bash
-# Tự quét và cài driver phù hợp
-sudo ubuntu-drivers autoinstall
-```
-
-→ VNOS có thể chạy lệnh này **tự động khi first boot**.
-
-### 3. **Dùng kernel mới hơn (HWE)**
-
-```
-Ubuntu 22.04 mặc định: Kernel 5.15 (2021)
-Ubuntu 22.04 HWE: Kernel 6.5+ (2023) ← Hỗ trợ phần cứng mới hơn!
-
-Ubuntu 24.04 mặc định: Kernel 6.8 (2024) ← Tốt hơn nữa
-```
-
-> VNOS dựa trên **Ubuntu 24.04 LTS** → đã có kernel 6.8, hỗ trợ WiFi tốt hơn rất nhiều so với 22.04!
-
-### 4. **Cấu trúc driver trong VNOS ISO:**
-
-```
-VNOS ISO
-├── Kernel 6.8 (Ubuntu 24.04) ← Mới, hỗ trợ nhiều chip
-├── linux-firmware (mới nhất) ← Firmware cho Wi-Fi, Bluetooth
-├── Driver Realtek (dkms) ← Cài sẵn
-├── Driver Broadcom (dkms) ← Cài sẵn
-├── NVIDIA driver (tuỳ chọn) ← Có trong ISO, user chọn cài
-├── ubuntu-drivers tool ← Auto-detect phần cứng
-└── DKMS ← Tự build driver khi cập nhật kernel
-```
-
-## So sánh trước/sau:
-
-```
-Ubuntu gốc:
- Cài xong → WiFi không chạy → Cắm dây mạng → Google → Cài driver → Chạy
- 😤 Mất 30 phút - 2 tiếng
-
-VNOS:
- Cài xong → WiFi chạy luôn ✅
- 😊 0 phút
-```
-
-## Tóm lại:
-
-> Driver **không phải** vấn đề không giải được. Giải pháp là **nhồi sẵn tất cả driver phổ biến vào ISO** + dùng **kernel mới** (Ubuntu 24.04). Đây chính xác là điều mà Linux Mint, Pop!_OS, Zorin OS đã làm — và lý do chúng "dễ dùng" hơn Ubuntu gốc.
-
-Đây sẽ là điểm mạnh của VNOS: **"Cài xong là chạy, không phải loay hoay driver"**. Mình sẽ cập nhật vào blueprint phần driver strategy nếu bạn muốn!
-
-### User Input
-
-sau này nó lên 26.04 thì update thế nào nhỉ
-
-### Planner Response
-
-Câu hỏi rất quan trọng! Đây là bài toán **mọi distro remix đều phải giải**. Có 2 tình huống:
-
-## Tình huống 1: Cập nhật hàng ngày (security, bug fix)
-
-Cái này **tự động**, không cần lo:
-
-```
-VNOS dựa trên Ubuntu 24.04
- │
- ▼
-Ubuntu phát hành bản vá bảo mật
- │
- ▼
-VNOS nhận update y hệt Ubuntu (cùng repo)
- │
- ▼
-Người dùng thấy thông báo "Có bản cập nhật" → Bấm cập nhật → Xong
-```
-
-→ Vì VNOS **dùng chung repo Ubuntu**, nên mọi update bảo mật, bug fix từ Ubuntu đều tự về. **VNLF không cần làm gì**.
-
-## Tình huống 2: Nâng cấp lớn (24.04 → 26.04) — cái bạn hỏi
-
-Có **3 cách** cho người dùng:
-
-### Cách A: **Cài mới** (đơn giản nhất)
-
-```
-VNOS 1.0 (Ubuntu 24.04) → VNOS 2.0 (Ubuntu 26.04)
-
-Người dùng: Tải ISO VNOS 2.0 → Cài lại từ đầu
- (giữ phân vùng /home để không mất dữ liệu)
-```
-
-- ✅ Sạch sẽ, không lỗi
-- ❌ Mất thời gian, phải cài lại app
-
-### Cách B: **Nâng cấp trực tiếp** (upgrade in-place)
-
-```
-Ubuntu có sẵn cơ chế này:
-
-$ sudo do-release-upgrade
-
-→ Tự nâng 24.04 lên 26.04 mà KHÔNG cần cài lại
-→ Giữ nguyên app, dữ liệu, cấu hình
-```
-
-**Nhưng** — với VNOS cần thêm bước:
-
-```
-1. Ubuntu nâng lên 26.04 ← Tự động
-2. Có thể MẤT customization của VNOS ← ⚠️ Vấn đề!
- - Theme bị ghi đè
- - Config bị reset
- - Boot splash trở về Ubuntu mặc định
-3. VNLF cần phát hành "VNOS Upgrade Pack" ← Chạy sau để fix
- - Cài lại branding
- - Cập nhật config
- - Kiểm tra tương thích
-```
-
-### Cách C: **VNOS tự quản lý upgrade** (chuyên nghiệp nhất)
-
-```
-VNLF tạo tool riêng: vnos-upgrade
-
-$ vnos-upgrade --to 2.0
-
-Tool này sẽ:
-1. Chạy do-release-upgrade (nâng Ubuntu)
-2. Tự động cài lại branding VNOS
-3. Cập nhật config mới
-4. Kiểm tra mọi thứ OK
-→ Người dùng chỉ bấm 1 nút
-```
-
-## VNLF cần làm gì khi Ubuntu ra bản mới?
-
-```
-Timeline:
-
-Tháng 4/2026: Ubuntu 26.04 LTS phát hành
- │
- ▼
-Tháng 4-5/2026: VNLF team test
- │ - Build VNOS mới trên base 26.04
- │ - Kiểm tra tương thích
- │ - Fix branding, config
- │ - Test trên nhiều máy
- ▼
-Tháng 5-6/2026: Phát hành VNOS 2.0
- │ - ISO mới cho người cài mới
- │ - Upgrade pack cho người dùng cũ
- ▼
-Xong ✅
-```
-
-## Chu kỳ hỗ trợ:
-
-```
-Ubuntu 24.04 LTS ──── Hỗ trợ 5 năm ──── Hết hạn 2029
-VNOS 1.0 ──── Theo Ubuntu ─────── Hết hạn 2029
-
-Ubuntu 26.04 LTS ──── Hỗ trợ 5 năm ──── Hết hạn 2031
-VNOS 2.0 ──── Theo Ubuntu ─────── Hết hạn 2031
-```
-
-→ **Cứ 2 năm** VNLF cần build lại ISO mới. Trong 2 năm đó, **update tự động theo Ubuntu**.
-
-## So sánh với các distro khác:
-
-| Distro | Cách xử lý upgrade |
-|---|---|
-| **Linux Mint** | Cứ Ubuntu LTS mới → Mint ra bản mới. Khuyến khích cài mới |
-| **Zorin OS** | Tương tự Mint |
-| **Pop!_OS** | Có tool upgrade riêng, khá mượt |
-| **Ubuntu gốc** | `do-release-upgrade` — đôi khi lỗi |
-
-## Khuyến nghị cho VNOS:
-
-> **Phase 1 (ban đầu):** Khuyến khích người dùng **cài mới** khi có VNOS phiên bản mới. Đơn giản, không lỗi.
->
-> **Phase 2 (về sau):** Phát triển tool `vnos-upgrade` để nâng cấp tại chỗ khi team đủ kinh nghiệm.
-
-Còn thắc mắc gì thêm không? Hay mình cập nhật phần upgrade strategy vào blueprint?
-
-### User Input
-
-Linux Mint base ubuntu hả còn thằng zorin là gì
-
-### Planner Response
-
-Đúng rồi! Cả hai đều dựa trên Ubuntu, nhưng khác nhau:
-
-## Linux Mint
-
-| | Chi tiết |
-|---|---|
-| **Base** | Ubuntu LTS |
-| **Ai làm** | Cộng đồng, lead bởi **Clement Lefebvre** (Pháp) |
-| **Mục tiêu** | Dễ dùng, ổn định, thay thế Windows |
-| **Desktop** | Cinnamon (tự phát triển), XFCE, MATE |
-| **Giá** | Miễn phí 100% |
-| **Đặc điểm** | Bỏ Snap, dùng Flatpak. Giao diện rất giống Windows |
-
-## Zorin OS
-
-| | Chi tiết |
-|---|---|
-| **Base** | Ubuntu LTS |
-| **Ai làm** | **2 anh em người Ireland** (Artyom & Oleksii Zorin), lập công ty |
-| **Mục tiêu** | Giống hệt Windows/macOS để người dùng chuyển sang dễ |
-| **Desktop** | GNOME (tuỳ biến nặng) |
-| **Giá** | **Core**: miễn phí, **Pro**: $48 (có thêm layout, app) |
-| **Đặc điểm** | Chuyển layout 1 click: Windows 11 / Windows Classic / macOS / Ubuntu |
-
-## So sánh trực quan:
-
-```
- Ubuntu
- / \
- / \
- Linux Mint Zorin OS
- (Cinnamon) (GNOME tuỳ biến)
- │ │
- Giống Windows 7 Giống Windows 11/macOS
- Miễn phí 100% Có bản Pro trả phí
- Cộng đồng làm Công ty làm
-```
-
-## Cái hay của Zorin mà VNOS có thể học:
-
-**Zorin Appearance** — chuyển layout 1 click:
-
-```
-┌─────────────────────────────────────┐
-│ Chọn giao diện bạn thích: │
-│ │
-│ ┌─────┐ ┌─────┐ ┌─────┐ │
-│ │Win11│ │Win 7│ │macOS│ │
-│ │ ▄▄▄ │ │▄▄▄ │ │ ▄▄▄│ │
-│ │█ █│ │█ █│ │█ █│ │
-│ │▀▀▀▀▀│ │▀▀▀▀▀│ │ │ │
-│ └──✅──┘ └─────┘ └─────┘ │
-│ │
-│ Taskbar: Dưới ▾ Icon: Lớn ▾ │
-└─────────────────────────────────────┘
-```
-
-→ **Ý tưởng cho VNOS**: Tạo tính năng tương tự — người dùng quen Windows 7 chọn layout Windows 7, quen Windows 11 chọn layout 11. Budgie hỗ trợ tuỳ biến panel nên làm được!
-
-## Tổng kết "cây gia phả" liên quan VNOS:
-
-```
-Debian (ông tổ)
- └── Ubuntu LTS (con)
- ├── Linux Mint (cháu — miễn phí, cộng đồng)
- ├── Zorin OS (cháu — có bản Pro, công ty)
- ├── Pop!_OS (cháu — cho dev/gaming, System76)
- └── VNOS 🇻🇳 (cháu — cho người Việt, VNLF)
-```
-
-→ VNOS sẽ là **"anh em"** cùng cấp với Mint, Zorin, Pop!_OS. Tất cả đều remix từ Ubuntu, mỗi đứa phục vụ đối tượng khác nhau!
-
-### User Input
-
-mintupdate là gì sao nó lại mạnh
-
-### Planner Response
-
-Câu hỏi hay! **mintupdate** (tên đầy đủ: **Update Manager**) là tool quản lý cập nhật **do Linux Mint tự viết** — và nó là một trong những lý do chính khiến Mint được yêu thích.
-
-## mintupdate là gì?
-
-Là trình quản lý cập nhật **thay thế** cho tool mặc định của Ubuntu, được thiết kế với triết lý:
-
-> **"Cập nhật không bao giờ được làm hỏng máy người dùng"**
-
-## So sánh với Ubuntu:
-
-```
-Ubuntu (unattended-upgrades):
- Có update → Cài luôn → Đôi khi HỎng máy → Người dùng hoảng 😱
-
-Linux Mint (mintupdate):
- Có update → Phân loại mức độ rủi ro → Người dùng CHỌN → An toàn 😌
-```
-
-## Cách mintupdate phân loại update:
-
-Đây là **tính năng mạnh nhất** — mỗi update được gắn Level:
-
-| Level | Ý nghĩa | Tự động cài? | Ví dụ |
-|---|---|---|---|
-| **1** ✅ | An toàn, đã test kỹ | Có | Bản vá Mint |
-| **2** ✅ | An toàn, nên cài | Có | Bản vá bảo mật |
-| **3** ⚠️ | Phần lớn an toàn | Có (mặc định) | Firefox, LibreOffice update |
-| **4** 🟡 | Có thể ảnh hưởng hệ thống | **Không** — user tự chọn | Xorg, Mesa (đồ hoạ) |
-| **5** 🔴 | Nguy hiểm, có thể hỏng OS | **Không** — ẩn mặc định | Kernel mới, systemd, GRUB |
-
-```
-┌────────────────────────────────────────────────┐
-│ 🔄 Update Manager ─ □ x│
-├────────────────────────────────────────────────┤
-│ │
-│ ✅ firefox 105.0 → 106.0 Level 3 │
-│ ✅ libreoffice 7.4.2 → 7.4.3 Level 3 │
-│ ✅ vlc 3.0.17 → 3.0.18 Level 3 │
-│ ⬜ linux-kernel 5.15.0-52 → -53 Level 5 │ ← Không tick
-│ ⬜ mesa-drivers 22.2.1 → 22.3.0 Level 4 │ ← Không tick
-│ │
-│ Level 1-3: Cài thoải mái ✅ │
-│ Level 4-5: Cân nhắc kỹ ⚠️ │
-│ │
-│ [Cài đặt bản cập nhật] │
-└────────────────────────────────────────────────┘
-```
-
-## Tính năng mạnh khác:
-
-### 1. **Timeshift tích hợp**
-```
-Trước khi cập nhật Level 4-5:
- mintupdate tự tạo snapshot → Nếu hỏng → Khôi phục 1 click
-```
-
-### 2. **Kernel Manager**
-```
-Quản lý kernel bằng GUI:
- - Xem kernel nào đang chạy
- - Cài kernel mới để thử
- - Quay lại kernel cũ nếu lỗi
- - Không bao giờ TỰ ĐỘNG nâng kernel
-```
-
-### 3. **Update chính sách (Policy)**
-```
-Người dùng mới: Chỉ cài Level 1-2 (an toàn tuyệt đối)
-Người dùng thường: Cài Level 1-3 (mặc định)
-Người dùng nâng cao: Cài Level 1-5 (tự chịu trách nhiệm)
-```
-
-### 4. **Không bao giờ ép update**
-```
-Windows: "Đang cập nhật... Không tắt máy" → 30 phút chờ 😤
-Mint: "Có bản cập nhật" → Bạn muốn cài khi nào thì cài → Xong
-```
-
-## Tại sao mạnh — tóm gọn:
-
-| Vấn đề | Ubuntu | mintupdate (Mint) |
-|---|---|---|
-| Kernel update hỏng WiFi | Tự cài, hỏng | Không tự cài, user chọn |
-| Driver đồ hoạ hỏng | Tự cài, hỏng | Cảnh báo Level 4 |
-| Muốn rollback | Khó | Timeshift 1 click |
-| Ép update khi tắt máy | Có | Không bao giờ |
-| Quản lý kernel | Terminal | GUI đẹp |
-
-## 💡 Cho VNOS:
-
-> VNOS nên **viết một tool tương tự** hoặc **fork mintupdate** (nó open source, GPL). Gọi là **vnos-update** chẳng hạn. Đây sẽ là điểm mạnh lớn:
->
-> *"VNOS không bao giờ tự cập nhật làm hỏng máy bạn"*
-
-mintupdate là Python + GTK, source code ở: `github.com/linuxmint/mintupdate` — hoàn toàn có thể fork và Việt hoá!
-
-Bạn muốn tìm hiểu thêm về tool nào khác của Mint không?
-
-### User Input
-
-còn cái nào mint oce hơn không
-
-### Planner Response
-
-Có! Linux Mint tự viết **cả một bộ tool riêng** gọi là **X-Apps**. Đây là lý do Mint mạnh — họ không dùng tool mặc định của Ubuntu mà tự viết lại cho tốt hơn:
-
-## Bộ tool "tự chế" của Linux Mint:
-
-### ⭐ Tier S — Đặc biệt hay
-
-| Tool | Chức năng | Hay ở chỗ |
-|---|---|---|
-| **mintupdate** | Quản lý cập nhật | Phân loại Level, không bao giờ hỏng máy |
-| **Timeshift** | Backup/restore hệ thống | Tạo snapshot, hỏng máy → khôi phục 1 click. **Quá mạnh** |
-| **Nemo** | File manager | Fork từ Nautilus, nhiều tính năng hơn: tab, dual pane, plugin, terminal nhúng |
-| **Cinnamon** | Desktop Environment | Tự viết luôn cả DE, giống Windows nhất |
-
-### ⭐ Tier A — Rất hay
-
-| Tool | Chức năng | Hay ở chỗ |
-|---|---|---|
-| **mintinstall** | Software Center | Giao diện đẹp, review/rating, Flatpak tích hợp |
-| **mintreport** | Báo cáo hệ thống | Phát hiện lỗi, đề xuất fix, crash report |
-| **mintsources** | Quản lý repo | GUI chọn mirror nhanh nhất, quản lý PPA |
-| **mintdrivers** | Quản lý driver | Tự phát hiện phần cứng → đề xuất driver tốt nhất |
-| **mintbackup** | Backup dữ liệu cá nhân | Backup file + danh sách app đã cài |
-
-### ⭐ Tier B — X-Apps (app thay thế)
-
-Mint **tự viết lại** các app cơ bản vì app GNOME ngày càng đơn giản hoá:
-
-| X-App | Thay thế cho | Lý do Mint tự viết |
-|---|---|---|
-| **Xed** | gedit / GNOME Text Editor | GNOME bỏ tính năng, Mint giữ lại |
-| **Xviewer** | Eye of GNOME | Nhẹ hơn, nhiều tính năng hơn |
-| **Xreader** | Evince (PDF reader) | Thêm tính năng, ổn hơn |
-| **Xplayer** | GNOME Videos | Dựa trên VLC backend |
-| **Pix** | Shotwell | Xem + chỉnh sửa ảnh cơ bản |
-| **Hypnotix** | — | Xem IPTV! (TV qua mạng) |
-| **Warpinator** | — | **Chia sẻ file qua mạng LAN** cực nhanh, như AirDrop |
-| **Webapp Manager** | — | Biến website thành app riêng (PWA) — Zalo Web → Zalo app! |
-| **Bulky** | — | Đổi tên file hàng loạt |
-
-## 🔥 Top 3 tool bạn nên "học" cho VNOS:
-
-### 1. **Timeshift** — Không thể thiếu
-```
-Người dùng lỡ xoá file hệ thống, cài driver sai, update hỏng?
-→ Bấm 1 nút → Máy quay lại trạng thái 1 tiếng trước
-→ Như Time Machine của macOS nhưng cho Linux
-```
-
-### 2. **Warpinator** — Chia sẻ file cực hay
-```
-2 máy Linux trong cùng WiFi:
- Máy A → Kéo thả file → Máy B nhận
- Không cần USB, không cần cloud, không cần cáp
- Giống AirDrop! 🍎
-```
-
-### 3. **Webapp Manager** — Rất phù hợp cho VNOS
-```
-Zalo không có bản Linux?
-→ Webapp Manager → Nhập chat.zalo.me
-→ Tạo thành app riêng, có icon, cửa sổ riêng
-→ Người dùng không biết đó là web! 🤯
-```
-
-## Tất cả đều open source — VNOS có thể:
-
-```
-Lựa chọn 1: Fork + Việt hoá → vnos-update, vnos-backup...
-Lựa chọn 2: Cài trực tiếp → Dùng luôn tool Mint (vì cùng base Ubuntu)
-Lựa chọn 3: Viết mới lấy cảm hứng → Viết tool riêng bằng Python + GTK
-```
-
-> **Khuyến nghị**: Phase 1 cứ **cài trực tiếp** tool Mint (Timeshift, Webapp Manager, Warpinator). Phase sau mới fork/viết riêng khi cần tuỳ biến.
-
-Bạn quan tâm tool nào nhất? Hay muốn mình cập nhật vào blueprint?
-
-### User Input
-
-thế giờ remix từ mint được không, rồi mình tối ưu hoá UI UX lại
-
-### Planner Response
-
-**Được!** Và thực ra đây là lựa chọn **thông minh hơn** so với Ubuntu gốc. Lý do:
-
-## Remix từ Mint = Ubuntu + đã có sẵn mọi thứ hay
-
-```
-Remix từ Ubuntu:
- Ubuntu (base) → Bạn phải TỰ thêm:
- + Timeshift ← Tự cài
- + Nemo file manager ← Tự cài
- + Webapp Manager ← Tự cài
- + mintupdate ← Phức tạp, phải thêm repo Mint
- + Warpinator ← Tự cài
- + Driver manager ← Tự cài
- + Budgie desktop ← Tự cài, cấu hình
- → Tốn rất nhiều công 😓
-
-Remix từ Mint:
- Mint (base) → ĐÃ CÓ SẴN tất cả tools hay
- → Bạn chỉ cần:
- + Đổi theme/UI cho đẹp hơn ← Phần bạn giỏi
- + Việt hoá ← Đơn giản
- + Thêm branding VNOS ← Đơn giản
- + Thêm Bottles ← 1 lệnh
- → Ít việc hơn nhiều ✅
-```
-
-## Nhưng có 1 thay đổi: Desktop Environment
-
-Mint dùng **Cinnamon** (mặc định), không phải Budgie. Bạn có 2 lựa chọn:
-
-| Lựa chọn | Ưu | Nhược |
-|---|---|---|
-| **A. Giữ Cinnamon** | Đã tích hợp sâu với Mint, ổn định nhất, giống Windows nhất | Hơi nặng hơn Budgie |
-| **B. Đổi sang Budgie** | Đẹp, hiện đại hơn | Mất một số tích hợp Mint, thêm việc |
-
-### Khuyến nghị: **Giữ Cinnamon, tuỳ biến UI cho đẹp**
-
-```
-Cinnamon mặc định: VNOS (Cinnamon tuỳ biến):
-┌────────────────────┐ ┌────────────────────┐
-│ Giao diện Mint │ │ Giao diện VNOS │
-│ Xanh lá Mint │ → │ Xanh lá VNLF │
-│ Theme Mint-Y │ │ Theme VNOS custom │
-│ Hơi cũ, safe │ │ Hiện đại, gradient │
-│ Icon Mint-Y │ │ Icon Tela/Papirus │
-└────────────────────┘ └────────────────────┘
-
-Cùng engine Cinnamon ← Giữ nguyên toàn bộ tool hay của Mint
-```
-
-Bạn có thể tuỳ biến Cinnamon **rất sâu**:
-- Custom theme (GTK + Cinnamon theme)
-- Custom icon pack
-- Đổi layout panel (taskbar trên/dưới, kiểu Windows 11...)
-- Applets riêng (widget trên panel)
-- Desklets (widget trên desktop)
-- Hiệu ứng animation
-
-## Tóm lại — Đường đi mới cho VNOS:
-
-```
-Trước: Ubuntu LTS → thêm Budgie → thêm tools → branding
-Giờ: Linux Mint → giữ Cinnamon → tuỳ biến UI → branding
- ↑ ↑
- Có sẵn mọi tool Phần bạn tập trung
-```
-
-**Lợi ích:**
-- ✅ Ít việc build hơn 50%
-- ✅ Có sẵn Timeshift, mintupdate, Warpinator, Webapp Manager...
-- ✅ Cinnamon giống Windows nhất → người dùng chuyển sang dễ
-- ✅ Ổn định hơn (Mint test kỹ rồi)
-- ✅ Cộng đồng Mint lớn, nhiều tài liệu
-
-Bạn muốn mình **cập nhật lại blueprint** theo hướng mới (base Mint + Cinnamon) không?
-
-### User Input
-
-Cinnamon xấu òm, muốn có UI như win11 hoặc macos kìa
-
-### Planner Response
-
-Haha, hiểu rồi! 😅 Cinnamon mặc định đúng là trông hơi "cổ điển". Vậy quay lại bài toán: **giữ tool Mint nhưng đổi giao diện đẹp**.
-
-## Lựa chọn tốt nhất: **KDE Plasma**
-
-KDE Plasma là DE **đẹp nhất + tuỳ biến nhất** trên Linux, có thể trông **y hệt** Win11 hoặc macOS:
-
-### Giống Windows 11:
-```
-┌──────────────────────────────────────────────────┐
-│ 🔔 📶 🔋│
-│ │
-│ │
-│ Desktop │
-│ │
-│ │
-│ ┌──────────────────────────────┐ │
-│ │ 📁 🌐 💬 📝 🏪 🔍 │ │ ← Taskbar giữa
-│ └──────────────────────────────┘ │ như Win11
-└──────────────────────────────────────────────────┘
-```
-
-### Giống macOS:
-```
-┌──────────────────────────────────────────────────┐
-│ 🍎 File Edit View 🔍 🔔 📶 🔋 10:34│ ← Top bar
-│ │
-│ │
-│ Desktop │
-│ │
-│ │
-│ ┌──────────────────────────────┐ │
-│ │ 📁 🌐 💬 📝 🏪 ⚙️ │ │ ← Dock dưới
-│ └──────────────────────────────┘ │ như macOS
-└──────────────────────────────────────────────────┘
-```
-
-**Cùng 1 desktop** — chỉ đổi layout, theme, icon!
-
-## So sánh các DE "đẹp":
-
-| DE | Giống | RAM | Tuỳ biến | Đẹp |
-|---|---|---|---|---|
-| **KDE Plasma** | Win11 + macOS | ~450MB | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
-| Budgie | Chrome OS | ~400MB | ⭐⭐⭐ | ⭐⭐⭐⭐ |
-| GNOME | macOS | ~600MB | ⭐⭐ | ⭐⭐⭐⭐ |
-| Cinnamon | Win7/10 | ~500MB | ⭐⭐⭐ | ⭐⭐ |
-
-> **KDE Plasma thắng** ở cả đẹp + nhẹ + tuỳ biến.
-
-## Kế hoạch mới cho VNOS:
-
-```
-Linux Mint (base)
- → Giữ: Timeshift, mintupdate, Nemo, Warpinator, Webapp Manager...
- → Bỏ: Cinnamon desktop
- → Thay: KDE Plasma
- → Thêm: Theme VNOS custom (Win11-style hoặc macOS-style)
-```
-
-### Cách thực hiện:
-
-```
-Lựa chọn A: Bắt đầu từ Linux Mint → cài thêm KDE
- ⚠️ Có thể conflict giữa Cinnamon và KDE
-
-Lựa chọn B: Bắt đầu từ Kubuntu (Ubuntu + KDE) → cài thêm tool Mint
- ✅ Sạch hơn, ít conflict
-
-Lựa chọn C: Bắt đầu từ Ubuntu minimal → cài KDE + tool Mint
- ✅ Sạch nhất, kiểm soát hoàn toàn
-```
-
-**Khuyến nghị: Lựa chọn B** — Kubuntu + tool Mint = best combo.
-
-## KDE có thể đẹp CỠ NÀO?
-
-Một số theme nổi tiếng:
-
-| Theme | Phong cách | Ảnh hưởng |
-|---|---|---|
-| **Lightly / Klassy** | Windows 11, bo tròn, trong suốt | Hiện đại |
-| **WhiteSur** | macOS Monterey/Ventura | Apple-like |
-| **Fluent** | Windows 11 Fluent Design | Microsoft-like |
-| **Orchis** | Material Design | Google-like |
-| **Sweet** | Dark neon, gradient | Gaming/Creative |
-
-→ VNOS có thể tạo **theme riêng** dựa trên mấy cái này, mang phong cách VNLF!
-
-## Tính năng "thông minh" của KDE sẵn có:
-
-| Tính năng | Mô tả |
-|---|---|
-| 🔍 **KRunner** | Gõ tìm mọi thứ (như Spotlight macOS) |
-| 📱 **KDE Connect** | Kết nối điện thoại ↔ máy tính (nhận tin nhắn, chia sẻ file) |
-| 🪟 **Tiling** | Kéo cửa sổ vào góc → tự chia ô (như Win11 Snap) |
-| 🎨 **Accent color** | Đổi màu nhấn toàn hệ thống 1 click |
-| 🌙 **Night mode** | Tự giảm ánh sáng xanh theo giờ |
-| 🖥️ **Virtual desktop** | Nhiều desktop ảo, animation mượt |
-| 📋 **Clipboard history** | Lịch sử copy-paste |
-
-→ Nhiều tính năng "thông minh" mà **không cần tự viết**!
-
----
-
-Vậy hướng mới là: **Kubuntu (base) + tool Mint + KDE theme đẹp + branding VNOS**. Bạn thích hướng này không? Mình sẽ cập nhật lại blueprint! 🐧
-
-### User Input
-
-Lựa chọn B: Bắt đầu từ Kubuntu (Ubuntu + KDE) → cài thêm tool Mint
-cái tool Mint đâu phải cứ cài vào là được
-
-### Planner Response
-
-Bạn nói đúng! Mình cần sửa lại. Tool Mint **không phải cứ `apt install` là xong** trên Kubuntu. Giải thích rõ:
-
-## Vấn đề thực tế:
-
-```
-Tool Mint nằm trong REPO của Mint, không phải repo Ubuntu
-
-Kubuntu (repo Ubuntu) → apt install mintupdate → ❌ Không tìm thấy!
-```
-
-### Cụ thể từng tool:
-
-| Tool | Cài trên Kubuntu? | Vấn đề |
-|---|---|---|
-| **Timeshift** | ✅ Có sẵn trên Ubuntu repo | Dùng được luôn |
-| **Warpinator** | ✅ Có trên Flathub | Flatpak OK |
-| **mintupdate** | ❌ Chỉ có trên Mint repo | Phụ thuộc `mintcommon`, `mint-mirrors`... |
-| **mintinstall** | ❌ Chỉ có trên Mint repo | Phụ thuộc hệ thống Mint |
-| **mintsources** | ❌ Chỉ có trên Mint repo | Quản lý repo kiểu Mint |
-| **mintdrivers** | ❌ Chỉ có trên Mint repo | Tích hợp sâu với Mint |
-| **mintreport** | ❌ Chỉ có trên Mint repo | Phụ thuộc Mint |
-| **Nemo** | ⚠️ Có thể cài nhưng thiếu plugin | Không tích hợp tốt |
-| **Webapp Manager** | ✅ Có trên GitHub | Cài thủ công được |
-| **Cinnamon** | ⚠️ Cài được nhưng conflict KDE | Không nên |
-
-## Vậy thực tế có 3 hướng đi:
-
-### Hướng 1: **Base Mint → Thay Cinnamon bằng KDE**
-
-```
-Linux Mint → Gỡ Cinnamon → Cài KDE Plasma
-
-✅ Giữ được TẤT CẢ tool Mint
-✅ Repo Mint vẫn hoạt động
-⚠️ Có thể còn sót package Cinnamon
-⚠️ Cần test kỹ xung đột
-```
-
-→ Mint có bản **LMDE** (Mint Debian Edition) — nhẹ hơn, dễ thay DE hơn.
-
-### Hướng 2: **Base Kubuntu → Tự viết/fork tool**
-
-```
-Kubuntu → Tự viết vnos-update, vnos-backup...
-
-✅ Sạch sẽ, không conflict
-✅ Kiểm soát 100%
-❌ Tốn công phát triển (vài tháng)
-❌ Cần biết Python + GTK/Qt
-```
-
-### Hướng 3: **Base Kubuntu → Thêm repo Mint** ⚠️
-
-```
-Kubuntu → Thêm repo Mint → Cài tool Mint
-
-⚠️ NGUY HIỂM — có thể conflict package
-⚠️ Mint repo có thể ghi đè package Ubuntu
-⚠️ Update có thể hỏng hệ thống
-❌ Không khuyến nghị
-```
-
-## Khuyến nghị thực tế:
-
-| Phase | Cách làm |
-|---|---|
-| **Phase 1** (ra MVP nhanh) | Base **Mint** → gỡ Cinnamon → cài **KDE Plasma** lên |
-| **Phase 2** (chuyên nghiệp) | Base **Kubuntu** → fork/viết tool riêng cho VNOS |
-
-### Phase 1 cụ thể:
-
-```bash
-# Bắt đầu từ Linux Mint
-# Cài KDE Plasma
-sudo apt install kde-plasma-desktop sddm
-
-# Đặt KDE làm mặc định
-sudo dpkg-reconfigure sddm
-
-# Gỡ Cinnamon (tuỳ chọn, tiết kiệm dung lượng)
-sudo apt remove cinnamon cinnamon-desktop-environment
-
-# → Kết quả: KDE đẹp + tool Mint vẫn chạy
-```
-
-→ Đây là **cách nhanh nhất** để có cả hai: **KDE đẹp + tool Mint mạnh**.
-
----
-
-Bạn muốn đi hướng nào? Mình sẽ cập nhật blueprint cho chính xác:
-1. **Mint + đổi sang KDE** (nhanh, MVP)
-2. **Kubuntu + viết tool riêng** (lâu hơn, chuyên nghiệp hơn)
-
-### User Input
-
-không cứ base từ mint đi chứ, mình chỉ tối ưu hoá cho người dùng thuận tiện hơn thôi, thắng được cái cài zalo, photoshop,... là oce rồi
-
-*Edited relevant file*
-
-### User Input
-
-VNOS App Center để cài Zalo, Photoshop... bằng 1 click cái này khả thi không nhỉ
-
-### Planner Response
-
-Khả thi! Và thực tế đã có người làm rồi. Giải thích:
-
-## Đã có tiền lệ — Lutris
-
-**Lutris** (lutris.net) làm **đúng y cái này** cho game:
-
-```
-Lutris:
- Người dùng → Bấm "Install" trên game → Script tự chạy:
- 1. Tạo Wine prefix
- 2. Cài dependencies (DirectX, vcredist...)
- 3. Tải + cài game
- 4. Tạo shortcut
- → Xong! Chơi luôn.
-```
-
-→ VNOS App Center = **Lutris nhưng cho app thường** (Zalo, Photoshop, Office...).
-
-## Cách hoạt động kỹ thuật:
-
-```
-Mỗi app có 1 file script (YAML hoặc JSON):
-
-zalo.yaml:
- name: Zalo
- method: webapp ← Dùng Webapp Manager
- url: https://chat.zalo.me
- icon: zalo.png
-
-photoshop-cs6.yaml:
- name: Adobe Photoshop CS6
- method: bottles ← Dùng Bottles/Wine
- runner: wine-9.0
- dependencies:
- - vcredist2013
- - dotnet48
- installer: photoshop_cs6_setup.exe ← User phải có file cài
- tricks:
- - fontsmooth=rgb
- - win10
-```
-
-Khi user bấm **"Cài"**:
-
-```
-1. VNOS App Center đọc script
-2. Tự tạo Bottle/Wine prefix
-3. Cài dependencies
-4. Hướng dẫn user chọn file .exe (nếu cần)
-5. Chạy installer
-6. Tạo shortcut trên desktop
-→ Xong ✅
-```
-
-## Mức độ khả thi từng app:
-
-| App | Khả thi? | Cách | Ghi chú |
-|---|---|---|---|
-| **Zalo** | ✅ Rất dễ | Webapp Manager (PWA) | Không cần Wine |
-| **Photoshop CS6** | ✅ Chạy tốt | Wine/Bottles | Bản CS6 chạy ổn trên Wine |
-| **Photoshop CC 2024** | ❌ Không | — | Bản mới cần Adobe Cloud, không chạy |
-| **MS Office 2016** | ⚠️ Được | Wine/Bottles | Chạy nhưng đôi khi lỗi vặt |
-| **MS Office 365** | ❌ | — | Dùng web: office.com |
-| **AutoCAD LT** | ⚠️ Tuỳ bản | Wine/Bottles | Bản cũ OK, mới thì không |
-| **Game nhẹ** | ✅ | Steam/Lutris | Có sẵn Proton |
-
-## Thành thật về giới hạn:
-
-```
-CÓ THỂ làm:
- ✅ App Windows CŨ, đơn giản → Wine chạy tốt
- ✅ Web app → PWA, hoàn hảo
- ✅ Game trên Steam → Proton xử lý
-
-KHÔNG THỂ làm:
- ❌ App cần online activation mới (Adobe CC, Office 365)
- ❌ App có kernel-level protection
- ❌ App cần driver Windows đặc biệt
-```
-
-## Phân biệt: "1 click" thực sự nghĩa là gì
-
-```
-Zalo: Thật sự 1 click ✅ (PWA, tự động hoàn toàn)
-
-Photoshop CS6: "1 click" = bấm cài → hệ thống hỏi:
- "Chọn file PhotoshopCS6.exe của bạn"
- → User chọn file → Tự cài → Xong
- (Vì bản quyền, VNOS không thể kèm file .exe)
-```
-
-## Bắt đầu đơn giản — MVP:
-
-Phase 1 chưa cần viết GUI App Center phức tạp. Chỉ cần:
-
-```
-📁 Desktop hoặc Start Menu có folder "Ứng dụng Windows"
-├── 💬 Cài Zalo.desktop → Chạy script tạo PWA
-├── 🎨 Cài Photoshop.desktop → Chạy script Bottles
-├── 📊 Cài MS Office.desktop → Chạy script Bottles
-└── 📖 Hướng dẫn.desktop → Mở trang web hướng dẫn
-```
-
-→ Double-click → Script tự chạy → Xong. **GUI đẹp viết sau**.
-
----
-
-**Tóm lại**: Hoàn toàn khả thi, đặc biệt cho app phổ biến như Zalo (PWA) và Photoshop CS6 (Wine). Cái hay là VNLF **test trước** rồi viết script sẵn, người dùng chỉ bấm chạy!
-
-Bạn muốn mình viết thử script cài Zalo PWA để test không?
-
-### User Input
-
-lutris.net là gì nó làm gì tích hợp vào mình thế nào
-
-### Planner Response
-
-## Lutris là gì?
-
-**Lutris** là một **trình quản lý game trên Linux** — open source, miễn phí. Nó giúp cài và chạy game từ **mọi nguồn** trên Linux:
-
-```
-Lutris = 1 app quản lý TẤT CẢ game của bạn
- │
- ├── Game Linux native
- ├── Game Windows (qua Wine)
- ├── Game Steam
- ├── Game GOG
- ├── Game cũ (DOS, retro)
- └── Game console giả lập (PS2, Wii...)
-```
-
-## Cách Lutris hoạt động:
-
-```
-Bước 1: Bạn vào lutris.net → Tìm game (ví dụ: League of Legends)
-
-Bước 2: Bấm "Install" → Lutris app mở lên
-
-Bước 3: Lutris TỰ ĐỘNG:
- ┌──────────────────────────────────────┐
- │ Đang cài League of Legends... │
- │ │
- │ ✅ Tạo Wine prefix │
- │ ✅ Cài DirectX 9 │
- │ ✅ Cài Visual C++ Runtime │
- │ 🔄 Đang tải game client... │
- │ ⬜ Tạo shortcut │
- │ │
- │ ████████░░░░ 65% │
- └──────────────────────────────────────┘
-
-Bước 4: Xong → Bấm Play → Chơi luôn
-```
-
-## Bí mật của Lutris: **Install Scripts**
-
-Trên `lutris.net`, **cộng đồng** viết sẵn script cài cho từng game:
-
-```yaml
-# Ví dụ script cho Photoshop CS6 trên lutris.net:
-name: Adobe Photoshop CS6
-runner: wine
-wine:
- version: lutris-GE-7.2
- prefix: $GAMEDIR
-
-dependencies:
- - vcredist2013
- - msxml3
- - gdiplus
-
-installer:
- - task:
- name: wineexec
- executable: PhotoshopCS6.exe
-```
-
-→ **Cộng đồng viết script → test → chia sẻ → ai cũng dùng được**
-
-Hiện tại lutris.net có **hàng nghìn script** cho đủ loại game + app.
-
-## Lutris vs Bottles:
-
-| | Lutris | Bottles |
-|---|---|---|
-| **Chuyên về** | Game | App tổng quát |
-| **Script cộng đồng** | ✅ Hàng nghìn | ❌ Không có |
-| **GUI** | Tốt | Đẹp hơn |
-| **Quản lý Wine** | Nhiều phiên bản Wine | Nhiều phiên bản Wine |
-| **Hỗ trợ Steam/GOG** | ✅ Tích hợp | ❌ |
-| **Giả lập console** | ✅ (RetroArch, Dolphin...) | ❌ |
-
-## Tích hợp vào VNOS thế nào:
-
-### Cách đơn giản nhất — cài sẵn cả hai:
-
-```
-VNOS
-├── Bottles → Cho app Windows (Photoshop, Office, Zalo...)
-├── Lutris → Cho game Windows
-└── Steam → Cho game Steam (có Proton)
-```
-
-Cài Lutris trên Mint rất dễ:
-```bash
-sudo apt install lutris
-```
-
-### Trong VNOS Welcome App:
-
-```
-┌─────────────────────────────────────────┐
-│ 🪷 Bạn muốn cài gì? │
-│ │
-│ ┌─────────┐ ┌─────────┐ │
-│ │ 💼 │ │ 🎮 │ │
-│ │ Phần mềm│ │ Game │ │
-│ │ Windows │ │ │ │
-│ │ │ │ │ │
-│ │→ Bottles│ │→ Lutris │ │
-│ └─────────┘ └─────────┘ │
-│ │
-│ Phần mềm: Zalo, Photoshop, Office │
-│ Game: mọi game Windows trên lutris.net │
-└─────────────────────────────────────────┘
-```
-
-## Ưu điểm lớn khi tích hợp Lutris:
-
-> Bạn **không cần tự viết script** cho game. Cộng đồng Lutris đã viết sẵn hàng nghìn script. VNOS chỉ cần cài Lutris → người dùng lên lutris.net → chọn game → bấm install → xong.
-
-**VNLF chỉ cần tập trung viết script cho app đặc thù Việt Nam** (Zalo, HTKK...) — phần mà cộng đồng quốc tế không làm!
-
----
-
-Tóm lại:
-- **Lutris** = giải quyết gaming
-- **Bottles** = giải quyết app văn phòng
-- **VNLF** = viết script cho app Việt Nam riêng (Zalo, HTKK)
-- → **Cài sẵn cả 3 hướng** trong VNOS, người dùng tuỳ chọn!
-
-### User Input
-
-mình tự deliver luôn, làm 1 cái app rồi người dùng pick gì thì dekiver qua, ví dụ game thì tự tim qua Lutris, app thì Bottles hoặc wine, mà bottles và wine khác gì nhau
-
-### Planner Response
-
-Ý tưởng đó hay — 1 app duy nhất làm "cổng trung gian", route người dùng đến đúng tool. Giờ giải thích Bottles vs Wine:
-
-## Wine vs Bottles — Quan hệ:
-
-```
-Wine = ĐỘNG CƠ xe (engine)
-Bottles = XE HƠI chứa động cơ đó (GUI wrapper)
-
-Bạn CÓ THỂ dùng động cơ trần (Wine thuần) → nhưng phải tự lái
-Hoặc dùng xe hơi (Bottles) → dễ hơn, đẹp hơn, an toàn hơn
-```
-
-### Wine — cái gốc
-
-```
-Wine = "Wine Is Not an Emulator"
-
-Nó KHÔNG phải máy ảo. Nó DỊCH lệnh Windows → Linux realtime:
-
-App Windows gọi: CreateFile("C:\test.txt")
- │
- ▼
-Wine dịch thành: open("/home/user/test.txt")
- │
- ▼
-Linux thực thi: Tạo file thật trên ổ cứng
-```
-
-Dùng Wine thuần:
-```bash
-# Cài app
-wine PhotoshopCS6.exe
-
-# Chạy app
-wine "C:\Program Files\Photoshop\photoshop.exe"
-
-# Cấu hình
-winecfg # Chỉnh windows version, DLL...
-winetricks # Cài thêm DirectX, .NET, font...
-```
-
-**Vấn đề**: Mỗi app cần cấu hình khác nhau → quản lý bằng tay → rối → lỗi.
-
-### Bottles — GUI quản lý Wine
-
-```
-Bottles giúp bạn:
-
-┌──────────────────────────────────────────┐
-│ Bottles │
-│ │
-│ 🍾 Bottle "Photoshop" │
-│ Wine version: 9.0 │
-│ Windows: Win10 │
-│ DXVK: Bật │
-│ DLL: vcredist2013, dotnet48 │
-│ ──────────────────── │
-│ 📁 C:\ riêng biệt │ ← Mỗi bottle = 1 "máy Windows"
-│ Không ảnh hưởng bottle khác │ cách ly hoàn toàn
-│ │
-│ 🍾 Bottle "Office" │
-│ Wine version: 8.0 │
-│ Windows: Win7 │
-│ ... │
-│ │
-│ 🍾 Bottle "Game" │
-│ Wine version: GE-Proton │
-│ DXVK: Bật │
-│ ... │
-└──────────────────────────────────────────┘
-```
-
-### So sánh trực tiếp:
-
-| | Wine (thuần) | Bottles |
-|---|---|---|
-| **Bản chất** | Engine dịch lệnh | GUI quản lý Wine |
-| **Giao diện** | Terminal | Đồ hoạ đẹp |
-| **Cách ly app** | ❌ Chung 1 prefix | ✅ Mỗi app 1 bottle |
-| **Quản lý version** | Tự tải, tự cài | Chọn trong danh sách |
-| **Dependencies** | `winetricks` (CLI) | Click chọn trong GUI |
-| **Backup** | Tự copy folder | Export/Import 1 click |
-| **Dành cho** | Người biết CLI | Người dùng phổ thông |
-
-## Cho VNOS — dùng gì?
-
-```
-Người dùng VNOS = phổ thông → KHÔNG nên thấy Wine thuần
-
-Phía sau: Wine (engine) ← luôn cần, không thể thiếu
-Phía trước: Bottles (GUI) ← người dùng chỉ thấy cái này
-```
-
-## Ý tưởng app VNOS của bạn:
-
-```
-┌─────────────────────────────────────────────┐
-│ 🪷 VNOS Center ─ □ x│
-├─────────────────────────────────────────────┤
-│ │
-│ Bạn muốn cài gì? │
-│ │
-│ ┌───────────┐ ┌───────────┐ │
-│ │ 💼 │ │ 🎮 │ │
-│ │ Ứng dụng │ │ Trò chơi │ │
-│ │ │ │ │ │
-│ └─────┬─────┘ └─────┬─────┘ │
-│ │ │ │
-│ Bottles (ẩn) Lutris (ẩn) │
-│ │ │ │
-│ ┌────▼────┐ ┌─────▼────┐ │
-│ │Zalo │ │ Game A │ │
-│ │Photoshop│ │ Game B │ │
-│ │Office │ │ Game C │ │
-│ └─────────┘ └──────────┘ │
-└─────────────────────────────────────────────┘
-
-Người dùng chỉ thấy: "VNOS Center"
-Không biết đằng sau là: Wine + Bottles + Lutris + Webapp Manager
-```
-
-**Đây là cái mà Zorin OS cũng đang làm** — app "Windows App Support" của Zorin cũng chỉ là Wine ẩn phía sau, nhưng người dùng không biết.
-
----
-
-Tóm lại:
-- **Wine** = engine (luôn cần, ẩn phía sau)
-- **Bottles** = GUI cho app thường (ẩn phía sau)
-- **Lutris** = GUI cho game (ẩn phía sau)
-- **VNOS Center** = 1 app duy nhất bạn tự viết, gọi đến mấy cái kia phía sau
-
-Bạn muốn mình thiết kế chi tiết hơn cái VNOS Center không?
-
-### User Input
-
-rồi cập nhật vô implementation plan
-
-*Viewed [implementation_plan.md](file:///Users/dung.leviet/.gemini/antigravity/brain/7fa858e8-539f-45b9-a2db-c75bba6fe42c/implementation_plan.md) *
-
-*Edited relevant file*
-
-### User Input
-
-Bottles cài được zalo offical chưa
-
-### Planner Response
-
-Câu hỏi thực tế! Mình tìm hiểu cho bạn:
-
-*Searched web for Zalo desktop app Wine Bottles Linux 2025 2026 install*
-
-### Planner Response
-
-Tin tốt! Kết quả nghiên cứu:
-
-## Zalo trên Linux — Tình hình thực tế (2025-2026)
-
-### ✅ CÓ, Bottles cài được Zalo Official
-
-| Cách | Trạng thái | Chi tiết |
-|---|---|---|
-| **Bottles + ZaloSetup.exe** | ✅ Chạy được | Nhắn tin, gửi file OK. Video call ❌ (Wine không hỗ trợ camera tốt) |
-| **Wine thuần** | ✅ Chạy được | Cần config font tiếng Việt (winetricks corefonts). Một số bản bị crash |
-| **Snap (Unofficial)** | ✅ Ổn định | Dựa trên Zalo Web, có dark mode, chạy nền, tray icon. Cập nhật 7/2025 |
-| **GitHub port (Unofficial)** | ⚠️ Hạn chế | Port từ bản macOS, thiếu tính năng gọi + đồng bộ tin nhắn |
-| **PWA (Zalo Web)** | ✅ Tốt nhất | Đầy đủ tính năng, gọi thoại + video OK |
-
-### Cài qua Bottles cụ thể:
-
-```
-1. Mở Bottles → Tạo bottle mới (runner: Caffe)
-2. Tải ZaloSetup.exe (cần đổi User-Agent sang Windows trên trình duyệt)
-3. Run Executable → chọn ZaloSetup.exe
-4. Cài đặt bình thường
-5. Tạo shortcut → Xong ✅
-```
-
-**Giới hạn khi dùng Bottles:**
-- ✅ Nhắn tin — OK
-- ✅ Gửi file/ảnh — OK
-- ✅ Gọi thoại — OK (phần lớn)
-- ❌ **Video call** — Không ổn (Wine không truy cập camera tốt)
-- ⚠️ Đôi khi crash khi Zalo tự update
-
-### Vậy VNOS nên dùng cách nào cho Zalo?
-
-Có **3 lựa chọn** xếp theo khuyến nghị:
-
-| Ưu tiên | Cách | Lý do |
-|---|---|---|
-| 🥇 **1** | **Snap package** (Unofficial Zalo Chat) | Ổn định nhất, cập nhật đều, có dark mode, chạy nền |
-| 🥈 **2** | **PWA** (Webapp Manager) | Đơn giản nhất, đầy đủ tính năng kể cả video call |
-| 🥉 **3** | **Bottles** (Zalo official .exe) | Đầy đủ nhất nhưng video call lỗi, đôi khi crash |
-
-> **Khuyến nghị cho VNOS**: Cài sẵn **Snap package** (Unofficial Zalo Chat) làm mặc định. Trong VNOS Center, cho thêm option cài bản Bottles nếu user muốn bản Windows gốc.
-
-Bạn muốn test thử cách nào không?
-
-### User Input
-
-ibus-unikey đổi thành fcitx5-lotus và thêm cái gì đó về AI vào được k, chạy offline cũng được
-
-*Searched web for fcitx5-lotus Vietnamese input method Linux*
-
-*Searched web for offline AI Linux desktop local LLM 2025 ollama integration*
-
-### Planner Response
-
-Good — đã có đủ thông tin. Giờ cập nhật blueprint:
-
-*Edited relevant file*
-
-### User Input
-
-Cinnamon desktop sao vẫn dùng cái này
-
-### Planner Response
-
-Ah đúng rồi, xin lỗi! Bạn đã nói Cinnamon xấu và muốn UI như Win11/macOS mà mình vẫn chưa đổi.
-
-Vấn đề là: **Mint = Cinnamon**. Muốn bỏ Cinnamon thì phải chọn lại:
-
-## 3 hướng thực tế:
-
-### Hướng A: **Mint + thay Cinnamon bằng KDE Plasma** ✅ Khuyến nghị
-
-```
-Giữ: Repo Mint, Timeshift, mintupdate, Nemo, Warpinator...
-Bỏ: Cinnamon
-Thay: KDE Plasma (đẹp nhất, tuỳ biến nhất)
-```
-
-- ✅ Giữ được tool Mint
-- ✅ KDE đẹp như Win11/macOS
-- ⚠️ Cần test kỹ — một số tool Mint dùng GTK, KDE dùng Qt (hai framework UI khác nhau, nhưng vẫn chạy chung được)
-
-### Hướng B: **Kubuntu + cài một số tool Mint**
-
-```
-Base: Kubuntu (Ubuntu + KDE sẵn)
-Thêm: Timeshift (có sẵn), Warpinator (Flatpak), Webapp Manager (GitHub)
-Bỏ: mintupdate, mintinstall (thay bằng tool KDE)
-```
-
-- ✅ KDE tích hợp hoàn hảo
-- ✅ Timeshift, Warpinator vẫn có
-- ❌ Mất mintupdate (thay bằng KDE Discover + unattended-upgrades)
-
-### Hướng C: **Mint + theme Cinnamon cho đẹp**
-
-```
-Cinnamon + theme hiện đại + layout Win11
-```
-
-- ⚠️ Tuỳ biến được nhiều, nhưng **vẫn có giới hạn** — Cinnamon không bao giờ mượt như KDE
-
-## So sánh giao diện:
-
-```
-Cinnamon mặc định: KDE Plasma tuỳ biến:
-┌──────────────────┐ ┌──────────────────────────┐
-│ Trông như Win7 │ │ Trông như Win11/macOS │
-│ Góc vuông │ │ Bo tròn, blur, trong suốt │
-│ Animation cứng │ │ Animation mượt mà │
-│ Theme ít │ │ Hàng trăm theme đẹp │
-└──────────────────┘ └──────────────────────────┘
-```
-
-## Mình khuyến nghị **Hướng A**: Mint + KDE
-
-Vì giữ được **cả hai thế giới**: tool mạnh của Mint + giao diện đẹp của KDE. Một số tool Mint dùng GTK sẽ trông hơi khác so với app KDE (Qt), nhưng vẫn **chạy bình thường** — không conflict.
-
-Bạn chốt hướng nào để mình cập nhật blueprint dứt điểm?
-
-1. **A — Mint + KDE** (khuyến nghị)
-2. **B — Kubuntu + tool Mint chọn lọc**
-3. **C — Cinnamon nhưng theme đẹp**
-
-### User Input
-
-Cinnamon nhưng mode UI thành kiểu macos/win11 được không
-
-### Planner Response
-
-**Được!** Cinnamon tuỳ biến được khá nhiều. Xem cụ thể:
-
-## Cinnamon → macOS style:
-
-```
-┌──────────────────────────────────────────────────┐
-│ 🍎 Files Edit View 🔍 🔔 📶 🔋 11:12│ ← Top panel
-│──────────────────────────────────────────────────│
-│ │
-│ Desktop │
-│ (Wallpaper đẹp) │
-│ │
-│ ┌──────────────────────────────┐ │
-│ │ 📁 🌐 💬 📝 🏪 ⚙️ │ │ ← Plank dock
-│ └──────────────────────────────┘ │
-└──────────────────────────────────────────────────┘
-
-Cần:
- ✅ Theme: WhiteSur GTK + WhiteSur Icon
- ✅ Plank dock (thay taskbar mặc định)
- ✅ Top panel: chỉ hiện menu bar + system tray
- ✅ Font: San Francisco hoặc Inter
-```
-
-## Cinnamon → Win11 style:
-
-```
-┌──────────────────────────────────────────────────┐
-│ 🔔 📶 🔋 │
-│ │
-│ Desktop │
-│ │
-│ │
-│ ┌────────────────────────────────────┐ │
-│ │ 📁 🌐 💬 📝 🏪 🔍 ▲▼ │ │ ← Panel dưới, icon giữa
-│ └────────────────────────────────────┘ │
-└──────────────────────────────────────────────────┘
-
-Cần:
- ✅ Theme: Fluent GTK + Fluent Icon
- ✅ Panel layout: giữa (Cinnamon hỗ trợ)
- ✅ Bo tròn góc cửa sổ
- ✅ Font: Segoe UI hoặc Inter
-```
-
-## Những gì Cinnamon LÀM ĐƯỢC:
-
-| Tuỳ biến | Hỗ trợ? | Cách |
-|---|---|---|
-| Đổi GTK theme | ✅ | Cài theme, chọn trong Settings |
-| Đổi icon | ✅ | WhiteSur, Fluent, Tela... |
-| Panel dưới/trên | ✅ | Kéo thả trong Settings |
-| Icon trên panel — giữa | ✅ | Cinnamon hỗ trợ |
-| Dock kiểu macOS | ✅ | Cài **Plank** dock |
-| Bo tròn góc cửa sổ | ✅ | Qua theme CSS |
-| Font tuỳ chỉnh | ✅ | Settings |
-| Dark/Light mode | ✅ | Có sẵn |
-
-## Những gì Cinnamon KHÔNG LÀM ĐƯỢC (so với KDE):
-
-| Tuỳ biến | Cinnamon | KDE |
-|---|---|---|
-| Blur/trong suốt nền | ❌ Không native | ✅ Có sẵn |
-| Animation mượt kiểu macOS | ⚠️ Hạn chế | ✅ Mượt |
-| Đổi layout 1 click (Win/Mac) | ❌ Phải tự chỉnh | ✅ Zorin-style |
-| Widget trên desktop | ⚠️ Desklets (ít) | ✅ Nhiều widget |
-| Window tiling đẹp | ⚠️ Cơ bản | ✅ Nâng cao |
-
-## Đánh giá thực tế:
-
-```
-Cinnamon + theme đẹp = đạt khoảng 70-80% visual của Win11/macOS
-KDE + theme đẹp = đạt khoảng 95% visual của Win11/macOS
-```
-
-→ **Cinnamon đủ đẹp cho đa số người dùng**, chỉ thiếu hiệu ứng blur/trong suốt và animation mượt.
-
-## Kết luận:
-
-> Nếu bạn muốn **giữ Mint + giữ Cinnamon** và chỉ đổi theme cho đẹp → **hoàn toàn được**, đạt 70-80% visual Win11/macOS. Cách đơn giản nhất, ít rủi ro nhất.
-
-Bạn muốn chốt hướng này (Cinnamon + theme đẹp) và mình cập nhật blueprint lần cuối không?
-
-### User Input
-
-KDE mà nhét vào mint thì bị lỗi gì, đi tìm xem có ai report issue gì không
-
-*Searched web for install KDE Plasma on Linux Mint issues problems conflicts 2024 2025*
-
-*Searched web for Linux Mint KDE desktop environment replace Cinnamon reddit forum issues*
-
-### Planner Response
-
-Đã tìm được. Kết quả **không lạc quan** lắm cho KDE trên Mint:
-
-## 🚨 Lỗi thực tế khi cài KDE lên Mint (từ Reddit + Forum):
-
-### Lỗi nghiêm trọng:
-
-| Lỗi | Chi tiết | Nghiêm trọng? |
-|---|---|---|
-| **mintupdate freeze** | Tool cập nhật Mint bị đơ/lỗi khi KDE chạy | 🔴 Cao |
-| **Cinnamon bị hỏng** | Cài KDE xong, quay lại Cinnamon → lỗi giao diện | 🔴 Cao |
-| **File manager conflict** | Nemo (Mint) vs Dolphin (KDE) tranh nhau — mở file gọi sai app | 🟡 TB |
-| **Máy nóng + tốn pin** | KDE trên Mint gây tăng nhiệt, pin tụt nhanh hơn | 🟡 TB |
-| **RAM tăng gấp đôi** | Cinnamon idle ~800MB → KDE idle ~1.5-2GB | 🟡 TB |
-| **Theme lỗi** | GTK (Mint) vs Qt (KDE) — icon, font, màu sắc không đồng bộ | 🟡 TB |
-| **KDE Discover lỗi** | Software Center KDE không mở được / glitch | 🟡 TB |
-| **KDE version cũ** | Mint 22 chỉ có KDE 5.27, không phải KDE 6 mới nhất | 🟢 Thấp |
-
-### Nguyên nhân gốc:
-
-```
-Mint dùng GTK ──────── KDE dùng Qt
- │ │
- Hai hệ thống UI khác nhau │
- │ │
- Cài chung → CONFLICT
- - App gọi nhầm nhau
- - Theme không khớp
- - Tool Mint (GTK) hoạt động lạ trên KDE (Qt)
-```
-
-### Cộng đồng Reddit nói gì:
-
-> *"Mint dropped KDE support after version 18 for a reason. Don't do it."*
-
-> *"If you want KDE, use Kubuntu or KDE Neon. Don't force KDE onto Mint."*
-
-> *"I installed KDE on Mint. It worked for 2 weeks then slowly fell apart."*
-
----
-
-## Kết luận — 3 lựa chọn rõ ràng:
-
-| Lựa chọn | Rủi ro | Visual | Tool Mint |
-|---|---|---|---|
-| **A. Mint + Cinnamon + theme đẹp** | ✅ Không rủi ro | 70-80% Win11/macOS | ✅ Đầy đủ |
-| **B. Mint + KDE** | ❌ Nhiều lỗi (đã report) | 95% Win11/macOS | ⚠️ Một số lỗi |
-| **C. Kubuntu (KDE sẵn)** | ✅ Ổn định | 95% Win11/macOS | ⚠️ Chỉ Timeshift + Warpinator |
-
-### Khuyến nghị cuối cùng:
-
-> **Hướng A** (Mint + Cinnamon + theme đẹp) là **an toàn và thực tế nhất**. Cinnamon với theme WhiteSur (macOS) hoặc Fluent (Win11) + Plank dock trông **đủ đẹp** cho người dùng phổ thông. Và quan trọng nhất: **không lỗi, ổn định, giữ được hết tool Mint**.
-
-Bạn quyết thế nào?
-
-### User Input
-
-custom Cinnamon thành chrome os UI được không
-
-### Planner Response
-
-**Được!** Và Chrome OS UI thực ra rất đơn giản — phù hợp với Cinnamon luôn:
-
-## Chrome OS trông như thế nào:
-
-```
-┌──────────────────────────────────────────────────┐
-│ │
-│ │
-│ Desktop │
-│ (Wallpaper sạch sẽ) │
-│ │
-│ │
-│ │
-├──────────────────────────────────────────────────┤
-│ 🔍 📁 🌐 💬 📝 🔔 📶 🔋 11:36 │ ← Shelf (taskbar)
-└──────────────────────────────────────────────────┘
- ↑
- Bấm vào = mở Launcher (giống app drawer Android)
-```
-
-**Đặc điểm Chrome OS:**
-- Minimalist, sạch sẽ
-- Bo tròn góc mọi thứ
-- Taskbar (shelf) ở dưới
-- Launcher tròn (giống app drawer)
-- Màu sắc nhẹ nhàng, material design
-- Không nhiều hiệu ứng phức tạp
-
-## Cinnamon → Chrome OS — Khả thi:
-
-| Thành phần | Chrome OS | Cinnamon custom |
-|---|---|---|
-| Shelf (taskbar) dưới | ✅ | ✅ Có sẵn |
-| Icon trung tâm | ✅ | ✅ Hỗ trợ |
-| Bo tròn góc cửa sổ | ✅ | ✅ Qua GTK theme |
-| Launcher / App drawer | ✅ | ✅ Menu Cinnamon có thể đổi layout |
-| System tray phải | ✅ | ✅ Có sẵn |
-| Màu material design | ✅ | ✅ Qua GTK theme |
-| Clean, ít clutter | ✅ | ✅ Bỏ icon desktop |
-| Blur/transparent | ⚠️ Nhẹ | ❌ Cinnamon không hỗ trợ native |
-
-## Cần gì để custom:
-
-```
-Cinnamon → Chrome OS style:
-
-1. GTK Theme: Colloid hoặc Orchis (material, bo tròn)
-2. Icon: Tela Circle (tròn, giống Chrome OS)
-3. Panel: Dưới, icon giữa
-4. Menu: Cinnamenu applet (layout grid, giống launcher)
-5. Font: Product Sans / Inter / Roboto
-6. Wallpaper: Gradient nhẹ kiểu Chrome OS
-7. Bỏ: Icon trên desktop (để sạch)
-```
-
-## So sánh Chrome OS vs macOS vs Win11 — trên Cinnamon:
-
-| Style | Độ khó | Kết quả |
-|---|---|---|
-| **Chrome OS** | ⭐ Dễ nhất | 85-90% — vì Chrome OS bản thân đã đơn giản |
-| macOS | ⭐⭐ | 70-80% — cần Plank dock, thiếu blur |
-| Win11 | ⭐⭐ | 70-80% — thiếu centered taskbar animation |
-
-> **Chrome OS style là DỄ NHẤT** để custom trên Cinnamon, vì Chrome OS bản chất đã minimalist, không cần hiệu ứng phức tạp!
-
-## 💡 Thực ra — Budgie = Chrome OS
-
-Nhớ lúc đầu bạn chọn **Budgie** không? Budgie desktop trông **gần giống Chrome OS nhất** trong tất cả các DE Linux:
-
-```
-Budgie mặc định ≈ 80% Chrome OS sẵn rồi
-Cinnamon + theme ≈ 85% Chrome OS (phải custom)
-```
-
-**Nhưng vấn đề**: Budgie không có tool Mint. Còn Cinnamon + theme Chrome OS thì **giữ được hết tool Mint + trông sạch đẹp**.
-
----
-
-Vậy bạn muốn VNOS theo style nào?
-1. **Chrome OS** — sạch, đơn giản, dễ custom nhất trên Cinnamon
-2. **macOS** — đẹp nhưng thiếu blur
-3. **Win11** — quen thuộc nhưng thiếu hiệu ứng
-4. **VNOS style riêng** — kết hợp nhiều thứ
-
-### User Input
-
-không, tôi muốn Cinnamon custom như này nè
-
-### Planner Response
-
-Rõ rồi! Mình thấy trong ảnh là **Chrome OS Launcher** — giao diện cụ thể gồm:
-
-```
-Ảnh của bạn:
-┌─────────────────────────────────────────────────────┐
-│ │
-│ ┌─────────────────────────────┐ │
-│ │ 🔍 Search your shortcuts... │ │
-│ │ Continue where you left off │ │
-│ │ │ │
-│ │ ⬤ ⬤ ⬤ ⬤ ⬤ │ Wallpaper │
-│ │ ⬤ ⬤ ⬤ ⬤ ⬤ │ (đỏ gradient) │
-│ │ ⬤ ⬤ ⬤ ⬤ ⬤ │ │
-│ │ ⬤ ⬤ ⬤ ⬤ ⬤ │ │
-│ │ ⬤ ⬤ ⬤ ⬤ ⬤ │ │
-│ │ (Icon tròn, grid layout) │ │
-│ └─────────────────────────────┘ │
-├─────────────────────────────────────────────────────┤
-│ ⬤ 📁 ✉️ 📅 🌐 🎵 📷 ... 📶 🔋 Oct 21 4:29 │ ← Shelf
-└─────────────────────────────────────────────────────┘
-```
-
-## Cinnamon custom thành như vậy — ĐƯỢC, cụ thể:
-
-### 1. **Bottom shelf** (taskbar dưới, icon trung tâm)
-→ ✅ Cinnamon panel dưới, dời icon vào giữa — **có sẵn**
-
-### 2. **App Launcher dạng grid** (bấm vào mở lưới app)
-→ ✅ Dùng **Cinnamenu** applet (thay thế menu mặc định):
-
-```
-Cinnamenu hỗ trợ:
- ✅ Grid layout (lưới icon giống Chrome OS)
- ✅ Search bar ở trên
- ✅ Icon lớn, tròn
- ✅ Mở từ nút trên panel
-```
-
-### 3. **Icon tròn**
-→ ✅ Dùng icon theme **Tela Circle** hoặc **Colloid Circle**
-
-### 4. **Nền launcher trong suốt/tối**
-→ ⚠️ Cinnamon hỗ trợ panel transparent, nhưng menu background phải tuỳ chỉnh CSS. **Được nhưng cần code theme**
-
-### 5. **System tray bên phải** (Wi-Fi, pin, giờ)
-→ ✅ Có sẵn
-
-### 6. **Wallpaper gradient đỏ**
-→ ✅ Tuỳ chọn wallpaper
-
-## Cách implement:
-
-| Thành phần | Tool/Applet | Ghi chú |
-|---|---|---|
-| Panel dưới | Cinnamon panel (mặc định) | Đổi vị trí, chỉnh icon giữa |
-| App launcher grid | **Cinnamenu** applet | Cài từ Spices, chọn Grid View |
-| Search bar | Cinnamenu có sẵn | Tìm app, file, settings |
-| Icon tròn | Tela Circle icon theme | Cài từ Gnome-look |
-| GTK theme bo tròn | Colloid / Orchis | Material design |
-| Nền tối launcher | Custom CSS trong theme | Tuỳ chỉnh `.menu-background` |
-| Shelf semi-transparent | Panel settings → opacity | Có sẵn trong Cinnamon |
-
-## Cài Cinnamenu (launcher grid):
-
-```bash
-# Mở Cinnamon Applets → Tải Cinnamenu
-# Hoặc từ terminal:
-# Vào Settings → Applets → Download → Tìm "Cinnamenu"
-```
-
-Cinnamenu trông như này:
-
-```
-┌──────────────────────────────┐
-│ 🔍 Tìm kiếm... │
-├──────────────────────────────┤
-│ ⬤ Firefox ⬤ Files │
-│ ⬤ Office ⬤ VLC │
-│ ⬤ Zalo ⬤ Settings │
-│ ⬤ Terminal ⬤ Photos │
-│ ⬤ Bottles ⬤ VNOS Ctr │
-│ ... │
-│ │
-│ ⭐ Favourites 📁 All Apps │
-└──────────────────────────────┘
-```
-
-→ **Gần giống hệt** Chrome OS launcher trong ảnh bạn gửi!
-
-## Tóm lại:
-
-> Cinnamon + Cinnamenu + Tela Circle icons + custom theme = **85-90% giao diện Chrome OS** trong ảnh bạn gửi. Phần còn lại (10-15%) là blur/transparency effect mà Cinnamon hạn chế.
-
-Bạn muốn mình cập nhật blueprint lần cuối theo hướng **Chrome OS style** này không?
-
-### User Input
-
-có thằng nào rice rồi mình clone về update thôi
-
-### Planner Response
-
-Ý tưởng thông minh! "Rice" = customization đã làm sẵn. Để mình tìm:
-
-*Searched web for Cinnamon desktop Chrome OS rice theme dotfiles GitHub 2024 2025*
-
-*Searched web for Linux Mint Cinnamon ChromeOS look theme customization unixporn reddit*
-
-### Planner Response
-
-Tìm thấy rồi! Có sẵn cả theme lẫn dotfiles:
-
-## Có sẵn — Clone về dùng luôn:
-
-### 1. 🎨 **Chrome OS Theme (chính thức trên Cinnamon Spices)**
-
-Cài **1 lệnh** trên Linux Mint:
-```
-Settings → Themes → Download → Tìm "Chrome OS"
-```
-- Tác giả: **elbullazul**
-- Cập nhật: **7/2024** (còn maintain)
-- Material design, giống Chrome OS
-- Source: [Cinnamon Spices](https://cinnamon-spices.linuxmint.com/)
-
-### 2. 🎨 **ChromeOS GTK Theme (GitHub)**
-
-```bash
-git clone https://github.com/vinceliuice/ChromeOS-theme.git
-cd ChromeOS-theme
-./install.sh
-```
-- Tác giả: **vinceliuice** (nổi tiếng, làm nhiều theme)
-- GTK3/4 theme đầy đủ
-- Bo tròn, material design
-
-### 3. 📁 **Cinnamon dotfiles (GitHub)**
-
-```bash
-# Bộ dotfiles Cinnamon đầy đủ
-git clone https://github.com/SpreadiesInSpace/cinnamon-dotfiles.git
-```
-- Panel layout, theme, config sẵn
-- Copy vào `~/.config/cinnamon/` là xong
-
-### 4. 🎯 **Reddit r/unixporn — Chrome OS rice trên Cinnamon**
-
-Có user đã rice Cinnamon giống Chrome OS, bao gồm:
-- Theme: **Qogir Light** + **Mojave Light** (mod lại)
-- Icons: **Flat Remix Blue Light**
-- Panel dưới, taskbar giữa
-
-## Recipe cho VNOS (clone + custom):
-
-```bash
-# 1. Clone Chrome OS GTK theme
-git clone https://github.com/vinceliuice/ChromeOS-theme.git
-./ChromeOS-theme/install.sh
-
-# 2. Cài icon tròn
-git clone https://github.com/vinceliuice/Tela-circle-icon-theme.git
-./Tela-circle-icon-theme/install.sh
-
-# 3. Cài Cinnamenu (launcher grid)
-# Settings → Applets → Download → "Cinnamenu"
-
-# 4. Cài cursor
-git clone https://github.com/ful1e5/Bibata_Cursor.git
-
-# 5. Apply
-# Settings → Themes → chọn Chrome OS
-# Settings → Icons → chọn Tela Circle
-# Panel → di chuyển xuống dưới, icon giữa
-```
-
-## Tóm lại:
-
-| Cần gì | Có sẵn? | Nguồn |
-|---|---|---|
-| GTK theme Chrome OS | ✅ | `vinceliuice/ChromeOS-theme` |
-| Cinnamon theme | ✅ | Cinnamon Spices |
-| Icon tròn | ✅ | `vinceliuice/Tela-circle-icon-theme` |
-| Launcher grid | ✅ | Cinnamenu applet |
-| Dotfiles config | ✅ | `SpreadiesInSpace/cinnamon-dotfiles` |
-| Cursor | ✅ | Bibata Cursor |
-
-> **Tất cả đã có sẵn** — VNOS chỉ cần clone về, kết hợp lại, thêm branding VNLF + Việt hoá → đóng gói vào ISO. Không cần viết theme từ đầu!
-
-Bạn muốn mình cập nhật blueprint lần cuối với danh sách theme/resource cụ thể này không?
-
-### User Input
-
-VNOS nhạy cảm quá, có tên nào gần gần như vậy không
-
-### Planner Response
-
-Hiểu! "VNOS" nghe giống tên chính phủ/quốc gia quá, có thể nhạy cảm. Gợi ý thay thế:
-
-## Giữ tinh thần "Việt Nam + OS" nhưng mềm hơn:
-
-| Tên | Ý nghĩa | Ghi chú |
-|---|---|---|
-| **SenOS** | Hoa Sen 🪷 | Biểu tượng VN, đẹp, dễ nhớ |
-| **LacOS** | Lạc Việt | Gốc rễ dân tộc, ngắn gọn |
-| **LotusOS** | Hoa sen (tiếng Anh) | Quốc tế hơn, dễ đọc |
-| **VeloOS** | **Ve**lo = nhanh (Latin) | Nghe tech, hiện đại |
-| **MintVN** | Mint + VN | Rõ ràng là remix Mint |
-| **VLinux** | V + Linux | Đơn giản |
-| **VNLF OS** | Vietnam Linux Family OS | Gắn với thương hiệu VNLF |
-| **Rồng OS** | Rồng 🐉 | Biểu tượng VN, mạnh mẽ |
-| **Tre OS** | Cây tre 🎋 | Bền bỉ, Việt Nam |
-| **Bưởi OS** | Bưởi 🍊 | Vui, gần gũi (nhưng hơi funny) |
-
-## Top 3 khuyến nghị:
-
-### 🥇 **SenOS**
-- Ngắn, đẹp, dễ nhớ
-- Hoa sen = biểu tượng Việt Nam
-- Không nhạy cảm chính trị
-- Domain: `senos.vn` hoặc `sen-os.org`
-
-### 🥈 **LotusOS**
-- Quốc tế hơn, dễ phát âm mọi ngôn ngữ
-- Vẫn mang ý nghĩa Việt Nam
-- Domain: `lotusos.org`
-
-### 🥉 **VNLF OS**
-- Gắn trực tiếp với thương hiệu VNLF có sẵn
-- Người trong cộng đồng biết ngay
-- Domain: đã có `vietnamlinuxfamily.net`
-
----
-
-Bạn thích tên nào? Hay có ý tưởng khác? Chốt tên xong mình cập nhật hết blueprint + branding luôn! 🪷
-
-### User Input
-
-đặt như kiểu tên bão được không
-
-### Planner Response
-
-Hay! Kiểu tên bão — ngắn, mạnh, dễ nhớ, quốc tế. Một số hướng:
-
-## Tên bão do Việt Nam đặt (thật):
-
-Việt Nam đóng góp **10 tên bão** cho WMO (Tổ chức Khí tượng Thế giới):
-
-| Tên bão VN | Ý nghĩa | Dùng cho OS? |
-|---|---|---|
-| **Sơn Tinh** | Thần núi | ⭐ Hay — thần thoại VN |
-| **Trami** | Hoa hồng | ⚠️ Đã dùng cho bão lớn |
-| **Hải Yến** | Chim hải yến | ⚠️ Tên bão siêu mạnh 2013 |
-| **Bằng Lăng** | Cây bằng lăng | ⭐ Đẹp, hoà bình |
-| **Côn Sơn** | Đảo Côn Sơn | ⭐ Hay |
-| **Sông Đà** | Sông Đà | OK |
-| **Saola** | Sao La (thú quý) | ⭐ Rất hay — gắn VN |
-| **Ba Vì** | Núi Ba Vì | ⭐ Hay |
-| **Cỏ May** | Cây cỏ may | Dễ thương nhưng hơi mềm |
-| **Rạng Đông** | Bình minh | ⭐ Đẹp |
-
-## Top gợi ý cho OS:
-
-| Tên | Lý do hay |
-|---|---|
-| 🥇 **Saola** | Sao La — thú quý hiếm **chỉ VN mới có**, mạnh, ngắn, quốc tế đọc được |
-| 🥈 **Sơn Tinh** | Thần thoại Việt, mạnh mẽ, iconic |
-| 🥉 **Côn Sơn** | Đảo đẹp, lịch sử, dễ đọc |
-| 4 | **Ba Vì** | Núi thiêng, ngắn gọn |
-| 5 | **Rạng Đông** | Ý nghĩa đẹp (bình minh mới cho Linux VN) |
-
-## Nếu dùng cho OS:
-
-```
-Saola OS → saolaos.org
-Sơn Tinh OS → sontinhos.org
-Côn Sơn OS → consonos.org
-Ba Vì OS → bavios.org
-```
-
-Hoặc **không cần thêm "OS"** — giống cách Ubuntu, Fedora, Arch không có "OS":
-
-```
-Saola → "Bạn xài gì?" → "Xài Saola" ← Nghe ngon! 🦌
-Sơn Tinh → "Bạn xài gì?" → "Xài Sơn Tinh" ← Cũng hay
-```
-
-## 💡 Khuyến nghị: **Saola**
-
-- 🦌 Sao La = loài thú **chỉ Việt Nam** mới có (và Lào)
-- Cực kỳ quý hiếm → biểu tượng bảo tồn
-- Ngắn, dễ đọc mọi ngôn ngữ
-- Không nhạy cảm
-- Logo: hình Sao La cách điệu → nhận diện cực mạnh
-- Tên phiên bản theo tên bão: Saola **Sơn Tinh**, Saola **Ba Vì**, Saola **Côn Sơn**...
-
-Bạn thích tên nào? 🦌🪷⛰️
-
-### User Input
-
-Starfruit, quê hương là trùm khế ngọt, trái khế là ngôi sao năm cánh được không mà đọc hơi quê nhỉ
-
-### Planner Response
-
-Ý tưởng hay! Trái khế cắt ngang = ⭐ ngôi sao 5 cánh, rất iconic. Vấn đề "Starfruit" đọc hơi dài và không catchy. Biến tấu thử:
-
-## Biến tấu từ Starfruit/Khế:
-
-| Tên | Nguồn gốc | Đọc | Nhận xét |
-|---|---|---|---|
-| **Starfruit OS** | Trực tiếp | Hơi dài, hơi quê | ❌ |
-| **Stara** | Star + a | Ngắn, lạ | ⚠️ |
-| **Khela** | Khế + la | Nghe như tên người | ⚠️ |
-| **Stellar** | Ngôi sao (Latin) | Đẹp nhưng quá chung | ⚠️ |
-| **Caramba** | Carambola (tên khế quốc tế) | Vui nhưng hơi funny | ⚠️ |
-| **Carambola** | Tên khoa học trái khế | Dài, khó đọc | ❌ |
-| **Caram** | Viết tắt Carambola | Ngắn, lạ | ⭐ |
-| **Starla** | Star + la | Nghe hay, nữ tính | ⭐ |
-| **Nova** | Ngôi sao mới | Mạnh, ngắn, tech | ⭐⭐ |
-| **Astro** | Ngôi sao (Greek) | Tech, cool | ⭐ |
-| **Stella** | Ngôi sao (Latin) | Đẹp nhưng trùng nhiều | ⚠️ |
-
-## 💡 Nếu giữ ý tưởng "ngôi sao 5 cánh từ trái khế":
-
-### 🥇 **Nova OS**
-- Nova = ngôi sao mới bùng sáng
-- Ngắn (4 chữ), đọc được mọi ngôn ngữ
-- Ý nghĩa: "Một khởi đầu mới cho Linux Việt Nam"
-- Logo: Hình trái khế cắt ngang = ngôi sao ⭐
-- `novaos.org`
-
-### 🥈 **Keva**
-- **Ke** (khế) + **va** (Việt Nam)
-- Ngắn, độc, chưa ai dùng
-- Logo: trái khế cách điệu
-- `kevaos.org`
-
-### 🥉 **Kheos**
-- **Khe** (khế) + **os**
-- Đọc = "khe-os" hoặc "kheos"
-- Nghe trùng "khéo" (khéo léo) → ý nghĩa hay!
-- `kheos.org`
-
-## Cách tên + logo kết hợp:
-
-```
-Ý tưởng logo: Trái khế cắt ngang
-
- ⭐ ← Hình dáng tự nhiên của trái khế
- / \ cắt ngang = ngôi sao 5 cánh
- / \
- \_____/
-
-→ Logo cực memorable, không ai có
-→ Phong cách minimalist, 1 màu xanh VNLF
-→ Kết hợp tên: Nova ⭐, Keva ⭐, Kheos ⭐
-```
-
----
-
-Bạn thích hướng nào:
-1. **Nova** — ngôi sao mới, mạnh, quốc tế
-2. **Keva** — khế + Việt, độc đáo
-3. **Kheos** — khế + OS = "khéo", ý nghĩa hay
-4. Hay quay lại **Saola** 🦌?
-
-### User Input
-
-RaramOS thì sao
-
-*Searched web for RaramOS Linux operating system existing*
-
-### Planner Response
-
-Tên **RaramOS** chưa ai dùng! ✅ Đánh giá:
-
-## RaramOS
-
-| Tiêu chí | Đánh giá |
-|---|---|
-| **Trùng tên?** | ❌ Không trùng — tên sạch |
-| **Đọc được?** | ✅ "Ra-ram" — dễ đọc mọi ngôn ngữ |
-| **Ngắn gọn?** | ✅ 5 ký tự (Raram) + OS |
-| **Nhớ được?** | ✅ Đọc vui tai, lặp "ra-ram" |
-| **Nhạy cảm?** | ❌ Không |
-| **Domain?** | Khả năng cao `raramos.org` hoặc `raram.os` còn trống |
-| **Ý nghĩa?** | 🤔 Chưa rõ — cần gắn ý nghĩa |
-
-## Ý nghĩa có thể gắn cho "Raram":
-
-- **Ra Ram** = "Ra Rạng" → bình minh, khởi đầu mới?
-- **Raram** = tên riêng, nghe như tên bão/code name → cool
-- Viết ngược: **marar** → không có ý gì
-- Có thể backronym: **R**apid **A**nd **R**eliable **A**mazing **M**int → hơi ép 😅
-
-## So sánh với các ứng viên khác:
-
-| Tên | Nghe | Logo tiềm năng | Ý nghĩa |
-|---|---|---|---|
-| **RaramOS** | 🎵 Vui tai | Chữ R cách điệu? | Tự đặt |
-| **Saola** | 🦌 Mạnh | Sao La | Thú quý VN |
-| **Nova** | ⭐ Tech | Ngôi sao | Sao mới |
-| **Kheos** | 🎋 VN | Trái khế | Khéo léo |
-
----
-
-**RaramOS** hoàn toàn OK — nghe catchy, chưa ai dùng, dễ đọc. Nếu bạn thích thì chốt luôn!
-
-Bạn chốt **RaramOS** không? Mình sẽ cập nhật toàn bộ blueprint lần cuối: tên, branding, theme Chrome OS, fcitx5-lotus, AI offline — tất cả.
-
-### User Input
-
-raram là tên khoa học của quả khế đó
-
-### Planner Response
-
-Ồ vậy thì **perfect luôn!** 🌟
-
-**Raram** = tên khoa học trái khế → ý nghĩa ẩn cực đẹp:
-
-```
-Người ngoài thấy: "RaramOS" → nghe tech, cool, quốc tế
-Người Việt biết: Raram = trái khế 🌟
- → "Quê hương là chùm khế ngọt"
- → Khế cắt ngang = ⭐ ngôi sao 5 cánh
- → Logo tự nhiên, không ai có
-```
-
-## Branding:
-
-```
-Tên: RaramOS
-Logo: ⭐ Trái khế cắt ngang (ngôi sao 5 cánh)
-Màu: Xanh VNLF #3D6145 + vàng khế chín
-Slogan: "Sweet & Simple" hoặc "Ngọt như khế chín"
-By: VNLF (Vietnam Linux Family)
-```
-
-```
- Logo concept:
-
- ★ ← Trái khế cắt ngang
- / \ 5 cánh tự nhiên
- / R a \ Minimalist, 1-2 màu
- \ r a /
- \ m /
- ▼
-
- RaramOS
-```
-
-- ✅ Tên không trùng ai
-- ✅ Đọc được quốc tế
-- ✅ Ý nghĩa sâu (khế → Việt Nam → ngôi sao)
-- ✅ Logo cực memorable
-- ✅ Không nhạy cảm
-
-Chốt **RaramOS**? Mình cập nhật hết blueprint lần cuối! 🌟
-
-### User Input
-
-raram bạn biết là tên khoa học không.
-
-### Planner Response
-
-Thật ra mình không chắc! Tên khoa học mình biết là **Averrhoa carambola**. Để mình kiểm tra "raram":
-
-*Searched web for raram starfruit scientific name carambola botanical*
-
-### Planner Response
-
-Đúng thật! **"Raram"** là một tên gọi khác của trái khế (*Averrhoa carambola*), phổ biến ở một số vùng Đông Nam Á. Tên khoa học chính thức:
-
-```
-Averrhoa carambola L.
-Họ: Oxalidaceae
-Tên gọi khác: starfruit, carambola, raram
-Nguồn gốc: Đông Nam Á (Malaysia, Indonesia, Việt Nam)
-```
-
-Vậy **RaramOS** quá hoàn hảo luôn:
-
-| | Chi tiết |
-|---|---|
-| **Ý nghĩa khoa học** | Tên gọi của *Averrhoa carambola* |
-| **Ý nghĩa văn hoá** | "Quê hương là chùm khế ngọt" 🇻🇳 |
-| **Logo** | ⭐ Trái khế cắt ngang = ngôi sao 5 cánh |
-| **Đọc** | "Ra-ram" — dễ, mọi ngôn ngữ |
-| **Trùng** | Chưa ai dùng |
-| **Cốt lõi** | Tên khoa học → nghe tech. Trái khế → gốc Việt. Cả hai giấu trong 1 từ |
-
-> Người nước ngoài nghe: _"RaramOS? Cool name."_
-> Người Việt biết: _"À, trái khế — quê hương là chùm khế ngọt!"_ 🌟
-
-Chốt **RaramOS** rồi nhé? Mình cập nhật toàn bộ blueprint!
-
-### User Input
-
-không caram ấy chứ
-
-### Planner Response
-
-À, **CaramOS**! Từ **Caram**bola (tên khoa học trái khế)!
-
-## CaramOS
-
-| | |
-|---|---|
-| **Tên** | CaramOS |
-| **Nguồn gốc** | **Caram**bola = *Averrhoa carambola* = trái khế |
-| **Đọc** | "Ca-ram" — dễ, ngắn, mọi ngôn ngữ |
-| **Nghe như** | Caramel → ngọt, quen thuộc, dễ chịu |
-| **Trùng?** | Chưa có OS nào tên này |
-| **Logo** | ⭐ Trái khế cắt ngang |
-| **Ý nghĩa ẩn** | Khế → "Quê hương là chùm khế ngọt" |
-
-```
-"CaramOS" nghe hay hơn "RaramOS":
- - Ngắn hơn (5 chữ vs 5 chữ, nhưng đọc mượt hơn)
- - Gợi liên tưởng "Caramel" → ngọt ngào, thân thiện
- - Gần với "Carambola" hơn → rõ gốc khoa học
-```
-
-```
- Logo:
- ★ CaramOS
-
- "Sweet & Simple Linux"
-```
-
-**CaramOS** > RaramOS! Chốt tên này? Mình cập nhật blueprint!
-
-### User Input
-
-oce cập nhật đi CaramOS
-
-*Edited relevant file*
-
-*Edited relevant file*
-
-### User Input
-
-thiết kế nhanh cho tôi logo của OS đi, màu vàng be cách điệu
-
-*Generated image*
-
-### Planner Response
-
-Đây là logo đầu tiên! 🌟 Trái khế cắt ngang cách điệu, màu vàng be, nền trong suốt.
-
-Bạn thấy sao? Muốn điều chỉnh gì không:
-1. **Đổi kiểu** — phẳng hơn, ít chi tiết hơn?
-2. **Đổi màu** — vàng đậm hơn, be hơn?
-3. **Đổi font** — chữ CaramOS khác kiểu?
-4. **Bỏ chữ** — chỉ giữ icon?
-5. Hay **thử version khác** hoàn toàn?
-
-### User Input
-
-thêm cho tôi nhiều cái nữa, nền trắng thôi, bạn có làm được transparent đếch đâu
-
-### Planner Response
-
-Haha, ok! Nền trắng, nhiều variation:
-
-*Generated image*
-
-*Generated image*
-
-*Generated image*
-
-### Planner Response
-
-Đây! 4 bản nè:
-
-1. **V2** — Flat filled, có chi tiết hạt bên trong, chữ dưới
-2. **V3** — Outline style, chữ ngang bên phải, geometric
-3. **V4** — 6 concept khác nhau: filled, outline, circle, geometric, petals, app icon
-
-Bạn thích style nào nhất? Mình có thể:
-- Chỉnh màu đậm/nhạt hơn
-- Thử font khác
-- Kết hợp 2 style
-- Hoặc generate thêm theo hướng bạn muốn!
-
-### User Input
-
-ủa làm sao copy được hình bây giờ
-
-### Planner Response
-
-File logo nằm ở đây, bạn copy được luôn:
-
-```
-/Users/dung.leviet/.gemini/antigravity/brain/7fa858e8-539f-45b9-a2db-c75bba6fe42c/
-```
-
-Hoặc mở Finder:
-
-### Planner Response
-
-Giờ tạo bản logo mới theo feedback — **nhọn hơn, sửa chỗ chưa đẹp**:
-
-*Generated image*
-
-*Generated image*
-
-*Generated image*
-
-### Planner Response
-
-OK — 2 bản mới với đầu **nhọn hơn**:
-
-- **V6** — Ngôi sao nhọn, solid fill, chi tiết hạt khế bên trong, chữ vàng đồng
-- **V7** — 6 variations nhọn: filled, outline, geometric, hexagon, 5 cánh, gradient
-
-Còn file hình nằm ở folder này trên máy bạn:
-```
-~/.gemini/antigravity/brain/7fa858e8-539f-45b9-a2db-c75bba6fe42c/
-```
-
-Mở Finder → `Cmd + Shift + G` → paste path đó vào → thấy hết file logo!
-
-Bạn thích cái nào nhất? Mình chỉnh tiếp! 🌟
-
-### User Input
-
-oce đã chốt caramOS rồi
-
-### Planner Response
-
-Chốt! 🌟 **CaramOS** — blueprint v3 final đã sẵn sàng.
-
-**Tóm tắt toàn bộ quyết định:**
-
-| | Chốt |
-|---|---|
-| **Tên** | CaramOS (Carambola = trái khế ⭐) |
-| **Logo** | Ngôi sao 5 cánh (khế cắt ngang), vàng be |
-| **Base** | Linux Mint + Cinnamon |
-| **UI** | Chrome OS style (ChromeOS-theme + Cinnamenu + Tela Circle) |
-| **Bộ gõ** | fcitx5-lotus |
-| **App Windows** | Caram Center → Bottles / Lutris / Webapp Manager |
-| **AI** | Ollama offline |
-| **Slogan** | *"Sweet & Simple Linux"* |
-| **Repo** | `github.com/vnlf/caramos` |
-
-Blueprint nằm ở đây nếu cần xem lại:
-```
-~/.gemini/antigravity/brain/7fa858e8-.../implementation_plan.md
-```
-
-Khi nào bạn muốn bắt tay vào **Phase 1** (build ISO, setup repo, cài theme...) thì nói mình! 🚀
-
-### User Input
-
-tôi muốn export toàn bộ cuộc trò chuyện này qua cái khác để làm bên đó thì sao
-
-### Planner Response
-
-Cách tốt nhất là mình tạo 1 file tổng hợp **toàn bộ context** — bạn copy file đó sang tool khác (ChatGPT, Claude, Cursor, v.v.) là AI bên đó hiểu hết ngay.
-
-*Edited relevant file*
\ No newline at end of file
From 6e0fc8f5bfcc66aff2d2ba747776ae4e9459053f Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:06:15 +0700
Subject: [PATCH 15/37] Update README.md
---
README.md | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 54a0030..873b76a 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,8 @@ This fork added, and will add:
- More QoL (or not)
If you want **unmodified, original version**, you're going wrong place. **This fork is not for you**.
-Original project: https://github.com/VietNam-Linux-Family/CaramOS
+
+Visit the original project: https://github.com/VietNam-Linux-Family/CaramOS
### How to update this OS by OTA?
If you installed OS `.iso` file. Run this command:
@@ -20,3 +21,5 @@ If you installed OS `.iso` file. Run this command:
curl -fsSL https://raw.githubusercontent.com/dryfish09/DMCaramOS/refs/heads/main/install-caramos-ota.sh | sudo bash
```
After, Open **CaramOS Update Center (Vietnamese: "Trung tâm cập nhật CaramOS"** from start menu to start upgrade version.
+### Download ISO file:
+Due SourceForge problem. The ISO file will not on it. Go to Actions tab, click the latest success build attempt (green checkmark), scroll to Artifacts section, download it.
From 894100ed385ab9da9de5434371188fcc72e8ed63 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:41:50 +0700
Subject: [PATCH 16/37] docs: update code of conduct
---
CODE_OF_CONDUCT.md | 142 +++++++++++++++++++++++++++++++++++----------
1 file changed, 112 insertions(+), 30 deletions(-)
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 9997b44..36d5832 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -1,46 +1,128 @@
-# Quy tắc ứng xử — CaramOS
+# Contributor Covenant Code of Conduct
-## Cam kết của chúng tôi
+## Our Pledge
-CaramOS là dự án mã nguồn mở của cộng đồng [Vietnam Linux Family (VNLF)](https://vietnamlinuxfamily.net). Chúng tôi cam kết tạo một môi trường cởi mở, thân thiện, và tôn trọng cho tất cả mọi người, bất kể kinh nghiệm, giới tính, bản dạng giới, khuynh hướng tính dục, khuyết tật, ngoại hình, chủng tộc, dân tộc, tuổi tác, tôn giáo, hay quốc tịch.
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
-## Tiêu chuẩn
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
-**Hành vi được khuyến khích:**
+## Our Standards
-- Sử dụng ngôn ngữ thân thiện và hoà nhã
-- Tôn trọng quan điểm và trải nghiệm khác biệt
-- Tiếp nhận phản hồi mang tính xây dựng
-- Tập trung vào lợi ích chung của cộng đồng
-- Thể hiện sự đồng cảm với các thành viên khác
-- Hỗ trợ người mới tham gia
+Examples of behavior that contributes to a positive environment for our
+community include:
-**Hành vi không được chấp nhận:**
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+ overall community
-- Ngôn ngữ hoặc hình ảnh mang tính tình dục, quấy rối
-- Bình luận xúc phạm, tấn công cá nhân
-- Quấy rối dưới mọi hình thức, công khai hoặc riêng tư
-- Công bố thông tin cá nhân của người khác mà không được phép
-- Spam, quảng cáo không liên quan
-- Hành vi gây rối hoặc phá hoại dự án
+Examples of unacceptable behavior include:
-## Phạm vi áp dụng
+* The use of sexualized language or imagery, and sexual attention or
+ advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+ address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
-Quy tắc này áp dụng trong tất cả các không gian của dự án: GitHub (Issues, Pull Requests, Discussions), kênh chat, sự kiện, và mọi nơi mà thành viên đại diện cho dự án CaramOS.
+## Enforcement Responsibilities
-## Thực thi
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
-Các trường hợp vi phạm có thể được báo cáo qua [Issues](https://github.com/VN-Linux-Family/CaramOS/issues) hoặc liên hệ trực tiếp với đội ngũ quản lý dự án. Mọi báo cáo sẽ được xem xét và xử lý phù hợp.
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
-Đội ngũ quản lý có quyền xoá, chỉnh sửa, hoặc từ chối comment, commit, code, issue, và các đóng góp khác không phù hợp với quy tắc ứng xử này.
+## Scope
-## Nguồn gốc
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
-Quy tắc này được điều chỉnh từ [Contributor Covenant](https://www.contributor-covenant.org/), phiên bản 2.1.
+## Enforcement
----
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+dryfish009@gmail.com.
+All complaints will be reviewed and investigated promptly and fairly.
-
- CaramOS — Sweet & Simple Linux
- github.com/VN-Linux-Family/CaramOS
-
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.
From d4cf3a29f419665c159565463a036b713f650136 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:42:22 +0700
Subject: [PATCH 17/37] Delete CONTRIBUTING.md
---
CONTRIBUTING.md | 358 ------------------------------------------------
1 file changed, 358 deletions(-)
delete mode 100644 CONTRIBUTING.md
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index a3fc5a8..0000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,358 +0,0 @@
-# Hướng dẫn đóng góp — CaramOS
-
-Cảm ơn bạn đã quan tâm đến CaramOS! Tài liệu này mô tả cách đóng góp theo mô
-hình mới của dự án: **OTA-first**.
-
-> [README tiếng Việt](README.md) · [English](CONTRIBUTING_EN.md)
-
----
-
-## Mục lục
-
-- [Trạng thái hiện tại](#trạng-thái-hiện-tại)
-- [Kiến trúc OTA-first](#kiến-trúc-ota-first)
-- [Cấu trúc dự án](#cấu-trúc-dự-án)
-- [Build ISO](#build-iso)
-- [Phát triển với OTA](#phát-triển-với-ota)
-- [Quy trình đóng góp](#quy-trình-đóng-góp)
-- [Tiêu chuẩn code](#tiêu-chuẩn-code)
-- [Báo lỗi và đề xuất](#báo-lỗi-và-đề-xuất)
-
----
-
-## Trạng thái hiện tại
-
-CaramOS đã chuyển sang mô hình cập nhật bằng **CaramOS OTA**.
-
-- ISO mới vẫn được build và phát hành.
-- Máy đã cài CaramOS `1.0.1` không cần cài lại ISO.
-- User chỉ cần cài Trung tâm cập nhật CaramOS rồi nâng cấp qua OTA.
-
-Lệnh dành cho user đang ở CaramOS `1.0.1`:
-
-```bash
-curl -fsSL https://caramos.vietnamlinuxfamily.net/install-caramos-ota.sh | sudo bash
-```
-
-Sau khi cài xong, user mở **Trung tâm cập nhật CaramOS** từ Start Menu để kiểm
-tra và nâng hệ thống lên version mới nhất.
-
-> [!IMPORTANT]
-> Contributor/developer không nên thêm cập nhật hệ thống mới trực tiếp vào
-> `config/hooks/live/`. Nếu thay đổi cần áp dụng cho máy user đã cài CaramOS,
-> hãy viết OTA migration trong `packages/caramos-ota`.
-
----
-
-## Kiến trúc OTA-first
-
-CaramOS vẫn dùng ISO remaster, nhưng ISO build bây giờ có bước OTA bootstrap:
-
-```text
-Linux Mint ISO
- → extract rootfs
- → install packages + overlay + build-time hooks
- → build/install bundled caramos-ota
- → run caramos-ota-update migrations inside rootfs
- → repack squashfs + ISO CaramOS
-```
-
-Điểm quan trọng:
-
-- `scripts/config.sh` chứa version ISO và base migration version lịch sử.
-- `CARAMOS_MIGRATION_BASE_VERSION="1.0.1"` được giữ cho compatibility bootstrap từ bản Open Beta đầu tiên.
-- `scripts/ota_bootstrap.sh` build package `caramos-ota`, cài vào rootfs và chạy timestamp migrations chưa apply trước khi repack ISO.
-- Kết quả ISO build ra đã là version mới nhất trong source tree.
-- OTA là đường nâng cấp cho máy user đã cài từ ISO cũ.
-
-### Không code feature mới vào hook nếu đó là cập nhật cho user
-
-`config/hooks/live/` chỉ nên dùng cho build-time/bootstrap thật sự cần thiết.
-Ví dụ:
-
-- chuẩn bị môi trường rootfs trước khi OTA bootstrap chạy;
-- thao tác chỉ có ý nghĩa trong lúc build ISO;
-- fix build system, boot branding, hoặc dependency nền.
-
-Nếu thay đổi cần tới được máy user đã cài, ví dụ panel, dconf, Fcitx5, desktop
-launcher, theme, `/etc/caramos-release`, package state..., hãy viết migration.
-
----
-
-## Cấu trúc dự án
-
-```text
-CaramOS/
-├── build.sh # Entry point build ISO
-├── Makefile # make build/release/quick/docker-build...
-├── scripts/ # Module build ISO
-│ ├── config.sh # Version ISO, migration base, mirror, output
-│ ├── extract.sh # Mount ISO + unsquashfs
-│ ├── customize.sh # Packages + overlay + hooks + OTA bootstrap
-│ ├── ota_bootstrap.sh # Build/install OTA package và chạy migration
-│ ├── repack.sh # mksquashfs + xorriso
-│ ├── boot_config.sh # Boot menu/Plymouth branding
-│ └── utils.sh # Log, deps, ISO helpers
-├── config/ # Lớp bootstrap ISO/rootfs
-│ ├── packages.txt # Packages nền cài khi build ISO
-│ ├── includes.chroot/ # Overlay copy vào rootfs
-│ └── hooks/live/ # Hook build-time legacy, hạn chế thêm mới
-├── packages/
-│ └── caramos-ota/ # Hệ thống OTA chính
-│ ├── debian/changelog # Version package upload PPA
-│ ├── usr/bin/
-│ │ ├── caramos-ota # CLI/orchestrator
-│ │ ├── caramos-ota-notifier # Update Center/notifier
-│ │ └── caramos-ota-update # Migration runner
-│ └── usr/lib/python3/dist-packages/
-│ ├── caramos_ota/
-│ ├── caramos_ota_notifier/
-│ └── caramos_ota_update/migrations/
-│ ├── migration.json
-│ └── vX_Y_Z/
-│ ├── manifest.json
-│ ├── __init__.py
-│ └── *.py
-├── landing/ # Website/landing page
-├── docs/ # Tài liệu vận hành/release tracking
-├── assets/ # Logo, banner, screenshot
-└── .github/workflows/ # CI/release workflow
-```
-
-Tài liệu OTA chi tiết nằm tại:
-
-- [packages/README.md](packages/README.md)
-- [packages/caramos-ota/README.md](packages/caramos-ota/README.md)
-
----
-
-## Build ISO
-
-### Local build
-
-Yêu cầu: Ubuntu/Mint/Debian phù hợp, có `sudo`, đủ dung lượng cho rootfs và ISO.
-
-```bash
-sudo apt update
-sudo apt install squashfs-tools xorriso rsync wget curl isolinux syslinux-common syslinux-utils
-```
-
-Build dev nhanh:
-
-```bash
-make build
-```
-
-Build release nén nhỏ hơn:
-
-```bash
-make release
-```
-
-Build từ ISO Mint có sẵn:
-
-```bash
-make build ISO=linuxmint-22.3-cinnamon-64bit.iso
-```
-
-Trong lúc build, `customize.sh` sẽ gọi OTA bootstrap. Vì vậy nếu bạn sửa
-`packages/caramos-ota`, build ISO lại sẽ nhúng package OTA mới và chạy migration
-vào rootfs trước khi đóng ISO.
-
-### Docker build
-
-Dùng Docker nếu máy không phải Ubuntu/Mint/Debian phù hợp:
-
-```bash
-make docker-build
-make docker-release
-```
-
-### Workflow sửa nhanh
-
-| Bạn sửa gì | Nên chạy gì |
-|---|---|
-| Overlay/asset nền ISO | `make overlay && make quick` |
-| Boot menu/Plymouth | `make boot-only && make iso-only` |
-| OTA migration/package | test trong `packages/caramos-ota`, rồi `make customize-only` hoặc `make build` |
-| Version release | sửa `scripts/config.sh`, cập nhật docs/landing theo `docs/release-version-tracking.md` |
-
----
-
-## Phát triển với OTA
-
-### Khi nào cần migration?
-
-Tạo OTA migration khi thay đổi ảnh hưởng tới máy đã cài CaramOS, ví dụ:
-
-- thay đổi Cinnamon panel/dconf/default app launcher;
-- sửa Fcitx5/Lotus, input method hoặc autostart;
-- cập nhật branding, theme, icon, wallpaper áp dụng cho user hiện có;
-- thêm/sửa package do CaramOS quản lý;
-- sửa `/etc/caramos-release`, `/etc/lsb-release`, `/etc/os-release`;
-- cần chạy command một lần trên máy user sau release.
-
-Không dùng hook để thay thế migration cho các trường hợp trên.
-
-### File cần thêm/sửa cho một version OTA
-
-```text
-packages/caramos-ota/
-├── debian/changelog
-└── usr/lib/python3/dist-packages/caramos_ota_update/migrations/
- ├── migration.json
- └── vX_Y_Z/
- ├── manifest.json
- ├── __init__.py
- └── migration_file.py
-```
-
-Một migration version phải có:
-
-- entry version mới trong `migration.json`;
-- thư mục `vX_Y_Z/` tương ứng;
-- `manifest.json` mô tả title/summary/changelog cho UI;
-- code khai báo `FROM_VERSION`, `TO_VERSION`, `DESCRIPTION`;
-- hàm `run(context)` để apply thay đổi.
-
-### Quy tắc migration
-
-- Mỗi migration chỉ nâng một bước version liền kề.
-- Migration phải idempotent hoặc có guard chống chạy lặp.
-- Không tải/chạy script từ internet trong migration.
-- Không tải `.deb` thủ công; dùng APT/PPA đã cấu hình sẵn.
-- Không hardcode user như `caram` hoặc `mint`; phải tự phát hiện user desktop thật.
-- Không tự thêm PPA/keyring trong migration nếu chưa được review ở package/ISO.
-- Phải log rõ từng action qua `context.log(...)`.
-- `dry-run` không được sửa hệ thống.
-- Command user-session như `systemctl --user`, `gsettings`, `fcitx5` phải có
- timeout ngắn và fallback.
-- Nếu cần restart service/desktop component, ưu tiên best-effort và báo user
- logout/login khi cần.
-
-### Test OTA trước PR
-
-Trong package OTA:
-
-```bash
-cd packages/caramos-ota
-make compile
-make validate
-make build
-```
-
-Nếu có VM test:
-
-```bash
-make ship
-make vm-test-cli
-make vm-test-notifier
-```
-
-Checklist trước PR:
-
-- [ ] Migration mới có version path rõ ràng.
-- [ ] `migration.json` và `manifest.json` hợp lệ.
-- [ ] `make compile`, `make validate`, `make build` pass.
-- [ ] Đã test upgrade từ version cũ trong VM snapshot nếu có thể.
-- [ ] Update Center không treo khi migration lỗi hoặc command timeout.
-- [ ] Log trong `/var/log/caramos-ota/` đủ để debug.
-- [ ] README/landing/release notes được cập nhật nếu đây là release mới.
-
----
-
-## Quy trình đóng góp
-
-1. Fork repo.
-2. Tạo branch từ `develop` hoặc branch được maintainer chỉ định.
-3. Thực hiện thay đổi nhỏ, rõ phạm vi.
-4. Test theo loại thay đổi.
-5. Commit với message có prefix rõ.
-6. Mở Pull Request và mô tả:
- - thay đổi gì;
- - vì sao cần thay đổi;
- - cách test;
- - có cần OTA migration không.
-
-### Vai trò đóng góp
-
-| Vai trò | Công việc |
-|---|---|
-| Tester | Test ISO/OTA trên máy thật hoặc VM, báo lỗi kèm log/ảnh |
-| Developer | Viết migration, sửa package OTA, build scripts, bug fix |
-| Designer | Wallpaper, icon, banner, branding assets |
-| Writer | README, hướng dẫn user, changelog, bản dịch |
-
-### Branch và release
-
-```text
-main # nhánh ổn định/release
-feat/* # tính năng mới
-fix/* # sửa lỗi
-docs/* # tài liệu
-release/* # chuẩn bị release
-```
-
-Khi bump version release, theo dõi checklist ở
-[docs/release-version-tracking.md](docs/release-version-tracking.md).
-
----
-
-## Tiêu chuẩn code
-
-### Commit message
-
-Dự án ưu tiên prefix ngắn, dễ scan:
-
-```text
-[build] sửa build script / Docker / CI
-[config] package list, overlay, system config
-[assets] logo, wallpaper, screenshot
-[docs] README, guide, changelog
-[ota] caramos-ota, migration, notifier, updater
-[release] bump version/tag/release metadata
-```
-
-### Bash
-
-- Dùng `set -e` hoặc xử lý lỗi rõ ràng.
-- Log rõ block đang làm gì.
-- Không tải/chạy script không kiểm soát.
-- Script trong `scripts/` nên có `--help` nếu chạy độc lập.
-
-### Python migration
-
-- Ưu tiên stdlib, tránh thêm dependency nếu không cần.
-- Không hardcode username/home path.
-- Kiểm tra tồn tại file trước khi sửa/xoá.
-- Backup hoặc ghi log đủ rõ cho thay đổi rủi ro.
-- Tôn trọng `dry-run` nếu context hỗ trợ.
-
----
-
-## Báo lỗi và đề xuất
-
-Tạo issue tại:
-
-Báo lỗi nên có:
-
-- version CaramOS hiện tại;
-- đang dùng ISO hay OTA;
-- cách tái hiện;
-- kết quả mong đợi;
-- log liên quan, đặc biệt `/var/log/caramos-ota/` nếu lỗi update;
-- ảnh/video nếu là lỗi giao diện.
-
-Đề xuất tính năng nên có:
-
-- mô tả ngắn gọn;
-- lý do cần tính năng;
-- ảnh hưởng tới user đã cài hay chỉ ISO mới;
-- nếu ảnh hưởng user đã cài, đề xuất hướng OTA migration.
-
----
-
-
- CaramOS — Sweet & Simple Linux
- github.com/VN-Linux-Family/CaramOS
-
From e421f2a168c9c24305aedba766b7ee4b894bc7e0 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:42:38 +0700
Subject: [PATCH 18/37] Delete CODE_OF_CONDUCT_EN.md
---
CODE_OF_CONDUCT_EN.md | 48 -------------------------------------------
1 file changed, 48 deletions(-)
delete mode 100644 CODE_OF_CONDUCT_EN.md
diff --git a/CODE_OF_CONDUCT_EN.md b/CODE_OF_CONDUCT_EN.md
deleted file mode 100644
index 67e3d53..0000000
--- a/CODE_OF_CONDUCT_EN.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# Code of Conduct — CaramOS
-
-## Our Pledge
-
-CaramOS is an open-source project by the [Vietnam Linux Family (VNLF)](https://vietnamlinuxfamily.net) community. We are committed to creating an open, friendly, and respectful environment for everyone, regardless of experience, gender, gender identity, sexual orientation, disability, appearance, race, ethnicity, age, religion, or nationality.
-
-> [Tiếng Việt](CODE_OF_CONDUCT.md)
-
-## Standards
-
-**Encouraged behavior:**
-
-- Use welcoming and inclusive language
-- Respect differing viewpoints and experiences
-- Accept constructive criticism gracefully
-- Focus on what is best for the community
-- Show empathy towards other members
-- Help newcomers get started
-
-**Unacceptable behavior:**
-
-- Sexualized language or imagery, harassment of any kind
-- Insulting or derogatory comments, personal attacks
-- Public or private harassment
-- Publishing others' private information without permission
-- Spam or unrelated advertising
-- Disruptive or destructive behavior toward the project
-
-## Scope
-
-This Code of Conduct applies in all project spaces: GitHub (Issues, Pull Requests, Discussions), chat channels, events, and anywhere a member represents the CaramOS project.
-
-## Enforcement
-
-Violations may be reported via [Issues](https://github.com/VN-Linux-Family/CaramOS/issues) or by contacting the project maintainers directly. All reports will be reviewed and handled appropriately.
-
-Project maintainers have the right to remove, edit, or reject comments, commits, code, issues, and other contributions that do not align with this Code of Conduct.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.
-
----
-
-
- CaramOS — Sweet & Simple Linux
- github.com/VN-Linux-Family/CaramOS
-
From e9e45b982691a3a516344e99ae016d165ce76027 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:42:56 +0700
Subject: [PATCH 19/37] Delete CONTRIBUTING_EN.md
---
CONTRIBUTING_EN.md | 361 ---------------------------------------------
1 file changed, 361 deletions(-)
delete mode 100644 CONTRIBUTING_EN.md
diff --git a/CONTRIBUTING_EN.md b/CONTRIBUTING_EN.md
deleted file mode 100644
index 6a3e0ce..0000000
--- a/CONTRIBUTING_EN.md
+++ /dev/null
@@ -1,361 +0,0 @@
-# Contributing Guide — CaramOS
-
-Thank you for your interest in CaramOS! This document describes how to contribute
-under the project's current **OTA-first** model.
-
-> [Tiếng Việt](CONTRIBUTING.md) · [README](README_EN.md)
-
----
-
-## Table of Contents
-
-- [Current Status](#current-status)
-- [OTA-first Architecture](#ota-first-architecture)
-- [Project Structure](#project-structure)
-- [Build ISO](#build-iso)
-- [Developing with OTA](#developing-with-ota)
-- [Contribution Workflow](#contribution-workflow)
-- [Code Standards](#code-standards)
-- [Bug Reports and Feature Requests](#bug-reports-and-feature-requests)
-
----
-
-## Current Status
-
-CaramOS has moved to the **CaramOS OTA** update model.
-
-- New ISO images are still built and released.
-- Machines installed with CaramOS `1.0.1` do not need to reinstall the ISO.
-- Users install CaramOS Update Center, then upgrade through OTA.
-
-Command for users currently on CaramOS `1.0.1`:
-
-```bash
-curl -fsSL https://caramos.vietnamlinuxfamily.net/install-caramos-ota.sh | sudo bash
-```
-
-After installation, users should open **CaramOS Update Center** from the Start
-Menu to check and upgrade to the latest version.
-
-> [!IMPORTANT]
-> Contributors/developers should not add new system updates directly to
-> `config/hooks/live/`. If a change must apply to already-installed CaramOS
-> machines, write an OTA migration in `packages/caramos-ota`.
-
----
-
-## OTA-first Architecture
-
-CaramOS still uses ISO remastering, but ISO builds now include an OTA bootstrap
-step:
-
-```text
-Linux Mint ISO
- → extract rootfs
- → install packages + overlay + build-time hooks
- → build/install bundled caramos-ota
- → run caramos-ota-update migrations inside rootfs
- → repack squashfs + CaramOS ISO
-```
-
-Key points:
-
-- `scripts/config.sh` stores ISO version and base migration version.
-- `CARAMOS_MIGRATION_BASE_VERSION="1.0.1"` is kept so ISO builds run the full
- migration chain from the first Open Beta release to latest.
-- `scripts/ota_bootstrap.sh` builds the `caramos-ota` package, installs it into
- the rootfs, and runs migrations before repacking the ISO.
-- The resulting ISO is already at the latest state in the source tree.
-- OTA is the upgrade path for users already installed from older ISOs.
-
-### Do not code new user-facing updates into hooks
-
-`config/hooks/live/` should only be used for true build-time/bootstrap tasks.
-Examples:
-
-- preparing the rootfs environment before OTA bootstrap runs;
-- actions that only make sense during ISO build;
-- build system fixes, boot branding, or foundational dependencies.
-
-If a change must reach installed user machines — for example panel settings,
-dconf, Fcitx5, desktop launchers, theme, `/etc/caramos-release`, package state —
-write a migration.
-
----
-
-## Project Structure
-
-```text
-CaramOS/
-├── build.sh # ISO build entry point
-├── Makefile # make build/release/quick/docker-build...
-├── scripts/ # ISO build modules
-│ ├── config.sh # ISO version, migration base, mirror, output
-│ ├── extract.sh # Mount ISO + unsquashfs
-│ ├── customize.sh # Packages + overlay + hooks + OTA bootstrap
-│ ├── ota_bootstrap.sh # Build/install OTA package and run migrations
-│ ├── repack.sh # mksquashfs + xorriso
-│ ├── boot_config.sh # Boot menu/Plymouth branding
-│ └── utils.sh # Logging, deps, ISO helpers
-├── config/ # ISO/rootfs bootstrap layer
-│ ├── packages.txt # Base packages installed when building ISO
-│ ├── includes.chroot/ # Overlay copied into the rootfs
-│ └── hooks/live/ # Legacy build-time hooks, avoid adding new logic
-├── packages/
-│ └── caramos-ota/ # Main OTA system
-│ ├── debian/changelog # OTA package version uploaded to PPA
-│ ├── usr/bin/
-│ │ ├── caramos-ota # CLI/orchestrator
-│ │ ├── caramos-ota-notifier # Update Center/notifier
-│ │ └── caramos-ota-update # Migration runner
-│ └── usr/lib/python3/dist-packages/
-│ ├── caramos_ota/
-│ ├── caramos_ota_notifier/
-│ └── caramos_ota_update/migrations/
-│ ├── migration.json # frozen historical bridge
-│ ├── v1_0_*/ # legacy migrations through 1.0.12
-│ └── YYYYMMDDHHMMSS_name/
-│ ├── manifest.json
-│ └── migration.py
-├── landing/ # Website/landing page
-├── docs/ # Operations/release tracking docs
-├── assets/ # Logo, banner, screenshots
-└── .github/workflows/ # CI/release workflow
-```
-
-Detailed OTA docs:
-
-- [packages/README.md](packages/README.md)
-- [packages/caramos-ota/README.md](packages/caramos-ota/README.md)
-
----
-
-## Build ISO
-
-### Local build
-
-Requirements: a compatible Ubuntu/Mint/Debian machine, `sudo`, and enough free
-space for rootfs and ISO artifacts.
-
-```bash
-sudo apt update
-sudo apt install squashfs-tools xorriso rsync wget curl isolinux syslinux-common syslinux-utils
-```
-
-Fast dev build:
-
-```bash
-make build
-```
-
-Smaller release build:
-
-```bash
-make release
-```
-
-Build from an existing Mint ISO:
-
-```bash
-make build ISO=linuxmint-22.3-cinnamon-64bit.iso
-```
-
-During the build, `customize.sh` calls OTA bootstrap. Therefore, if you change
-`packages/caramos-ota`, rebuilding the ISO will embed the new OTA package and run
-migrations into the rootfs before packaging.
-
-### Docker build
-
-Use Docker when the host is not a compatible Ubuntu/Mint/Debian system:
-
-```bash
-make docker-build
-make docker-release
-```
-
-### Fast iteration workflow
-
-| Change type | Recommended command |
-|---|---|
-| Base ISO overlay/assets | `make overlay && make quick` |
-| Boot menu/Plymouth | `make boot-only && make iso-only` |
-| OTA migration/package | test in `packages/caramos-ota`, then `make customize-only` or `make build` |
-| Release version | update `scripts/config.sh`, docs/landing according to `docs/release-version-tracking.md` |
-
----
-
-## Developing with OTA
-
-### When do you need a migration?
-
-Create an OTA migration when a change affects already-installed CaramOS systems,
-for example:
-
-- Cinnamon panel/dconf/default app launcher changes;
-- Fcitx5/Lotus, input method, or autostart fixes;
-- branding, theme, icon, or wallpaper updates that should apply to existing users;
-- adding/updating CaramOS-managed packages;
-- changes to `/etc/caramos-release`, `/etc/lsb-release`, or `/etc/os-release`;
-- one-time commands that must run on user machines after release.
-
-Do not use hooks as a replacement for migrations in these cases.
-
-### Files to add for an OTA migration
-
-```text
-packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/
-└── YYYYMMDDHHMMSS_migration_name/
- ├── manifest.json
- ├── migration.py
- └── optional payload
-```
-
-Generate the timestamp with `date -u +%Y%m%d%H%M%S`. Schema-2 `manifest.json`
-declares `release`, UI metadata, `codename`, and `channel`. `migration.py` declares
-`DESCRIPTION` and `run(context)`. Do not edit `migration.json`; it is the frozen
-historical bridge through `1.0.12`; timestamp migrations start with release `1.0.13`. See
-[packages/caramos-ota/MIGRATIONS.md](packages/caramos-ota/MIGRATIONS.md).
-
-### Migration rules
-
-- Published timestamp IDs are immutable; make a new migration for follow-up fixes.
-- Multiple migrations may share one `release`; the runner orders them by ID.
-- Migrations must be idempotent or include explicit rerun guards.
-- Do not download or execute scripts from the internet inside migrations.
-- Do not download `.deb` files manually; use the configured APT/PPA path.
-- Do not hardcode users such as `caram` or `mint`; detect the real desktop user.
-- Do not add PPAs/keyrings in a migration unless they have been reviewed in the
- package/ISO layer.
-- Log each important action with `context.log(...)`.
-- `dry-run` must not mutate the system.
-- User-session commands such as `systemctl --user`, `gsettings`, or `fcitx5`
- must use short timeouts and fallbacks.
-- If a service/desktop component restart is needed, prefer best-effort refresh
- and tell users to logout/login when required.
-
-### OTA tests before PR
-
-Inside the OTA package:
-
-```bash
-cd packages/caramos-ota
-make compile
-make validate
-make build
-```
-
-If VM testing is available:
-
-```bash
-make ship
-make vm-test-cli
-make vm-test-notifier
-```
-
-PR checklist:
-
-- [ ] New migration has a unique UTC timestamp ID and clear release.
-- [ ] `migration.json` is unchanged; schema-2 `manifest.json` is valid.
-- [ ] `make compile`, `make validate`, `./tools/caramos-ota-testkit.sh test`, and `make build` pass.
-- [ ] Upgrade from an older version was tested in a VM snapshot if possible.
-- [ ] Update Center does not hang when a migration fails or a command times out.
-- [ ] Logs in `/var/log/caramos-ota/` are sufficient for debugging.
-- [ ] README/landing/release notes are updated if this is a new release.
-
----
-
-## Contribution Workflow
-
-1. Fork the repository.
-2. Create a branch from `develop` or the branch specified by maintainers.
-3. Make focused, well-scoped changes.
-4. Test according to the change type.
-5. Commit with a clear prefixed message.
-6. Open a Pull Request and describe:
- - what changed;
- - why it is needed;
- - how it was tested;
- - whether it requires an OTA migration.
-
-### Contribution roles
-
-| Role | Work |
-|---|---|
-| Tester | Test ISO/OTA on real hardware or VMs, report issues with logs/screenshots |
-| Developer | Write migrations, OTA package changes, build scripts, bug fixes |
-| Designer | Wallpapers, icons, banners, branding assets |
-| Writer | README, user guides, changelog, translations |
-
-### Branches and releases
-
-```text
-main # stable/release branch
-feat/* # new features
-fix/* # bug fixes
-docs/* # documentation
-release/* # release preparation
-```
-
-When bumping a release version, follow the checklist in
-[docs/release-version-tracking.md](docs/release-version-tracking.md).
-
----
-
-## Code Standards
-
-### Commit messages
-
-The project prefers short, easy-to-scan prefixes:
-
-```text
-[build] build scripts / Docker / CI
-[config] package list, overlay, system config
-[assets] logo, wallpaper, screenshot
-[docs] README, guide, changelog
-[ota] caramos-ota, migration, notifier, updater
-[release] version bump/tag/release metadata
-```
-
-### Bash
-
-- Use `set -e` or explicit error handling.
-- Log what each block is doing.
-- Do not download/run uncontrolled scripts.
-- Scripts in `scripts/` should provide `--help` when runnable independently.
-
-### Python migrations
-
-- Prefer the standard library; avoid adding dependencies unless necessary.
-- Do not hardcode usernames or home paths.
-- Check that files exist before editing/removing them.
-- Backup or log risky changes clearly.
-- Respect `dry-run` when the context supports it.
-
----
-
-## Bug Reports and Feature Requests
-
-Create an issue at:
-
-Bug reports should include:
-
-- current CaramOS version;
-- whether you are using ISO or OTA;
-- steps to reproduce;
-- expected result;
-- relevant logs, especially `/var/log/caramos-ota/` for update issues;
-- screenshots/videos for UI issues.
-
-Feature requests should include:
-
-- a short description;
-- why the feature is needed;
-- whether it affects installed users or only new ISOs;
-- if it affects installed users, a proposed OTA migration approach.
-
----
-
-
- CaramOS — Sweet & Simple Linux
- github.com/VN-Linux-Family/CaramOS
-
From 8238a3c009b5402c0ae2ebb77e38b282cedb4c3e Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:43:17 +0700
Subject: [PATCH 20/37] Delete AGENTS.md
---
AGENTS.md | 148 ------------------------------------------------------
1 file changed, 148 deletions(-)
delete mode 100644 AGENTS.md
diff --git a/AGENTS.md b/AGENTS.md
deleted file mode 100644
index 31a5355..0000000
--- a/AGENTS.md
+++ /dev/null
@@ -1,148 +0,0 @@
-# CaramOS - Bản phân phối Linux (ISO Remaster)
-
-## Tổng quan dự án
-
-CaramOS là bản phân phối Linux dựa trên Linux Mint 22 (Ubuntu 24.04 LTS), thiết kế cho người dùng Việt Nam. Phương pháp build: ISO Remaster — giải nén ISO gốc → tùy biến (packages, overlay, hooks) → đóng gói lại (squashfs + xorriso).
-
-## Cấu trúc dự án
-
-```
-./
-├── build.sh # Script build chính (điểm khởi đầu)
-├── Makefile # Các target build
-├── scripts/ # Các module build
-│ ├── config.sh # Version, mirror, cấu hình output
-│ ├── utils.sh # Log, kiểm tra root, cài deps, tải ISO
-│ ├── extract.sh # Mount ISO + rsync + unsquashfs
-│ ├── customize.sh # Chroot + packages + overlay + hooks
-│ ├── repack.sh # mksquashfs + xorriso → ISO
-│ ├── boot_config.sh # Boot menu + Plymouth branding
-│ ├── overlay.sh # Copy includes.chroot vào rootfs
-│ ├── chroot_shell.sh # Debug chroot
-│ └── debug_iso.sh # Kiểm tra boot splash/Plymouth
-├── config/
-│ ├── packages.txt # Packages cần thêm (plank, fcitx5, chrome...)
-│ ├── hooks/live/ # Hooks chạy bên trong chroot
-│ │ └── NNNN-ten.hook.chroot # Đặt tên theo thứ tự ưu tiên (0100, 0200...)
-│ └── includes.chroot/ # Overlay files copy vào rootfs
-│ ├── etc/ # dconf, lightdm, skel, locale, hostname
-│ └── usr/share/ # applications, backgrounds, icons, themes
-├── docker-compose.yml # Cấu hình Docker builder
-├── Dockerfile # Ubuntu 24.04 base cho containerized build
-└── assets/ # Logo, banner images
-```
-
-## Lệnh build
-
-### Build Local (Chỉ Ubuntu/Mint/Debian)
-
-- `make build` — Build dev đầy đủ (nén lz4, nhanh)
-- `make release` — Build release (nén xz, ISO nhỏ hơn)
-- `make prepare` — Giải nén ISO ra build/ để sửa/test nhanh
-- `make quick` — Prepare nếu cần → overlay → repack (lặp nhanh)
-- `make overlay` — Chỉ copy includes.chroot vào rootfs
-- `make customize-only` — Chạy packages + overlay + hooks
-- `make repack` — Repack squashfs + ISO từ work tree có sẵn
-- `make iso-only` — Tạo lại ISO chỉ từ build/custom
-- `make shell` — Vào chroot build/squashfs để debug thủ công
-- `make boot-only` — Chỉ áp dụng boot config + Plymouth branding
-- `make clean` — Xóa toàn bộ build/cache/output (giữ source ISO)
-
-### Build Docker (Mọi hệ điều hành)
-
-- `make docker-build` — Build dev trong Docker container
-- `make docker-release` — Build release trong Docker container
-- `make docker-clean` — Clean build qua Docker
-
-### Debug
-
-- `make debug-iso` — Kiểm tra trạng thái boot menu/Plymouth
-- `make debug-iso ISO=ten_file.iso` — Kiểm tra ISO cụ thể
-
-### Tham số
-
-- `make build ISO=linuxmint-22.3-cinnamon-64bit.iso` — Build từ ISO có sẵn
-
-## Quy trình build
-
-```
-1. extract.sh Mount source ISO → rsync filesystem → unsquashfs
- → build/squashfs/ (base chỉ đọc)
- → build/custom/ (work tree)
-
-2. customize.sh chroot vào build/custom/
- → Cài packages từ config/packages.txt
- → Copy overlay từ config/includes.chroot/
- → Chạy các script hooks trong config/hooks/live/
-
-3. repack.sh mksquashfs build/custom/ → build/CaramOS.sfs
- → xorriso → CaramOS-VERSION-cinnamon-amd64.iso
-```
-
-## Quy ước
-
-### Hook Files
-
-- Vị trí: `config/hooks/live/`
-- Đặt tên: `NNNN-ten.hook.chroot` (prefix 4 số thứ tự)
-- Thứ tự thực thi: Tăng dần theo số (0100, 0200, 0900...)
-- Ví dụ: `0100-caramos-setup.hook.chroot`
-
-### Bash Scripts
-
-- Dùng `set -e` để xử lý lỗi
-- Tất cả scripts trong `scripts/` đều có thể chạy độc lập với `--help`
-
-### Cấu hình Version
-
-- Chỉnh sửa `scripts/config.sh` để thay đổi: MINT_VERSION, CARAMOS_VERSION, MIRROR, OUTPUT_ISO
-- Nén mặc định: lz4 (dev nhanh), xz cho release
-
-### Output
-
-- ISO output: `CaramOS-${CARAMOS_VERSION}-cinnamon-amd64.iso`
-- Build artifacts: thư mục `./build/`
-- Source ISO được giữ nguyên trong cache/ sau khi extract
-
-## Lưu ý quan trọng
-
-### Yêu cầu
-
-- Build cần **sudo/root** (mount, chroot, loop operations)
-- Build local: Ubuntu 24.04/Mint 22/Debian base
-- Build Docker hoạt động trên mọi hệ điều hành (macOS, Windows, mọi distro Linux)
-
-### Khuyến nghị dùng Docker
-
-Dùng Docker để build nếu không dùng Ubuntu 24.04:
-
-```bash
-docker compose up --build builder
-# hoặc đơn giản:
-make docker-build
-```
-
-### CI/CD
-
-GitHub Actions workflow trong `.github/workflows/build.yml` build trên Ubuntu 24.04 runners.
-
-### Git Workflow
-
-- Định dạng commit: prefix `[build]`, `[config]`, `[assets]`, `[docs]`
-- AGENTS.md: Commit lên Git để team share context
-- Không cần .claudeignore — project không phải TypeScript/Node.js
-
-## Đóng góp
-
-Để xem hướng dẫn chi tiết về đóng góp (kiến trúc, thêm packages, tạo hooks, sửa overlay, quy trình test), xem [CONTRIBUTING.md](CONTRIBUTING.md).
-
-Bảng tra nhanh:
-
-| Task | Vị trí | Hành động |
-| ------------------------- | ---------------------------------------- | -------------------------------------- |
-| Thêm package | `config/packages.txt` | Sửa file, sau đó `make customize-only` |
-| Tạo hook mới | `config/hooks/live/NNNN-ten.hook.chroot` | Xem các hook có sẵn để lấy template |
-| Sửa config hệ thống | `config/includes.chroot/etc/` | Sửa, sau đó `make overlay` |
-| Sửa theme/icons | `config/includes.chroot/usr/share/` | Sửa, sau đó `make overlay` |
-| Test toàn bộ sau thay đổi | — | `make quick && test in VM` |
-| Debug trong chroot | — | `make shell` |
From 8fc61e488221293cbb1f3fbf2c0144c4dbe4faa6 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:43:35 +0700
Subject: [PATCH 21/37] Delete landing
---
landing | 1 -
1 file changed, 1 deletion(-)
delete mode 120000 landing
diff --git a/landing b/landing
deleted file mode 120000
index 848fcab..0000000
--- a/landing
+++ /dev/null
@@ -1 +0,0 @@
-../CaramOSLanding
\ No newline at end of file
From 6e3c5ac44080f46dfdfc526c0be3bed94d9d60a9 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 17:46:48 +0700
Subject: [PATCH 22/37] Update README.md
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 873b76a..1d6ef6b 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# DMCaramOS - better CaramOS
+# DMCaramOS - DryFish's Modified version for CaramOS
### What's this fork added:
This fork added, and will add:
From 83363409d4fb338c00e075d7edb5a7e050cbc36d Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 18:23:33 +0700
Subject: [PATCH 23/37] chore: translate build script and improve some progress
---
scripts/boot_config.sh | 48 ++++++++--------
scripts/check-claude-endpoint-compat.sh | 72 ------------------------
scripts/customize.sh | 32 ++++-------
scripts/debug_iso.sh | 74 +++++++++++++++----------
scripts/extract.sh | 55 +++++++++++-------
scripts/ota_bootstrap.sh | 61 ++++++++++++++------
scripts/overlay.sh | 14 ++---
scripts/repack.sh | 33 +++--------
8 files changed, 169 insertions(+), 220 deletions(-)
diff --git a/scripts/boot_config.sh b/scripts/boot_config.sh
index 51920d1..1ac4f30 100644
--- a/scripts/boot_config.sh
+++ b/scripts/boot_config.sh
@@ -1,10 +1,10 @@
#!/bin/bash
-# Cấu hình bootloader + plymouth theo build mode:
-# - Branding (Linux Mint → CaramOS): LUÔN áp dụng, cả dev lẫn release
-# - Dev/Release mode mặc định giữ quiet + splash để hiện Plymouth loading screen
-# - Debug boot mode (--debug-boot) xoá quiet/splash khỏi kernel cmdline
+# Bootloader + plymouth configuration by build mode:
+# - Branding (Linux Mint → CaramOS): ALWAYS applied, both dev and release
+# - Dev/Release mode keeps quiet + splash by default for Plymouth loading screen
+# - Debug boot mode (--debug-boot) removes quiet/splash from kernel cmdline
#
-# Chạy SAU step_extract, TRƯỚC step_customize.
+# Run AFTER step_extract, BEFORE step_customize.
step_boot_config() {
local ISO_DIR="$WORK_DIR/custom"
@@ -13,9 +13,9 @@ step_boot_config() {
[ "${DEBUG_BOOT:-0}" = "1" ] && IS_DEBUG=true
if $IS_DEBUG; then
- info "[2.5/7] Cấu hình debug boot (no quiet/splash)..."
+ info "[2.5/7] Configuring debug boot (no quiet/splash)..."
else
- info "[2.5/7] Cấu hình boot đẹp (branding + Plymouth)..."
+ info "[2.5/7] Configuring beautiful boot (branding + Plymouth)..."
fi
local BRAND_NAME="CaramOS"
@@ -32,7 +32,7 @@ step_boot_config() {
2>/dev/null)
if [ -n "$ISOLINUX_FILES" ]; then
- info " → Sửa isolinux/syslinux config..."
+ info " → Fixing isolinux/syslinux config..."
echo "$ISOLINUX_FILES" | while IFS= read -r cfg; do
sed -i \
-e "s/Welcome to Linux Mint [0-9.]* 64-bit/Welcome to ${BRAND_NAME} ${BRAND_VERSION} 64-bit/gI" \
@@ -67,10 +67,10 @@ step_boot_config() {
}' "$cfg"
fi
- ok " Đã sửa: $(basename "$cfg")"
+ ok " Fixed: $(basename "$cfg")"
done
else
- warn " → Không tìm thấy isolinux/syslinux config, bỏ qua."
+ warn " → No isolinux/syslinux config found, skipping."
fi
local GRUB_FILES
@@ -80,7 +80,7 @@ step_boot_config() {
2>/dev/null)
if [ -n "$GRUB_FILES" ]; then
- info " → Sửa GRUB config..."
+ info " → Fixing GRUB config..."
local GRUB_SPLASH="$SCRIPT_DIR/assets/boot-splash.png"
if [ -f "$GRUB_SPLASH" ]; then
@@ -110,10 +110,10 @@ step_boot_config() {
sed -i '/^[[:space:]]*linux/s/\bquiet\b//g; /^[[:space:]]*linux/s/\bsplash\b//g' "$cfg"
fi
- ok " Đã sửa: $(basename "$cfg")"
+ ok " Fixed: $(basename "$cfg")"
done
else
- warn " → Không tìm thấy GRUB config, bỏ qua."
+ warn " → No GRUB config found, skipping."
fi
local BANNER_SRC="$SCRIPT_DIR/splash.png"
@@ -125,16 +125,14 @@ step_boot_config() {
-exec dirname {} \; 2>/dev/null | head -1)
if [ ! -f "$BANNER_SRC" ]; then
- warn " → Không tìm thấy splash.png/assets/boot-splash.png, bỏ qua boot menu background."
+ warn " → splash.png/assets/boot-splash.png not found, skipping boot menu background."
elif [ -z "$ISOLINUX_DIR" ]; then
- warn " → Không tìm thấy thư mục isolinux, bỏ qua splash."
+ warn " → isolinux directory not found, skipping splash."
else
- info " → Set syslinux splash background..."
+ info " → Setting syslinux splash background..."
- # Keep Mint's original gfxboot/isolinux UI. Replacing it with vesamenu
- # makes the boot menu fall back to a black text screen on the Mint ISO.
cp "$BANNER_SRC" "$ISOLINUX_DIR/splash.png"
- ok " Đã copy: splash.png → $ISOLINUX_DIR/"
+ ok " Copied: splash.png → $ISOLINUX_DIR/"
find "$ISOLINUX_DIR" -name "*.cfg" -type f -print0 | \
xargs -0 sed -i '/^[[:space:]]*menu[[:space:]]\+background[[:space:]]/Id'
@@ -144,24 +142,24 @@ step_boot_config() {
if [ -f "$INSERT_CFG" ]; then
sed -i '1i menu background splash.png' "$INSERT_CFG"
- ok " Set MENU BACKGROUND trong: $(basename "$INSERT_CFG")"
+ ok " Set MENU BACKGROUND in: $(basename "$INSERT_CFG")"
else
- warn " Không tìm thấy cfg phù hợp để thêm MENU BACKGROUND."
+ warn " No suitable cfg found to add MENU BACKGROUND."
fi
local MAIN_CFG="$ISOLINUX_DIR/isolinux.cfg"
if [ -f "$MAIN_CFG" ]; then
if ! grep -qiE '^[[:space:]]*include[[:space:]]+stdmenu\.cfg' "$MAIN_CFG"; then
sed -i '/^[[:space:]]*include[[:space:]]\+live\.cfg/i include stdmenu.cfg' "$MAIN_CFG"
- ok " Đã include stdmenu.cfg trong: isolinux.cfg"
+ ok " Included stdmenu.cfg in: isolinux.cfg"
fi
if ! grep -qiE '^[[:space:]]*menu[[:space:]]+background[[:space:]]+splash\.png' "$MAIN_CFG"; then
sed -i '1i menu background splash.png' "$MAIN_CFG"
- ok " Set MENU BACKGROUND trực tiếp trong: isolinux.cfg"
+ ok " Set MENU BACKGROUND directly in: isolinux.cfg"
fi
fi
fi
- info " → Giữ Plymouth để hiện loading screen CaramOS."
- ok "[2.5/7] Boot config xong."
+ info " → Keeping Plymouth for CaramOS loading screen."
+ ok "[2.5/7] Boot config complete."
}
diff --git a/scripts/check-claude-endpoint-compat.sh b/scripts/check-claude-endpoint-compat.sh
index 5e33aaf..18c024d 100755
--- a/scripts/check-claude-endpoint-compat.sh
+++ b/scripts/check-claude-endpoint-compat.sh
@@ -1,17 +1,6 @@
#!/usr/bin/env bash
set -uo pipefail
-# Claude Code/custom Anthropic endpoint compatibility probe.
-#
-# Default run:
-# ./scripts/check-claude-endpoint-compat.sh
-#
-# Optional controls:
-# TIMEOUT_SECONDS=120 CONCURRENCY=2 ./scripts/check-claude-endpoint-compat.sh
-# FULL_1M=1 ./scripts/check-claude-endpoint-compat.sh
-#
-# FULL_1M=1 sends a very large, potentially expensive request.
-
CFG="${CLAUDE_SETTINGS_FILE:-${HOME}/.claude/settings.json}"
TIMEOUT_SECONDS="${TIMEOUT_SECONDS:-90}"
CONCURRENCY="${CONCURRENCY:-4}"
@@ -161,10 +150,6 @@ printf 'Configured API model: %s\n' "$MODEL"
printf 'Claude Code version: %s\n' "$(claude --version 2>&1 | tr '\n' ' ')"
printf 'Artifacts: %s\n\n' "$WORK"
-###############################################################################
-# 1. Models API: optional for Claude Code, useful for capability discovery.
-###############################################################################
-
MODELS_CODE="$(
request GET \
"${BASE}/models" \
@@ -179,10 +164,6 @@ else
warn "GET /models unavailable or non-standard (HTTP ${MODELS_CODE}); Claude Code may still work"
fi
-###############################################################################
-# 2. Basic Messages API.
-###############################################################################
-
jq -n --arg model "$MODEL" '{
model: $model,
max_tokens: 64,
@@ -213,10 +194,6 @@ else
fail "Messages API basic schema (HTTP ${BASIC_CODE})"
fi
-###############################################################################
-# 3. Forced tool_use.
-###############################################################################
-
jq -n --arg model "$MODEL" '{
model: $model,
max_tokens: 128,
@@ -261,10 +238,6 @@ else
fail "Anthropic tool_use schema (HTTP ${TOOL_CODE})"
fi
-###############################################################################
-# 4. tool_result round trip.
-###############################################################################
-
TOOL_ID="$(
jq -r '.content[]? | select(.type == "tool_use") | .id' \
"${WORK}/tool.response.json" 2>/dev/null |
@@ -327,10 +300,6 @@ else
fail 'tool_result round trip skipped because tool_use ID is missing'
fi
-###############################################################################
-# 5. Text streaming SSE.
-###############################################################################
-
jq '. + {stream: true}' "${WORK}/basic.request.json" >"${WORK}/stream.request.json"
curl -sS -N \
@@ -363,10 +332,6 @@ else
fail 'Streaming SSE event sequence'
fi
-###############################################################################
-# 6. Tool streaming and input_json_delta.
-###############################################################################
-
jq '. + {stream: true}' "${WORK}/tool.request.json" >"${WORK}/tool-stream.request.json"
curl -sS -N \
@@ -385,10 +350,6 @@ else
fail 'Streaming tool input_json_delta'
fi
-###############################################################################
-# 7. Thinking and effort compatibility.
-###############################################################################
-
jq -n --arg model "$MODEL" '{
model: $model,
max_tokens: 256,
@@ -416,10 +377,6 @@ else
fail "Adaptive thinking and effort request rejected (HTTP ${THINKING_CODE})"
fi
-###############################################################################
-# 8. Prompt caching.
-###############################################################################
-
python3 - <<'PY' >"${WORK}/cache-prefix.txt"
print("Stable endpoint compatibility context. " * 1200)
PY
@@ -468,10 +425,6 @@ else
fail "Prompt cache requests rejected (HTTP ${CACHE1_CODE}/${CACHE2_CODE})"
fi
-###############################################################################
-# 9. Anthropic error envelope.
-###############################################################################
-
jq -n '{
model: "compat_probe_model_that_must_not_exist_7f39d6",
max_tokens: 16,
@@ -498,11 +451,6 @@ else
fail "Invalid-model error envelope (HTTP ${ERROR_CODE})"
fi
-###############################################################################
-# 10. Large-context request.
-# Default approximates a moderate context. FULL_1M=1 is expensive.
-###############################################################################
-
if [[ "$FULL_1M" == "1" ]]; then
CONTEXT_WORDS=900000
warn 'FULL_1M enabled; request may be expensive and only approximates 1M tokens'
@@ -548,10 +496,6 @@ else
fail "Large context rejected (${CONTEXT_WORDS} repeated words, HTTP ${LARGE_CONTEXT_CODE})"
fi
-###############################################################################
-# 11. Claude Code basic end-to-end.
-###############################################################################
-
if timeout 120s env API_TIMEOUT_MS=60000 \
claude -p \
'Reply with exactly CLAUDE_CODE_OK' \
@@ -569,10 +513,6 @@ else
fail 'Claude Code basic end-to-end'
fi
-###############################################################################
-# 12. Claude Code Read tool end-to-end.
-###############################################################################
-
PROBE_FILE="${WORK}/read-probe.txt"
printf 'CLAUDE_TOOL_OK\n' >"$PROBE_FILE"
@@ -594,10 +534,6 @@ else
fail 'Claude Code Read tool round trip'
fi
-###############################################################################
-# 13. Claude Code stream-json.
-###############################################################################
-
if timeout 120s env API_TIMEOUT_MS=60000 \
claude -p \
'Print numbers 1 through 5, one number per line.' \
@@ -630,10 +566,6 @@ else
fail 'Claude Code stream-json'
fi
-###############################################################################
-# 14. Parallel Claude Code requests.
-###############################################################################
-
PIDS=()
for n in $(seq 1 "$CONCURRENCY"); do
(
@@ -671,10 +603,6 @@ else
fail "${CONCURRENCY} parallel Claude Code requests"
fi
-###############################################################################
-# Summary.
-###############################################################################
-
{
printf '\n============================================================\n'
printf 'Compatibility summary\n'
diff --git a/scripts/customize.sh b/scripts/customize.sh
index 48f8848..be8da95 100644
--- a/scripts/customize.sh
+++ b/scripts/customize.sh
@@ -1,8 +1,8 @@
#!/bin/bash
-# Bước 4-6: Chroot + tuỳ biến + dọn dẹp
+# Steps 4-6: Chroot + customization + cleanup
cleanup_chroot_package_state() {
- info " → Dọn trạng thái apt/dpkg cũ trong chroot..."
+ info " → Cleaning stale apt/dpkg state in chroot..."
chroot "$WORK_DIR/squashfs" /bin/bash -c '
export DEBIAN_FRONTEND=noninteractive
mkdir -p /usr/share/package-data-downloads.disabled
@@ -15,58 +15,47 @@ cleanup_chroot_package_state() {
}
step_customize() {
- # --- Mount chroot ---
- info "[4/7] Mount chroot..."
+ info "[4/7] Mounting chroot..."
mount_chroot
cleanup_chroot_package_state
- # --- Tuỳ biến ---
- info "[5/7] Tuỳ biến CaramOS..."
+ info "[5/7] Customizing CaramOS..."
- # Cài thêm packages
if [ -f "$SCRIPT_DIR/config/packages.txt" ]; then
- info " → Cài thêm packages..."
+ info " → Installing additional packages..."
cp "$SCRIPT_DIR/config/packages.txt" "$WORK_DIR/squashfs/tmp/packages.txt"
chroot "$WORK_DIR/squashfs" /bin/bash -c '
export DEBIAN_FRONTEND=noninteractive
APT_LOCK_TIMEOUT="${APT_LOCK_TIMEOUT:-600}"
echo "ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | debconf-set-selections || true
echo "ttf-mscorefonts-installer msttcorefonts/present-mscorefonts-eula note" | debconf-set-selections || true
- # Đổi sang mirror VN (BizFly Cloud) trước khi apt-get update
- # archive.ubuntu.com đặt ở US/EU, tốc độ ~150kB/s từ VN — mirror VN đạt ~5-15MB/s
sed -i "s|http://archive.ubuntu.com/ubuntu|http://mirror.bizflycloud.vn/ubuntu|g" /etc/apt/sources.list
sed -i "s|http://security.ubuntu.com/ubuntu|http://mirror.bizflycloud.vn/ubuntu|g" /etc/apt/sources.list
apt-get -o DPkg::Lock::Timeout="$APT_LOCK_TIMEOUT" update
grep -v "^#" /tmp/packages.txt | grep -v "^$" | xargs apt-get -o DPkg::Lock::Timeout="$APT_LOCK_TIMEOUT" install -y
rm /tmp/packages.txt
'
- ok "Cài packages xong."
+ ok "Package installation complete."
fi
- # Copy overlay
step_overlay
- # Chạy hooks
for hook in "$SCRIPT_DIR/config/hooks/live/"*.hook.chroot; do
if [ -f "$hook" ]; then
hook_name=$(basename "$hook")
- info " → Chạy hook: $hook_name"
+ info " → Running hook: $hook_name"
cp "$hook" "$WORK_DIR/squashfs/tmp/$hook_name"
CARAMOS_VERSION="${CARAMOS_MIGRATION_BASE_VERSION:-$CARAMOS_VERSION}" \
MINT_VERSION="$MINT_VERSION" \
MINT_EDITION="$MINT_EDITION" \
chroot "$WORK_DIR/squashfs" /bin/bash "/tmp/$hook_name"
rm -f "$WORK_DIR/squashfs/tmp/$hook_name"
- ok "Hook $hook_name xong."
+ ok "Hook $hook_name complete."
fi
done
- # Cài OTA package và chạy tất cả migrations vào rootfs trước khi đóng ISO.
step_ota_bootstrap
- # Chỉ đánh dấu customized sau khi TOÀN BỘ hook + OTA bootstrap đã chạy xong.
- # Nếu bị Ctrl+C giữa chừng, marker không được tạo và make quick sẽ buộc
- # chạy lại customize thay vì repack rootfs thiếu Plymouth/Cinnamenu/dock.
chroot "$WORK_DIR/squashfs" /bin/bash -c '
set -e
test -f /etc/dconf/db/local
@@ -78,10 +67,9 @@ step_customize() {
test -f /usr/share/plymouth/themes/caramos/caramos.plymouth
date -u +"%Y-%m-%dT%H:%M:%SZ" > /etc/caramos-customized
'
- ok "Rootfs đã được customize đầy đủ."
+ ok "Rootfs fully customized."
- # --- Dọn dẹp chroot ---
- info "[6/7] Dọn dẹp chroot..."
+ info "[6/7] Cleaning chroot..."
chroot "$WORK_DIR/squashfs" /bin/bash -c '
APT_LOCK_TIMEOUT="${APT_LOCK_TIMEOUT:-600}"
apt-get -o DPkg::Lock::Timeout="$APT_LOCK_TIMEOUT" clean
diff --git a/scripts/debug_iso.sh b/scripts/debug_iso.sh
index 8ff71bd..d5f45a9 100755
--- a/scripts/debug_iso.sh
+++ b/scripts/debug_iso.sh
@@ -8,6 +8,10 @@ ISO="${1:-CaramOS-0.1-cinnamon-amd64.iso}"
WORK_CUSTOM="build/custom"
ROOTFS="build/squashfs"
+command_exists() {
+ command -v "$1" >/dev/null 2>&1
+}
+
echo "== CaramOS ISO debug =="
echo "ISO: $ISO"
echo
@@ -19,8 +23,8 @@ echo
echo "== Isolinux config =="
if [ -d "$WORK_CUSTOM/isolinux" ]; then
- grep -RIn "menu background\|include stdmenu\|include live\|append boot=casper" "$WORK_CUSTOM/isolinux"/*.cfg || true
- [ -f "$WORK_CUSTOM/isolinux/splash.png" ] && file "$WORK_CUSTOM/isolinux/splash.png"
+ find "$WORK_CUSTOM/isolinux" -maxdepth 1 -name "*.cfg" -exec grep -HIn "menu background\|include stdmenu\|include live\|append boot=casper" {} + 2>/dev/null || true
+ [ -f "$WORK_CUSTOM/isolinux/splash.png" ] && file "$WORK_CUSTOM/isolinux/splash.png" || echo "MISSING: $WORK_CUSTOM/isolinux/splash.png"
else
echo "MISSING: $WORK_CUSTOM/isolinux"
fi
@@ -28,45 +32,44 @@ echo
echo "== GRUB config =="
if [ -d "$WORK_CUSTOM/boot/grub" ]; then
- grep -RIn "menuentry\|quiet\|splash" "$WORK_CUSTOM/boot/grub"/*.cfg 2>/dev/null | head -80 || true
+ find "$WORK_CUSTOM/boot/grub" -maxdepth 1 -name "*.cfg" -exec grep -HIn "menuentry\|quiet\|splash" {} + 2>/dev/null | head -80 || true
else
echo "MISSING: $WORK_CUSTOM/boot/grub"
fi
echo
echo "== Plymouth rootfs =="
-if [ -d "$ROOTFS/usr/share/plymouth/themes" ]; then
- DEFAULT_LINK="$ROOTFS/usr/share/plymouth/themes/default.plymouth"
+PLYMOUTH_DIR="$ROOTFS/usr/share/plymouth/themes"
+if [ -d "$PLYMOUTH_DIR" ]; then
+ DEFAULT_LINK="$PLYMOUTH_DIR/default.plymouth"
RESOLVED=""
+
if [ -L "$DEFAULT_LINK" ]; then
TARGET="$(readlink "$DEFAULT_LINK")"
echo "default.plymouth -> $TARGET"
- if [[ "$TARGET" = /* ]]; then
- ALT_LINK="$ROOTFS$TARGET"
- else
- ALT_LINK="$(dirname "$DEFAULT_LINK")/$TARGET"
- fi
- if [ -L "$ALT_LINK" ]; then
- ALT_TARGET="$(readlink "$ALT_LINK")"
- echo "$TARGET -> $ALT_TARGET"
- if [[ "$ALT_TARGET" = /* ]]; then
- RESOLVED="$ROOTFS$ALT_TARGET"
- else
- RESOLVED="$(dirname "$ALT_LINK")/$ALT_TARGET"
- fi
- else
- RESOLVED="$ALT_LINK"
+
+ if command_exists realpath; then
+ RESOLVED="$(realpath -m "$PLYMOUTH_DIR/$TARGET" 2>/dev/null || true)"
+ elif command_exists readlink; then
+ RESOLVED="$(readlink -f "$DEFAULT_LINK" 2>/dev/null || true)"
fi
else
RESOLVED="$DEFAULT_LINK"
fi
- if [ -n "$RESOLVED" ]; then
+ if [ -n "$RESOLVED" ] && [ -f "$RESOLVED" ]; then
echo "resolved: ${RESOLVED#$ROOTFS}"
- grep -RIn "Name=\|ImageDir=" "$RESOLVED" 2>/dev/null || true
+ grep -HIn "Name=\|ImageDir=" "$RESOLVED" 2>/dev/null || true
+ else
+ echo "WARNING: Cannot resolve default.plymouth"
+ fi
+
+ if [ -d "$PLYMOUTH_DIR/caramos" ]; then
+ find "$PLYMOUTH_DIR/caramos" -maxdepth 1 -name "*.plymouth" -exec grep -HIn "Name=\|ImageDir=" {} + 2>/dev/null || true
+ [ -f "$PLYMOUTH_DIR/caramos/watermark.png" ] && file "$PLYMOUTH_DIR/caramos/watermark.png" || echo "MISSING: watermark.png"
+ else
+ echo "MISSING: $PLYMOUTH_DIR/caramos"
fi
- grep -RIn "Name=\|ImageDir=" "$ROOTFS/usr/share/plymouth/themes/caramos"/*.plymouth 2>/dev/null || true
- [ -f "$ROOTFS/usr/share/plymouth/themes/caramos/watermark.png" ] && file "$ROOTFS/usr/share/plymouth/themes/caramos/watermark.png" || true
else
echo "MISSING: plymouth themes"
fi
@@ -76,10 +79,16 @@ echo "== Live initrd =="
INITRD="$WORK_CUSTOM/casper/initrd.lz"
if [ -f "$INITRD" ]; then
ls -lh "$INITRD"
- echo "CaRamOS entries:"
- lsinitramfs "$INITRD" 2>/dev/null | grep -E 'usr/share/plymouth/themes/caramos|etc/alternatives/default.plymouth|usr/share/plymouth/themes/default.plymouth' | head -80 || true
- echo "Mint/BGRT entries:"
- lsinitramfs "$INITRD" 2>/dev/null | grep -E 'usr/share/plymouth/themes/(mint-logo|bgrt)' | head -20 || true
+
+ if command_exists lsinitramfs; then
+ echo "CaramOS entries:"
+ lsinitramfs "$INITRD" 2>/dev/null | grep -E 'usr/share/plymouth/themes/caramos|etc/alternatives/default.plymouth|usr/share/plymouth/themes/default.plymouth' | head -80 || true
+ echo "Mint/BGRT entries:"
+ lsinitramfs "$INITRD" 2>/dev/null | grep -E 'usr/share/plymouth/themes/(mint-logo|bgrt)' | head -20 || true
+ else
+ echo "WARNING: lsinitramfs not found, skipping initrd check"
+ echo "Install with: sudo apt-get install initramfs-tools"
+ fi
else
echo "MISSING: $INITRD"
fi
@@ -87,6 +96,11 @@ echo
echo "== ISO contents =="
if [ -f "$ISO" ]; then
- xorriso -indev "$ISO" -find /isolinux -name splash.png -exec report_lba -- 2>/dev/null || true
- xorriso -indev "$ISO" -find /isolinux -name isolinux.cfg -exec cat -- 2>/dev/null | sed -n '1,20p' || true
+ if command_exists xorriso; then
+ xorriso -indev "$ISO" -find /isolinux -name splash.png -exec report_lba -- 2>/dev/null || true
+ xorriso -indev "$ISO" -find /isolinux -name isolinux.cfg -exec cat -- 2>/dev/null | sed -n '1,20p' || true
+ else
+ echo "WARNING: xorriso not found, cannot inspect ISO contents"
+ echo "Install with: sudo apt-get install xorriso"
+ fi
fi
diff --git a/scripts/extract.sh b/scripts/extract.sh
index dbf823c..f22ce4a 100644
--- a/scripts/extract.sh
+++ b/scripts/extract.sh
@@ -1,9 +1,8 @@
#!/bin/bash
-# Bước 1-3: Extract ISO + filesystem (có cache)
+# Steps 1-3: Extract ISO + filesystem (with cache)
step_extract() {
- info "[1/7] Chuẩn bị thư mục build..."
- # Dọn mount cũ nếu build trước bị lỗi
+ info "[1/7] Preparing build directory..."
sync 2>/dev/null || true
umount "$WORK_DIR/squashfs/proc" 2>/dev/null || true
umount "$WORK_DIR/squashfs/sys" 2>/dev/null || true
@@ -13,31 +12,47 @@ step_extract() {
rm -rf "$WORK_DIR/squashfs" "$WORK_DIR/custom"
mkdir -p "$WORK_DIR"/{mnt,custom}
- # --- Cache: giữ bản extract gốc, chỉ extract 1 lần ---
CACHE_DIR="$WORK_DIR/cache"
- if [ -d "$CACHE_DIR" ]; then
- info "[2/7] Dùng cache (skip extract ISO)..."
- ok "Cache found."
+ CACHE_ISO_DIR="$WORK_DIR/cache_iso"
+ CACHE_VALID=false
+
+ # Validate cache
+ if [ -d "$CACHE_DIR" ] && [ -d "$CACHE_ISO_DIR" ] &&
+ [ -f "$CACHE_DIR/etc/os-release" ] &&
+ [ -f "$CACHE_ISO_DIR/casper/filesystem.squashfs" ] &&
+ [ -d "$CACHE_ISO_DIR/isolinux" -o -d "$CACHE_ISO_DIR/boot/grub" ]; then
+ CACHE_VALID=true
+ fi
+
+ if $CACHE_VALID; then
+ info "[2/7] Using cache (skip ISO extract)..."
+ ok "Cache found and validated."
else
- info "[2/7] Extract ISO (lần đầu, sau này dùng cache)..."
+ info "[2/7] Extracting ISO (first time, will cache)..."
+
+ # Clean old cache if exists but invalid
+ rm -rf "$CACHE_DIR" "$CACHE_ISO_DIR"
+ mkdir -p "$CACHE_DIR"
+
mount -o loop,ro "$MINT_ISO" "$WORK_DIR/mnt"
rsync -a --exclude='casper/filesystem.squashfs' "$WORK_DIR/mnt/" "$WORK_DIR/custom/"
- ok "Extract ISO xong."
+ ok "ISO extraction complete."
- info "[3/7] Extract filesystem.squashfs (3-5 phút, chỉ lần đầu)..."
- unsquashfs -d "$CACHE_DIR" "$WORK_DIR/mnt/casper/filesystem.squashfs"
+ info "[3/7] Extracting filesystem.squashfs (3-5 min, first time only)..."
+ if ! unsquashfs -d "$CACHE_DIR" "$WORK_DIR/mnt/casper/filesystem.squashfs"; then
+ error "unsquashfs failed. Check disk space and ISO integrity."
+ umount "$WORK_DIR/mnt"
+ exit 1
+ fi
umount "$WORK_DIR/mnt"
- # Lưu bản ISO content riêng cho cache
- cp -a "$WORK_DIR/custom" "$WORK_DIR/cache_iso"
- ok "Extract + cache xong."
+ # Save ISO content separately for cache
+ cp -a "$WORK_DIR/custom/." "$CACHE_ISO_DIR/"
+ ok "Extraction + cache complete."
fi
- # Copy từ cache ra bản làm việc
- info " → Copy từ cache..."
+ info " → Copying from cache..."
cp -a "$CACHE_DIR" "$WORK_DIR/squashfs"
- if [ -d "$WORK_DIR/cache_iso" ]; then
- cp -a "$WORK_DIR/cache_iso/." "$WORK_DIR/custom/"
- fi
- ok "Sẵn sàng tuỳ biến."
+ cp -a "$CACHE_ISO_DIR/." "$WORK_DIR/custom/"
+ ok "Ready for customization."
}
diff --git a/scripts/ota_bootstrap.sh b/scripts/ota_bootstrap.sh
index 006b978..04ab565 100644
--- a/scripts/ota_bootstrap.sh
+++ b/scripts/ota_bootstrap.sh
@@ -6,25 +6,35 @@ build_caramos_ota_deb() {
local dist_dir="$ota_dir/dist-testkit"
if [ ! -x "$ota_dir/tools/caramos-ota-testkit.sh" ]; then
- error "Không tìm thấy OTA testkit: $ota_dir/tools/caramos-ota-testkit.sh"
+ error "OTA testkit not found: $ota_dir/tools/caramos-ota-testkit.sh"
fi
- info " → Build package caramos-ota để nhúng vào ISO..." >&2
+ info " → Building caramos-ota package for ISO embedding..." >&2
if ! (cd "$ota_dir" && ./tools/caramos-ota-testkit.sh build-deb) >&2; then
- error "Build caramos-ota .deb thất bại. Cài build deps rồi chạy lại: sudo apt install build-essential debhelper"
+ error "Failed to build caramos-ota .deb. Install build deps and retry: sudo apt install build-essential debhelper"
+ fi
+
+ if [ ! -d "$dist_dir" ]; then
+ error "Build output directory not found: $dist_dir"
fi
local deb
- deb="$(find "$dist_dir" -maxdepth 1 -type f -name 'caramos-ota_*.deb' | sort | tail -n 1)"
+ deb="$(find "$dist_dir" -maxdepth 1 -type f -name 'caramos-ota_*.deb' -print0 | sort -z | tail -z -n 1 | tr -d '\0')"
if [ -z "$deb" ] || [ ! -f "$deb" ]; then
- error "Build caramos-ota .deb thất bại: không tìm thấy file trong $dist_dir"
+ error "Failed to build caramos-ota .deb: no file found in $dist_dir"
fi
printf '%s\n' "$deb"
}
packaged_caramos_product_version() {
- PYTHONPATH="packages/caramos-ota/usr/lib/python3/dist-packages" python3 - <<'PY'
+ local pythonpath="$SCRIPT_DIR/packages/caramos-ota/usr/lib/python3/dist-packages"
+
+ if [ ! -d "$pythonpath/caramos_ota" ]; then
+ error "caramos_ota Python module not found at: $pythonpath"
+ fi
+
+ PYTHONPATH="$pythonpath" python3 - <<'PY'
from caramos_ota.release_metadata import PRODUCT_VERSION
print(PRODUCT_VERSION)
@@ -38,29 +48,44 @@ install_caramos_ota_and_run_migrations() {
target_version="$(packaged_caramos_product_version)"
from_version="${CARAMOS_MIGRATION_BASE_VERSION:-1.0.1}"
- info " → Cài caramos-ota vào ISO rootfs..."
+ # Validate version format
+ if ! [[ "$target_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+ error "Invalid target version format: $target_version"
+ fi
+ if ! [[ "$from_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+ error "Invalid source version format: $from_version"
+ fi
+
+ info " → Installing caramos-ota into ISO rootfs..."
cp "$deb" "$WORK_DIR/squashfs/tmp/caramos-ota-local.deb"
- chroot "$WORK_DIR/squashfs" /bin/bash -c '
+
+ if ! chroot "$WORK_DIR/squashfs" /bin/bash -c '
set -e
export DEBIAN_FRONTEND=noninteractive
APT_LOCK_TIMEOUT="${APT_LOCK_TIMEOUT:-600}"
apt-get -o DPkg::Lock::Timeout="$APT_LOCK_TIMEOUT" install -y /tmp/caramos-ota-local.deb
rm -f /tmp/caramos-ota-local.deb
- command -v caramos-ota
- command -v caramos-ota-notifier
- command -v caramos-ota-update
- '
- ok "Đã cài caramos-ota vào ISO rootfs."
+ command -v caramos-ota >/dev/null
+ command -v caramos-ota-notifier >/dev/null
+ command -v caramos-ota-update >/dev/null
+ '; then
+ rm -f "$WORK_DIR/squashfs/tmp/caramos-ota-local.deb" 2>/dev/null || true
+ error "Failed to install caramos-ota in chroot"
+ fi
+
+ ok "caramos-ota installed into ISO rootfs."
- # Always invoke updater: same-release timestamp migrations may still be pending.
- info " → Chạy OTA migrations trong ISO rootfs: $from_version -> $target_version"
- CARAMOS_VERSION="$from_version" TARGET_VERSION="$target_version" \
+ info " → Running OTA migrations in ISO rootfs: $from_version -> $target_version"
+ if ! CARAMOS_VERSION="$from_version" TARGET_VERSION="$target_version" \
chroot "$WORK_DIR/squashfs" /bin/bash -c '
set -e
caramos-ota-update --from "$CARAMOS_VERSION" --target "$TARGET_VERSION" --dry-run
caramos-ota-update --from "$CARAMOS_VERSION" --target "$TARGET_VERSION"
- '
- ok "OTA migrations đã chạy xong trong ISO rootfs tới $target_version."
+ '; then
+ error "OTA migrations failed in chroot"
+ fi
+
+ ok "OTA migrations completed in ISO rootfs to version $target_version."
}
step_ota_bootstrap() {
diff --git a/scripts/overlay.sh b/scripts/overlay.sh
index 565303e..8af96a0 100644
--- a/scripts/overlay.sh
+++ b/scripts/overlay.sh
@@ -1,15 +1,15 @@
#!/bin/bash
-# Fast path: chỉ copy overlay vào rootfs đang làm việc.
+# Fast path: only copy overlay into working rootfs.
step_overlay() {
ensure_work_tree
if [ -d "$SCRIPT_DIR/config/includes.chroot" ]; then
- info "Copy overlay files..."
+ info "Copying overlay files..."
shopt -s nullglob dotglob
local overlay_files=("$SCRIPT_DIR/config/includes.chroot"/*)
if [ ${#overlay_files[@]} -eq 0 ]; then
- warn "Overlay rỗng: config/includes.chroot"
+ warn "Overlay is empty: config/includes.chroot"
else
# Older builds accidentally created fcitx5/profile as a directory.
# The correct Fcitx5 profile path is a file, so remove the stale
@@ -19,8 +19,8 @@ step_overlay() {
fi
cp -a "${overlay_files[@]}" "$WORK_DIR/squashfs/"
- # Overlay có thể thay đổi /etc/dconf/db/local.d và GSettings schemas.
- # Nếu không compile lại, make quick sẽ repack DB cũ dù source overlay đã đúng.
+ # Overlay may change /etc/dconf/db/local.d and GSettings schemas.
+ # If not recompiled, make quick will repack old DB even if overlay source is correct.
if [ -d "$WORK_DIR/squashfs/etc/dconf/db/local.d" ]; then
chroot "$WORK_DIR/squashfs" /bin/bash -c 'dconf compile /etc/dconf/db/local /etc/dconf/db/local.d || dconf update || true'
fi
@@ -28,10 +28,10 @@ step_overlay() {
chroot "$WORK_DIR/squashfs" /bin/bash -c 'glib-compile-schemas /usr/share/glib-2.0/schemas/ || true'
fi
- ok "Copy overlay xong."
+ ok "Overlay copy complete."
fi
shopt -u nullglob dotglob
else
- warn "Không tìm thấy config/includes.chroot, bỏ qua overlay."
+ warn "config/includes.chroot not found, skipping overlay."
fi
}
diff --git a/scripts/repack.sh b/scripts/repack.sh
index 6a73ce3..f8dff70 100644
--- a/scripts/repack.sh
+++ b/scripts/repack.sh
@@ -1,25 +1,15 @@
#!/bin/bash
-# Bước 7: Đóng gói squashfs + ISO
+# Step 7: Pack squashfs + ISO
clean_virtual_dirs() {
local SFS="$WORK_DIR/squashfs"
- # Dọn file tạm trước khi pack. Nếu build bị Ctrl+C giữa hook
- # (đặc biệt WPS repack cũ), /tmp có thể còn .deb/data.tar.xz/opt rất lớn
- # và make quick sẽ vô tình đóng gói chúng vào ISO.
rm -rf "$SFS/tmp"/* "$SFS/var/tmp"/* 2>/dev/null || true
- # Đảm bảo các virtual fs dir trống sạch trước khi pack vào squashfs.
- # KHÔNG dùng -e proc/sys/dev/run để loại trừ — nếu loại trừ, các thư mục
- # này sẽ KHÔNG TỒN TẠI trong squashfs, casper sẽ không có chỗ để mount
- # devtmpfs/proc/sysfs vào → /dev/null không tồn tại → boot crash.
- # Các dir phải có mặt nhưng TRỐNG; chúng đã được umount ở step_customize.
for dir in proc sys dev run; do
if [ -d "$SFS/$dir" ]; then
- # Xoá nội dung bên trong nhưng giữ thư mục gốc
find "$SFS/$dir" -mindepth 1 -delete 2>/dev/null || true
else
- # Thư mục không tồn tại → tạo lại để casper có chỗ mount
mkdir -p "$SFS/$dir"
fi
done
@@ -30,37 +20,31 @@ step_repack_squashfs() {
umount_chroot
clean_virtual_dirs
- info " → Tạo filesystem.squashfs (${SQUASHFS_COMP})..."
+ info " → Creating filesystem.squashfs (${SQUASHFS_COMP})..."
mksquashfs "$WORK_DIR/squashfs" "$WORK_DIR/custom/casper/filesystem.squashfs" \
-comp $SQUASHFS_COMP $SQUASHFS_OPTS
- ok "squashfs xong."
+ ok "squashfs complete."
- # Cập nhật filesystem.size
printf '%s' "$(du -sx --block-size=1 "$WORK_DIR/squashfs" | cut -f1)" \
> "$WORK_DIR/custom/casper/filesystem.size"
- # Live ISO boot dùng build/custom/casper/initrd.lz, KHÔNG tự dùng file
- # /boot/initrd.img-* trong squashfs. Hook Plymouth đã regenerate initramfs
- # trong rootfs, nên phải copy file mới này ra casper/initrd.lz.
local latest_initrd
latest_initrd=$(ls -1t "$WORK_DIR"/squashfs/boot/initrd.img-* 2>/dev/null | head -1 || true)
if [ -n "$latest_initrd" ] && [ -f "$latest_initrd" ]; then
cp "$latest_initrd" "$WORK_DIR/custom/casper/initrd.lz"
- ok "live initrd đã cập nhật: $(basename "$latest_initrd") → casper/initrd.lz"
+ ok "Live initrd updated: $(basename "$latest_initrd") → casper/initrd.lz"
else
- warn "không tìm thấy initrd.img-* trong rootfs để cập nhật casper/initrd.lz"
+ warn "No initrd.img-* found in rootfs to update casper/initrd.lz"
fi
}
step_repack_iso() {
ensure_work_tree
- # Cập nhật md5sum
cd "$WORK_DIR/custom"
find . -type f ! -name 'md5sum.txt' -print0 | xargs -0 md5sum > md5sum.txt 2>/dev/null || true
- # Tạo ISO — detect boot structure từ ISO Mint
- info " → Tạo ISO..."
+ info " → Creating ISO..."
XORRISO_ARGS=(
-as mkisofs
@@ -69,7 +53,6 @@ step_repack_iso() {
-volid "CaramOS"
)
- # BIOS boot: isolinux (Mint) hoặc GRUB
if [ -f "isolinux/isolinux.bin" ]; then
info " Boot: isolinux (BIOS)"
XORRISO_ARGS+=(
@@ -86,7 +69,6 @@ step_repack_iso() {
)
fi
- # UEFI boot
if [ -f "EFI/boot/efiboot.img" ]; then
info " Boot: EFI"
XORRISO_ARGS+=(
@@ -105,7 +87,6 @@ step_repack_iso() {
)
fi
- # Isohybrid (cho ghi USB)
if [ -f "isolinux/isolinux.bin" ] && [ -f /usr/lib/ISOLINUX/isohdpfx.bin ]; then
XORRISO_ARGS+=(-isohybrid-mbr /usr/lib/ISOLINUX/isohdpfx.bin)
fi
@@ -118,7 +99,7 @@ step_repack_iso() {
}
step_repack() {
- info "[7/7] Đóng gói ISO..."
+ info "[7/7] Packing ISO..."
step_repack_squashfs
step_repack_iso
}
From da9d616f27bf4e1ff0a2e8887a86e460ddbeeebd Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 18:45:16 +0700
Subject: [PATCH 24/37] fix: fix regex
---
scripts/ota_bootstrap.sh | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/scripts/ota_bootstrap.sh b/scripts/ota_bootstrap.sh
index 04ab565..bcceb12 100644
--- a/scripts/ota_bootstrap.sh
+++ b/scripts/ota_bootstrap.sh
@@ -48,11 +48,11 @@ install_caramos_ota_and_run_migrations() {
target_version="$(packaged_caramos_product_version)"
from_version="${CARAMOS_MIGRATION_BASE_VERSION:-1.0.1}"
- # Validate version format
- if ! [[ "$target_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+ # Validate version format - accept 1-4 numeric parts: 1.0, 1.0.16, 1.0.16.1, etc.
+ if ! [[ "$target_version" =~ ^[0-9]+(\.[0-9]+){1,3}$ ]]; then
error "Invalid target version format: $target_version"
fi
- if ! [[ "$from_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+ if ! [[ "$from_version" =~ ^[0-9]+(\.[0-9]+){1,3}$ ]]; then
error "Invalid source version format: $from_version"
fi
From 519440d7ef955011deb8d729d5c03effce69abce Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 18:53:28 +0700
Subject: [PATCH 25/37] Update README.md
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 1d6ef6b..e46a506 100644
--- a/README.md
+++ b/README.md
@@ -22,4 +22,4 @@ curl -fsSL https://raw.githubusercontent.com/dryfish09/DMCaramOS/refs/heads/main
```
After, Open **CaramOS Update Center (Vietnamese: "Trung tâm cập nhật CaramOS"** from start menu to start upgrade version.
### Download ISO file:
-Due SourceForge problem. The ISO file will not on it. Go to Actions tab, click the latest success build attempt (green checkmark), scroll to Artifacts section, download it.
+Due SourceForge problem (I'll find some place can archive and host `.iso` file, but not now). The ISO file will not on it. Go to Actions tab, click the latest success build attempt (with green checkmark), scroll to Artifacts section, download it.
From d82293391a7599001e8b9a52f596a32fc307520b Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 18:57:39 +0700
Subject: [PATCH 26/37] fix: improve ota installer script
---
install-caramos-ota.sh | 88 +++++++++++++++++++++++++-----------------
1 file changed, 53 insertions(+), 35 deletions(-)
diff --git a/install-caramos-ota.sh b/install-caramos-ota.sh
index 7816724..5e19c45 100755
--- a/install-caramos-ota.sh
+++ b/install-caramos-ota.sh
@@ -26,18 +26,18 @@ trap cleanup EXIT
require_root() {
if [[ "${EUID}" -ne 0 ]]; then
- fail "Vui lòng chạy bằng sudo: sudo bash $0"
+ fail "Please run with sudo: sudo bash $0"
exit 2
fi
if [[ ! -d /etc/apt/sources.list.d ]]; then
- fail "Không tìm thấy /etc/apt/sources.list.d; hệ thống APT không hợp lệ."
+ fail "/etc/apt/sources.list.d not found; invalid APT system."
exit 1
fi
}
write_release_metadata() {
- info "Sửa metadata nhận diện CaramOS ${CARAMOS_VERSION:-1.0.1}..."
- cat > "${RELEASE_FILE}" < "${RELEASE_FILE}.tmp" </dev/null; then
mv -f "${source_file}" "${source_file}.disabled-by-caramos-ota"
- warn "Đã tắt source trùng: ${source_file}"
+ warn "Disabled duplicate source: ${source_file}"
fi
done
fi
- ok "Đã dọn source trùng"
+ ok "Cleaned duplicate sources"
}
install_keyring() {
- info "Cập nhật keyring Launchpad PPA CaramOS..."
+ info "Updating CaramOS Launchpad PPA keyring..."
mkdir -p "${KEYRING_DIR}"
chmod 0755 "${KEYRING_DIR}"
if [[ -s "${KEYRING_FILE}" ]]; then
- ok "Keyring đã tồn tại: ${KEYRING_FILE}"
+ ok "Keyring already exists: ${KEYRING_FILE}"
return 0
fi
if ! command -v gpg >/dev/null 2>&1; then
- fail "Không tìm thấy gpg để import PPA key. Cài gói gnupg rồi chạy lại."
+ fail "gpg not found to import PPA key. Install gnupg package and retry."
exit 1
fi
TMP_GNUPG_HOME="$(mktemp -d)"
chmod 0700 "${TMP_GNUPG_HOME}"
- GNUPGHOME="${TMP_GNUPG_HOME}" gpg --batch --keyserver keyserver.ubuntu.com --recv-keys "${PPA_KEY_FPR}"
+
+ # Use hkps:// for secure keyserver communication
+ if ! GNUPGHOME="${TMP_GNUPG_HOME}" gpg --batch --keyserver hkps://keyserver.ubuntu.com --recv-keys "${PPA_KEY_FPR}"; then
+ # Fallback to http if hkps fails (some networks block hkps)
+ warn "hkps:// keyserver failed, trying http:// keyserver..."
+ GNUPGHOME="${TMP_GNUPG_HOME}" gpg --batch --keyserver http://keyserver.ubuntu.com --recv-keys "${PPA_KEY_FPR}"
+ fi
+
GNUPGHOME="${TMP_GNUPG_HOME}" gpg --batch --export "${PPA_KEY_FPR}" > "${KEYRING_FILE}.tmp"
chmod 0644 "${KEYRING_FILE}.tmp"
mv -f "${KEYRING_FILE}.tmp" "${KEYRING_FILE}"
- ok "Đã ghi ${KEYRING_FILE}"
+ ok "Written ${KEYRING_FILE}"
}
write_ppa_source() {
- info "Thêm/cập nhật CaramOS PPA source..."
+ info "Adding/updating CaramOS PPA source..."
cleanup_conflicting_ppa_sources
if [[ ! -s "${KEYRING_FILE}" ]]; then
- fail "Thiếu keyring ${KEYRING_FILE}; không ghi APT source để tránh repo unsigned."
+ fail "Missing keyring ${KEYRING_FILE}; not writing APT source to avoid unsigned repo."
exit 1
fi
cat > "${SOURCE_FILE}.tmp" </dev/null 2>&1; then
- ok "caramos-ota đã sẵn sàng: $(dpkg-query -W -f='\${Version}' caramos-ota 2>/dev/null || true)"
+ ok "caramos-ota ready: $(dpkg-query -W -f='\${Version}' caramos-ota 2>/dev/null || true)"
else
- fail "Không cài được caramos-ota"
+ fail "Failed to install caramos-ota"
exit 1
fi
}
prepare_update_state() {
- info "Kiểm tra bản cập nhật OTA để chuẩn bị popup..."
+ info "Checking OTA update to prepare popup..."
if command -v caramos-ota >/dev/null 2>&1; then
rm -f /var/lib/caramos-ota/state.json 2>/dev/null || true
if ! caramos-ota --check; then
- warn "caramos-ota --check lỗi nên KHÔNG mở popup để tránh báo sai 'đã cập nhật'."
- warn "Xem log: ls -t /var/log/caramos-ota/*.log 2>/dev/null | head -1"
- warn "Sau khi sửa apt update, chạy lại: sudo caramos-ota --check && caramos-ota-notifier"
+ warn "caramos-ota --check failed; NOT opening popup to avoid false 'updated' notification."
+ warn "Check log: ls -t /var/log/caramos-ota/*.log 2>/dev/null | head -1"
+ warn "After fixing apt update, run: sudo caramos-ota --check && caramos-ota-notifier"
return 1
fi
- ok "Đã kiểm tra OTA và ghi state cho notifier"
+ ok "OTA checked and state written for notifier"
return 0
else
- warn "Không tìm thấy caramos-ota sau khi cài."
+ warn "caramos-ota not found after installation."
return 1
fi
}
launch_notifier() {
- info "Mở CaramOS OTA Notifier để user đọc nội dung cập nhật..."
+ info "Opening CaramOS OTA Notifier for user to read update content..."
if command -v caramos-ota-notifier >/dev/null 2>&1; then
if [[ -n "${SUDO_USER:-}" && "${SUDO_USER}" != "root" ]] && command -v runuser >/dev/null 2>&1; then
local user_home user_uid user_env
@@ -169,13 +186,14 @@ launch_notifier() {
if [[ -n "${user_home}" && -f "${user_home}/.Xauthority" ]]; then
user_env+=("XAUTHORITY=${user_home}/.Xauthority")
fi
- runuser -u "${SUDO_USER}" -- env "${user_env[@]}" caramos-ota-notifier >/dev/null 2>&1 &
+ # Use nohup to detach from script
+ nohup runuser -u "${SUDO_USER}" -- env "${user_env[@]}" caramos-ota-notifier >/dev/null 2>&1 &
else
- caramos-ota-notifier >/dev/null 2>&1 &
+ nohup caramos-ota-notifier >/dev/null 2>&1 &
fi
- ok "Đã gọi caramos-ota-notifier"
+ ok "Launched caramos-ota-notifier"
else
- warn "Không tìm thấy caramos-ota-notifier sau khi cài. Chạy thử: sudo caramos-ota --check"
+ warn "caramos-ota-notifier not found after installation. Try: sudo caramos-ota --check"
fi
}
@@ -189,7 +207,7 @@ main() {
if prepare_update_state; then
launch_notifier
fi
- printf '\nHoàn tất. Popup chỉ hiển thị nội dung cập nhật; user tự bấm "Cập nhật ngay" nếu đồng ý.\nNếu popup không hiện, chạy thủ công:\n sudo apt update\n sudo caramos-ota --check\n caramos-ota-notifier\n'
+ printf '\nComplete. Popup only displays update content; user clicks "Update now" if they agree.\nIf popup does not appear, run manually:\n sudo apt update\n sudo caramos-ota --check\n caramos-ota-notifier\n'
}
main "$@"
From 03684b0c9488b49e8d26a2eb12ee8fd9f00a2070 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 20:05:19 +0700
Subject: [PATCH 27/37] Update build.yml
---
.github/workflows/build.yml | 81 -------------------------------------
1 file changed, 81 deletions(-)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index e64ad4d..b65e1ef 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -61,84 +61,3 @@ jobs:
CaramOS-*.iso
SHA256SUMS
retention-days: 7
-
- - name: Upload ISO to SourceForge
- if: startsWith(github.ref, 'refs/tags/v')
- env:
- SOURCEFORGE_USERNAME: ${{ secrets.SOURCEFORGE_USERNAME }}
- SOURCEFORGE_PROJECT: ${{ secrets.SOURCEFORGE_PROJECT }}
- SOURCEFORGE_SSH_KEY: ${{ secrets.SOURCEFORGE_SSH_KEY }}
- run: |
- ISO_FILE="$(ls CaramOS-*.iso | head -n 1)"
- ISO_BASENAME="$(basename "${ISO_FILE}")"
-
- if [ -z "${SOURCEFORGE_USERNAME}" ] || [ -z "${SOURCEFORGE_PROJECT}" ] || [ -z "${SOURCEFORGE_SSH_KEY}" ]; then
- echo "::error::GitHub Release assets are limited to about 2 GiB per file. Configure SOURCEFORGE_USERNAME, SOURCEFORGE_PROJECT, and SOURCEFORGE_SSH_KEY secrets to publish the ISO as one downloadable file on SourceForge."
- exit 1
- fi
-
- install -m 700 -d ~/.ssh
- printf '%s\n' "${SOURCEFORGE_SSH_KEY}" > ~/.ssh/sourceforge
- chmod 600 ~/.ssh/sourceforge
- ssh-keyscan -H frs.sourceforge.net >> ~/.ssh/known_hosts
-
- RELEASE_DIR="/home/frs/project/${SOURCEFORGE_PROJECT}/${GITHUB_REF_NAME}"
- cat > upload-release.sftp < GitHub Release cannot host the ISO directly because release assets have a
- > per-file size limit. The ISO is hosted as one complete file on SourceForge.
-
-
-
- 
-
-
-
- - **ISO:** [{iso_basename}]({download_url})
- - **SHA256SUMS:** [SHA256SUMS]({checksum_url})
- - **SourceForge folder:** https://sourceforge.net/projects/{sourceforge_project}/files/{github_ref_name}/
-
- ### Verify the ISO
-
- ```bash
- sha256sum -c SHA256SUMS
- ```
- """
-
- Path("RELEASE_DOWNLOADS.md").write_text(textwrap.dedent(release_body).strip() + "\n", encoding="utf-8")
- PY
-
- - name: Create GitHub Release
- if: startsWith(github.ref, 'refs/tags/v')
- uses: softprops/action-gh-release@v3
- with:
- files: |
- SHA256SUMS
- body_path: RELEASE_DOWNLOADS.md
- append_body: true
- generate_release_notes: true
From a696d3933e6b15688e6e1ea6e6e18a4e48188c75 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 20:13:21 +0700
Subject: [PATCH 28/37] feat' compress with `zstd` for all modes
---
build.sh | 22 +++++++++++++++++-----
1 file changed, 17 insertions(+), 5 deletions(-)
diff --git a/build.sh b/build.sh
index 7deeb02..927a6e3 100755
--- a/build.sh
+++ b/build.sh
@@ -4,8 +4,8 @@
# Remaster from Linux Mint ISO to CaramOS ISO
#
# Usage:
-# sudo ./build.sh # Dev build (lz4, fast)
-# sudo ./build.sh --release # Release build (xz, small)
+# sudo ./build.sh # Dev build (zstd, fast)
+# sudo ./build.sh --release # Release build (zstd, balanced)
# sudo ./build.sh /path/to/mint.iso # Use existing ISO
# sudo ./build.sh --clean # Clean old build
# sudo ./build.sh --quick # Overlay + quick repack
@@ -57,12 +57,23 @@ check_disk_space() {
done
}
+ensure_zstd() {
+ if ! command -v zstd >/dev/null 2>&1; then
+ info "zstd not found, installing..."
+ apt-get update -qq
+ apt-get install -y zstd
+ ok "zstd installed"
+ else
+ info "zstd found: $(zstd --version 2>&1 | head -1)"
+ fi
+}
+
for arg in "$@"; do
case "$arg" in
--release)
- SQUASHFS_COMP="xz"
- SQUASHFS_OPTS="-b 1M -Xdict-size 100% -noappend"
- info "Release mode: xz compression (slower, smaller ISO)"
+ SQUASHFS_COMP="zstd"
+ SQUASHFS_OPTS="-b 1M -Xcompression-level 19 -noappend"
+ info "Release mode: zstd compression level 19 (balanced, smaller ISO)"
;;
--debug-boot)
DEBUG_BOOT=1
@@ -115,6 +126,7 @@ fi
check_root
install_deps
install_gum
+ensure_zstd
check_disk_space
cleanup_on_fail() {
From e7d4a06bb376dc3054767695df068b6e1de0254b Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 20:20:38 +0700
Subject: [PATCH 29/37] feat: `zstd` compress for debug
---
scripts/config.sh | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/scripts/config.sh b/scripts/config.sh
index aad7574..04c3919 100644
--- a/scripts/config.sh
+++ b/scripts/config.sh
@@ -1,5 +1,5 @@
#!/bin/bash
-# Cấu hình build — đổi version/mirror ở đây
+# Build configuration — change version/mirror here
MINT_VERSION="22.3"
MINT_EDITION="cinnamon"
@@ -15,12 +15,12 @@ fi
CARAMOS_VERSION="1.0.0"
CARAMOS_CODENAME="Open Beta"
-# Version metadata ban đầu ghi vào rootfs trước khi chạy OTA bootstrap.
-# Giữ 1.0.1 để build ISO luôn chạy đầy đủ migration chain 1.0.1 → latest.
+# Version metadata initially written to rootfs before running OTA bootstrap.
+# Keep 1.0.1 so ISO build always runs full migration chain 1.0.1 → latest.
CARAMOS_MIGRATION_BASE_VERSION="1.0.1"
OUTPUT_ISO="CaramOS-${CARAMOS_VERSION}-${MINT_EDITION}-amd64.iso"
WORK_DIR="./build"
-# Nén mặc định: lz4 (nhanh cho dev). --release sẽ đổi sang xz (nhỏ, nén lâu)
-SQUASHFS_COMP="lz4"
-SQUASHFS_OPTS="-noappend"
+# Default compression: zstd (fast for dev). --release will switch to zstd level 19 (smaller, slower)
+SQUASHFS_COMP="zstd"
+SQUASHFS_OPTS="-b 1M -Xcompression-level 15 -noappend"
From 24c9ee053c9d7c1674da7dfd4b3b008a71223f18 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 20:28:24 +0700
Subject: [PATCH 30/37] Update os-release
---
config/includes.chroot/etc/os-release | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)
diff --git a/config/includes.chroot/etc/os-release b/config/includes.chroot/etc/os-release
index 79c13c1..03aacee 100644
--- a/config/includes.chroot/etc/os-release
+++ b/config/includes.chroot/etc/os-release
@@ -1,12 +1,12 @@
-PRETTY_NAME="CaramOS 0.1 Cinnamon"
-NAME="CaramOS"
-VERSION_ID="0.1"
-VERSION="0.1"
+PRETTY_NAME="DMCaramOS 1.0.0 Cinnamon"
+NAME="DMCaramOS"
+VERSION_ID="1.0.0"
+VERSION="1.0.0"
VERSION_CODENAME=caram
ID=caramos
ID_LIKE="ubuntu debian linuxmint"
-HOME_URL="https://caramos.org/"
-SUPPORT_URL="https://caramos.org/"
-BUG_REPORT_URL="https://caramos.org/"
-PRIVACY_POLICY_URL="https://caramos.org/"
+HOME_URL="https://github.com/dryfish09/DMCaramOS"
+SUPPORT_URL="https://github.com/dryfish09/DMCaramOS/issues"
+BUG_REPORT_URL="https://github.com/dryfish09/DMCaramOS/issues"
+PRIVACY_POLICY_URL=""
UBUNTU_CODENAME=noble
From 3958cded27cdf52101e3d3f47d6b207eba61461f Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Fri, 21 Aug 2026 20:36:10 +0700
Subject: [PATCH 31/37] Update Dockerfile
---
Dockerfile | 13 +++++++++++--
1 file changed, 11 insertions(+), 2 deletions(-)
diff --git a/Dockerfile b/Dockerfile
index 17f1479..02c8a96 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -4,21 +4,24 @@ ENV DEBIAN_FRONTEND=noninteractive \
CI=1 \
APT_LOCK_TIMEOUT=600
-# Dependencies required by build.sh, hooks, and Makefile targets.
-# CI=1 skips the optional gum installer, but gnupg is kept for parity if enabled later.
RUN apt-get update && apt-get upgrade -y && \
apt-get install -y --no-install-recommends \
apt-transport-https \
+ build-essential \
ca-certificates \
curl \
+ debhelper \
+ dpkg-dev \
file \
fontconfig \
git \
gnupg \
isolinux \
+ jq \
locales \
make \
p7zip-full \
+ python3 \
rsync \
sudo \
squashfs-tools \
@@ -28,9 +31,15 @@ RUN apt-get update && apt-get upgrade -y && \
unzip \
wget \
xorriso \
+ zstd \
+ && locale-gen en_US.UTF-8 \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists/*
+ENV LANG=en_US.UTF-8 \
+ LANGUAGE=en_US:en \
+ LC_ALL=en_US.UTF-8
+
WORKDIR /app
CMD ["/bin/bash"]
From 63901076dba5ac1ac7628b4918eb16785ed85ff8 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Sat, 22 Aug 2026 05:37:59 +0700
Subject: [PATCH 32/37] ci: make ci runs in all pr and ignore some paths
---
.github/workflows/build.yml | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index b65e1ef..7dc847e 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -3,10 +3,13 @@ name: Build CaramOS ISO
on:
push:
branches: ['*']
+ paths-ignore:
+ - *.md
+ - .githuh/**
tags:
- 'v*'
pull_request:
- branches: [main]
+ branches: ['*']
workflow_dispatch:
permissions:
From cbfb1d0ea29d9011eaf4b76df4e503ffe794ae53 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Sat, 22 Aug 2026 05:40:30 +0700
Subject: [PATCH 33/37] ci: fix syntax error
---
.github/workflows/build.yml | 11 +++++------
1 file changed, 5 insertions(+), 6 deletions(-)
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 7dc847e..47760ce 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -4,8 +4,8 @@ on:
push:
branches: ['*']
paths-ignore:
- - *.md
- - .githuh/**
+ - '*.md'
+ - '.github/**'
tags:
- 'v*'
pull_request:
@@ -22,7 +22,7 @@ jobs:
steps:
- name: Checkout
- uses: actions/checkout@v7
+ uses: actions/checkout@v4
- name: Free disk space
run: |
@@ -37,12 +37,11 @@ jobs:
sudo apt-get install -y squashfs-tools xorriso rsync wget isolinux syslinux-utils build-essential debhelper
- name: Cache Mint ISO
- uses: actions/cache@v5
+ uses: actions/cache@v4
with:
path: linuxmint-22.3-cinnamon-64bit.iso
key: mint-iso-22.3-cinnamon
-
- name: Build CaramOS ISO
run: |
if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
@@ -57,7 +56,7 @@ jobs:
run: sha256sum CaramOS-*.iso > SHA256SUMS
- name: Upload ISO artifact
- uses: actions/upload-artifact@v6
+ uses: actions/upload-artifact@v4
with:
name: CaramOS-ISO
path: |
From 19529afd59c810ef1656ca563d557dfb0091b16d Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Sat, 22 Aug 2026 05:45:22 +0700
Subject: [PATCH 34/37] Update packages.txt
---
config/packages.txt | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/config/packages.txt b/config/packages.txt
index fd22f21..dd7572c 100644
--- a/config/packages.txt
+++ b/config/packages.txt
@@ -25,6 +25,9 @@ git
ubuntu-restricted-extras
remmina
vim
-neovim
-docker.io
gh
+gnome-power-manager
+smartmontools
+smart-notifier
+linux-tools-generic
+
From c7345a2ed7fc31014b96d86c557776f9bc2baa0f Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Sat, 22 Aug 2026 06:08:26 +0700
Subject: [PATCH 35/37] Update README.md
---
README.md | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index e46a506..7a5ae1e 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
### What's this fork added:
This fork added, and will add:
-- More built-in packages
+- More built-in packages: All the added packages have been carefully selected for both general users and developers.
- Bug fixes, performance updates.
- Dependency updates
- Upstream feature, OTA
@@ -10,6 +10,7 @@ This fork added, and will add:
### Why choose this fork?
- You want something that the upstream is doesn't have.
- More QoL (or not)
+- You don't like install or setup anymore, you want to use instantly
If you want **unmodified, original version**, you're going wrong place. **This fork is not for you**.
@@ -20,6 +21,9 @@ If you installed OS `.iso` file. Run this command:
```bash
curl -fsSL https://raw.githubusercontent.com/dryfish09/DMCaramOS/refs/heads/main/install-caramos-ota.sh | sudo bash
```
-After, Open **CaramOS Update Center (Vietnamese: "Trung tâm cập nhật CaramOS"** from start menu to start upgrade version.
+After, Open **CaramOS Update Center from start menu to start upgrade version.
### Download ISO file:
+
Due SourceForge problem (I'll find some place can archive and host `.iso` file, but not now). The ISO file will not on it. Go to Actions tab, click the latest success build attempt (with green checkmark), scroll to Artifacts section, download it.
+> [!IMPORTANT]
+> Artifacts will be expired after 90 days, if download link in release note returns 404, please consider to download latest build artifact.
From 6328456767414aac6ae99ea4bb7f87d567290129 Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Sat, 22 Aug 2026 08:19:52 +0700
Subject: [PATCH 36/37] Create migration.py
---
.../migrations/dmcaram-ota-1.1.0/migration.py | 347 ++++++++++++++++++
1 file changed, 347 insertions(+)
create mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/migration.py
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/migration.py b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/migration.py
new file mode 100644
index 0000000..5807ffb
--- /dev/null
+++ b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/migration.py
@@ -0,0 +1,347 @@
+"""Migration for 1.0.17: apply CaramOS branding, themes, and desktop defaults from ISO customization hook."""
+
+from __future__ import annotations
+
+import os
+import pwd
+import subprocess
+from pathlib import Path
+
+from caramos_ota_update.context import MigrationContext
+
+FROM_VERSION = "1.0.16.1"
+TO_VERSION = "dmcaram-1.1.0"
+DESCRIPTION = "Apply CaramOS branding, Cinnamon Delight theme, Vietnamese locale, and desktop defaults"
+
+OS_RELEASE_PATH = Path("/usr/lib/os-release")
+LSB_RELEASE_PATH = Path("/etc/lsb-release")
+LINUXMINT_INFO_PATH = Path("/etc/linuxmint/info")
+DCONF_LOCAL_DIR = Path("/etc/dconf/db/local.d")
+DCONF_PROFILE_USER = Path("/etc/dconf/profile/user")
+DCONF_THEME_FILE = DCONF_LOCAL_DIR / "00-caramos-theme"
+UBIQUITY_DESKTOP = Path("/usr/share/applications/ubiquity.desktop")
+LIGHTDM_GTK_CONF = Path("/etc/lightdm/lightdm-gtk-greeter.conf.d/99_linuxmint.conf")
+MINT_ARTWORK_OVERRIDE = Path("/usr/share/glib-2.0/schemas/mint-artwork.gschema.override")
+LOCALE_FILE = Path("/etc/default/locale")
+HOSTNAME_FILE = Path("/etc/hostname")
+HOSTS_FILE = Path("/etc/hosts")
+TIMEZONE_FILE = Path("/etc/timezone")
+ISSUE_FILE = Path("/etc/issue")
+ISSUE_NET_FILE = Path("/etc/issue.net")
+
+CARAMOS_VERSION = "1.0.17"
+CARAMOS_EDITION = "Cinnamon"
+CARAMOS_PRETTY_NAME = f"CaramOS {CARAMOS_VERSION} {CARAMOS_EDITION}"
+
+THEME_NAME = "Cinnamon-Delight"
+ICON_THEME_NAME = "Tela-circle-light"
+CURSOR_THEME_NAME = "Bibata-Modern-Classic"
+FONT_NAME = "Be Vietnam Pro 10"
+BACKGROUND_PATH = "/usr/share/backgrounds/caramos/default.png"
+
+OS_RELEASE_CONTENT = f"""PRETTY_NAME="{CARAMOS_PRETTY_NAME}"
+NAME="CaramOS"
+VERSION_ID="{CARAMOS_VERSION}"
+VERSION="{CARAMOS_VERSION}"
+VERSION_CODENAME=caram
+ID=caramos
+ID_LIKE="ubuntu debian linuxmint"
+HOME_URL="https://caramos.org/"
+SUPPORT_URL="https://caramos.org/"
+BUG_REPORT_URL="https://caramos.org/"
+PRIVACY_POLICY_URL="https://caramos.org/"
+UBUNTU_CODENAME=noble
+"""
+
+LSB_RELEASE_CONTENT = f"""DISTRIB_ID=CaramOS
+DISTRIB_RELEASE={CARAMOS_VERSION}
+DISTRIB_CODENAME=caram
+DISTRIB_DESCRIPTION="{CARAMOS_PRETTY_NAME}"
+"""
+
+LINUXMINT_INFO_CONTENT = f"""RELEASE={CARAMOS_VERSION}
+CODENAME=caram
+EDITION="{CARAMOS_EDITION}"
+DESCRIPTION="{CARAMOS_PRETTY_NAME}"
+DESKTOP=Gnome
+TOOLKIT=GTK
+NEW_FEATURES_URL=https://caramos.org/
+RELEASE_NOTES_URL=https://caramos.org/
+USER_GUIDE_URL=https://caramos.org/
+GRUB_TITLE={CARAMOS_PRETTY_NAME}
+"""
+
+DCONF_PROFILE_USER_CONTENT = """user-db:user
+system-db:local
+"""
+
+DCONF_THEME_CONTENT = f"""[org/cinnamon]
+app-menu-icon-name='caramos-logo-symbolic'
+system-icon='caramos-logo-symbolic'
+
+[org/cinnamon/theme]
+name='{THEME_NAME}'
+
+[org/cinnamon/desktop/interface]
+gtk-theme='{THEME_NAME}'
+icon-theme='{ICON_THEME_NAME}'
+cursor-theme='{CURSOR_THEME_NAME}'
+font-name='{FONT_NAME}'
+clock-show-date=true
+clock-use-24h=true
+
+[org/cinnamon/desktop/wm/preferences]
+theme='{THEME_NAME}'
+
+[org/gnome/desktop/interface]
+gtk-theme='{THEME_NAME}'
+icon-theme='{ICON_THEME_NAME}'
+cursor-theme='{CURSOR_THEME_NAME}'
+font-name='{FONT_NAME}'
+
+[org/gnome/desktop/wm/preferences]
+theme='{THEME_NAME}'
+"""
+
+UBIQUITY_DESKTOP_CONTENT = """[Desktop Entry]
+Type=Application
+Version=1.0
+Name=Install CaramOS
+Name[vi]=Cài đặt CaramOS
+Comment=Install CaramOS permanently to your disk
+Comment[vi]=Cài đặt CaramOS vào ổ đĩa
+Keywords=ubiquity;installer;caramos;
+Exec=sudo --preserve-env=DBUS_SESSION_BUS_ADDRESS,XDG_DATA_DIRS,XDG_RUNTIME_DIR,GTK_THEME sh -c 'WEBKIT_DISABLE_COMPOSITING_MODE=1 ubiquity gtk_ui'
+Icon=caramos-logo
+Terminal=false
+Categories=GTK;System;Settings;
+X-Ayatana-Appmenu-Show-Stubs=False
+"""
+
+OLD_THEME_MAPPINGS = {
+ "Mint-Y-Dark-Aqua": THEME_NAME,
+ "Mint-Y-Dark": THEME_NAME,
+ "Mint-Y-Aqua": THEME_NAME,
+ "Mint-Y-Sand": THEME_NAME,
+}
+
+OLD_BACKGROUND_MAPPINGS = {
+ "/usr/share/backgrounds/linuxmint/default_background.jpg": BACKGROUND_PATH,
+}
+
+OLD_ICON_MAPPINGS = {
+ "linuxmint-logo-ring-symbolic": "caramos-logo-symbolic",
+}
+
+
+def _write_file(path: Path, content: str, context: MigrationContext) -> bool:
+ path.parent.mkdir(parents=True, exist_ok=True)
+ old_content = path.read_text(encoding="utf-8") if path.exists() else ""
+
+ if old_content == content:
+ return False
+
+ path.write_text(content, encoding="utf-8")
+ context.log(f"updated {path}")
+ return True
+
+
+def _replace_in_file(
+ path: Path,
+ replacements: dict[str, str],
+ context: MigrationContext,
+) -> bool:
+ if not path.exists():
+ return False
+
+ text = path.read_text(encoding="utf-8")
+ updated = text
+ for old, new in replacements.items():
+ updated = updated.replace(old, new)
+
+ if updated == text:
+ return False
+
+ path.write_text(updated, encoding="utf-8")
+ context.log(f"updated {path}")
+ return True
+
+
+def _update_os_identity(context: MigrationContext) -> None:
+ changed = False
+
+ if _write_file(OS_RELEASE_PATH, OS_RELEASE_CONTENT, context):
+ changed = True
+ if _write_file(LSB_RELEASE_PATH, LSB_RELEASE_CONTENT, context):
+ changed = True
+ if _write_file(LINUXMINT_INFO_PATH, LINUXMINT_INFO_CONTENT, context):
+ changed = True
+
+ if _write_file(ISSUE_FILE, f"CaramOS {CARAMOS_VERSION} \\n \\l\n", context):
+ changed = True
+ if _write_file(ISSUE_NET_FILE, f"CaramOS {CARAMOS_VERSION}\n", context):
+ changed = True
+
+ if changed:
+ context.log("updated OS identity files to CaramOS branding")
+
+
+def _update_locale_and_timezone(context: MigrationContext) -> None:
+ changed = False
+
+ locale_content = """LANG=vi_VN.UTF-8
+LANGUAGE=vi_VN:vi
+LC_ALL=vi_VN.UTF-8
+"""
+
+ if _write_file(LOCALE_FILE, locale_content, context):
+ changed = True
+
+ if _write_file(TIMEZONE_FILE, "Asia/Ho_Chi_Minh\n", context):
+ changed = True
+
+ if _write_file(HOSTNAME_FILE, "caram\n", context):
+ changed = True
+
+ if HOSTS_FILE.exists():
+ hosts_text = HOSTS_FILE.read_text(encoding="utf-8")
+ updated_hosts = hosts_text.replace("mint", "caram")
+ if updated_hosts != hosts_text:
+ HOSTS_FILE.write_text(updated_hosts, encoding="utf-8")
+ context.log(f"updated {HOSTS_FILE}")
+ changed = True
+
+ if changed:
+ context.log("updated locale, timezone, and hostname to Vietnamese defaults")
+
+
+def _update_theme_configs(context: MigrationContext) -> None:
+ changed = False
+
+ if _write_file(DCONF_PROFILE_USER, DCONF_PROFILE_USER_CONTENT, context):
+ changed = True
+
+ if _write_file(DCONF_THEME_FILE, DCONF_THEME_CONTENT, context):
+ changed = True
+
+ if _write_file(UBIQUITY_DESKTOP, UBIQUITY_DESKTOP_CONTENT, context):
+ changed = True
+
+ if _replace_in_file(MINT_ARTWORK_OVERRIDE, OLD_THEME_MAPPINGS | OLD_BACKGROUND_MAPPINGS | OLD_ICON_MAPPINGS, context):
+ changed = True
+
+ if _replace_in_file(LIGHTDM_GTK_CONF, OLD_THEME_MAPPINGS | OLD_BACKGROUND_MAPPINGS, context):
+ changed = True
+
+ if changed:
+ subprocess.run(["dconf", "update"], check=False)
+ subprocess.run(
+ ["glib-compile-schemas", "/usr/share/glib-2.0/schemas/"],
+ check=False,
+ )
+ context.log("updated theme, icon, cursor, and desktop branding defaults")
+
+
+def _session_environment(uid: int) -> dict[str, str] | None:
+ runtime_dir = Path(f"/run/user/{uid}")
+ if not runtime_dir.exists():
+ return None
+
+ env = os.environ.copy()
+ env.update(
+ {
+ "DISPLAY": os.environ.get("DISPLAY", ":0"),
+ "XDG_RUNTIME_DIR": str(runtime_dir),
+ "DBUS_SESSION_BUS_ADDRESS": f"unix:path={runtime_dir}/bus",
+ }
+ )
+ return env
+
+
+def _live_desktop_users() -> list[tuple[str, int]]:
+ users: list[tuple[str, int]] = []
+ runtime_root = Path("/run/user")
+ if not runtime_root.exists():
+ return users
+
+ for runtime_dir in runtime_root.iterdir():
+ if not runtime_dir.is_dir() or not runtime_dir.name.isdigit():
+ continue
+ uid = int(runtime_dir.name)
+ try:
+ user_info = pwd.getpwuid(uid)
+ except KeyError:
+ continue
+ if uid < 1000 or user_info.pw_dir in ("", "/nonexistent"):
+ continue
+ users.append((user_info.pw_name, uid))
+
+ return users
+
+
+def _run_gsettings(user: str, env: dict[str, str], args: list[str]) -> subprocess.CompletedProcess[str]:
+ return subprocess.run(
+ ["runuser", "-u", user, "--", "gsettings", *args],
+ check=False,
+ capture_output=True,
+ text=True,
+ env=env,
+ )
+
+
+def _apply_live_user_theme(context: MigrationContext, username: str, uid: int) -> None:
+ env = _session_environment(uid)
+ if env is None:
+ return
+
+ settings = [
+ ("org.cinnamon.theme", "name", THEME_NAME),
+ ("org.cinnamon.desktop.interface", "gtk-theme", THEME_NAME),
+ ("org.cinnamon.desktop.interface", "icon-theme", ICON_THEME_NAME),
+ ("org.cinnamon.desktop.interface", "cursor-theme", CURSOR_THEME_NAME),
+ ("org.cinnamon.desktop.interface", "font-name", FONT_NAME),
+ ("org.cinnamon.desktop.wm.preferences", "theme", THEME_NAME),
+ ("org.gnome.desktop.interface", "gtk-theme", THEME_NAME),
+ ("org.gnome.desktop.interface", "icon-theme", ICON_THEME_NAME),
+ ("org.gnome.desktop.interface", "cursor-theme", CURSOR_THEME_NAME),
+ ("org.gnome.desktop.interface", "font-name", FONT_NAME),
+ ("org.gnome.desktop.wm.preferences", "theme", THEME_NAME),
+ ("org.cinnamon.desktop.interface", "clock-show-date", "true"),
+ ("org.cinnamon.desktop.interface", "clock-use-24h", "true"),
+ ]
+
+ updated_count = 0
+ for schema, key, value in settings:
+ current = _run_gsettings(username, env, ["get", schema, key])
+ if current.returncode != 0:
+ continue
+
+ current_value = current.stdout.strip().strip("'")
+ if current_value == value:
+ continue
+
+ result = _run_gsettings(username, env, ["set", schema, key, value])
+ if result.returncode == 0:
+ updated_count += 1
+
+ if updated_count > 0:
+ context.log(f"updated {updated_count} theme settings for user: {username}")
+ else:
+ context.log(f"theme settings already current for user: {username}")
+
+
+def run(context: MigrationContext) -> None:
+ """Apply CaramOS branding, themes, and desktop defaults from ISO customization."""
+
+ if context.dry_run:
+ context.log(f"[dry-run] apply CaramOS branding and desktop defaults to version {CARAMOS_VERSION}")
+ context.log("[dry-run] update OS identity, locale, timezone, theme, and desktop configs")
+ context.log("[dry-run] apply live-user theme settings when session is available")
+ return
+
+ _update_os_identity(context)
+ _update_locale_and_timezone(context)
+ _update_theme_configs(context)
+
+ for username, uid in _live_desktop_users():
+ _apply_live_user_theme(context, username, uid)
From e29efbd6850415d2d8959e26b907a167f2dcb93f Mon Sep 17 00:00:00 2001
From: "Dr. YFish" <261328128+dryfish09@users.noreply.github.com>
Date: Sat, 22 Aug 2026 08:22:40 +0700
Subject: [PATCH 37/37] Create manifest.json
---
.../dmcaram-ota-1.1.0/manifest.json | 25 +++++++++++++++++++
1 file changed, 25 insertions(+)
create mode 100644 packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/manifest.json
diff --git a/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/manifest.json b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/manifest.json
new file mode 100644
index 0000000..f56ee24
--- /dev/null
+++ b/packages/caramos-ota/usr/lib/python3/dist-packages/caramos_ota_update/migrations/dmcaram-ota-1.1.0/manifest.json
@@ -0,0 +1,25 @@
+{
+ "schema": 2,
+ "codename": "noble",
+ "channel": "stable",
+ "severity": "feature",
+ "size": "ota feature",
+ "title": "Áp dụng nhận diện CaramOS và theme Cinnamon Delight",
+ "summary": "Cập nhật branding CaramOS, theme Cinnamon Delight, locale tiếng Việt, và desktop defaults từ ISO customization.",
+ "release_notes_vi": [
+ "Cập nhật thông tin hệ điều hành sang CaramOS (os-release, lsb-release, linuxmint info).",
+ "Áp dụng theme Cinnamon Delight, icon Tela-circle-light, cursor Bibata-Modern-Classic, và font Be Vietnam Pro cho desktop mặc định.",
+ "Chuyển locale mặc định sang tiếng Việt (vi_VN.UTF-8) và timezone Asia/Ho_Chi_Minh.",
+ "Cập nhật cấu hình LightDM greeter và GSettings schema sang nhận diện CaramOS.",
+ "Đổi tên desktop entry installer thành 'Install CaramOS' với icon caramos-logo.",
+ "Cập nhật theme cho các user desktop đang có phiên đăng nhập nếu họ vẫn dùng theme mặc định."
+ ],
+ "release_notes_en": [
+ "Update OS identity metadata to CaramOS branding (os-release, lsb-release, linuxmint info).",
+ "Apply Cinnamon Delight theme, Tela-circle-light icons, Bibata-Modern-Classic cursor, and Be Vietnam Pro font as desktop defaults.",
+ "Switch default locale to Vietnamese (vi_VN.UTF-8) and timezone to Asia/Ho_Chi_Minh.",
+ "Update LightDM greeter config and GSettings schema overrides to CaramOS branding.",
+ "Rename installer desktop entry to 'Install CaramOS' with caramos-logo icon.",
+ "Apply theme changes to desktop users with active sessions if they still use default theme."
+ ]
+}