Files
mumh5/electron/main.ts
T
kibiandClaude Opus 5.5 6d29ee1485 Initial commit: mumh5, a modern Mumble client
Electron desktop app with a Svelte 5 interface for any Mumble server.

- Mumble protocol core: TLS, handshake, channels, users, text, plugin data,
  client-side pacing of Murmur's rate limits
- Voice: WebCodecs Opus over the TCP tunnel, voice activity, push to talk,
  always-on, devices, per-user volume and local mute
- Several servers at once, voice on one; server rail with icons and ordering
- Chat: channels, direct messages, side chat, file sharing through f0ckm,
  inline images without it, click-to-play YouTube
- Profiles with rich descriptions, registration, rename, nicknames,
  connection information and moderation menus
- Identity wizard, multiple identities, PKCS#12 import/export, desktop
  Mumble certificate import, certificate pinning and viewer
- Tray icon with voice state
- Unit, server and end-to-end tests against a real Murmur

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 23:28:43 +02:00

153 lines
7.1 KiB
TypeScript

import { app, BrowserWindow, dialog, ipcMain, shell, session, systemPreferences, type WebContents } from 'electron';
import { promises as fs } from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import { IdentityStore } from './identity-store.ts';
import { describeCert } from './certs.ts';
import * as tray from './tray.ts';
import { openTls } from './tls-transport.ts';
const devUrl = process.env.VITE_DEV_SERVER_URL;
let identityStore: IdentityStore | null = null;
const identities = () => (identityStore ??= new IdentityStore(app.getPath('userData')));
// ─── Mumble TLS connections, one per renderer request ─────────────────────────
type Conn = ReturnType<typeof openTls> & { owner: WebContents };
const conns = new Map<string, Conn>();
// ─── Identities (client certificates) ─────────────────────────────────────────
ipcMain.handle('identities:list', () => identities().list());
ipcMain.handle('identities:create', (_e, name: string, email: string) => identities().create(String(name), String(email ?? '')));
ipcMain.handle('identities:import', (_e, bytes: Uint8Array, password: string, name: string) =>
identities().importP12(new Uint8Array(bytes), String(password ?? ''), String(name ?? '')));
ipcMain.handle('identities:findMumble', () => identities().findMumbleCertificate().then(f => f && { name: f.name }));
ipcMain.handle('identities:importMumble', (_e, name: string) => identities().importFromMumble(String(name ?? '')));
ipcMain.handle('identities:setDefault', (_e, id: string) => identities().setDefault(String(id)));
ipcMain.handle('identities:rename', (_e, id: string, name: string) => identities().rename(String(id), String(name)));
ipcMain.handle('identities:remove', (_e, id: string) => identities().remove(String(id)));
ipcMain.handle('identities:finishSetup', () => identities().finishSetup());
// Saves a password-protected .p12 backup where the user chooses; returns the path or null
ipcMain.handle('identities:export', async (e, id: string, password: string) => {
const { bytes, name } = await identities().exportP12(String(id), String(password ?? ''));
const win = BrowserWindow.fromWebContents(e.sender);
const opts = {
title: 'Save identity backup',
defaultPath: path.join(app.getPath('documents'), `${name.replace(/[^\w.-]+/g, '_') || 'identity'}.p12`),
filters: [{ name: 'PKCS#12 certificate', extensions: ['p12', 'pfx'] }]
};
const res = win ? await dialog.showSaveDialog(win, opts) : await dialog.showSaveDialog(opts);
if (res.canceled || !res.filePath) return null;
await fs.writeFile(res.filePath, bytes, { mode: 0o600 });
return res.filePath;
});
// The renderer picks the connection id and subscribes before calling open, so no event can be missed
ipcMain.handle('mumble:open', async (e, connId: string, host: string, port: number, identityId?: string) => {
if (typeof connId !== 'string' || conns.has(connId)) throw new Error('Invalid connection id');
const id = await identities().get(identityId);
const owner = e.sender;
const emit = (channel: string, ...args: unknown[]) => { if (!owner.isDestroyed()) owner.send(channel, connId, ...args); };
const conn = openTls(String(host), Number(port) || 64738, id.certPem, id.keyPem, {
onSecure: info => emit('mumble:secure', info),
onData: chunk => emit('mumble:data', chunk),
onClose: reason => { conns.delete(connId); emit('mumble:close', reason); }
});
conns.set(connId, Object.assign(conn, { owner }));
owner.once('destroyed', () => conn.close());
});
ipcMain.on('mumble:send', (e, connId: string, bytes: Uint8Array) => {
const conn = conns.get(connId);
if (conn && conn.owner === e.sender) conn.send(bytes);
});
ipcMain.on('mumble:close', (e, connId: string) => {
const conn = conns.get(connId);
if (conn && conn.owner === e.sender) conn.close();
});
// Parses DER certificates (e.g. a user's chain from UserStats) for the viewer
ipcMain.handle('certs:describe', (_e, ders: Uint8Array[]) =>
(Array.isArray(ders) ? ders.slice(0, 8) : []).flatMap(d => { try { return [describeCert(Buffer.from(d))]; } catch { return []; } }));
ipcMain.on('tray:update', (_e, state: tray.TrayState) => tray.update(state));
ipcMain.handle('platform:info', () => ({ os: process.platform, osVersion: os.release() }));
// ─── Window ────────────────────────────────────────────────────────────────────
let mainWindow: BrowserWindow | null = null;
function createWindow() {
const win = new BrowserWindow({
width: 1280,
height: 800,
minWidth: 360,
minHeight: 480,
backgroundColor: '#111214',
title: 'mumh5',
autoHideMenuBar: true,
webPreferences: {
preload: path.join(__dirname, 'preload.cjs'),
contextIsolation: true,
sandbox: true,
nodeIntegration: false,
// Voice must play without a click first
autoplayPolicy: 'no-user-gesture-required',
// Keep audio and timers running at full speed when the window is in the background
backgroundThrottling: false
}
});
// Links from chat open in the system browser, never inside the app
win.webContents.setWindowOpenHandler(({ url }) => {
if (/^https?:\/\//i.test(url)) shell.openExternal(url);
return { action: 'deny' };
});
win.webContents.on('will-navigate', (e, url) => {
if (devUrl && url.startsWith(devUrl)) return;
e.preventDefault();
if (/^https?:\/\//i.test(url)) shell.openExternal(url);
});
mainWindow = win;
win.on('close', e => {
if (tray.shouldHideOnClose()) {
e.preventDefault();
win.hide();
}
});
win.on('show', () => tray.onWindowVisibility());
win.on('hide', () => tray.onWindowVisibility());
win.on('closed', () => { if (mainWindow === win) mainWindow = null; });
if (devUrl) win.loadURL(devUrl);
else win.loadFile(path.join(__dirname, '../dist/index.html'));
}
app.whenReady().then(async () => {
// macOS asks once per app for microphone access
if (process.platform === 'darwin') await systemPreferences.askForMediaAccess('microphone').catch(() => false);
// YouTube refuses embeds without a referrer (error 153); a file:// app sends none
session.defaultSession.webRequest.onBeforeSendHeaders({ urls: ['https://www.youtube-nocookie.com/*'] }, (details, cb) => {
if (!details.requestHeaders.Referer) details.requestHeaders.Referer = 'https://mumh5.app/';
cb({ requestHeaders: details.requestHeaders });
});
// Microphone, camera and screen capture for voice and video; nothing else
session.defaultSession.setPermissionRequestHandler((_wc, permission, cb) => {
cb(['media', 'display-capture', 'clipboard-sanitized-write', 'notifications'].includes(permission));
});
createWindow();
await tray.setupTray(() => mainWindow, action => mainWindow?.webContents.send('tray:action', action));
app.on('activate', () => { if (BrowserWindow.getAllWindows().length === 0) createWindow(); });
});
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit();
});