@flor1n4/audio-cli

CLI xử lý audio dựa trên FFmpeg: chuyển đổi định dạng, điều chỉnh tốc độ, cập nhật metadata, chuẩn hóa tên tệp và xem thông tin audio.

FFmpeg và FFprobe đã được đóng gói sẵn; không cần cài đặt riêng. Yêu cầu Node.js 18 trở lên.

Cài đặt

npm install -g @flor1n4/audio-cli

Kiểm tra sau khi cài đặt:

audio-cli --help
audio-cli --version

Windows PowerShell, macOS và Linux đều có thể dùng các lệnh dưới đây. Khi đường dẫn chứa khoảng trắng, hãy đặt trong dấu ngoặc kép.

Cách dùng

audio-cli <lệnh> <file-hoặc-thư-mục> [tùy-chọn]

Các lệnh khả dụng:

| Lệnh | Mô tả | | --- | --- | | convert | Chuyển tệp audio sang định dạng mong muốn. | | rename | Chuẩn hóa tên tệp audio. | | metadata | Cập nhật metadata mà không thay đổi codec audio. | | info | Hiển thị codec, thời lượng, bitrate, kích thước và metadata. |

Xem trợ giúp chi tiết cho từng lệnh:

audio-cli convert --help
audio-cli metadata --help

Chuyển đổi audio

# Chuyển toàn bộ file trong thư mục sang MP3 và lưu tại thư mục khác
audio-cli convert ./Novel --output ./output --album "Tiên Nghịch" --bitrate 192k

# Quét cả thư mục con, tăng tốc 1.5 lần và giữ các tệp gốc
audio-cli convert ./Novel --recursive --speed 1.5 --keep

# Xem trước kết quả mà không thay đổi tệp
audio-cli convert ./Novel --recursive --dry-run

# Xuất định dạng khác và giữ nguyên tên file
audio-cli convert ./input --ext m4a --no-clean-name --keep

Tùy chọn convert

| Tùy chọn | Mặc định | Mô tả | | --- | --- | --- | | -o, --output <dir> | Thư mục của tệp đầu vào | Thư mục lưu kết quả. | | -a, --album <name> | — | Gán tên album. | | -s, --speed <number> | 1 | Tốc độ phát; phải lớn hơn 0. | | -b, --bitrate <bitrate> | 128k | Một trong: 64k, 96k, 128k, 160k, 192k, 256k, 320k. | | -e, --ext <ext> | mp3 | Phần mở rộng đầu ra, chỉ gồm chữ và số. | | -r, --recursive | false | Quét cả thư mục con. | | -k, --keep | false | Giữ lại tệp gốc. | | -f, --force | false | Ghi đè tệp đầu ra đã tồn tại. | | --no-clean-name | — | Không chuẩn hóa tên tệp đầu ra. | | --dry-run | false | Xem trước thao tác, không chuyển đổi. | | -v, --verbose | false | Hiển thị thông tin chi tiết. |

Chuẩn hóa tên tệp

# Chuẩn hóa tên các file trong thư mục hiện tại
audio-cli rename ./Novel

# Bao gồm thư mục con; ghi đè nếu tên đích đã tồn tại
audio-cli rename ./Novel --recursive --force

Lệnh này loại bỏ ký tự không hợp lệ và chuẩn hóa tên tệp. Theo mặc định, tệp bị bỏ qua nếu tên đích đã tồn tại.

Cập nhật metadata

# Gán album và nghệ sĩ cho mọi tệp trong thư mục
audio-cli metadata ./Novel --album "Tiên Nghịch" --artist "Audio Team"

# Dùng tên tệp làm tiêu đề, bao gồm thư mục con
audio-cli metadata ./Novel --title-from-filename --recursive

Phải cung cấp ít nhất một trong các tùy chọn --album, --artist hoặc --title-from-filename.

Xem thông tin tệp

audio-cli info ./Novel/chapter-01.mp3

Định dạng đầu vào hỗ trợ

mp3, m4a, aac, wav, flac, ogg, opus, wma, aiff, alac, ape, amr, 3gp, webm.

Lưu ý an toàn

• convert xóa tệp gốc sau khi chuyển đổi thành công, trừ khi dùng --keep.
• Nên dùng --dry-run trước khi xử lý thư mục lớn.
• metadata cập nhật trực tiếp tệp nguồn; nên sao lưu dữ liệu quan trọng trước khi chạy hàng loạt.
• Khi đầu vào và đầu ra là cùng một tệp (ví dụ MP3 sang MP3), công cụ dùng tệp tạm để tránh mất dữ liệu.

License

MIT