Add voice recording

Tools > Start Recording / Start Multitrack Recording / Stop Recording
record what is heard on the server, our own voice included, into Ogg
Opus, and publish client_is_recording. A plain recording mixes everyone
down to mono; a multitrack one gives each speaker (by unique id) an
uncoupled mono stream of their own under channel mapping family 255,
named in the tags after their nickname when the recording started,
silent until they first speak, and continuing into name-2.ogg past 255
speakers. Tracks are spooled beside the output and muxed on stop, since
the header carries the channel count.

The status bar shows a label that stops the recording; the existing
recording hotkeys start one straight into the last-used folder.
OggOpusFile now shares the new Ogg page writer and Opus header code.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-04 14:57:51 +00:00
co-authored by Claude Opus 5.5
parent 93e0b36083
commit dc413f4975
26 changed files with 1721 additions and 94 deletions
@@ -93,6 +93,12 @@ final class HotkeyActions implements HotkeyEngine.Handler {
case NICKNAME_CHANGE -> frame.changeNickname(hotkey.argument);
case RECORDING_START -> startRecording(targets, false);
case RECORDING_START_MULTITRACK -> startRecording(targets, true);
case RECORDING_STOP -> {
for (ServerTab tab : targets) tab.session().stopRecording();
}
case FILEBROWSER -> frame.browseCurrentChannel();
case SKIN_RELOAD -> frame.reloadSkin();
case BRING_TO_FRONT -> frame.bringToFront();
@@ -104,6 +110,10 @@ final class HotkeyActions implements HotkeyEngine.Handler {
}
}
private void startRecording(List<ServerTab> targets, boolean multitrack) {
for (ServerTab tab : targets) frame.recordings().startNow(tab.session(), multitrack);
}
private void setMicMuted(List<ServerTab> targets, boolean muted) {
for (ServerTab tab : targets) tab.session().setMicMuted(muted);
frame.refreshAfterHotkey();
@@ -59,6 +59,7 @@ import java.util.concurrent.atomic.AtomicBoolean;
public final class MainFrame extends JFrame implements ServerTabPane.Listener {
private final Settings settings;
private final RecordingActions recordings;
private final Bookmarks bookmarks = Bookmarks.load();
private final AwayMessages awayMessages = AwayMessages.load();
private final IdentityStore identities;
@@ -105,6 +106,7 @@ public final class MainFrame extends JFrame implements ServerTabPane.Listener {
public MainFrame(Settings settings) {
super("TS3J — TeamSpeak 3 Java Client");
this.settings = settings;
this.recordings = new RecordingActions(this, settings);
this.chatZoom = new TextZoom(settings.chatZoom, z -> {
settings.chatZoom = z;
settings.save();
@@ -164,7 +166,9 @@ public final class MainFrame extends JFrame implements ServerTabPane.Listener {
if (selected != null) selected.chat().openFind();
}
});
statusBar = new StatusBar();
statusBar = new StatusBar(() -> {
if (selected != null) selected.session().stopRecording();
});
statusBar.setVisible(settings.showStatusBar);
add(statusBar, BorderLayout.SOUTH);
@@ -298,6 +302,21 @@ public final class MainFrame extends JFrame implements ServerTabPane.Listener {
showContacts(null);
}
@Override
public boolean isRecording() {
return selected != null && selected.session().isRecording();
}
@Override
public void onStartRecording(boolean multitrack) {
if (selected != null) recordings.choose(selected.session(), multitrack);
}
@Override
public void onStopRecording() {
if (selected != null) selected.session().stopRecording();
}
@Override
public boolean canViewBanList() {
return selected != null && selected.session().canViewBanList();
@@ -588,6 +607,10 @@ public final class MainFrame extends JFrame implements ServerTabPane.Listener {
return out;
}
RecordingActions recordings() {
return recordings;
}
ServerTab selectedTab() {
return selected;
}
@@ -1004,6 +1027,7 @@ public final class MainFrame extends JFrame implements ServerTabPane.Listener {
toolbar.refresh(connected, anyConnected, micMuted, deaf, active, away);
toolbar.showHostButton(hostButtonOf(selected));
menuBar.refresh(connected, anyConnected, micMuted, deaf, active, away, commander);
statusBar.showRecording(connected && selected.session().isRecording());
updateTray();
}
@@ -76,6 +76,13 @@ final class MainMenuBar extends JMenuBar {
void onShowContacts();
/** Whether the current tab is recording; asked as the Tools menu opens. */
boolean isRecording();
void onStartRecording(boolean multitrack);
void onStopRecording();
/** Whether the current server lets us read its ban list; asked as the Tools menu opens. */
boolean canViewBanList();
@@ -125,6 +132,9 @@ final class MainMenuBar extends JMenuBar {
private JMenuItem phoneticItem;
private JMenuItem avatarItem;
private JMenuItem deleteAvatarItem;
private JMenuItem startRecordingItem;
private JMenuItem startMultitrackItem;
private JMenuItem stopRecordingItem;
private JMenuItem banListItem;
private JMenuItem complaintsItem;
private JMenuItem serverLogItem;
@@ -271,6 +281,12 @@ final class MainMenuBar extends JMenuBar {
JMenuItem contactsItem = new JMenuItem("Contacts…", Icons.ofAny("CONTACT", "EDIT_FRIEND_FOE_STATUS"));
contactsItem.setAccelerator(KeyStroke.getKeyStroke("control shift O"));
contactsItem.addActionListener(e -> listener.onShowContacts());
startRecordingItem = new JMenuItem("Start Recording", Icons.of("RECORDING_START"));
startRecordingItem.addActionListener(e -> listener.onStartRecording(false));
startMultitrackItem = new JMenuItem("Start Multitrack Recording", Icons.of("RECORDING_START"));
startMultitrackItem.addActionListener(e -> listener.onStartRecording(true));
stopRecordingItem = new JMenuItem("Stop Recording", Icons.of("RECORDING_STOP"));
stopRecordingItem.addActionListener(e -> listener.onStopRecording());
banListItem = new JMenuItem("Ban List", Icons.of("BAN_LIST"));
banListItem.setAccelerator(KeyStroke.getKeyStroke("control shift B"));
// The shortcut works while the item is hidden, so it asks for itself.
@@ -294,6 +310,10 @@ final class MainMenuBar extends JMenuBar {
tools.add(identitiesItem);
tools.add(contactsItem);
tools.addSeparator();
tools.add(startRecordingItem);
tools.add(startMultitrackItem);
tools.add(stopRecordingItem);
tools.addSeparator();
tools.add(banListItem);
tools.add(complaintsItem);
tools.add(serverLogItem);
@@ -311,6 +331,10 @@ final class MainMenuBar extends JMenuBar {
complaintsItem.setVisible(complaints);
serverLogItem.setVisible(serverLog);
adminSeparator.setVisible(bans || complaints || serverLog);
boolean recording = listener.isRecording();
startRecordingItem.setVisible(!recording);
startMultitrackItem.setVisible(!recording);
stopRecordingItem.setVisible(recording);
}
@Override
@@ -350,6 +374,8 @@ final class MainMenuBar extends JMenuBar {
phoneticItem.setEnabled(connected);
avatarItem.setEnabled(connected);
deleteAvatarItem.setEnabled(connected);
startRecordingItem.setEnabled(connected);
startMultitrackItem.setEnabled(connected);
banListItem.setEnabled(connected);
complaintsItem.setEnabled(connected);
serverLogItem.setEnabled(connected);
@@ -0,0 +1,51 @@
package com.ts3client.ui;
import com.ts3client.config.Settings;
import com.ts3client.recording.VoiceRecorder;
import com.ts3client.session.ServerSession;
import javax.swing.JFileChooser;
import javax.swing.filechooser.FileNameExtensionFilter;
import java.awt.Component;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
/** Starts recordings, into a file the user picks or, from a hotkey, the folder last used. */
final class RecordingActions {
private final Component owner;
private final Settings settings;
RecordingActions(Component owner, Settings settings) {
this.owner = owner;
this.settings = settings;
}
/** Asks where to save, then starts recording. */
void choose(ServerSession session, boolean multitrack) {
if (!session.isConnected() || session.isRecording()) return;
Path dir = settings.recordingFolder();
if (!Files.isDirectory(dir)) dir = Paths.get(System.getProperty("user.home", "."));
JFileChooser chooser = new JFileChooser(dir.toFile());
chooser.setDialogTitle(multitrack ? "Start Multitrack Recording" : "Start Recording");
chooser.setFileFilter(new FileNameExtensionFilter("Ogg Opus (*.ogg)", "ogg"));
chooser.setSelectedFile(session.recordingFile(dir).toFile());
if (chooser.showSaveDialog(owner) != JFileChooser.APPROVE_OPTION) return;
File file = chooser.getSelectedFile();
if (!file.getName().toLowerCase().endsWith(".ogg")) file = new File(file.getParentFile(), file.getName() + ".ogg");
settings.recordingDir = file.getParentFile().getAbsolutePath();
settings.save();
session.startRecording(mode(multitrack), file.toPath());
}
void startNow(ServerSession session, boolean multitrack) {
if (!session.isConnected() || session.isRecording()) return;
session.startRecording(mode(multitrack), session.recordingFile(settings.recordingFolder()));
}
private static VoiceRecorder.Mode mode(boolean multitrack) {
return multitrack ? VoiceRecorder.Mode.MULTITRACK : VoiceRecorder.Mode.MIXED;
}
}
@@ -1,26 +1,54 @@
package com.ts3client.ui;
import com.formdev.flatlaf.util.ScaledEmptyBorder;
import com.formdev.flatlaf.util.UIScale;
import javax.swing.JLabel;
import javax.swing.JPanel;
import java.awt.BorderLayout;
import java.awt.Cursor;
import java.awt.FlowLayout;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
/** The strip at the bottom of the window: connection status on the left, codec info on the right. */
/**
* The strip at the bottom of the window: connection status on the left, codec info on the
* right, and while the server on screen is being recorded, a label that stops it.
*/
final class StatusBar extends JPanel {
private final JLabel statusLabel = new JLabel("Not connected");
private final JLabel codecLabel = new JLabel();
private final JLabel recordingLabel = new JLabel("Recording", Icons.of("RECORDING_STOP"), JLabel.LEADING);
StatusBar() {
StatusBar(Runnable onStopRecording) {
super(new BorderLayout());
setBackground(Theme.statusBg());
setBorder(new ScaledEmptyBorder(3, 8, 3, 8));
statusLabel.setFont(Theme.uiFont());
codecLabel.setFont(Theme.uiFont());
codecLabel.setForeground(Theme.chatSystem());
add(statusLabel, BorderLayout.WEST);
add(codecLabel, BorderLayout.EAST);
recordingLabel.setFont(Theme.uiFont());
recordingLabel.setToolTipText("Stop Recording");
recordingLabel.setCursor(Cursor.getPredefinedCursor(Cursor.HAND_CURSOR));
recordingLabel.setVisible(false);
recordingLabel.addMouseListener(new MouseAdapter() {
@Override
public void mouseClicked(MouseEvent e) {
onStopRecording.run();
}
});
JPanel east = new JPanel(new FlowLayout(FlowLayout.TRAILING, UIScale.scale(12), 0));
east.setOpaque(false);
east.add(recordingLabel);
east.add(codecLabel);
// In the centre, a long status is cut short rather than drawn over the labels beside it.
add(statusLabel, BorderLayout.CENTER);
add(east, BorderLayout.EAST);
}
void showRecording(boolean recording) {
recordingLabel.setVisible(recording);
}
void setStatus(String text) {