Export Card to Audio – Xuất thẻ Anki thành file MP3 để nghe lại

🎧 Export Card to Audio là gì?

Export Card to Audio giúp bạn:

• Chuyển nội dung thẻ Anki thành file .mp3,
• Để bạn có thể:
  • Nghe lại thẻ như một playlist audio,
  • Ôn bài khi:
    • Đi đường,
    • Tập thể dục,
    • Làm việc nhà,
    • Hoặc bất cứ lúc nào không ngồi trước màn hình.

Addon cho phép:

• Chọn field nào dùng cho mặt trước và mặt sau,
• Nếu field có audio sẵn → dùng luôn file audio đó, +- Nếu field chỉ có text → addon tự chuyển văn bản thành giọng nói (TTS),
• Tuỳ chỉnh:
  • Ngôn ngữ đọc (front/back),
  • Thời gian nghỉ giữa các phần,
  • Pattern lặp (ví dụ ffbb),
  • Thêm tiếng beep ở đầu file,
  • Thư mục lưu file audio.

Hiện addon chỉ hỗ trợ Windows. Tác giả mở cửa cho dev khác đóng góp để hỗ trợ thêm OS.

---

🧩 Cách hoạt động tổng quan

Khi bạn chạy lệnh Export:

1. Chọn một hoặc nhiều thẻ trong Browser.
2. Chọn field Front/Back và ngôn ngữ tương ứng.
3. Addon tạo một hoặc nhiều file .mp3:
   • Mỗi file tương ứng với một thẻ (hoặc cả deck nếu bạn cấu hình/merge về sau),
   • Nội dung audio:
     • Nếu field có [sound:...] → dùng audio đó,
     • Nếu chỉ có text → TTS đọc theo language bạn chọn.

Bạn có thể:

• Chép các file .mp3 này sang điện thoại,
• Nghe trên bất kỳ app nghe nhạc/podcast nào.

---

📥 Cách sử dụng chi tiết

Bước 1: Mở Browser và chọn các thẻ muốn xuất

1. Mở Browser trong Anki.
2. Lọc/Chọn deck/Tag/Note type như bình thường.
3. Chọn:
   • Một thẻ, hoặc
   • Nhiều thẻ (giữ Shift / Ctrl để multi-select).

Bước 2: Gọi lệnh Export Card to Audio

1. Chuột phải vào vùng thẻ đã chọn.
2. Chọn menu:

"Export audio card/s"

3. Một hộp thoại sẽ hiện ra, yêu cầu bạn điền:

Các trường cấu hình chính

• Card Front Field:

  • Field chứa thông tin mặt trước (ví dụ: Front, Expression…).

• Card Back Field:

  • Field chứa nội dung giải thích/mặt sau (ví dụ: Back, Meaning…).

• Front language:

  • Ngôn ngữ của field mặt trước:
    • Quan trọng nếu field là text,
    • Để TTS chọn giọng đọc phù hợp (Anh, Nhật, v.v.).

• Back language:

  • Ngôn ngữ của field mặt sau (tương tự Front language).

• Delay time in s:

  • Số giây im lặng giữa các phần audio trong một file,
  • Ví dụ:
    • 2–3 giây để có thời gian nhớ lại trước khi nghe đáp án.

• Audio pattern:

  • Định nghĩa thứ tự và số lần lặp front/back trong một file,
  • Ví dụ:
    • "ffbb":
      • Phát audio front 2 lần,
      • Sau đó audio back 2 lần.
  • Chỉ nhận hai ký tự:
    • f = front,
    • b = back.

• Add a beep at the beginning:

  • Nếu bật:
    • Thêm tiếng “bíp” đầu file,
    • Giúp bạn nhận diện rõ ràng lúc audio bắt đầu.

• Save Directory:

  • Thư mục sẽ chứa các file .mp3 được xuất,
  • Nên chọn một folder riêng để dễ quản lý và sync ra thiết bị khác.

4. Điền xong → bấm OK / Accept.

Addon sẽ bắt đầu:

• Tạo file .mp3 cho từng thẻ,
• Hoặc báo lỗi nếu có thẻ khiến quá trình crash (xem phần lưu ý bên dưới).

---

⚠️ Lưu ý & hạn chế

1. Chỉ hỗ trợ Windows

• Addon hiện chỉ được test và hỗ trợ trên:
  • Windows (desktop),
• Nếu bạn muốn:
  • Dùng trên macOS / Linux → cần dev khác port thêm,
  • Hoặc dùng các workflow khác (vd: dùng script ngoài, TTS ngoài).

2. Vấn đề khi field chứa nhiều file audio

• Tác giả ghi nhận:
  • Khi một field chứa 2 file audio trở lên, addon có thể gặp lỗi (bug),
  • Đây là điểm cần chú ý nếu bạn hay nhét nhiều [sound:...] trong cùng field.

3. Crash khi export nhiều thẻ

• Một số người dùng báo:
  • Chạy export 50+ thẻ có thể gây crash,
  • Hoặc chỉ xuất được một phần rồi dừng.

Giải pháp gợi ý:

• Xuất theo batch nhỏ (ví dụ 20–30 thẻ),
• Kiểm tra log để xem có thẻ “gây crash” đặc biệt không.

4. Mong muốn thêm tính năng

Người dùng đã đề xuất:

• Một pattern “tự động” kiểu:
  • Thời lượng im lặng = thời lượng audio trước đó + X giây,
  • Để tạo khoảng nghĩ phù hợp với độ dài câu.
• Tuỳ chọn:
  • Xuất cả deck thành 1 file audio duy nhất (hiện có thể phải merge bằng tool ngoài).

Nếu những điều này quan trọng với workflow của bạn:

• Hãy theo dõi GitHub repo,
• Hoặc tự viết script nhỏ để merge .mp3 sau khi export.

---

📥 Cài đặt addon

1. Mở Anki Desktop trên Windows.
2. Vào Tools → Add-ons → Get Add-ons…
3. Nhập code: 1117983796
4. Bấm OK để cài.
5. Khởi động lại Anki.

---

🌐 Liên kết hỗ trợ & mã nguồn

• GitHub / báo lỗi / góp ý / PR:
  https://github.com/nicodeheza/audiocards