How gamezad/ts3-mobile works
TS3 Mobile is an experimental Android TeamSpeak 3 client. Users enter server details, connect through the foreground service, browse channels and participants, join channels, and control playback and microphone settings. The service coordinates identity, protocol sessions, reconnection, and audio; the protocol adapter handles TeamSpeak session events, while audio-opus supplies voice encoding and playback. The README documents additional capabilities beyond the sampled code; links for those are shown only where documentation supports them.
Main entry points: TeamSpeakService.kt Foreground service · Ts3jSessionClient.kt ts3j adapter · MainActivity.kt Activity · OpusMicrophoneCapture.kt Microphone capture
Components 22
Android app
- Activity
app/src/main/java/io/github/ts3mobile/app/MainActivity.kt - Connection form
app/src/main/java/io/github/ts3mobile/app/MainViewModel.kt - Main screen
app/src/main/java/io/github/ts3mobile/app/ui/MainScreen.kt - Foreground service
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Service state
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakServiceState.kt - Reconnect policy
app/src/main/java/io/github/ts3mobile/app/service/ReconnectPolicy.kt
TeamSpeak protocol
- Session client API
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Ts3SessionClient.kt - ts3j adapter
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Ts3jSessionClient.kt - Snapshot store
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/SessionSnapshotStore.kt - Channel ordering
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/ChannelTree.kt - Session models
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Model.kt - Identity codec
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Ts3IdentityCodec.kt
Voice audio
- Audio routing
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/AudioDeviceRouter.kt - Voice playback
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/OpusAudioPlayer.kt - Opus decoder
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/NativeOpusDecoder.kt - Participant mixer
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/ParticipantGainMixer.kt - Microphone capture
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/OpusMicrophoneCapture.kt - Opus encoder
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/NativeOpusEncoder.kt - RNNoise processor
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/NativeRnNoiseProcessor.kt
Identity security
- Identity vault
app/src/main/java/io/github/ts3mobile/app/identity/IdentityVault.kt
Other components
- User
- TeamSpeak server
Connections 25
- User → Activity: uses
README.md - Activity → Connection form: updates form
app/src/main/java/io/github/ts3mobile/app/MainActivity.kt - Activity → Main screen: renders
app/src/main/java/io/github/ts3mobile/app/MainActivity.kt - Activity → Foreground service: starts and binds
app/src/main/java/io/github/ts3mobile/app/MainActivity.kt - Main screen → Channel ordering: orders channels
app/src/main/java/io/github/ts3mobile/app/ui/MainScreen.kt - Foreground service → Service state: publishes state
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Foreground service → Reconnect policy: applies backoff
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Foreground service → Identity vault: loads identity
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Identity vault → Identity codec: generates identity
app/src/main/java/io/github/ts3mobile/app/identity/IdentityVault.kt - Foreground service → Session client API: controls session
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Session client API → ts3j adapter: implemented by
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Ts3jSessionClient.kt - ts3j adapter → TeamSpeak server: connects and transmits
README.md - ts3j adapter → Snapshot store: updates and reads
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Ts3jSessionClient.kt - ts3j adapter → Identity codec: uses identity
ts3-protocol/src/main/kotlin/io/github/ts3mobile/protocol/Ts3jSessionClient.kt - ts3j adapter → Session models: maps session data
- Main screen → Session models: displays roster
- Foreground service → Audio routing: controls routing
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Foreground service → Voice playback: controls playback
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - ts3j adapter → Voice playback: delivers voice frames
- Voice playback → Opus decoder: decodes packets
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/OpusAudioPlayer.kt - Voice playback → Participant mixer: applies participant gains
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/OpusAudioPlayer.kt - Foreground service → Microphone capture: controls transmission
app/src/main/java/io/github/ts3mobile/app/service/TeamSpeakService.kt - Microphone capture → Opus encoder: encodes frames
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/OpusMicrophoneCapture.kt - Microphone capture → RNNoise processor: denoises audio
audio-opus/src/main/java/io/github/ts3mobile/audio/opus/OpusMicrophoneCapture.kt - Microphone capture → Session client API: provides voice source