╔══════════════════════════════════════════════════════════════════════╗ ║ AIVA DEMO RECORDING - QUICK REFERENCE ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ 📁 LOCATION: /mnt/e/genesis-system/RECEPTIONISTAI/scripts ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🚀 ONE-COMMAND EXECUTION ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ cd /mnt/e/genesis-system/RECEPTIONISTAI/scripts ║ ║ ./QUICK_START.sh ║ ║ ║ ║ (Installs dependencies + generates audio in <5 minutes) ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🔧 MANUAL EXECUTION ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ # 1. Install ffmpeg (one-time) ║ ║ sudo apt-get install ffmpeg ║ ║ ║ ║ # 2. Install Python deps (one-time) ║ ║ pip install requests python-docx ║ ║ ║ ║ # 3. Run recording script ║ ║ python record_demo.py ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 📦 OUTPUT FILES ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ ../assets/audio/demo.opus (Primary - WebM/Opus, ~300KB) ║ ║ ../assets/audio/demo.mp3 (Fallback - MP3, ~450KB) ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🎙️ VOICE CONFIGURATION ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ Voice: eucalyptus (AIVA) ║ ║ Type: Telnyx NaturalHD Premium ║ ║ Gender: Female ║ ║ Accent: Australian ║ ║ Sample Rate: 22.05kHz ║ ║ Duration: ~75 seconds ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🔍 VERIFICATION ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ # Listen to files ║ ║ ffplay ../assets/audio/demo.opus ║ ║ ffplay ../assets/audio/demo.mp3 ║ ║ ║ ║ # Check file sizes ║ ║ ls -lh ../assets/audio/demo.* ║ ║ ║ ║ # Get audio info ║ ║ ffprobe ../assets/audio/demo.opus ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🌐 DEPLOYMENT (HTML) ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🎬 SYNC WITH VIDEO (JavaScript) ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ const video = document.getElementById('hero-video'); ║ ║ const audio = document.getElementById('hero-audio'); ║ ║ ║ ║ video.addEventListener('play', () => audio.play()); ║ ║ video.addEventListener('pause', () => audio.pause()); ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ⚙️ CUSTOMIZATION ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ Edit record_demo.py to change: ║ ║ ║ ║ VOICE_NAME = "eucalyptus" # Change voice ║ ║ OPUS_BITRATE = "32k" # Adjust quality/size ║ ║ MP3_BITRATE = "48k" # Adjust fallback quality ║ ║ SAMPLE_RATE = 22050 # Audio frequency ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🐛 TROUBLESHOOTING ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ ERROR: "ffmpeg not found" ║ ║ → sudo apt-get install ffmpeg ║ ║ ║ ║ ERROR: "No module named 'requests'" ║ ║ → pip install requests python-docx ║ ║ ║ ║ ERROR: "TTS API error: 401" ║ ║ → Check API key in script (already configured) ║ ║ ║ ║ WARNING: "File size >500KB" ║ ║ → Lower bitrate: OPUS_BITRATE = "24k" ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 💰 COST & TIME ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ Setup Time: <5 minutes (one-time) ║ ║ Generation Time: <1 minute per run ║ ║ Cost Per Run: ~$0.06 (Telnyx TTS) ║ ║ Total Project: <$1 ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 📚 DOCUMENTATION ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ Pipeline Guide: /mnt/e/genesis-system/plans/ ║ ║ AIVA_DEMO_RECORDING_PIPELINE.md ║ ║ ║ ║ Setup Guide: README_RECORDING.md (this directory) ║ ║ ║ ║ Summary: ../DEMO_RECORDING_SUMMARY.md ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ✅ QUALITY TARGETS ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ ✓ Opus file: <350KB ║ ║ ✓ MP3 file: <500KB ║ ║ ✓ Duration: ~75 seconds ║ ║ ✓ Sample rate: 22.05kHz ║ ║ ✓ Normalization: -16 LUFS ║ ║ ✓ Load time: <2s on 3G ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🎯 BROWSER SUPPORT ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ Chrome: ✅ Opus ║ ║ Firefox: ✅ Opus ║ ║ Safari 14.1+:✅ Opus ║ ║ Safari <14.1:✅ MP3 fallback ║ ║ Edge: ✅ Opus ║ ║ Mobile: ✅ Both formats ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 🔄 ALTERNATIVE VOICES (Australian) ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ eucalyptus - Female (current/AIVA) ║ ║ marlu - Male (alternative) ║ ║ ║ ║ To change: Edit VOICE_NAME in record_demo.py ║ ║ ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ 📋 CHECKLIST ║ ╠══════════════════════════════════════════════════════════════════════╣ ║ ║ ║ [ ] ffmpeg installed ║ ║ [ ] Python deps installed ║ ║ [ ] Script executed ║ ║ [ ] Audio files generated ║ ║ [ ] Quality verified (listen) ║ ║ [ ] File sizes acceptable ║ ║ [ ] Uploaded to website ║ ║ [ ] HTML updated ║ ║ [ ] Tested in browsers ║ ║ [ ] Mobile tested ║ ║ ║ ╚══════════════════════════════════════════════════════════════════════╝ Genesis AI - 2026-02-15