caelestia-pro

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 11 Open GitHub ↗

Caelestia Pro cho Ubuntu 26.04: Hyprland shell, hình nền động và giao diện tiếng Việt

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Caelestia Pro

Caelestia Pro là bộ desktop shell dành cho Hyprland, kết hợp giao diện
Caelestia, hình nền động, Material You, trung tâm cài đặt Nexus, phím tắt kiểu
Windows 11 và File Explorer dựa trên Dolphin.

> [!IMPORTANT]
> Bản đầy đủ này chỉ hỗ trợ **Ubuntu 26.04 LTS** và hiện được kiểm thử trên
> `x86_64`. Bộ cài sẽ dừng nếu phát hiện hệ điều hành hoặc kiến trúc khác.

## Tính năng nổi bật

- Thanh tác vụ, launcher, dashboard, thông báo, màn hình khóa và menu phiên.
- Hình nền ảnh/video MP4, WebM và MKV với bảng màu Material You.
- Tự tạm dừng hình nền động khi dùng pin hoặc khi cửa sổ che màn hình.
- Tự nhận diện GPU và bộ giải mã video; có thể chỉnh trong Nexus.
- Chụp/quay màn hình, lịch sử bảng tạm, media, Wi-Fi, Bluetooth và âm thanh.
- Phím tắt quen thuộc kiểu Windows 11.
- Dolphin được cấu hình thành File Explorer với hồ sơ riêng, không ghi đè hồ
  sơ Dolphin mặc định.
- Giao diện và hướng dẫn tiếng Việt.
- Giữ KDE Plasma làm phiên đăng nhập riêng để có thể quay lại bất cứ lúc nào.

## Yêu cầu

- Ubuntu 26.04 LTS `x86_64`.
- Tài khoản người dùng thường có quyền xác thực qua `pkexec`.
- Kết nối Internet để tải gói phụ thuộc và phông chữ.
- Nên có ít nhất 8 GiB dung lượng trống để biên dịch.

Không chạy bộ cài bằng `sudo`. Bộ cài chỉ yêu cầu quyền quản trị ở bước cài
gói hệ thống.

## Cài nhanh

```bash
git clone https://github.com/conlongnhong/caelestia-pro.git
cd caelestia-pro

./install.sh --check
./install.sh
```

`--check` chỉ kiểm tra hệ điều hành, kiến trúc và cấu trúc mã nguồn; không cài
đặt hoặc thay đổi cấu hình.

Sau khi hoàn tất, đăng xuất khỏi Plasma, chọn phiên **Hyprland** trong SDDM rồi
đăng nhập lại.

### Tùy chọn bộ cài

```bash
./install.sh --help
./install.sh --check
./install.sh --skip-deps
./install.sh --yes
```

Chỉ dùng `--skip-deps` khi toàn bộ gói phụ thuộc, bao gồm `hyprland-dev`, đã
được cài đúng phiên bản. `--yes` dành cho phiên không tương tác.

## Thư mục dữ liệu

Mặc định, bộ cài sử dụng thư mục XDG của người dùng:

| Biến | Mặc định |
| --- | --- |
| `CAELESTIA_WALLPAPERS_DIR` | Thư mục Ảnh XDG cộng `/Wallpapers` |
| `CAELESTIA_RECORDINGS_DIR` | Thư mục Video XDG cộng `/Recordings` |
| `CAELESTIA_SCREENSHOTS_DIR` | Thư mục Ảnh XDG cộng `/Screenshots` |
| `XDG_DATA_HOME` | `~/.local/share` |
| `XDG_STATE_HOME` | `~/.local/state` |
| `XDG_CACHE_HOME` | `~/.cache` |

Có thể chọn thư mục khác trước khi kiểm tra và cài:

```bash
export CAELESTIA_WALLPAPERS_DIR="$HOME/Pictures/Wallpapers"
export CAELESTIA_RECORDINGS_DIR="$HOME/Videos/Recordings"
export CAELESTIA_SCREENSHOTS_DIR="$HOME/Pictures/Screenshots"

./install.sh --check
./install.sh
```

Hình nền động được đặt trong thư mục con `Animated` của thư viện hình nền.
Trong launcher, nhập `>wallpaper `, chuyển sang mục **Động** rồi chọn **Làm
mới**.

Cấu hình chính nằm tại:

```text
~/.config/caelestia/
```

Các thiết lập thường dùng có thể chỉnh trong Nexus, gồm đường dẫn hình nền,
GPU, bộ giải mã video, thời tiết, định dạng giờ và chế độ tiết kiệm tài nguyên.

## Sao lưu và gỡ cài đặt

Trước khi thay đổi cấu hình, bộ cài tự sao lưu các đích liên quan vào:

```text
${XDG_STATE_HOME:-$HOME/.local/state}/caelestia-aw/backups/
```

Xem bản sao lưu đang được dùng để khôi phục:

```bash
cat "${XDG_STATE_HOME:-$HOME/.local/state}/caelestia-aw/last-backup"
```

Gỡ Caelestia Pro và khôi phục cấu hình trước khi cài:

```bash
"${XDG_DATA_HOME:-$HOME/.local/share}/caelestia-aw/uninstall-ubuntu.sh"
```

Gỡ không cần hỏi lại:

```bash
"${XDG_DATA_HOME:-$HOME/.local/share}/caelestia-aw/uninstall-ubuntu.sh" --yes
```

Bộ gỡ giữ nguyên các gói `apt`, thư viện hình nền, ảnh chụp và video đã ghi.

> [!WARNING]
> Bộ cài thay thế cấu hình Hyprland và Caelestia đang dùng sau khi đã sao lưu.
> Hãy giữ thư mục backup nếu bạn cần khôi phục cấu hình cũ.

## Cấu trúc kho mã nguồn

```text
.
├── install.sh             # Cổng kiểm tra và cài đặt cho Ubuntu 26.04
├── caelestia-aw/          # Dotfiles, cấu hình tương thích và bộ cài/gỡ
├── caelestia-shell-aw/    # Giao diện QML và plugin C++
├── caelestia-cli-aw/      # Công cụ dòng lệnh Python
├── quickshell/            # Runtime Quickshell đã ghim phiên bản
└── cava/                  # Thư viện visualiser âm thanh
```

Đây là monorepo dạng vendor: mã nguồn cần thiết được lưu trực tiếp trong kho,
không cần tải Git submodule.

## Bảo mật

Các thay đổi hardening, CVE đã xử lý, phạm vi đánh giá và giới hạn kiểm thử được
ghi tại [báo cáo bảo mật tháng 7/2026](docs/security-hardening-2026-07.md).

## ☕ Donate cà phê

Nếu **Caelestia Pro** hữu ích với bạn, hãy cân nhắc ủng hộ mình một ly cà phê để duy trì và phát triển dự án.

Nguyễn Nam Dương 
 Quét mã bằng MoMo hoặc ứng dụng ngân hàng hỗ trợ VietQR/Napas 247.

## Nguồn và giấy phép

Caelestia Pro là dự án cộng đồng, không liên kết chính thức với Caelestia
upstream.

- Caelestia gốc: [caelestia-dots](https://github.com/caelestia-dots)
- Caelestia Animated Wallpaper:
  [AdiAmbassador/caelestia-aw](https://github.com/AdiAmbassador/caelestia-aw)
- Quickshell:
  [quickshell-mirror/quickshell](https://github.com/quickshell-mirror/quickshell)
- Cava: [karlstav/cava](https://github.com/karlstav/cava)

Các phần dựa trên Caelestia Shell và CLI được phân phối theo GPL-3.0.
Quickshell giữ giấy phép LGPL-3.0/GPL-3.0 của dự án gốc; Cava giữ giấy phép
MIT. Xem các tệp giấy phép trong từng thư mục thành phần để biết đầy đủ điều
khoản.

caelestia-pro

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README