Dự án/MH-Dowsample
Thu thập và chuẩn hóaAlpha

MH-Dowsample

Kiểm tra, phân loại và sắp xếp sample thành thư viện gọn cho DAW.

v4.1.0Python 3.11+CI passingMIT License
MH-Dowsample — logo
Logo dự án lấy từ repository GitHub.

MH-Dowsample biến những folder audio hỗn tạp thành một thư viện dễ duyệt từ DAW. Pipeline kiểm tra từng file, ước lượng metadata âm nhạc, chuyển audio hợp lệ sang WAV 16-bit PCM có tag, phát hiện trùng bằng SHA-256 và ghi kết quả vào SQLite.

Ứng dụng chạy hoàn toàn cục bộ. Audio, session trình duyệt, database, credential, log và thư viện tạo ra đều nằm ngoài Git, giữ trên máy người dùng.

Tính năng

Kiểm tra chất lượng

Đo duration, bitrate, tỉ lệ silence và khả năng đọc audio trước khi nhận file.

Phân loại nội dung

Phân biệt loop, one-shot, FX; ước lượng BPM, key và gợi ý genre thực dụng.

Chuẩn hóa đầu ra

Normalize và export WAV 44.1 kHz, 16-bit PCM có tag đầy đủ.

Bố cục thư viện sạch

Tên file dễ đọc, ưu tiên nội dung; folder thân thiện với DAW.

Chống trùng lặp

Vân tay SHA-256 và inventory SQLite đảm bảo không import trùng.

Xử lý song song

Batch có thể cấu hình số worker và kích thước.

Web discovery có kiểm soát

Tìm audio công khai qua URL, tài nguyên trang, JSON và media control.

Telegram có duyệt

Người dùng được mời có thể gửi link audio công khai sau khi admin phê duyệt.

Quy trình xử lý
  1. 01Folder cục bộ hoặc URL đã duyệt
  2. 02Cổng kiểm tra chất lượng
  3. 03Phân loại và phân tích
  4. 04Normalize + tag WAV
  5. 05Kiểm trùng SHA-256
  6. 06Thư viện có tổ chức + inventory SQLite
Bằng chứng hiện có
  • CI matrix Python 3.11 và 3.12 với test, coverage ≥68%, ruff, mypy, bandit
  • Bot Telegram vận hành theo mã mời + phê duyệt admin
  • Đầu ra chuẩn 44.1 kHz / 16-bit PCM WAV có metadata
Chưa được xác nhận
  • Chưa có GUI người dùng cuối
  • Không tự động chạy trên thư viện production khi chưa backup
  • Chưa được kiểm định pháp lý cho từng nguồn web
Được nói
  • Chạy dry-run trước
  • Backup trước khi apply
  • Kiểm tra log sau mỗi lần chạy
Không được nói
  • Không chạy trên thư viện production khi chưa backup
  • Không auto-apply trên batch lớn