31 Commits

Author SHA1 Message Date
Jose Luis Montañes Ojados
0010bc6cf7 Fix bug where disabling PTT would incorrectly stop VAD capture
All checks were successful
Build and Release / build-linux (push) Successful in 32s
Build and Release / build-windows (push) Successful in 2m20s
Build and Release / release (push) Successful in 9s
2026-01-17 17:10:21 +01:00
Jose Luis Montañes Ojados
a14d068ada Update TUI footer legend with VAD controls 2026-01-17 17:08:25 +01:00
Jose Luis Montañes Ojados
b66e0737d0 Fix deadlock on exit by making mic level updates async 2026-01-17 17:06:46 +01:00
Jose Luis Montañes Ojados
2860102627 Fix mic bar background continuity in status bar 2026-01-17 17:02:18 +01:00
Jose Luis Montañes Ojados
ebe2b26ae9 Improve microphone level sensitivity using logarithmic (dB) scaling 2026-01-17 16:41:17 +01:00
Jose Luis Montañes Ojados
356b492629 Fix Poke timeout, input CommandLow handling, and add Poke Popup
All checks were successful
Build and Release / build-linux (push) Successful in 35s
Build and Release / build-windows (push) Successful in 2m35s
Build and Release / release (push) Has been skipped
2026-01-17 15:57:34 +01:00
Jose Luis Montañes Ojados
99f26c4485 fix: restore author credits in about view 2026-01-17 03:27:18 +01:00
Jose Luis Montañes Ojados
9ed1d4f60e ci: automate release notes generation using git log
All checks were successful
Build and Release / build-linux (push) Successful in 33s
Build and Release / build-windows (push) Successful in 1m54s
Build and Release / release (push) Successful in 8s
2026-01-17 03:15:53 +01:00
Jose Luis Montañes Ojados
a639558ce4 docs: update README with new binary naming and release instructions
All checks were successful
Build and Release / build-linux (push) Successful in 34s
Build and Release / build-windows (push) Successful in 1m52s
Build and Release / release (push) Successful in 4s
2026-01-17 03:10:02 +01:00
Jose Luis Montañes Ojados
3dc4942942 ci: rename binaries to ts3-tui and improve artifact naming 2026-01-17 03:09:31 +01:00
Jose Luis Montañes Ojados
ed8f9a4538 ci: set linux job to run on x86_64 host runner
All checks were successful
Build and Release / build-linux (push) Successful in 34s
Build and Release / build-windows (push) Successful in 1m54s
Build and Release / release (push) Successful in 29s
2026-01-17 02:54:39 +01:00
Jose Luis Montañes Ojados
1283fdc9c4 ci: consolidate build workflows and automate Gitea releases 2026-01-17 02:54:04 +01:00
Jose Luis Montañes Ojados
71017f1e61 ci: add architecture suffixes and document WSL2 runner setup 2026-01-17 02:47:15 +01:00
Jose Luis Montañes Ojados
81d73e9b08 ci: disable go cache to prevent hangs on self-hosted runner
All checks were successful
Build Linux / build-linux (push) Successful in 57s
Build Windows / build-windows (push) Successful in 2m19s
2026-01-17 02:40:11 +01:00
Jose Luis Montañes Ojados
36111ff781 fix: linux arm64 build error (Dup2 is not available, use unix.Dup2) 2026-01-17 02:38:50 +01:00
Jose Luis Montañes Ojados
3a1db4e80c ci: bundle required DLLs in Windows artifact 2026-01-17 02:38:03 +01:00
Jose Luis Montañes Ojados
7284b9d4b9 ci: downgrade upload-artifact to v3 for Gitea compatibility
Some checks failed
Build Linux / build-linux (push) Failing after 5m46s
Build Windows / build-windows (push) Has been cancelled
2026-01-17 02:31:21 +01:00
Jose Luis Montañes Ojados
206f158c8e ci: fix dependencies and Go path for Gitea Actions
Some checks failed
Build Windows / build-windows (push) Failing after 2m16s
Build Linux / build-linux (push) Has been cancelled
2026-01-17 02:28:13 +01:00
Jose Luis Montañes Ojados
2cd818c331 ci: fix Gitea CI workflows to build the TUI application for Linux and Windows.
Some checks failed
Build Windows / build-windows (push) Failing after 1m56s
Build Linux / build-linux (push) Has been cancelled
2026-01-17 02:24:02 +01:00
Jose Luis Montañes Ojados
952552302a ci: add Linux and Windows build workflow for Gitea Actions
Some checks failed
Build Windows / build-windows (push) Failing after 5m13s
Build Linux / build-linux (push) Failing after 6m41s
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 5s
2026-01-17 02:15:39 +01:00
Jose Luis Montañes Ojados
b6224cd2fd feat: Add Gitea Actions demo workflow.
All checks were successful
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 5s
2026-01-17 02:05:54 +01:00
Jose Luis Montañes Ojados
5ff7affd95 style: update About view credits format 2026-01-17 02:01:49 +01:00
Jose Luis Montañes Ojados
6ae4d39b92 refactor: move PowerShell scripts to a dedicated scripts/ directory and remove unused timestamp.go. 2026-01-17 01:50:54 +01:00
Jose Luis Montañes Ojados
d7eb34c7d4 feat: Add VS Code Go development settings for tool environment variables and gopls configuration. 2026-01-17 01:49:11 +01:00
Jose Luis Montañes Ojados
46fe506585 docs: add VS Code development guide to readme 2026-01-17 01:48:20 +01:00
Jose Luis Montañes Ojados
b067dbb7bf docs: add linux dependencies and wsl2 audio setup to readme 2026-01-17 01:39:37 +01:00
Jose Luis Montañes Ojados
7f7d62d7d8 docs: final walkthrough and task updates for audio and linux fixes 2026-01-17 01:39:09 +01:00
Jose Luis Montañes Ojados
c81f64d9ca feat: full WSL2 audio support and Windows audio stability fix 2026-01-17 01:38:13 +01:00
Jose Luis Montañes Ojados
c1bb24473e Implement spacer skipping in navigation tree 2026-01-17 00:58:55 +01:00
Jose Luis Montañes Ojados
3a57f41fc2 Implement Poke functionality, refine talking status and add local log events 2026-01-17 00:53:50 +01:00
Jose Luis Montañes Ojados
be5e26486c Implement Poke functionality with dynamic message and focus redirection 2026-01-17 00:25:42 +01:00
28 changed files with 1404 additions and 181 deletions

117
.gitea/workflows/build.yml Normal file
View File

@@ -0,0 +1,117 @@
name: Build and Release
on:
push:
branches: [master]
tags: ['v*']
jobs:
build-windows:
runs-on: windows-latest
defaults:
run:
shell: msys2 {0}
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup Go
uses: actions/setup-go@v5
with:
go-version: '1.24'
cache: false
- name: Setup MSYS2
uses: msys2/setup-msys2@v2
with:
msystem: MINGW64
path-type: inherit
update: true
install: >-
mingw-w64-x86_64-gcc
mingw-w64-x86_64-opus
mingw-w64-x86_64-opusfile
mingw-w64-x86_64-portaudio
mingw-w64-x86_64-pkgconf
zip
- name: Build TUI
run: |
export CGO_ENABLED=1
mkdir -p dist
# More descriptive name: ts3-tui
go build -o dist/ts3-tui.exe ./cmd/tui
# Copy DLLs
cp /mingw64/bin/libogg-0.dll dist/
cp /mingw64/bin/libopus-0.dll dist/
cp /mingw64/bin/libopusfile-0.dll dist/
cp /mingw64/bin/libportaudio-2.dll dist/ || true
# Create ZIP with architecture name
cd dist && zip -r ../ts3-tui-windows-x86_64.zip . *
- name: Upload Artifact
uses: actions/upload-artifact@v3
with:
name: ts3-tui-windows-zip
path: ts3-tui-windows-x86_64.zip
build-linux:
runs-on: linux-x86_64
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup Go
uses: actions/setup-go@v5
with:
go-version: '1.24'
cache: false
- name: Install Dependencies
run: |
sudo apt-get update
sudo apt-get install -y \
libportaudio2 portaudio19-dev \
libopus-dev libopusfile-dev \
libpulse-dev pkg-config gcc
- name: Build TUI
run: |
export CGO_ENABLED=1
export ARCH=$(uname -m)
mkdir -p dist
# More descriptive name: ts3-tui-linux-ARCH
go build -o dist/ts3-tui-linux-${ARCH} ./cmd/tui
- name: Upload Artifact
uses: actions/upload-artifact@v3
with:
name: ts3-tui-linux-binaries
path: dist/*
release:
needs: [build-windows, build-linux]
if: startsWith(github.ref, 'refs/tags/v')
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Generate Changelog
run: |
# Get commits since the last tag (or since the beginning)
git log --oneline $(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || git rev-list --max-parents=0 HEAD)..HEAD > changelog.txt
- name: Download Artifacts
uses: actions/download-artifact@v3
- name: Create Release
uses: softprops/action-gh-release@v1
with:
body_path: changelog.txt
files: |
ts3-tui-windows-zip/ts3-tui-windows-x86_64.zip
ts3-tui-linux-binaries/*
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

15
.vscode/settings.json vendored Normal file
View File

@@ -0,0 +1,15 @@
{
"go.toolsEnvVars": {
"CGO_ENABLED": "1",
"PATH": "D:\\esto_al_path\\msys64\\mingw64\\bin;${env:PATH}",
"PKG_CONFIG_PATH": "D:\\esto_al_path\\msys64\\mingw64\\lib\\pkgconfig"
},
"gopls": {
"formatting.gofumpt": true,
"ui.diagnostic.diagnosticsDelay": "300ms",
"build.directoryFilters": [
"-vendor"
]
},
"go.lintOnSave": "package"
}

View File

@@ -56,6 +56,9 @@ func main() {
} }
} }
// Silence noise (ALSA/PortAudio) on Linux or if debugFile is set
redirectStderr(debugFile)
// Create the TUI model // Create the TUI model
m := NewModel(*serverAddr, *nickname) m := NewModel(*serverAddr, *nickname)

View File

@@ -22,6 +22,7 @@ const (
FocusChat FocusChat
FocusInput FocusInput
FocusUserView FocusUserView
FocusAbout
) )
// ListItem represents an item in the navigation tree (Channel or User) // ListItem represents an item in the navigation tree (Channel or User)
@@ -31,6 +32,14 @@ type ListItem struct {
User *UserNode User *UserNode
} }
func (l ListItem) IsSpacer() bool {
if l.IsUser || l.Channel == nil {
return false
}
// TeamSpeak spacers usually look like [spacer0], [*spacer1], etc.
return strings.Contains(strings.ToLower(l.Channel.Name), "[spacer")
}
// ChatMessage represents a message in the chat // ChatMessage represents a message in the chat
type ChatMessage struct { type ChatMessage struct {
Time time.Time Time time.Time
@@ -71,6 +80,7 @@ type Model struct {
// UI State // UI State
focus Focus focus Focus
lastFocus Focus // To return from About view
width, height int width, height int
channels []ChannelNode channels []ChannelNode
items []ListItem // Flattened list for navigation items []ListItem // Flattened list for navigation
@@ -87,12 +97,20 @@ type Model struct {
talkingClients map[uint16]bool // ClientID -> isTalking talkingClients map[uint16]bool // ClientID -> isTalking
// Audio state // Audio state
audioPlayer *audio.Player audioPlayer *audio.Player
audioCapturer *audio.Capturer audioCapturer *audio.Capturer
playbackVol int // 0-100 playbackVol int // 0-100
micLevel int // 0-100 (current input level) micLevel int // 0-100 (current input level)
isMuted bool // Mic muted isMuted bool // Mic muted
isPTT bool // Push-to-talk active isPTT bool // Push-to-talk active (Manual TX)
vadEnabled bool // Voice Activation Detection active
vadThreshold int // 0-100 threshold for VAD
vadLastTriggered time.Time // Last time VAD threshold was exceeded
// Popup State
showPokePopup bool
pokePopupSender string
pokePopupMessage string
// Program reference for sending messages from event handlers // Program reference for sending messages from event handlers
program *tea.Program program *tea.Program
@@ -101,6 +119,7 @@ type Model struct {
// User View // User View
showUserView bool showUserView bool
viewUser *UserNode viewUser *UserNode
pokeID uint16 // Target ID for pending poke
} }
// addLog adds a message to the log panel // addLog adds a message to the log panel
@@ -124,6 +143,8 @@ func NewModel(serverAddr, nickname string) *Model {
logMessages: []string{"Starting..."}, logMessages: []string{"Starting..."},
talkingClients: make(map[uint16]bool), talkingClients: make(map[uint16]bool),
playbackVol: 80, // Default 80% volume playbackVol: 80, // Default 80% volume
vadEnabled: true,
vadThreshold: 50,
} }
} }
@@ -182,6 +203,16 @@ type clientLeftMsg struct {
clientID uint16 clientID uint16
} }
type clientMovedMsg struct {
clientID uint16
channelID uint64
}
type pokeMsg struct {
senderName string
message string
}
type chatMsg struct { type chatMsg struct {
senderID uint16 senderID uint16
senderName string senderName string
@@ -239,6 +270,20 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
m.audioPlayer.PlayPCM(e.SenderID, e.PCM) m.audioPlayer.PlayPCM(e.SenderID, e.PCM)
} }
}) })
m.client.On(ts3client.EventClientMoved, func(e *ts3client.ClientMovedEvent) {
m.program.Send(clientMovedMsg{
clientID: e.ClientID,
channelID: e.ChannelID,
})
})
m.client.On(ts3client.EventPoke, func(e *ts3client.PokeEvent) {
m.program.Send(pokeMsg{
senderName: e.SenderName,
message: e.Message,
})
})
} }
// Initialize audio player // Initialize audio player
@@ -259,16 +304,53 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
} else { } else {
m.audioCapturer = capturer m.audioCapturer = capturer
// Set callback to send audio to server when PTT is active // Set callback to send audio to server when PTT is active
// Set callback to send audio to server when PTT is active
m.audioCapturer.SetCallback(func(samples []int16) { m.audioCapturer.SetCallback(func(samples []int16) {
if m.isPTT && m.client != nil && !m.isMuted { // Calculate level of this frame for VAD decision
// Note: GetLevel() is smoothed, we might want instant frame level for VAD trigger?
// But pkg/audio/level.go is efficient. Let's re-calculate for precision.
level := audio.CalculateRMSLevel(samples)
// Determine if we should transmit
shouldTransmit := false
// Manual PTT (Locked on with 'v')
if m.isPTT {
shouldTransmit = true
}
// VAD Logic
if m.vadEnabled && !m.isMuted {
if level > m.vadThreshold {
shouldTransmit = true
m.vadLastTriggered = time.Now()
} else if !m.vadLastTriggered.IsZero() && time.Since(m.vadLastTriggered) < 1*time.Second {
// Hold VAD open for 1 second (decay)
shouldTransmit = true
}
}
// Allow transmission if forced or VAD triggered
if shouldTransmit && m.client != nil && !m.isMuted {
m.client.SendAudio(samples) m.client.SendAudio(samples)
} }
// Update mic level for display
// Update mic level for display (use the calculated level)
if m.program != nil { if m.program != nil {
m.program.Send(micLevelMsg(m.audioCapturer.GetLevel())) // Use goroutine to prevent blocking the capture loop if the UI is busy (e.g. shutting down)
go m.program.Send(micLevelMsg(level))
} }
}) })
m.addLog("Audio capturer initialized") m.addLog("Audio capturer initialized")
// Start capture immediately if VAD is enabled or PTT is active
if m.vadEnabled || m.isPTT {
if err := m.audioCapturer.Start(); err != nil {
m.addLog("Error starting audio capture: %v", err)
} else {
m.addLog("Audio capture started (VAD/PTT active)")
}
}
} }
// Connect asynchronously // Connect asynchronously
@@ -308,16 +390,7 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
} }
} }
// Update mic level when PTT is active (multiply for better visibility) // Legacy mic level handling removed to support VAD event-driven updates
if m.isPTT && m.audioCapturer != nil {
level := m.audioCapturer.GetLevel() * 4 // Boost for visibility
if level > 100 {
level = 100
}
m.micLevel = level
} else {
m.micLevel = 0 // Reset when not transmitting
}
// Continue ticking (100ms for responsive mic level) // Continue ticking (100ms for responsive mic level)
return m, tea.Tick(100*time.Millisecond, func(t time.Time) tea.Msg { return m, tea.Tick(100*time.Millisecond, func(t time.Time) tea.Msg {
@@ -348,6 +421,36 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
} }
return m, nil return m, nil
case clientMovedMsg:
if msg.clientID == m.selfID {
chName := "Unknown"
if ch := m.client.GetChannel(msg.channelID); ch != nil {
chName = ch.Name
}
m.chatMessages = append(m.chatMessages, ChatMessage{
Time: time.Now(),
Sender: "SYSTEM",
Content: fmt.Sprintf("You moved to channel: %s", chName),
})
}
return m, nil
case pokeMsg:
// Append to chat as well
m.chatMessages = append(m.chatMessages, ChatMessage{
Time: time.Now(),
Sender: "POKE",
Content: fmt.Sprintf("[%s]: %s", msg.senderName, msg.message),
})
m.addLog("Received poke from %s: %s", msg.senderName, msg.message)
// Trigger Popup
m.showPokePopup = true
m.pokePopupSender = msg.senderName
m.pokePopupMessage = msg.message
return m, nil
case chatMsg: case chatMsg:
m.chatMessages = append(m.chatMessages, ChatMessage{ m.chatMessages = append(m.chatMessages, ChatMessage{
Time: time.Now(), Time: time.Now(),
@@ -455,11 +558,50 @@ func (m *Model) updateChannelList(channels []*ts3client.Channel) {
} }
} }
} }
// Ensure selectedIdx is valid (not on a spacer)
if len(m.items) > 0 {
if m.selectedIdx >= len(m.items) {
m.selectedIdx = len(m.items) - 1
}
// If current is a spacer, find next valid one
if m.items[m.selectedIdx].IsSpacer() {
found := false
// Try going down
for i := m.selectedIdx; i < len(m.items); i++ {
if !m.items[i].IsSpacer() {
m.selectedIdx = i
found = true
break
}
}
// If not found, try going up
if !found {
for i := m.selectedIdx; i >= 0; i-- {
if !m.items[i].IsSpacer() {
m.selectedIdx = i
break
}
}
}
}
}
} }
func (m *Model) handleKeyPress(msg tea.KeyMsg) (tea.Model, tea.Cmd) { func (m *Model) handleKeyPress(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
key := msg.String()
// Global Key Handling for Popup
if m.showPokePopup {
if key == "esc" || key == "enter" || key == "q" {
m.showPokePopup = false
}
return m, nil
}
// 1. Absolute Globals (Always active) // 1. Absolute Globals (Always active)
switch msg.String() { switch key {
case "ctrl+c": case "ctrl+c":
if m.client != nil { if m.client != nil {
m.client.Disconnect() m.client.Disconnect()
@@ -475,7 +617,16 @@ func (m *Model) handleKeyPress(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
case "tab": case "tab":
// Cycle focus // Cycle focus
m.focus = (m.focus + 1) % 3 m.focus = (m.focus + 1) % 4 // FocusChannels, FocusChat, FocusInput, FocusUserView
return m, nil
case "f1":
if m.focus == FocusAbout {
m.focus = m.lastFocus
} else {
m.lastFocus = m.focus
m.focus = FocusAbout
}
return m, nil return m, nil
} }
@@ -485,8 +636,8 @@ func (m *Model) handleKeyPress(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
return m.handleInputKeys(msg) return m.handleInputKeys(msg)
} }
// 3. Global Shortcuts (Only when NOT in Input) // 3. Global Shortcuts (Only when NOT in Input or About)
if m.focus != FocusInput && m.focus != FocusUserView { if m.focus != FocusInput && m.focus != FocusUserView && m.focus != FocusAbout {
switch msg.String() { switch msg.String() {
case "q": case "q":
// Quit (same as ctrl+c) // Quit (same as ctrl+c)
@@ -531,16 +682,58 @@ func (m *Model) handleKeyPress(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
} }
return m, nil return m, nil
case "ctrl+up", "ctrl+right":
// Increase VAD threshold
m.vadThreshold += 5
if m.vadThreshold > 100 {
m.vadThreshold = 100
}
m.addLog("VAD Threshold: %d", m.vadThreshold)
return m, nil
case "ctrl+down", "ctrl+left":
// Decrease VAD threshold
m.vadThreshold -= 5
if m.vadThreshold < 0 {
m.vadThreshold = 0
}
m.addLog("VAD Threshold: %d", m.vadThreshold)
return m, nil
case "g", "G":
// Toggle VAD (Gate)
m.vadEnabled = !m.vadEnabled
state := "OFF"
if m.vadEnabled {
state = "ON"
// Ensure capturer is running if VAD is on
if m.audioCapturer != nil && !m.audioCapturer.IsRunning() {
if err := m.audioCapturer.Start(); err != nil {
m.addLog("Error starting VAD capture: %v", err)
}
}
} else {
// Stop if PTT is also off
if !m.isPTT && m.audioCapturer != nil && m.audioCapturer.IsRunning() {
m.audioCapturer.Stop()
}
}
m.addLog("Voice Activation (Gate): %s", state)
return m, nil
case "v", "V": case "v", "V":
// Toggle voice (PTT) // Toggle voice (PTT)
m.isPTT = !m.isPTT m.isPTT = !m.isPTT
if m.isPTT { if m.isPTT {
if m.audioCapturer != nil { if m.audioCapturer != nil && !m.audioCapturer.IsRunning() {
m.audioCapturer.Start() if err := m.audioCapturer.Start(); err != nil {
m.addLog("Audio capture error: %v", err)
}
} }
m.addLog("🎤 Transmitting...") m.addLog("🎤 Transmitting...")
} else { } else {
if m.audioCapturer != nil { // Stop only if VAD is also off
if !m.vadEnabled && m.audioCapturer != nil && m.audioCapturer.IsRunning() {
m.audioCapturer.Stop() m.audioCapturer.Stop()
} }
m.addLog("🎤 Stopped transmitting") m.addLog("🎤 Stopped transmitting")
@@ -564,11 +757,20 @@ func (m *Model) handleKeyPress(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
return m.handleChatKeys(msg) return m.handleChatKeys(msg)
case FocusUserView: case FocusUserView:
return m.handleUserViewKeys(msg) return m.handleUserViewKeys(msg)
case FocusAbout:
return m.handleAboutViewKeys(msg)
} }
return m, nil return m, nil
} }
func (m *Model) handleChatKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) { func (m *Model) handleChatKeys(_ tea.KeyMsg) (tea.Model, tea.Cmd) {
return m, nil
}
func (m *Model) handleAboutViewKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
if msg.String() == "esc" || msg.String() == "f1" {
m.focus = m.lastFocus
}
return m, nil return m, nil
} }
@@ -588,6 +790,13 @@ func (m *Model) handleUserViewKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
m.focus = FocusChannels m.focus = FocusChannels
m.showUserView = false m.showUserView = false
case "1":
// Initiate Poke: set target, clear input, and focus it
m.pokeID = u.ID
m.focus = FocusInput
m.inputText = ""
m.addLog("Write poke message for %s and press Enter...", u.Nickname)
case "2": case "2":
// Toggle mute for this user // Toggle mute for this user
_, muted := m.audioPlayer.GetUserSettings(u.ID) _, muted := m.audioPlayer.GetUserSettings(u.ID)
@@ -618,17 +827,37 @@ func (m *Model) handleUserViewKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
func (m *Model) handleChannelKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) { func (m *Model) handleChannelKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
switch msg.String() { switch msg.String() {
case "up", "k": case "up", "k":
if m.selectedIdx > 0 { for m.selectedIdx > 0 {
m.selectedIdx-- m.selectedIdx--
if !m.items[m.selectedIdx].IsSpacer() {
break
}
// If we hit the top and it's a spacer, we might need to go down to find the first valid one
if m.selectedIdx == 0 && m.items[m.selectedIdx].IsSpacer() {
// Search forward for the first valid one
for i := 0; i < len(m.items); i++ {
if !m.items[i].IsSpacer() {
m.selectedIdx = i
break
}
}
break
}
} }
case "down", "j": case "down", "j":
if m.selectedIdx < len(m.items)-1 { for m.selectedIdx < len(m.items)-1 {
m.selectedIdx++ m.selectedIdx++
if !m.items[m.selectedIdx].IsSpacer() {
break
}
} }
case "enter": case "enter":
// Join selected channel OR open user view // Join selected channel OR open user view
if m.selectedIdx < len(m.items) && m.client != nil { if m.selectedIdx < len(m.items) && m.client != nil {
item := m.items[m.selectedIdx] item := m.items[m.selectedIdx]
if item.IsSpacer() {
return m, nil // Do nothing for spacers
}
if !item.IsUser { if !item.IsUser {
// Channel // Channel
ch := item.Channel ch := item.Channel
@@ -656,11 +885,27 @@ func (m *Model) handleInputKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
switch msg.String() { switch msg.String() {
case "enter": case "enter":
if m.inputText != "" && m.client != nil { if m.inputText != "" && m.client != nil {
m.client.SendChannelMessage(m.inputText) if m.pokeID != 0 {
err := m.client.Poke(m.pokeID, m.inputText)
if err != nil {
m.addLog("Error poking client %d: %v", m.pokeID, err)
} else {
m.addLog("Poke sent!")
}
m.pokeID = 0
m.focus = FocusUserView
} else {
m.client.SendChannelMessage(m.inputText)
}
m.inputText = "" m.inputText = ""
} }
case "esc": case "esc":
m.focus = FocusChannels if m.pokeID != 0 {
m.pokeID = 0
m.focus = FocusUserView
} else {
m.focus = FocusChannels
}
m.inputText = "" m.inputText = ""
case "backspace": case "backspace":
if len(m.inputText) > 0 { if len(m.inputText) > 0 {
@@ -688,6 +933,36 @@ func (m *Model) handleInputKeys(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
// View renders the UI // View renders the UI
func (m *Model) View() string { func (m *Model) View() string {
if m.showPokePopup {
boxStyle := lipgloss.NewStyle().
Border(lipgloss.DoubleBorder()).
BorderForeground(lipgloss.Color("196")). // Red for Poke
Padding(1, 2).
Width(50).
Align(lipgloss.Center)
titleStyle := lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("226")).MarginBottom(1)
senderStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("208")).Bold(true)
msgStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("255")).Italic(true)
helpStyle := lipgloss.NewStyle().Faint(true).MarginTop(2)
content := lipgloss.JoinVertical(lipgloss.Center,
titleStyle.Render("YOU WERE POKED!"),
"",
fmt.Sprintf("From: %s", senderStyle.Render(m.pokePopupSender)),
"",
msgStyle.Render(fmt.Sprintf("%q", m.pokePopupMessage)),
"",
helpStyle.Render("(Press Esc/Enter to close)"),
)
return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, boxStyle.Render(content))
}
if m.focus == FocusAbout {
return m.renderAboutView()
}
if m.width == 0 { if m.width == 0 {
return "Loading..." return "Loading..."
} }
@@ -794,7 +1069,11 @@ func (m *Model) View() string {
} }
// Input // Input
inputContent := "> " + m.inputText prompt := "> "
if m.pokeID != 0 {
prompt = "[Poke Message] > "
}
inputContent := prompt + m.inputText
if m.focus == FocusInput { if m.focus == FocusInput {
inputStyle = inputStyle.BorderForeground(lipgloss.Color("212")) inputStyle = inputStyle.BorderForeground(lipgloss.Color("212"))
inputContent += "█" inputContent += "█"
@@ -806,7 +1085,7 @@ func (m *Model) View() string {
if m.showLog { if m.showLog {
logHelp = "L chat" logHelp = "L chat"
} }
help := lipgloss.NewStyle().Faint(true).Render(fmt.Sprintf("↑↓ navigate │ Enter join │ Tab switch │ %s │ V talk │ M mute │ +/- vol │ q quit", logHelp)) help := lipgloss.NewStyle().Faint(true).Render(fmt.Sprintf("↑↓ nav │ Ent join │ Tab switch │ %s │ V PTT │ G VAD │ ^↕↔ thresh │ M mute │ +/- vol │ q quit", logHelp))
// Combine panels // Combine panels
panels := lipgloss.JoinHorizontal(lipgloss.Top, channelPanel, rightPanel) panels := lipgloss.JoinHorizontal(lipgloss.Top, channelPanel, rightPanel)
@@ -849,12 +1128,85 @@ func (m *Model) renderStatusBar() string {
} }
volPart := fmt.Sprintf("%s:%s%d%%", muteIcon, volBar, m.playbackVol) volPart := fmt.Sprintf("%s:%s%d%%", muteIcon, volBar, m.playbackVol)
micBar := audio.LevelToBar(m.micLevel, 6) // Custom Mic Bar with VAD Threshold
pttIcon := "MIC" micBarWidth := 8
if m.isPTT { var micBar string
pttIcon = "*TX*"
if m.vadEnabled {
// Calculate threshold position
threshPos := m.vadThreshold * micBarWidth / 100
if threshPos >= micBarWidth {
threshPos = micBarWidth - 1
}
// Calculate filled position based on current level
filled := m.micLevel * micBarWidth / 100
// Build bar
var sb strings.Builder
for i := 0; i < micBarWidth; i++ {
char := "░"
if i < filled {
char = "█"
}
// Overlay threshold marker
if i == threshPos {
if i < filled {
// Threshold is met
char = "▓"
} else {
// Threshold not met
char = "│"
}
}
sb.WriteString(char)
}
micBar = sb.String()
} else {
micBar = audio.LevelToBar(m.micLevel, micBarWidth)
} }
micPart := fmt.Sprintf("%s:%s", pttIcon, micBar)
pttStyle := lipgloss.NewStyle()
pttIcon := "MIC"
if m.isPTT {
pttIcon = " ON" // Manual ON
pttStyle = pttStyle.Foreground(lipgloss.Color("196")).Bold(true) // Red
} else if m.vadEnabled {
pttIcon = "VAD"
// Check if actively transmitting (using logic with decay)
isTransmitting := false
if !m.isMuted {
if m.micLevel > m.vadThreshold {
isTransmitting = true
} else if !m.vadLastTriggered.IsZero() && time.Since(m.vadLastTriggered) < 1*time.Second {
isTransmitting = true
}
}
if isTransmitting {
// Transmitting via VAD: Red/Bold
pttStyle = pttStyle.Foreground(lipgloss.Color("196")).Bold(true)
} else {
// Idle VAD: Gray/Faint
pttStyle = pttStyle.Foreground(lipgloss.Color("240")).Faint(true)
}
} else {
// Standard Mic (PTT mode but off)
pttStyle = pttStyle.Foreground(lipgloss.Color("255")) // White
}
// Apply status bar background color to prevent cutting
pttStyle = pttStyle.Background(lipgloss.Color("57")) // Matches Top Bar Background
// Style for the bar itself to maintain background continuity
barStyle := lipgloss.NewStyle().Background(lipgloss.Color("57")).Foreground(lipgloss.Color("255"))
micPart := fmt.Sprintf("%s%s%s",
pttStyle.Render(pttIcon),
barStyle.Render(":"),
barStyle.Render(micBar))
rightPart := fmt.Sprintf("%s | %s ", volPart, micPart) rightPart := fmt.Sprintf("%s | %s ", volPart, micPart)
@@ -1062,7 +1414,7 @@ func (m *Model) renderUserView() string {
fmt.Sprintf("%s %s", labelStyle.Render("Local Mute:"), muteStr), fmt.Sprintf("%s %s", labelStyle.Render("Local Mute:"), muteStr),
"", "",
"--- Menu ---", "--- Menu ---",
"1. Poke (Not Impl)", "1. Poke",
"2. Toggle Local Mute", "2. Toggle Local Mute",
"+/-: Adjust Volume", "+/-: Adjust Volume",
"", "",
@@ -1071,3 +1423,36 @@ func (m *Model) renderUserView() string {
return lipgloss.JoinVertical(lipgloss.Left, info...) return lipgloss.JoinVertical(lipgloss.Left, info...)
} }
func (m *Model) renderAboutView() string {
titleStyle := lipgloss.NewStyle().
Bold(true).
Foreground(lipgloss.Color("205")).
MarginBottom(1).
Align(lipgloss.Center)
boxStyle := lipgloss.NewStyle().
Border(lipgloss.RoundedBorder()).
BorderForeground(lipgloss.Color("62")).
Padding(2).
Width(60).
Align(lipgloss.Center)
mainContent := lipgloss.JoinVertical(lipgloss.Center,
titleStyle.Render("TS3 TUI CLIENT"),
lipgloss.NewStyle().Foreground(lipgloss.Color("250")).Render("Una terminal potente para tus comunidades."),
"",
lipgloss.NewStyle().Bold(true).Render("Realizado por JosLeDeta"),
lipgloss.NewStyle().Italic(true).Faint(true).Render("Hecho en Antigravity"),
"",
lipgloss.NewStyle().Bold(true).Render("Con la ayuda de:"),
lipgloss.NewStyle().Foreground(lipgloss.Color("212")).Render("- Gemini 3 Pro"),
lipgloss.NewStyle().Foreground(lipgloss.Color("212")).Render("- Claude Opus 4.5"),
"",
"",
lipgloss.NewStyle().Faint(true).Render("(Presiona ESC o F1 para volver)"),
)
// Center everything on screen
return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, boxStyle.Render(mainContent))
}

24
cmd/tui/noise_linux.go Normal file
View File

@@ -0,0 +1,24 @@
//go:build linux
package main
import (
"os"
"golang.org/x/sys/unix"
)
func redirectStderr(f *os.File) {
if f == nil {
// Silence altogether if no debug file
null, err := os.OpenFile(os.DevNull, os.O_WRONLY, 0)
if err == nil {
_ = unix.Dup2(int(null.Fd()), int(os.Stderr.Fd()))
}
return
}
// Redirect fd 2 (stderr) to our debug file
// This captures C-level library noise (ALSA, PortAudio) into the log
_ = unix.Dup2(int(f.Fd()), int(os.Stderr.Fd()))
}

12
cmd/tui/noise_other.go Normal file
View File

@@ -0,0 +1,12 @@
//go:build !linux
package main
import (
"os"
)
func redirectStderr(f *os.File) {
// No-op on other platforms for now
// Windows doesn't have the ALSA noise problem
}

1
go.mod
View File

@@ -13,6 +13,7 @@ require (
github.com/charmbracelet/bubbletea v1.3.10 github.com/charmbracelet/bubbletea v1.3.10
github.com/charmbracelet/lipgloss v1.1.0 github.com/charmbracelet/lipgloss v1.1.0
github.com/go-ole/go-ole v1.2.6 github.com/go-ole/go-ole v1.2.6
github.com/gordonklaus/portaudio v0.0.0-20250206071425-98a94950218b
github.com/gorilla/websocket v1.5.3 github.com/gorilla/websocket v1.5.3
github.com/moutend/go-wca v0.3.0 github.com/moutend/go-wca v0.3.0
gopkg.in/hraban/opus.v2 v2.0.0-20230925203106-0188a62cb302 gopkg.in/hraban/opus.v2 v2.0.0-20230925203106-0188a62cb302

2
go.sum
View File

@@ -20,6 +20,8 @@ github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6
github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM= github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
github.com/go-ole/go-ole v1.2.6 h1:/Fpf6oFPoeFik9ty7siob0G6Ke8QvQEuVcuChpwXzpY= github.com/go-ole/go-ole v1.2.6 h1:/Fpf6oFPoeFik9ty7siob0G6Ke8QvQEuVcuChpwXzpY=
github.com/go-ole/go-ole v1.2.6/go.mod h1:pprOEPIfldk/42T2oK7lQ4v4JSDwmV0As9GaiUsvbm0= github.com/go-ole/go-ole v1.2.6/go.mod h1:pprOEPIfldk/42T2oK7lQ4v4JSDwmV0As9GaiUsvbm0=
github.com/gordonklaus/portaudio v0.0.0-20250206071425-98a94950218b h1:WEuQWBxelOGHA6z9lABqaMLMrfwVyMdN3UgRLT+YUPo=
github.com/gordonklaus/portaudio v0.0.0-20250206071425-98a94950218b/go.mod h1:esZFQEUwqC+l76f2R8bIWSwXMaPbp79PppwZ1eJhFco=
github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg= github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY= github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=

View File

@@ -36,6 +36,7 @@ type Client struct {
PingPacketID uint16 // Type 0x04 PingPacketID uint16 // Type 0x04
PongPacketID uint16 // Type 0x05 PongPacketID uint16 // Type 0x05
AckPacketID uint16 // Type 0x06 AckPacketID uint16 // Type 0x06
AckLowPacketID uint16 // Type 0x07
// Ping RTT tracking // Ping RTT tracking
PingSentTimes map[uint16]time.Time // Map PingPacketID -> Time sent PingSentTimes map[uint16]time.Time // Map PingPacketID -> Time sent
@@ -48,10 +49,14 @@ type Client struct {
ServerName string ServerName string
// Fragment reassembly (packet queue like ts3j) // Fragment reassembly (packet queue like ts3j)
CommandQueue map[uint16]*protocol.Packet // Packets waiting for reassembly CommandQueue map[uint16]*protocol.Packet // Packets waiting for reassembly (Type 0x02)
ExpectedCommandPID uint16 // Next expected packet ID ExpectedCommandPID uint16 // Next expected packet ID (Type 0x02)
FragmentState bool // Toggle: true = collecting, false = ready FragmentState bool // Toggle: true = collecting, false = ready
CommandLowQueue map[uint16]*protocol.Packet // Packets waiting for reassembly (Type 0x03)
ExpectedCommandLowPID uint16 // Next expected packet ID (Type 0x03)
FragmentStateLow bool // Toggle: true = collecting, false = ready
// Server Data // Server Data
Channels map[uint64]*Channel Channels map[uint64]*Channel
@@ -69,17 +74,20 @@ type Client struct {
func NewClient(nickname string) *Client { func NewClient(nickname string) *Client {
return &Client{ return &Client{
Nickname: nickname, Nickname: nickname,
PacketIDCounterC2S: 1, PacketIDCounterC2S: 1,
VoicePacketID: 1, AckLowPacketID: 1,
Channels: make(map[uint64]*Channel), VoicePacketID: 1,
VoiceDecoders: make(map[uint16]*opus.Decoder), Channels: make(map[uint64]*Channel),
CommandQueue: make(map[uint16]*protocol.Packet), VoiceDecoders: make(map[uint16]*opus.Decoder),
ExpectedCommandPID: 0, CommandQueue: make(map[uint16]*protocol.Packet),
PingSentTimes: make(map[uint16]time.Time), ExpectedCommandPID: 0,
PingRTT: 0, CommandLowQueue: make(map[uint16]*protocol.Packet),
PingDeviation: 0, ExpectedCommandLowPID: 0,
done: make(chan struct{}), PingSentTimes: make(map[uint16]time.Time),
PingRTT: 0,
PingDeviation: 0,
done: make(chan struct{}),
} }
} }
@@ -134,26 +142,41 @@ func (c *Client) Connect(address string) error {
defer ticker.Stop() defer ticker.Stop()
for { for {
// Recovery from panics in the main loop
func() {
defer func() {
if r := recover(); r != nil {
log.Printf("PANIC in Client loop: %v", r)
}
}()
select {
case <-c.done:
log.Println("Client loop stopped")
return
case pkt := <-pktChan:
if pkt == nil {
// Channel closed
return
}
if err := c.handlePacket(pkt); err != nil {
log.Printf("Error handling packet: %v", err)
}
case <-ticker.C:
if !c.Connected {
return // Don't send pings if not connected yet
}
// Send KeepAlive Ping (Encrypted, No NewProtocol)
if err := c.sendPing(); err != nil {
log.Printf("Error sending Ping: %v", err)
}
}
}()
// Check if we should exit after the inner function
select { select {
case <-c.done: case <-c.done:
log.Println("Client loop stopped")
return nil return nil
case pkt := <-pktChan: default:
if pkt == nil {
// Channel closed
return nil
}
if err := c.handlePacket(pkt); err != nil {
log.Printf("Error handling packet: %v", err)
}
case <-ticker.C:
if !c.Connected {
continue // Don't send pings if not connected yet
}
// Send KeepAlive Ping (Encrypted, No NewProtocol)
if err := c.sendPing(); err != nil {
log.Printf("Error sending Ping: %v", err)
}
} }
} }
} }

View File

@@ -35,6 +35,21 @@ func sanitizeForLog(s string) string {
} }
func (c *Client) handleCommand(pkt *protocol.Packet) error { func (c *Client) handleCommand(pkt *protocol.Packet) error {
// Select the correct queue and counters based on PacketType
var queue map[uint16]*protocol.Packet
var expectedPID *uint16
var fragmentState *bool
if pkt.Header.PacketType() == protocol.PacketTypeCommandLow {
queue = c.CommandLowQueue
expectedPID = &c.ExpectedCommandLowPID
fragmentState = &c.FragmentStateLow
} else {
queue = c.CommandQueue
expectedPID = &c.ExpectedCommandPID
fragmentState = &c.FragmentState
}
// Check if Encrypted // Check if Encrypted
// PacketTypeCommand is usually encrypted. // PacketTypeCommand is usually encrypted.
// Flag check? The flag is in the Header (e.g. Unencrypted flag). // Flag check? The flag is in the Header (e.g. Unencrypted flag).
@@ -100,14 +115,14 @@ func (c *Client) handleCommand(pkt *protocol.Packet) error {
// Queue-based fragment reassembly (like ts3j) // Queue-based fragment reassembly (like ts3j)
// Store packet in queue // Store packet in queue
c.CommandQueue[pkt.Header.PacketID] = &protocol.Packet{ queue[pkt.Header.PacketID] = &protocol.Packet{
Header: pkt.Header, Header: pkt.Header,
Data: append([]byte{}, data...), // Clone data (already decrypted) Data: append([]byte{}, data...), // Clone data (already decrypted)
} }
// Try to process packets in order // Try to process packets in order
for { for {
nextPkt, ok := c.CommandQueue[c.ExpectedCommandPID] nextPkt, ok := queue[*expectedPID]
if !ok { if !ok {
// Missing packet, wait for it // Missing packet, wait for it
break break
@@ -117,16 +132,16 @@ func (c *Client) handleCommand(pkt *protocol.Packet) error {
if isFragmented { if isFragmented {
// Toggle fragment state // Toggle fragment state
c.FragmentState = !c.FragmentState *fragmentState = !*fragmentState
if c.FragmentState { if *fragmentState {
// Starting a new fragment sequence // Starting a new fragment sequence
// Don't process yet, wait for more // Don't process yet, wait for more
c.ExpectedCommandPID++ *expectedPID++
continue continue
} else { } else {
// Ending fragment sequence - reassemble all // Ending fragment sequence - reassemble all
reassembled, compressed := c.reassembleFragments() reassembled, compressed := c.reassembleFragmentsCustom(queue, *expectedPID)
if reassembled == nil { if reassembled == nil {
log.Printf("Fragment reassembly failed") log.Printf("Fragment reassembly failed")
break break
@@ -144,9 +159,9 @@ func (c *Client) handleCommand(pkt *protocol.Packet) error {
} }
} }
} }
} else if c.FragmentState { } else if *fragmentState {
// Middle fragment - keep collecting // Middle fragment - keep collecting
c.ExpectedCommandPID++ *expectedPID++
continue continue
} else { } else {
// Non-fragmented packet - process normally // Non-fragmented packet - process normally
@@ -165,10 +180,11 @@ func (c *Client) handleCommand(pkt *protocol.Packet) error {
} }
// Remove processed packet from queue // Remove processed packet from queue
delete(c.CommandQueue, c.ExpectedCommandPID) delete(queue, *expectedPID)
c.ExpectedCommandPID++ *expectedPID++
// Process the command // Process the command
// Fix: processCommand should probably handle execution
if err := c.processCommand(data, nextPkt); err != nil { if err := c.processCommand(data, nextPkt); err != nil {
log.Printf("Error processing command: %v", err) log.Printf("Error processing command: %v", err)
} }
@@ -177,16 +193,17 @@ func (c *Client) handleCommand(pkt *protocol.Packet) error {
return nil return nil
} }
// reassembleFragments collects all buffered fragments in order and returns reassembled data // reassembleFragmentsCustom collects all buffered fragments in order from the given queue
func (c *Client) reassembleFragments() ([]byte, bool) { // ending at currentPID.
func (c *Client) reassembleFragmentsCustom(queue map[uint16]*protocol.Packet, currentPID uint16) ([]byte, bool) {
var result []byte var result []byte
compressed := false compressed := false
// Find the start of the fragment sequence (scan backwards from current) // Find the start of the fragment sequence (scan backwards from current)
startPID := c.ExpectedCommandPID startPID := currentPID
for { for {
prevPID := startPID - 1 prevPID := startPID - 1
pkt, ok := c.CommandQueue[prevPID] pkt, ok := queue[prevPID]
if !ok { if !ok {
break break
} }
@@ -198,9 +215,9 @@ func (c *Client) reassembleFragments() ([]byte, bool) {
startPID = prevPID startPID = prevPID
} }
// Now collect from startPID to ExpectedCommandPID (inclusive) // Now collect from startPID to currentPID (inclusive)
for pid := startPID; pid <= c.ExpectedCommandPID; pid++ { for pid := startPID; pid <= currentPID; pid++ {
pkt, ok := c.CommandQueue[pid] pkt, ok := queue[pid]
if !ok { if !ok {
log.Printf("Missing fragment PID=%d during reassembly", pid) log.Printf("Missing fragment PID=%d during reassembly", pid)
return nil, false return nil, false
@@ -212,11 +229,11 @@ func (c *Client) reassembleFragments() ([]byte, bool) {
} }
result = append(result, pkt.Data...) result = append(result, pkt.Data...)
delete(c.CommandQueue, pid) delete(queue, pid)
} }
log.Printf("Reassembled fragments PID %d-%d, total %d bytes, compressed=%v", log.Printf("Reassembled fragments PID %d-%d, total %d bytes, compressed=%v",
startPID, c.ExpectedCommandPID, len(result), compressed) startPID, currentPID, len(result), compressed)
return result, compressed return result, compressed
} }
@@ -226,8 +243,8 @@ func (c *Client) processCommand(data []byte, pkt *protocol.Packet) error {
cmdStr := string(data) cmdStr := string(data)
// Debug: Log packet flags and raw command preview (sanitized) // Debug: Log packet flags and raw command preview (sanitized)
log.Printf("Debug Packet: Compressed=%v, Fragmented=%v, RawLen=%d, Preview=%q", log.Printf("Debug Packet: PID=%d, Compressed=%v, Fragmented=%v, RawLen=%d, Preview=%q",
pkt.Header.FlagCompressed(), pkt.Header.FlagFragmented(), len(data), pkt.Header.PacketID, pkt.Header.FlagCompressed(), pkt.Header.FlagFragmented(), len(data),
func() string { func() string {
preview := cmdStr preview := cmdStr
if len(preview) > 100 { if len(preview) > 100 {
@@ -544,6 +561,28 @@ func (c *Client) processCommand(data []byte, pkt *protocol.Packet) error {
"message": msg, "message": msg,
}) })
case "notifyclientpoke":
msg := ""
invoker := "Unknown"
var invokerID uint16
if m, ok := args["msg"]; ok {
msg = protocol.Unescape(m)
}
if name, ok := args["invokername"]; ok {
invoker = protocol.Unescape(name)
}
if iid, ok := args["invokerid"]; ok {
var id uint64
fmt.Sscanf(iid, "%d", &id)
invokerID = uint16(id)
}
log.Printf("[Poke] %s: %s", invoker, msg)
c.emitEvent("client_poke", map[string]any{
"senderID": invokerID,
"senderName": invoker,
"message": msg,
})
case "notifyservergrouplist", "notifychannelgrouplist", "notifyclientneededpermissions": case "notifyservergrouplist", "notifychannelgrouplist", "notifyclientneededpermissions":
// Ignore verbose noisy setup commands // Ignore verbose noisy setup commands
default: default:

View File

@@ -55,6 +55,46 @@ func (c *Client) handlePacket(pkt *protocol.Packet) error {
c.Conn.SendPacket(ack) c.Conn.SendPacket(ack)
return c.handleCommand(pkt)
case protocol.PacketTypeCommandLow:
// Send ACK Low
ackData := make([]byte, 2)
binary.BigEndian.PutUint16(ackData, pkt.Header.PacketID)
ack := protocol.NewPacket(protocol.PacketTypeAckLow, ackData)
// Spec/ts3j: AckLow has its own counter
c.AckLowPacketID++
ack.Header.PacketID = c.AckLowPacketID
ack.Header.ClientID = c.ClientID
// ACKs usually don't have NewProtocol flag set in Header byte
ack.Header.Type &= ^uint8(protocol.PacketFlagNewProtocol)
// ACKs for Command packets after handshake must be encrypted
key := protocol.HandshakeKey
nonce := protocol.HandshakeNonce
if c.Handshake != nil && c.Handshake.Step >= 6 && len(c.Handshake.SharedIV) > 0 {
crypto := &protocol.CryptoState{
SharedIV: c.Handshake.SharedIV,
SharedMac: c.Handshake.SharedMac,
GenerationID: 0,
}
key, nonce = crypto.GenerateKeyNonce(&ack.Header, true) // Client->Server=true
}
// Meta for Client->Server: PID(2) + CID(2) + PT(1) = 5 bytes
meta := make([]byte, 5)
binary.BigEndian.PutUint16(meta[0:2], ack.Header.PacketID)
binary.BigEndian.PutUint16(meta[2:4], ack.Header.ClientID)
meta[4] = ack.Header.Type
encData, mac, _ := protocol.EncryptEAX(key, nonce, meta, ack.Data)
ack.Data = encData
copy(ack.Header.MAC[:], mac)
// log.Printf("Sending ACK Low for server CommandLow PID=%d", pkt.Header.PacketID)
c.Conn.SendPacket(ack)
return c.handleCommand(pkt) return c.handleCommand(pkt)
case protocol.PacketTypeVoice: case protocol.PacketTypeVoice:
c.handleVoice(pkt) c.handleVoice(pkt)

View File

@@ -1,3 +1,5 @@
//go:build windows
package audio package audio
import ( import (
@@ -11,8 +13,6 @@ import (
"github.com/moutend/go-wca/pkg/wca" "github.com/moutend/go-wca/pkg/wca"
) )
const captureFrameSamples = 960 // 20ms at 48kHz
// Capturer handles WASAPI audio capture from microphone // Capturer handles WASAPI audio capture from microphone
type Capturer struct { type Capturer struct {
client *wca.IAudioClient client *wca.IAudioClient
@@ -22,6 +22,7 @@ type Capturer struct {
running bool running bool
mu sync.Mutex mu sync.Mutex
stopChan chan struct{} stopChan chan struct{}
wg sync.WaitGroup
// Callback for captured audio (called with 960-sample frames) // Callback for captured audio (called with 960-sample frames)
onAudio func(samples []int16) onAudio func(samples []int16)
@@ -136,6 +137,7 @@ func (c *Capturer) Start() error {
return fmt.Errorf("failed to start audio client: %w", err) return fmt.Errorf("failed to start audio client: %w", err)
} }
c.wg.Add(1)
go c.captureLoop() go c.captureLoop()
return nil return nil
} }
@@ -151,6 +153,7 @@ func (c *Capturer) Stop() {
c.mu.Unlock() c.mu.Unlock()
close(c.stopChan) close(c.stopChan)
c.wg.Wait() // Wait for capture loop to finish before proceeding
c.client.Stop() c.client.Stop()
} }
@@ -180,6 +183,7 @@ func (c *Capturer) IsRunning() bool {
} }
func (c *Capturer) captureLoop() { func (c *Capturer) captureLoop() {
defer c.wg.Done()
ticker := time.NewTicker(10 * time.Millisecond) // Check more often than 20ms ticker := time.NewTicker(10 * time.Millisecond) // Check more often than 20ms
defer ticker.Stop() defer ticker.Stop()

112
pkg/audio/capture_linux.go Normal file
View File

@@ -0,0 +1,112 @@
//go:build linux
package audio
import (
"fmt"
"sync"
"github.com/gordonklaus/portaudio"
)
// Capturer handles audio capture using PortAudio
type Capturer struct {
stream *portaudio.Stream
running bool
mu sync.Mutex
onAudio func(samples []int16)
currentLevel int
levelMu sync.RWMutex
}
func NewCapturer() (*Capturer, error) {
if err := initPortAudio(); err != nil {
return nil, err
}
return &Capturer{}, nil
}
func (c *Capturer) SetCallback(fn func(samples []int16)) {
c.mu.Lock()
c.onAudio = fn
c.mu.Unlock()
}
func (c *Capturer) Start() error {
c.mu.Lock()
defer c.mu.Unlock()
if c.running {
return nil
}
var err error
c.stream, err = portaudio.OpenDefaultStream(1, 0, 48000, frameSamples, c.processCapture)
if err != nil {
return fmt.Errorf("failed to open portaudio capture stream: %w", err)
}
if err := c.stream.Start(); err != nil {
c.stream.Close()
return fmt.Errorf("failed to start portaudio capture stream: %w", err)
}
c.running = true
return nil
}
func (c *Capturer) Stop() {
c.mu.Lock()
defer c.mu.Unlock()
if !c.running {
return
}
c.running = false
if c.stream != nil {
c.stream.Abort()
}
}
func (c *Capturer) Close() {
c.Stop()
c.mu.Lock()
if c.stream != nil {
c.stream.Close()
}
c.mu.Unlock()
terminatePortAudio()
}
func (c *Capturer) processCapture(in []int16) {
c.mu.Lock()
callback := c.onAudio
running := c.running
c.mu.Unlock()
if !running || callback == nil {
return
}
// Calculate level
level := CalculateRMSLevel(in)
c.levelMu.Lock()
c.currentLevel = level
c.levelMu.Unlock()
// Clone buffer and send to callback
samples := make([]int16, len(in))
copy(samples, in)
callback(samples)
}
func (c *Capturer) GetLevel() int {
c.levelMu.RLock()
defer c.levelMu.RUnlock()
return c.currentLevel
}
func (c *Capturer) IsRunning() bool {
c.mu.Lock()
defer c.mu.Unlock()
return c.running
}

13
pkg/audio/common.go Normal file
View File

@@ -0,0 +1,13 @@
package audio
// Shared constants
const (
frameSamples = 960 // 20ms at 48kHz
captureFrameSamples = 960 // 20ms at 48kHz
)
// UserSettings represents per-user audio configuration
type UserSettings struct {
Volume float32 // 0.0 - 1.0 (or higher for boost)
Muted bool
}

45
pkg/audio/global_linux.go Normal file
View File

@@ -0,0 +1,45 @@
//go:build linux
package audio
import (
"fmt"
"os"
"sync"
"github.com/gordonklaus/portaudio"
)
var (
paMu sync.Mutex
paRefCount int
)
func initPortAudio() error {
paMu.Lock()
defer paMu.Unlock()
if paRefCount == 0 {
if err := portaudio.Initialize(); err != nil {
return err
}
devices, err := portaudio.Devices()
if err == nil {
fmt.Fprintf(os.Stderr, "[Audio] Linux/PortAudio initialized globally. Devices found: %d\n", len(devices))
}
}
paRefCount++
return nil
}
func terminatePortAudio() {
paMu.Lock()
defer paMu.Unlock()
paRefCount--
if paRefCount == 0 {
fmt.Fprintf(os.Stderr, "[Audio] Linux/PortAudio terminating globally...\n")
portaudio.Terminate()
}
}

View File

@@ -4,7 +4,7 @@ import (
"math" "math"
) )
// CalculateRMSLevel calculates the RMS level of PCM samples and returns 0-100 // CalculateRMSLevel calculates the RMS level of PCM samples and returns 0-100 (Logarithmic/dB)
func CalculateRMSLevel(samples []int16) int { func CalculateRMSLevel(samples []int16) int {
if len(samples) == 0 { if len(samples) == 0 {
return 0 return 0
@@ -16,15 +16,33 @@ func CalculateRMSLevel(samples []int16) int {
} }
rms := math.Sqrt(sum / float64(len(samples))) rms := math.Sqrt(sum / float64(len(samples)))
// Normalize to 0-100 (max int16 is 32767)
level := int(rms / 32767.0 * 100.0) // Normalize to 0.0 - 1.0
val := rms / 32768.0
if val < 0.000001 { // Avoid log(0)
return 0
}
// Convert to dB
db := 20 * math.Log10(val)
// Map -50dB (silence floor) to 0dB (max) to 0-100
const minDB = -50.0
if db < minDB {
return 0
}
// Scale
level := int((db - minDB) * (100.0 / (0 - minDB)))
if level > 100 { if level > 100 {
level = 100 level = 100
} }
return level return level
} }
// CalculatePeakLevel returns the peak level of PCM samples as 0-100 // CalculatePeakLevel returns the peak level of PCM samples as 0-100 (Logarithmic/dB)
func CalculatePeakLevel(samples []int16) int { func CalculatePeakLevel(samples []int16) int {
if len(samples) == 0 { if len(samples) == 0 {
return 0 return 0
@@ -40,7 +58,26 @@ func CalculatePeakLevel(samples []int16) int {
} }
} }
return int(float64(peak) / 32767.0 * 100.0) // Normalize
val := float64(peak) / 32768.0
if val < 0.000001 {
return 0
}
db := 20 * math.Log10(val)
const minDB = -50.0
if db < minDB {
// Linear falloff for very low signals to avoid clutter
return 0
}
level := int((db - minDB) * (100.0 / (0 - minDB)))
if level > 100 {
level = 100
}
return level
} }
// LevelToBar converts a 0-100 level to a visual bar string // LevelToBar converts a 0-100 level to a visual bar string

View File

@@ -1,8 +1,11 @@
//go:build windows
package audio package audio
import ( import (
"encoding/binary" "encoding/binary"
"fmt" "fmt"
"log"
"sync" "sync"
"time" "time"
"unsafe" "unsafe"
@@ -32,19 +35,11 @@ type Player struct {
bufferMu sync.Mutex bufferMu sync.Mutex
} }
type UserSettings struct {
Volume float32 // 0.0 - 1.0 (or higher for boost)
Muted bool
}
const (
frameSamples = 960 // 20ms at 48kHz
)
// NewPlayer creates a new WASAPI audio player // NewPlayer creates a new WASAPI audio player
func NewPlayer() (*Player, error) { func NewPlayer() (*Player, error) {
// Initialize COM // Initialize COM
ole.CoInitializeEx(0, ole.COINIT_APARTMENTTHREADED) ole.CoInitializeEx(0, ole.COINIT_APARTMENTTHREADED)
log.Printf("[Audio] Windows/WASAPI initializing...")
var deviceEnumerator *wca.IMMDeviceEnumerator var deviceEnumerator *wca.IMMDeviceEnumerator
if err := wca.CoCreateInstance( if err := wca.CoCreateInstance(
@@ -255,7 +250,7 @@ func (p *Player) GetUserSettings(clientID uint16) (float32, bool) {
} }
func (p *Player) playbackLoop() { func (p *Player) playbackLoop() {
ticker := time.NewTicker(20 * time.Millisecond) ticker := time.NewTicker(10 * time.Millisecond)
defer ticker.Stop() defer ticker.Stop()
for { for {
@@ -269,79 +264,88 @@ func (p *Player) playbackLoop() {
} }
func (p *Player) writeFrame() { func (p *Player) writeFrame() {
var padding uint32 for {
if err := p.client.GetCurrentPadding(&padding); err != nil { var padding uint32
return if err := p.client.GetCurrentPadding(&padding); err != nil {
} return
}
available := p.bufferSize - padding available := p.bufferSize - padding
if available < frameSamples { if available < frameSamples {
return return
} }
p.bufferMu.Lock() p.bufferMu.Lock()
// Mix audio from all active user buffers // Mix audio from all active user buffers
mixed := make([]int32, frameSamples) mixed := make([]int32, frameSamples)
activeUsers := 0 activeUsers := 0
hasAnyAudio := false
for id, buf := range p.userBuffers { for id, buf := range p.userBuffers {
if len(buf) > 0 { if len(buf) > 0 {
activeUsers++ hasAnyAudio = true
// Take up to frameSamples from this user activeUsers++
toTake := frameSamples // Take up to frameSamples from this user
if len(buf) < frameSamples { toTake := frameSamples
toTake = len(buf) if len(buf) < frameSamples {
} toTake = len(buf)
for i := 0; i < toTake; i++ {
sample := int32(buf[i])
// Apply user volume if set
if settings, ok := p.userSettings[id]; ok {
sample = int32(float32(sample) * settings.Volume)
} }
mixed[i] += sample for i := 0; i < toTake; i++ {
} sample := int32(buf[i])
// Advance buffer // Apply user volume if set
if len(buf) <= frameSamples { if settings, ok := p.userSettings[id]; ok {
delete(p.userBuffers, id) sample = int32(float32(sample) * settings.Volume)
} else { }
p.userBuffers[id] = buf[frameSamples:]
mixed[i] += sample
}
// Advance buffer
if len(buf) <= frameSamples {
delete(p.userBuffers, id)
} else {
p.userBuffers[id] = buf[frameSamples:]
}
} }
} }
}
p.bufferMu.Unlock() p.bufferMu.Unlock()
// Get WASAPI buffer // If no audio is playing, don't write anything (keep buffer empty for lower latency when audio starts)
var buffer *byte if !hasAnyAudio {
if err := p.renderClient.GetBuffer(uint32(frameSamples), &buffer); err != nil { return
return
}
p.mu.Lock()
vol := p.volume
p.mu.Unlock()
// Write mixed samples with clipping protection and volume application
bufSlice := unsafe.Slice(buffer, int(frameSamples)*2)
for i := 0; i < int(frameSamples); i++ {
val := mixed[i]
// Apply volume
val = int32(float32(val) * vol)
// Hard clipping
if val > 32767 {
val = 32767
} else if val < -32768 {
val = -32768
} }
binary.LittleEndian.PutUint16(bufSlice[i*2:], uint16(val))
}
p.renderClient.ReleaseBuffer(uint32(frameSamples), 0) // Get WASAPI buffer
var buffer *byte
if err := p.renderClient.GetBuffer(uint32(frameSamples), &buffer); err != nil {
return
}
p.mu.Lock()
vol := p.volume
p.mu.Unlock()
// Write mixed samples with clipping protection and volume application
bufSlice := unsafe.Slice(buffer, int(frameSamples)*2)
for i := 0; i < int(frameSamples); i++ {
val := mixed[i]
// Apply master volume
val = int32(float32(val) * vol)
// Hard clipping
if val > 32767 {
val = 32767
} else if val < -32768 {
val = -32768
}
binary.LittleEndian.PutUint16(bufSlice[i*2:], uint16(val))
}
p.renderClient.ReleaseBuffer(uint32(frameSamples), 0)
}
} }

201
pkg/audio/playback_linux.go Normal file
View File

@@ -0,0 +1,201 @@
//go:build linux
package audio
import (
"fmt"
"sync"
"github.com/gordonklaus/portaudio"
)
// Player handles audio playback using PortAudio
type Player struct {
stream *portaudio.Stream
volume float32
muted bool
mu sync.Mutex
running bool
stopChan chan struct{}
// User buffers for mixing
userBuffers map[uint16][]int16
// User settings
userSettings map[uint16]*UserSettings
bufferMu sync.Mutex
}
func NewPlayer() (*Player, error) {
if err := initPortAudio(); err != nil {
return nil, err
}
p := &Player{
volume: 1.0,
muted: false,
stopChan: make(chan struct{}),
userBuffers: make(map[uint16][]int16),
userSettings: make(map[uint16]*UserSettings),
}
return p, nil
}
func (p *Player) Start() error {
p.mu.Lock()
if p.running {
p.mu.Unlock()
return nil
}
// Create stream (Mono, 48kHz, 16-bit)
// We'll use a callback-based stream for lower latency
var err error
p.stream, err = portaudio.OpenDefaultStream(0, 1, 48000, frameSamples, p.processAudio)
if err != nil {
p.mu.Unlock()
return fmt.Errorf("failed to open portaudio stream: %w", err)
}
if err := p.stream.Start(); err != nil {
p.stream.Close()
p.mu.Unlock()
return fmt.Errorf("failed to start portaudio stream: %w", err)
}
p.running = true
p.mu.Unlock()
return nil
}
func (p *Player) Stop() {
p.mu.Lock()
defer p.mu.Unlock()
if !p.running {
return
}
p.running = false
if p.stream != nil {
p.stream.Abort()
}
}
func (p *Player) Close() {
p.Stop()
p.mu.Lock()
if p.stream != nil {
p.stream.Close()
}
p.mu.Unlock()
terminatePortAudio()
}
// processAudio is the PortAudio callback
func (p *Player) processAudio(out []int16) {
p.bufferMu.Lock()
defer p.bufferMu.Unlock()
// Initial silence
for i := range out {
out[i] = 0
}
if p.muted {
return
}
p.mu.Lock()
vol := p.volume
p.mu.Unlock()
mixed := make([]int32, len(out))
for id, buf := range p.userBuffers {
if len(buf) > 0 {
toTake := len(out)
if len(buf) < toTake {
toTake = len(buf)
}
for i := 0; i < toTake; i++ {
sample := int32(buf[i])
if settings, ok := p.userSettings[id]; ok {
sample = int32(float32(sample) * settings.Volume)
}
mixed[i] += sample
}
// Advance buffer
if len(buf) <= len(out) {
delete(p.userBuffers, id)
} else {
p.userBuffers[id] = buf[len(out):]
}
}
}
// Apply master volume and clip
for i := 0; i < len(out); i++ {
val := int32(float32(mixed[i]) * vol)
if val > 32767 {
val = 32767
} else if val < -32768 {
val = -32768
}
out[i] = int16(val)
}
}
func (p *Player) PlayPCM(senderID uint16, samples []int16) {
p.bufferMu.Lock()
defer p.bufferMu.Unlock()
if settings, ok := p.userSettings[senderID]; ok && settings.Muted {
return
}
p.userBuffers[senderID] = append(p.userBuffers[senderID], samples...)
if len(p.userBuffers[senderID]) > 48000*2 {
drop := len(p.userBuffers[senderID]) - 48000
p.userBuffers[senderID] = p.userBuffers[senderID][drop:]
}
}
func (p *Player) SetVolume(vol float32) {
p.mu.Lock()
defer p.mu.Unlock()
p.volume = vol
}
func (p *Player) SetMuted(muted bool) {
p.mu.Lock()
defer p.mu.Unlock()
p.muted = muted
}
func (p *Player) SetUserVolume(clientID uint16, vol float32) {
p.bufferMu.Lock()
defer p.bufferMu.Unlock()
if _, ok := p.userSettings[clientID]; !ok {
p.userSettings[clientID] = &UserSettings{Volume: 1.0, Muted: false}
}
p.userSettings[clientID].Volume = vol
}
func (p *Player) SetUserMuted(clientID uint16, muted bool) {
p.bufferMu.Lock()
defer p.bufferMu.Unlock()
if _, ok := p.userSettings[clientID]; !ok {
p.userSettings[clientID] = &UserSettings{Volume: 1.0, Muted: false}
}
p.userSettings[clientID].Muted = muted
}
func (p *Player) GetUserSettings(clientID uint16) (float32, bool) {
p.bufferMu.Lock()
defer p.bufferMu.Unlock()
if settings, ok := p.userSettings[clientID]; ok {
return settings.Volume, settings.Muted
}
return 1.0, false
}

View File

@@ -124,6 +124,10 @@ func (c *Client) emit(event EventType, data any) {
if fn, ok := h.(func(*TalkingStatusEvent)); ok { if fn, ok := h.(func(*TalkingStatusEvent)); ok {
fn(data.(*TalkingStatusEvent)) fn(data.(*TalkingStatusEvent))
} }
case EventPoke:
if fn, ok := h.(func(*PokeEvent)); ok {
fn(data.(*PokeEvent))
}
} }
} }
} }
@@ -405,6 +409,13 @@ func (c *Client) handleInternalEvent(eventType string, data map[string]any) {
Channels: getInt(data, "channels"), Channels: getInt(data, "channels"),
}) })
case "client_poke":
c.emit(EventPoke, &PokeEvent{
SenderID: getUint16(data, "senderID"),
SenderName: getString(data, "senderName"),
Message: getString(data, "message"),
})
case "error": case "error":
c.emit(EventError, &ErrorEvent{ c.emit(EventError, &ErrorEvent{
ID: getString(data, "id"), ID: getString(data, "id"),

View File

@@ -235,6 +235,19 @@ func (c *Client) KickFromServer(clientID uint16, reason string) error {
return c.internal.SendCommand(cmd) return c.internal.SendCommand(cmd)
} }
// Poke sends a poke message to a specific client
func (c *Client) Poke(clientID uint16, message string) error {
if c.internal == nil {
return fmt.Errorf("not connected")
}
cmd := protocol.NewCommand("clientpoke")
cmd.AddParam("clid", fmt.Sprintf("%d", clientID))
cmd.AddParam("msg", message)
return c.internal.SendCommand(cmd)
}
// ============================================================================= // =============================================================================
// Info Methods // Info Methods
// ============================================================================= // =============================================================================

View File

@@ -25,8 +25,18 @@ const (
// Error events // Error events
EventError EventType = "error" EventError EventType = "error"
// Poke events
EventPoke EventType = "poke"
) )
// PokeEvent is emitted when a poke message is received
type PokeEvent struct {
SenderID uint16
SenderName string
Message string
}
// ConnectedEvent is emitted when the client successfully connects // ConnectedEvent is emitted when the client successfully connects
type ConnectedEvent struct { type ConnectedEvent struct {
ClientID uint16 ClientID uint16

122
readme.md Normal file
View File

@@ -0,0 +1,122 @@
# TeamSpeak TUI Client
A modern, fast, and lightweight TeamSpeak 3 client built in Go with a beautiful Terminal User Interface (TUI).
## 🚀 Features
- **Low Latency Audio**: Optimized for both Windows (WASAPI) and Linux (PortAudio).
- **Responsive UI**: Built with Bubble Tea for a smooth terminal experience.
- **Cross-Platform**: Full support for Windows and Linux (including WSL2).
- **Audio Controls**: Per-user volume and mute indicators.
## 🛠️ Linux Dependencies
To build the project on Linux (including Ubuntu/WSL2), you need to install the following system libraries:
```bash
sudo apt-get update
sudo apt-get install -y \
libportaudio2 \
portaudio19-dev \
libopus-dev \
libpulse-dev
```
### 🔊 WSL2 Audio Setup
WSL2 does not have direct access to your Windows audio hardware. To enable audio, we recommend using a PulseAudio network bridge:
1. **Install PulseAudio on Windows** (e.g., via [portable binaries](https://www.freedesktop.org/wiki/Software/PulseAudio/Ports/Windows/)).
2. **Enable TCP**: Edit `default.pa` in PulseAudio and add:
`load-module module-native-protocol-tcp auth-anonymous=1 listen=0.0.0.0`
3. **Environment Variable**: Set the `PULSE_SERVER` in your WSL2 shell:
```bash
export PULSE_SERVER=tcp:$(grep nameserver /etc/resolv.conf | awk '{print $2}'):4713
```
## 🏗️ Building
```bash
# General build
go build -o ts-tui ./cmd/tui
# Run with debug logging (highly recommended for audio setup)
go run ./cmd/tui --server your-ip:9987 --debug
```
## ⌨️ Common Keys
- `q`: Quit cleanly.
- `Arrows / hjkl`: Navigate channels and users.
- `Enter`: Join channel.
- `1`: Poke user (in User View).
- `m`: Mute/Unmute audio.
## 💻 Development with VS Code
This project uses Go **build tags** to support multiple platforms from the same codebase. This can sometimes cause "redeclared" errors or "undefined" symbols in VS Code if not configured correctly.
### Recommended Setup
1. **Windows + MSYS2**: If you are developing on Windows and have Opus/PortAudio installed via MSYS2, your `.vscode/settings.json` should include the paths to your MinGW64 environment:
```json
{
"go.toolsEnvVars": {
"CGO_ENABLED": "1",
"PATH": "C:\\msys64\\mingw64\\bin;${env:PATH}",
"PKG_CONFIG_PATH": "C:\\msys64\\mingw64\\lib\\pkgconfig"
}
}
```
2. **Build Tags**: Do **not** force both tags simultaneously (e.g., `-tags=linux,windows`) as this will cause "redeclared" errors for types defined in both systems (like `Player` or `Capturer`).
3. **Switching OS Analysis**: If you are on Windows but want to check for errors in the Linux files, update your settings to:
```json
"go.toolsEnvVars": { "GOOS": "linux" }
```
### Pro Tip: VS Code Remote - WSL
For the best experience when working on Linux features from Windows, use the **WSL extension**. Open VS Code inside your WSL environment (`code .` from the WSL terminal). This allows `gopls` to run directly in Linux, where all system headers and libraries are natively available.
## 🤖 Gitea Actions (CI/CD)
El archivo `.gitea/workflows/build.yml` automatiza la compilación y la creación de Releases.
1. **Builds automáticas**: Cada `push` a `master` genera artefactos descargables.
2. **Releases automáticas**: Al subir un tag (`git tag v*`), se crea una Release con:
- `ts3-tui-windows-x86_64.zip` (Portable: exe + dlls).
- `ts3-tui-linux-x86_64` (Para PC/WSL2).
- `ts3-tui-linux-aarch64` (Para ARM/Raspberry Pi).
### Cómo usar tu propio Windows como Runner
Si tu Gitea no tiene runners públicos, puedes convertir tu propia máquina Windows en uno:
1. **Descarga `act_runner`**: Descarga el binario oficial de [Gitea Actions Runner](https://gitea.com/gitea/act_runner/releases).
2. **Registro**:
- Ve a tu instancia de Gitea -> Administración del Sitio -> Actions -> Runners.
- Copia el **Registration Token**.
- Ejecuta: `./act_runner register`
- Introduce la URL de tu Gitea y el token.
- En **labels**, asegúrate de poner `windows-latest:host`.
3. **Ejecución**:
- Lanza el runner: `./act_runner daemon`.
- Ahora, cualquier push lanzará la build en tu PC de forma automática.
> [!TIP]
> El workflow usa **MSYS2** automáticamente para instalar `opus` y `portaudio` en el entorno temporal de la build, así que no necesitas configurar nada extra en el sistema del runner.
### Cómo añadir un Runner en WSL2 (para x86_64)
Si tu runner principal es ARM (como una Raspberry Pi) y quieres compilar para tu PC (x86_64), lo mejor es poner un runner dentro de WSL2:
1. **Entra en WSL2**: Ejecuta `wsl` en tu terminal.
2. **Descarga `act_runner`**:
```bash
curl -L https://gitea.com/gitea/act_runner/releases/download/v0.2.13/act_runner-0.2.13-linux-amd64 -o act_runner
chmod +x act_runner
```
3. **Registro**:
- Igual que en Windows, usa `./act_runner register` con el token de tu Gitea.
- En **labels**, pon algo como `linux-x86_64:host`.
4. **Actualiza el workflow**:
- En `.gitea/workflows/build.yml`, cambia `runs-on: ubuntu-latest` por `runs-on: linux-x86_64` en el job `build-linux`.
> [!NOTE]
> Al usar el label `:host`, el runner usará las herramientas instaladas en tu Linux de WSL2 sin necesidad de Docker, lo que lo hace mucho más rápido.

View File

@@ -3,4 +3,5 @@ $env:PKG_CONFIG_PATH = "D:\esto_al_path\msys64\mingw64\lib\pkgconfig"
Write-Host "Starting TeamSpeak Client (Windows Native)..." -ForegroundColor Cyan Write-Host "Starting TeamSpeak Client (Windows Native)..." -ForegroundColor Cyan
# go run ./cmd/client/main.go --server localhost:9987 # go run ./cmd/client/main.go --server localhost:9987
go run ./cmd/example --server localhost:9987 # go run ./cmd/example --server localhost:9987
go run ./cmd/tui --server 127.0.0.1:9987 --nickname Adam --debug

View File

@@ -1,11 +0,0 @@
package main
import (
"fmt"
"time"
)
func main() {
t, _ := time.Parse("2006-01-02 15:04:05", "2023-07-24 10:06:33")
fmt.Println(t.Unix())
}