Trình phát nhạc MIDI dạng cửa sổ phủ (Overlay) hiện đại phong cách Spotify, tự động mô phỏng phím bấm nhạc cụ trong game (Where Winds Meet / Yên Vân Thập Lục Thanh - yysls).
Nguồn gốc dự án & Lời cảm ơn:
Dự án được làm lại (rework) và tiếp tục phát triển dựa trên dự án mã nguồn mở của tác giả YueLyn (SnowiyQ). Xin chân thành cảm ơn tác giả YueLyn vì nền tảng tuyệt vời ban đầu.
Do dự án gốc hiện đã ngừng phát triển tính năng mới, Hưng (Vùng Đất Chill) tiếp tục duy trì, bảo trì lỗi, nâng cấp logic phát nhạc Spotify và phát triển thêm các tính năng phục vụ cộng đồng.
Dự án luôn hoan nghênh mọi ý kiến đóng góp, báo lỗi và Pull Request.
-
Demo phát nhạc tự động:
https://github.com/user-attachments/assets/4d25e203-0e4f-4b0f-8dc4-e855ce5e6647 -
Demo đồng bộ & điều khiển:
https://github.com/user-attachments/assets/5223ff30-a859-4433-84c0-bfb3d8a8ed46
Nhấn Insert để thu nhỏ trình phát thành icon tròn mờ lơ lửng trên màn hình game. Icon sáng viền xanh lá khi nhạc đang phát.
- Giao diện Kính mờ Đen tuyền (Obsidian Glass): Thiết kế tối giản, độ trong suốt tinh tế, sắc nét và hiện đại.
- Hàng chờ & Phát ngẫu nhiên chuẩn Spotify:
- Hàng chờ ưu tiên (User Queue): Tách biệt với danh sách đang nghe, phát hết hàng chờ sẽ tự động tiếp tục ngữ cảnh trước đó.
- Xáo trộn bài không lặp lại (Fisher-Yates Shuffle): Tất cả các bài trong danh sách chỉ phát đúng 1 lần trong mỗi chu kỳ.
- Tự động chọn ngẫu nhiên bài xuất phát khi bấm "Phát ngẫu nhiên" tại Thư viện, Playlist hay Yêu thích.
- Tự động nhận diện cửa sổ game: Hỗ trợ Where Winds Meet và Yên Vân Thập Lục Thanh (
yysls.exe). - Chế độ phím linh hoạt: Hỗ trợ 21 phím tự nhiên hoặc 36 phím bán âm (kèm tổ hợp Shift/Ctrl).
- Phím tắt toàn cục (Global Hotkeys): Dừng/Phát (F9), Lùi bài (F10), Chuyển bài (F11), Dừng hẳn (F12) ngay cả khi đang thao tác trong game.
- Chơi nhóm (Band Mode) & Chia sẻ P2P: Kết nối nhiều người chơi qua mạng ngang hàng để hòa tấu các bài MIDI nhiều bè.
- Hỗ trợ đa ngôn ngữ: Tiếng Việt (mặc định), English, 日本語, 한국어, ไทย, 中文.
Tạo hoặc mở thư mục album nằm cạnh file thực thi và chép các file .mid vào:
Chill-Music/
├── chill-music.exe
├── locales/ <- Tự động sinh khi chạy (để tùy biến bản dịch nếu muốn)
├── album/ <- Đặt các bài nhạc .mid tại đây
│ ├── BaiHat1.mid
│ └── BaiHat2.mid
- Mở game và vào chế độ nhạc cụ.
- Nhấp chuột phải vào
chill-music.exechọn Run as administrator (bắt buộc quyền Admin để giả lập thao tác phím vào cửa sổ game). - Chọn bài hát trong Thư viện và bấm Play.
| Phím | Chức năng |
|---|---|
F9 |
Phát / Tạm dừng (Play / Pause) |
F10 |
Lùi về bài trước (hoặc tua về 0:00 nếu đã phát >3s) |
F11 |
Chuyển sang bài kế tiếp (Next) |
F12 |
Dừng phát nhạc (Stop) |
Insert |
Bật / tắt chế độ thu nhỏ (Mini Mode) |
[ / ] |
Chuyển đổi nhanh chế độ tính nốt |
(Có thể tùy chỉnh lại phím tắt trong Settings → Keybindings).
Dự án sử dụng Tauri v2 + Rust + Bun + Svelte 5:
-
Yêu cầu môi trường:
- Bun
- Rust & Cargo (bản ổn định)
- C++ Build Tools (Visual Studio 2022 Community hoặc Build Tools)
-
Chế độ phát triển (Dev Mode): Chạy file
dev.bat(tự động xin quyền Admin, thiết lập môi trường C++ và khởi chạy). -
Đóng gói phát hành (Build Release): Chạy file
build.bathoặc lệnh:bun install bun run tauri build
File thực thi
.exephát hành nằm tại:src-tauri/target/release/chill-music.exe
- Báo lỗi & Đóng góp ý tưởng: Tạo Issue hoặc gửi Pull Request.
- Cộng đồng giao lưu: Discord – Vùng Đất Chill.
- Người duy trì & phát triển hiện tại: Hưng (Vùng Đất Chill).
- Tác giả gốc: YueLyn (SnowiyQ).