🎵 TXAPP

TXA Music Player

Ứng dụng nghe nhạc mạnh mẽ với thiết kế hiện đại, hỗ trợ nhiều định dạng và tính năng nâng cao.

Hỗ trợ & Đóng góp

Nếu bạn có thắc mắc hoặc gặp lỗi, vui lòng:

• Gửi yêu cầu kéo (Pull Request) tại repository này.
• Hoặc liên hệ qua Facebook:

Thông tin File

• Phiên bản: v2.9.2_txa
• Kích thước: 181.93 MB

Chào mừng bạn đến với TXA Music Player - ứng dụng nghe nhạc hiện đại, giao diện đẹp mắt và nhiều tính năng tùy biến mạnh mẽ dành cho Android.

📌 Tổng Quan

TXAPP Music Player được xây dựng dựa trên kiến trúc hiện đại, tập trung vào trải nghiệm người dùng với các tính năng nổi bật:

• Hệ Thống Widget Mới: 5 loại widget (Classic, Slim 4x2, Jumbo 4x4, Mini 2x2, Square 2x2) với thiết kế Premium.
• Vòng Tiến Trình (Circular Progress): Hiển thị trạng thái bài hát bo tròn theo Album Art cực đẹp.
• Support Author: Tính năng ủng hộ tác giả (Buy Me a Coffee) tích hợp.
• Synced Lyrics: Hiển thị lời bài hát đồng bộ (giống ZingMP3).
• Mini Player: Trình phát thu nhỏ tiện lợi với đầy đủ điều khiển.
• Material You: Giao diện thích ứng theo màu sắc hệ thống.
• Tag Editor: Chỉnh sửa thông tin bài hát trực tiếp.

Phiên bản hiện tại: 2.9.2_txa (Được cập nhật tự động từ version.properties)

📦 Thông Tin Build (Latest Build Info)

Check	Value
File Name	TXAMUSIC_v2.9.2_txa.apk
Version	v2.9.2_txa
Build Date	16/01/2026
Size	181.93 MB
Status	Stable / Signed

SHA-256 Checksum:

3b0c4e5b4c3f6e1a8d2f9c7b5a1e3d6f8a2c4b6e9d1f3a5c7e9b2d4f6a8c0e2b69ef46b9b

Lưu ý: Hãy kiểm tra mã SHA-256 sau khi tải về để đảm bảo file gốc không bị chỉnh sửa.

---

📖 Hướng Dẫn Sử Dụng (Cho Người Dùng)

1. Cài đặt / Cập nhật:

   • Người dùng mới: Tải file APK từ thư mục TXABUILD/ sau khi down mã nguồn về và tự build nhé hoặc từ trang Releases.
   • Người dùng cũ: Vào Cài đặt -> Kiểm tra cập nhật để tải bản mới nhất trực tiếp.

2. Cấp quyền:

   • Mở ứng dụng và cấp quyền truy cập bộ nhớ (Storage) để app có thể quét nhạc.
   • Với tính năng "Lời bài hát nổi" (Floating Lyrics), vui lòng cấp quyền "Hiển thị trên ứng dụng khác" trong cài đặt.

3. Tính năng:

   • Quét nhạc: Vào Cài đặt -> Quét thư viện để cập nhật bài hát mới.
   • Lời bài hát: Nhấn vào icon Lyrics ở màn hình chơi nhạc để xem hoặc tải lời bài hát.

---

👨‍💻 Hướng Dẫn Phát Triển (Cho Developer)

Nếu bạn muốn đóng góp hoặc tự build ứng dụng, hãy làm theo các bước sau:

1. Yêu cầu môi trường

• OS: Windows, Linux, hoặc macOS.
• Java JDK: 17 (Bắt buộc).
• Android Studio: Phiên bản mới nhất (Koala/Ladybug...).
• Git: Đã cài đặt và cấu hình.

2. Clone Repository

Mở terminal và chạy lệnh sau để tải mã nguồn về:

git clone https://github.com/TXAVLOG/PROJECT.git
cd PROJECT

3. Cài đặt Dependencies

Dự án sử dụng Gradle để quản lý thư viện. Bạn không cần tải thủ công các gói. Tuy nhiên, hãy đảm bảo Internet ổn định để Gradle tải về lần đầu:

• Android SDK Build-Tools 34.0.0
• Kotlin Gradle Plugin
• Hilt, Room, Coil, ExoPlayer...

4. Build Ứng Dụng

Cách 1: Sử dụng Script tự động (Khuyên dùng)

Dự án cung cấp script PowerShell giúp dọn dẹp và build nhanh bản Debug:

Chạy trên Windows (PowerShell):

.\tools\build-fast.ps1

Script này sẽ tự động Clean Project và chạy AssembleDebug.

Cách 2: Build thủ công

Nếu bạn muốn build thủ công hoặc dùng trên Linux/Mac:

# Windows
.\gradlew.bat assembleDebug

# Linux/Mac
./gradlew assembleDebug

File APK sau khi build sẽ nằm trong app/build/outputs/apk/debug/.

5. Công Cụ Hỗ Trợ (Tools)

Backup Keystore

Để bảo mật và sao lưu Keystore (chữ ký ứng dụng), hãy sử dụng script có sẵn. Script này sẽ nén toàn bộ các file .jks và .keystore vào thư mục an toàn.

Windows:

.\tools\TXABackupKeystore.ps1

Linux/Mac:

chmod +x tools/TXABackupKeystore.sh
./tools/TXABackupKeystore.sh

---

✨ Contributors (Những người đóng góp)

Cảm ơn tất cả các bạn đã tham gia phát triển dự án này!

---

🔗 Tài liệu tham khảo

• Kotlin Documentation
• Android Jetpack Guide
• Material Design 3
• ExoPlayer

---

© 2024-2026 TXA Team. Developed with ❤️.