Tango Quiz Companion

日本語

起動方法

1. ZIPを右クリックして「すべて展開」を選びます。
2. README.html または TangoQuizCompanion.html をMicrosoft EdgeかGoogle Chromeで開きます。インストールは不要です。
3. Milonga DJ Proの「タグ書き出し」で作成したExcel（.xlsx）またはCSVを選びます。
4. 検定設定を選び、「検定開始」を押します。

SampleDB_for_text_quiz.csv を使うと、音源なしでテキスト検定を試せます。これは動作確認用の架空データです。

10秒曲あて・会場チャレンジ

ExcelDBを読み込んだ後、音源フォルダを選択します。異なる楽団の音源が4曲以上一致すると開始できます。照合には主にExcelDBの file_name を使います。音源自体は配布物に含まれません。

データとAI機能

• ExcelDBと音源は端末内で処理され、外部へアップロードされません。
• AI学習コーチは任意機能です。利用者自身のOpenAI APIキーとインターネット接続が必要で、API利用料が発生する場合があります。
• AIボタンを押した時だけ、検定結果・弱点傾向・誤答の要約を送信します。音源とExcelファイルは送信しません。
• 共有PCでは「APIキーを保存」をオフにしてください。復習履歴は使用したブラウザー内に保存されます。

Excelの読み込みに失敗する場合は、Excel側でUTF-8 CSVとして保存し直して読み込んでください。

English

1. Extract all files from the ZIP first.
2. Open README.html or TangoQuizCompanion.html in Microsoft Edge or Google Chrome. No installation is required.
3. Choose an Excel (.xlsx) or CSV file exported from Milonga DJ Pro.
4. Select the quiz settings and press “Start Quiz.”

SampleDB_for_text_quiz.csv contains fictional test data and lets you try the text quiz without audio. For the 10-second audio quiz, load your ExcelDB and choose your local music folder. At least four matched tracks from different orchestras are required.

ExcelDB data and audio stay on your device. The optional AI coach requires your own OpenAI API key and may incur API charges. Only a result summary is sent when you press the AI button; Excel and audio files are not sent. Do not save an API key on a shared computer.

Español

1. Extrae primero todos los archivos del ZIP.
2. Abre README.html o TangoQuizCompanion.html en Microsoft Edge o Google Chrome. No requiere instalación.
3. Elige un archivo Excel (.xlsx) o CSV exportado desde Milonga DJ Pro.
4. Selecciona los ajustes y pulsa “Iniciar Quiz”.

SampleDB_for_text_quiz.csv contiene datos ficticios para probar el quiz de texto sin audio. Para el quiz auditivo de 10 segundos, carga tu ExcelDB y elige tu carpeta de música. Se necesitan al menos cuatro pistas coincidentes de distintas orquestas.

Los datos de ExcelDB y el audio permanecen en tu dispositivo. El entrenador IA opcional requiere tu propia clave de OpenAI API y puede generar cargos. Solo se envía un resumen cuando pulsas el botón de IA; no se envían archivos Excel ni audio. No guardes la clave en un equipo compartido.