How suranjanverma/voice-translator works
Gray United Voice Translator is a Spring Boot web application for speech transcription, multilingual translation, account management, and per-user translation history. The documented main workflow captures browser audio and returns translated text for display and optional browser speech synthesis; sampled WebSocket code confirms one real-time route through Vosk and translation services. The graph also preserves documented authentication and history capabilities. Some README-described REST translation wiring is not present in the sampled controller excerpt, so that route is shown only as documented; other unsampled implementation details are omitted.
Main entry points: index.html Translation interface · SpeechWebSocketHandler.java Live speech handler · UserRepository.java User repository · TranslationRepository.java Translation repository
Components 20
Browser experience
- Translation interface
src/main/resources/static/index.html - Login interface
src/main/resources/static/login.html - Browser speech output
src/main/resources/static/index.html
Speech and translation
- WebSocket route
src/main/java/com/translator/language_translator/config/WebSocketConfig.java - Live speech handler
src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java - Vosk model manager
src/main/java/com/translator/language_translator/services/VoskModelManager.java - Speech transcription
src/main/java/com/translator/language_translator/services/SpeechService.java - Translation service
src/main/java/com/translator/language_translator/services/TranslationService.java - Translation API
src/main/java/com/translator/language_translator/controller/TranslatorController.java
Identity and security
- Registration and recovery
src/main/java/com/translator/language_translator/controller/AuthController.java - Login user lookup
src/main/java/com/translator/language_translator/services/CustomUserDetailsService.java - Session security
src/main/java/com/translator/language_translator/config/SecurityConfig.java
History and persistence
- User repository
src/main/java/com/translator/language_translator/repository/UserRepository.java - User account
src/main/java/com/translator/language_translator/model/AppUser.java - Translation repository
src/main/java/com/translator/language_translator/repository/TranslationRepository.java - Translation record
src/main/java/com/translator/language_translator/model/TranslationRecord.java
External services
- PostgreSQL
- Vosk ASR engine
- Translation APIs
Other components
- Translator user
Connections 23
- Translator user → Translation interface: records audio
README.md - Translation interface → WebSocket route: streams audio
- WebSocket route → Live speech handler: routes speech
src/main/java/com/translator/language_translator/config/WebSocketConfig.java - Live speech handler → Vosk model manager: gets model
src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java - Vosk model manager → Vosk ASR engine: loads model
src/main/java/com/translator/language_translator/services/VoskModelManager.java - Live speech handler → Translation service: translates text
src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java - Translation service → Translation APIs: requests translation
src/main/java/com/translator/language_translator/services/TranslationService.java - Translation APIs → Translation service: returns translation
- Live speech handler → Translation interface: sends results
src/main/java/com/translator/language_translator/config/SpeechWebSocketHandler.java - Translation interface → Browser speech output: speaks translation
README.md - Translation interface → Translation API: posts translation
- Translator user → Login interface: signs in
README.md - Login interface → Session security: starts session
README.md - Session security → Login user lookup: loads login user
- Login user lookup → User repository: finds account
src/main/java/com/translator/language_translator/services/CustomUserDetailsService.java - Registration and recovery → User repository: saves account
src/main/java/com/translator/language_translator/controller/AuthController.java - User repository → User account: maps accounts
src/main/java/com/translator/language_translator/repository/UserRepository.java - User repository → PostgreSQL: persists accounts
- Translation API → Translation repository: saves and reads
src/main/java/com/translator/language_translator/controller/TranslatorController.java - Translation repository → Translation record: maps records
src/main/java/com/translator/language_translator/repository/TranslationRepository.java - Translation repository → PostgreSQL: persists history
- Translation interface → Translation API: requests history
- Speech transcription → Vosk ASR engine: transcribes audio
src/main/java/com/translator/language_translator/services/SpeechService.java