WaveSync là ứng dụng trình phát nhạc và quản lý thư viện âm nhạc được xây dựng bằng C# WinForms với giao diện hiện đại, trực quan và dễ mở rộng.
Ứng dụng hỗ trợ đăng nhập người dùng, lưu lịch sử nghe nhạc riêng biệt, thêm bài hát mới và phát nhạc với đầy đủ các điều khiển hiện đại.
- ✅ Đăng nhập / Đăng ký: Hệ thống xác thực an toàn.
- ✅ Hồ sơ cá nhân: Người dùng có thể đổi mật khẩu và cập nhật Avatar riêng.
- ✅ Minimize to Tray: Thu nhỏ ứng dụng xuống khay hệ thống (System Tray) để chạy nền.
- ✅ Điều khiển đầy đủ: Play, Pause, Next, Previous, Seek (tua nhạc), Volume control.
- ✅ Chế độ phát: - Shuffle (Phát ngẫu nhiên).
- Loop (Lặp 1 bài / Lặp toàn bộ danh sách nhạc).
- ✅ Giao diện thông minh: - Hiệu ứng Marquee (chữ chạy) cho tên bài hát/nghệ sĩ quá dài.
- Hiệu ứng chuyển động (Sliding Animation) cho Sidebar và Settings.
- ✅ Yêu thích (Favorites): Thả tim ❤️ để lưu bài hát vào danh sách yêu thích riêng.
- ✅ Lịch sử: Tự động lưu lại các bài hát vừa nghe.
- ✅ Lưu toàn bộ metadata bài hát trong SQL LocalDB
- ✅ Thêm bài hát mới qua form riêng (hỗ trợ .mp3, .wav)
- ✅ Tải ảnh bìa tự động hoặc chọn thủ công
- ✅ Tìm kiếm nhanh theo Title / Artist / Album
- Sử dụng LocalDB (.mdf)
- File database nằm trong thư mục
Data/WaveSyncDB.mdf - Quản lý kết nối qua lớp
DatabaseHelper.cs
| Công nghệ | Mục đích |
|---|---|
| C# (.NET Framework) | Ngôn ngữ và nền tảng phát triển chính |
| SQL Server LocalDB 2022 | Lưu trữ User, Playlist, History, Song Data |
| NAudio | Thư viện xử lý âm thanh (Core Audio Engine) |
| TagLib# | Đọc Metadata (ID3 tags) và Ảnh bìa từ file MP3 |
| Guna.UI2.WinForms | Hỗ trợ thiết kế giao diện Flat/Modern |
Để ứng dụng hoạt động ổn định, máy tính cần đáp ứng:
- Hệ điều hành: Windows 10 hoặc Windows 11.
- SQL Server Express LocalDB 2022 (Bắt buộc để chạy Database).
Nếu bạn muốn xem code hoặc phát triển thêm:
- Công cụ: Cần cài đặt Visual Studio 2022 (bản Community trở lên) và tích vào workload .NET desktop development.
- Clone dự án:
git clone [https://github.com/hlongit/WaveSync.git](https://github.com/hlongit/WaveSync.git)
- Mở dự án: Chạy file MusicPlayer.sln.
- Restore Packages: Tại Solution Explorer, chuột phải vào Solution -> chọn Restore NuGet Packages.
- Chạy: Nhấn Start (F5)
Nếu bạn chỉ muốn tải về và sử dụng ngay:
- Cài đặt LocalDB: - Tải và cài đặt SQL Server LocalDB (khoảng 50MB) từ trang chủ Microsoft nếu máy bạn chưa có.
- Link tải trực tiếp từ Microsoft (Chọn bản LocalDB 2022).
- Tải ứng dụng: Vào mục Releases trên GitHub và tải file .zip.
- Giải nén: Giải nén toàn bộ file ZIP ra một thư mục.
- Chạy: Mở file MusicPlayer.exe.


