nixamp 0.27.2 → 0.28.0

package/src/locales/zh.ts

@@ -0,0 +1,201 @@
+import type { Catalogue } from "../i18n.ts";
+export default {
+  "Interface language": "界面语言",
+  "Language": "语言",
+  "Translation language": "翻译语言",
+  "Original (auto-detect)": "原文（自动检测）",
+  "Play": "播放",
+  "Pause": "暂停",
+  "Stop": "停止",
+  "Next": "下一个",
+  "Previous": "上一个",
+  "Select": "选择",
+  "Next/Prev": "下一个/上一个",
+  "Quit": "退出",
+  "Now Playing": "正在播放",
+  "Spectrum Analyser": "频谱分析仪",
+  "Playlist": "播放列表",
+  "Files": "文件",
+  "Open files": "打开文件",
+  "Open folder": "打开文件夹",
+  "Add to library": "添加到媒体库",
+  "Replace playlist": "替换播放列表",
+  "Filter": "筛选",
+  "Search": "搜索",
+  "Nothing loaded.": "尚未加载内容。",
+  "Empty.": "空。",
+  "Loading…": "正在加载…",
+  "Connecting…": "正在连接…",
+  "Connected": "已连接",
+  "Not connected": "未连接",
+  "No source": "无来源",
+  "Playing": "播放中",
+  "Stopped": "已停止",
+  "Volume": "音量",
+  "Seek": "播放位置",
+  "Full screen": "全屏",
+  "Download": "下载",
+  "Share": "分享",
+  "Copy": "复制",
+  "Copy link": "复制链接",
+  "Copied": "已复制",
+  "Save": "保存",
+  "Cancel": "取消",
+  "Close": "关闭",
+  "Remove": "移除",
+  "Delete": "删除",
+  "Edit": "编辑",
+  "Add": "添加",
+  "Send": "发送",
+  "Retry": "重试",
+  "Back": "返回",
+  "Next page": "下一页",
+  "Previous page": "上一页",
+  "Show more": "显示更多",
+  "Panels": "面板",
+  "Reset layout": "重置布局",
+  "Show": "显示",
+  "Hide": "隐藏",
+  "Collapse": "收起",
+  "Expand": "展开",
+  "Move up": "上移",
+  "Move down": "下移",
+  "Install": "安装",
+  "TV mode": "电视模式",
+  "On": "开启",
+  "Off": "关闭",
+  "Account": "账户",
+  "Sign in": "登录",
+  "Sign out": "退出登录",
+  "Create account": "创建账户",
+  "Email": "电子邮箱",
+  "Password": "密码",
+  "Forgot password?": "忘记密码？",
+  "Welcome back": "欢迎回来",
+  "Profile": "个人资料",
+  "Handle": "用户名",
+  "Your servers": "你的服务器",
+  "Server": "服务器",
+  "Connect": "连接",
+  "Disconnect": "断开连接",
+  "Directory": "目录",
+  "Favourites": "收藏",
+  "Follow": "关注",
+  "Unfollow": "取消关注",
+  "Notifications": "通知",
+  "Phone number": "电话号码",
+  "Save number": "保存号码",
+  "Transcript": "文字稿",
+  "Captions": "字幕",
+  "Translate audio": "翻译音频",
+  "Audio language": "音频语言",
+  "Audio options": "音频选项",
+  "Keep background sound": "保留背景声音",
+  "Background level": "背景音量",
+  "Speaker voices": "说话者声音",
+  "Any voice": "任意声音",
+  "Male voice": "男声",
+  "Female voice": "女声",
+  "Original audio.": "原始音频。",
+  "Buy translated audio": "购买翻译音频",
+  "Audio credit": "音频余额",
+  "Buy pass": "购买通行证",
+  "Pass": "通行证",
+  "Pay with": "支付方式",
+  "Check payment": "检查付款",
+  "Open checkout": "前往付款",
+  "Free sessions": "免费会话",
+  "Usage rates and expiry": "使用费率与有效期",
+  "Catalogs": "内容目录",
+  "Add catalog": "添加目录",
+  "Catalog name": "目录名称",
+  "Link": "链接",
+  "Play link": "播放链接",
+  "Go live": "开始直播",
+  "Publish": "发布",
+  "Listen": "收听",
+  "Live now": "正在直播",
+  "Upcoming": "即将开始",
+  "Parties": "一起看",
+  "Join party": "加入一起看",
+  "Invite code": "邀请码",
+  "Invite": "邀请",
+  "Chat": "聊天",
+  "Chat message": "聊天消息",
+  "People": "参与者",
+  "Speaker": "发言者",
+  "Speakers": "发言者",
+  "Listener": "听众",
+  "Moderator": "主持人",
+  "Raise hand": "举手",
+  "Hand raises": "举手列表",
+  "Questions": "问题",
+  "Resources": "资料",
+  "Replay": "回放",
+  "Schedule": "日程",
+  "Event": "活动",
+  "Host": "主办人",
+  "About": "关于",
+  "Stage": "舞台",
+  "Title": "标题",
+  "Description": "描述",
+  "Topic": "主题",
+  "Public": "公开",
+  "Anyone with the link": "拥有链接的任何人",
+  "Invited people": "受邀者",
+  "Who can join": "谁可以加入",
+  "Date and time": "日期与时间",
+  "Expected length": "预计时长",
+  "Repeat": "重复",
+  "Does not repeat": "不重复",
+  "Every day": "每天",
+  "Every week": "每周",
+  "Homepage": "网站",
+  "Host name": "主办人姓名",
+  "Profile photo URL": "头像网址",
+  "Broadcast link": "直播链接",
+  "Edit event": "编辑活动",
+  "Save changes": "保存更改",
+  "Create live": "创建直播",
+  "Schedule class": "安排课程",
+  "Start class": "开始课程",
+  "End event": "结束活动",
+  "End session": "结束本次会话",
+  "Session ended": "会话已结束",
+  "Event ended": "活动已结束",
+  "Cancelled": "已取消",
+  "Replay available": "可观看回放",
+  "Join": "加入",
+  "Create invite": "创建邀请",
+  "Invite as": "邀请身份",
+  "Watch now": "立即观看",
+  "Start a room": "创建房间",
+  "Recent replays": "近期回放",
+  "Your account": "你的账户",
+  "Write with AI": "用 AI 撰写",
+  "Suggested title": "建议标题",
+  "Suggested description": "建议描述",
+  "Suggested topic": "建议主题",
+  "Use these details": "使用这些信息",
+  "Learn something live.": "实时学习新知识。",
+  "Screen share": "共享屏幕",
+  "Upload and broadcast": "上传并直播",
+  "Help": "帮助",
+  "Reload Player": "重新加载播放器",
+  "Copy Bundled CLI Path": "复制内置命令行工具路径",
+  "Developer tools": "开发者工具",
+  "Undo": "撤销",
+  "Redo": "重做",
+  "Cut": "剪切",
+  "Paste": "粘贴",
+  "Select all": "全选",
+  "Status": "状态",
+  "Activity log": "活动日志",
+  "Admin": "管理",
+  "Playback controls": "播放控制",
+  "Tracks and folders": "曲目与文件夹",
+  "Original-language captions.": "原语言字幕。",
+  "Skip to playback controls": "跳转到播放控制",
+  "Skip to playlist": "跳转到播放列表",
+  "Skip to transcript and translated audio": "跳转到文字稿和翻译音频"
+} satisfies Catalogue;

package/src/mail-sender.ts

@@ -0,0 +1,12 @@
+export interface MailSender { apiKey: string; from: string }
+export interface BrandedMailSender extends MailSender { backtoschool?: MailSender }
+
+/** Only the exact school origins select its verified sender and credentials. */
+export function mailSender(options: BrandedMailSender, link: string): MailSender {
+  try {
+    const url = new URL(link);
+    if (options.backtoschool && url.protocol === "https:" &&
+      ["backtoschool.help", "www.backtoschool.help"].includes(url.hostname)) return options.backtoschool;
+  } catch { /* A malformed link never changes the sender. */ }
+  return options;
+}

package/src/main.ts

@@ -1,3 +1,4 @@
+import { t as uiMessage, i18n, terminalUiLanguage, uiLanguage } from "./i18n.ts";
 /**
  * nixamp — it really whips the terminal's ass.
  *
@@ -143,6 +144,7 @@ Keys in the player:
   d     detach: hand the music to a daemon and get the terminal back
   q     quit
 
+      --ui-language CODE  interface language (default: system language; fallback: English)
   -v, --version    print the version
   -h, --help       print this. \`nixamp help <command>\` says more about one
 `;
@@ -510,7 +512,18 @@ async function runDaemon(argv: string[]): Promise<number> {
  * because the flag is false in a module that was imported rather than run.
  */
 export async function main(): Promise<void> {
-  const [first, ...rest] = process.argv.slice(2);
+  const args = process.argv.slice(2);
+  const languageAt = args.findIndex(arg => arg === "--ui-language" || arg.startsWith("--ui-language="));
+  let language = terminalUiLanguage(process.env);
+  if (languageAt >= 0) {
+    const flag = args[languageAt]!;
+    const value = flag.includes("=") ? flag.slice(flag.indexOf("=") + 1) : args[languageAt + 1];
+    if (!value || value.startsWith("-")) throw new Error("nixamp: --ui-language needs a language code, e.g. de");
+    language = uiLanguage(value);
+    args.splice(languageAt, flag.includes("=") ? 1 : 2);
+  }
+  await i18n.setLanguage(language);
+  const [first, ...rest] = args;
 
   // Asked for however anybody asks for it. `nixamp help serve` and
   // `nixamp serve --help` are the same question, so they get the same answer.
@@ -842,15 +855,15 @@ export function view(
 
   ui.row({ size: 1 }, (header) => {
     header.text(" ⣿ NIXAMP", { fg: theme.title, bold: true, size: 11 });
-    header.text(state.playing ? "▶ PLAYING" : "■ STOPPED", {
+    header.text(state.playing ? uiMessage("▶ PLAYING") : uiMessage("■ STOPPED"), {
       fg: state.playing ? theme.success : theme.muted,
       size: 12,
     });
     header.text(`${state.tracks.length} tracks  ${state.root} `, { fg: theme.muted, align: "right" });
   });
 
-  ui.panel({ title: "Now Playing", size: 6 }, (p) => {
-    if (!track) { p.label("Nothing loaded."); return; }
+  ui.panel({ title: uiMessage("Now Playing"), size: 6 }, (p) => {
+    if (!track) { p.label(uiMessage("Nothing loaded.")); return; }
     p.text(displayName(track), { fg: theme.accent, bold: true, size: 1 });
     p.text(track.album || "—", { fg: theme.muted, size: 1 });
     p.row({ size: 1 }, (r) => {
@@ -863,7 +876,7 @@ export function view(
   });
 
   ui.row({ size: height - 10, gap: 1 }, (row) => {
-    row.panel({ title: "Spectrum Analyser", width: "1.3fr" }, (p) => {
+    row.panel({ title: uiMessage("Spectrum Analyser"), width: "1.3fr" }, (p) => {
       // Braille gives four vertical pixels per cell, so the bars move smoothly
       // rather than stepping through eight block glyphs.
       p.canvas((canvas) => {
@@ -879,8 +892,8 @@ export function view(
       });
     });
 
-    row.panel({ title: `Playlist (${state.tracks.length})`, width: "1fr" }, (p) => {
-      if (state.tracks.length === 0) { p.label("Empty."); return; }
+    row.panel({ title: `${uiMessage("Playlist")} (${i18n.number(state.tracks.length)})`, width: "1fr" }, (p) => {
+      if (state.tracks.length === 0) { p.label(uiMessage("Empty.")); return; }
       p.table({
         rows: state.tracks.map((t, i) => ({
           n: String(i + 1).padStart(2, " "),
@@ -910,11 +923,11 @@ export function view(
 
   ui.statusBar({
     items: [
-      { key: "Space", label: state.playing ? "Stop" : "Play", active: state.playing },
-      { key: "↑↓", label: "Select" },
-      { key: "n/p", label: "Next/Prev" },
-      { key: "Enter", label: "Play" },
-      { key: "q", label: "Quit" },
+      { key: "Space", label: state.playing ? uiMessage("Stop") : uiMessage("Play"), active: state.playing },
+      { key: "↑↓", label: uiMessage("Select") },
+      { key: "n/p", label: uiMessage("Next/Prev") },
+      { key: "Enter", label: uiMessage("Play") },
+      { key: "q", label: uiMessage("Quit") },
     ],
   });
 }

package/src/notify.ts

@@ -1,3 +1,5 @@
+import { mailSender, type BrandedMailSender } from "./mail-sender.ts";
+
 /**
  * Telling followers a broadcaster went live, wherever they are.
  *
@@ -119,27 +121,28 @@ export async function notifyAll(
  * blocked, and no dependency: a fetch is the whole client.
  */
 export function resendEmail(
-  { apiKey, from, fetch = globalThis.fetch, onEvent }: {
-    apiKey: string;
-    from: string;
+  { apiKey, from, backtoschool, reason = "You are getting this because you follow them on nixamp.", fetch = globalThis.fetch, onEvent }: BrandedMailSender & {
+    reason?: string;
     fetch?: typeof globalThis.fetch;
     onEvent?: (message: string) => void;
   },
 ): (to: string, note: Notification) => Promise<boolean> {
   return async (to, note) => {
     try {
+      const sender = mailSender({apiKey, from, backtoschool}, note.url);
       const response = await fetch("https://api.resend.com/emails", {
         method: "POST",
-        headers: { authorization: `Bearer ${apiKey}`, "content-type": "application/json" },
+        headers: { authorization: `Bearer ${sender.apiKey}`, "content-type": "application/json" },
+        signal: AbortSignal.timeout(15_000),
         body: JSON.stringify({
-          from,
+          from: sender.from,
           to: [to],
           subject: note.title,
-          text: `${note.body}\n\n${note.url}\n\nYou are getting this because you follow them on nixamp.`,
+          text: `${note.body}\n\n${note.url}\n\n${reason}`,
           html:
             `<p>${escapeHtml(note.body)}</p>` +
             `<p><a href="${escapeHtml(note.url)}">${escapeHtml(note.url)}</a></p>` +
-            `<p style="color:#666;font-size:12px">You are getting this because you follow them on nixamp.</p>`,
+            `<p style="color:#666;font-size:12px">${escapeHtml(reason)}</p>`,
         }),
       });
       if (!response.ok) {

package/src/password-reset.ts

@@ -1,6 +1,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import type { Queryable } from "./follows.ts";
 import type { Tokens } from "./tokens.ts";
+import { mailSender, type BrandedMailSender } from "./mail-sender.ts";
 
 export const RESET_MESSAGE = "If an account exists for that email, you’ll receive a password reset link shortly.";
 export const RESET_INVALID = "This reset link is invalid, expired, or already used. Request a new link.";
@@ -115,17 +116,16 @@ export class PasswordResets {
 }
 
 /** Transactional recovery mail has no follower footer and never logs a token. */
-export function resendPasswordReset(options: {
-  apiKey: string; from: string; fetch?: typeof globalThis.fetch;
-}): ResetMail {
+export function resendPasswordReset(options: BrandedMailSender & { fetch?: typeof globalThis.fetch }): ResetMail {
   return async (email, link) => {
     const host = new URL(link).hostname;
+    const sender = mailSender(options, link);
     const response = await (options.fetch ?? globalThis.fetch)("https://api.resend.com/emails", {
       method: "POST",
-      headers: { authorization: `Bearer ${options.apiKey}`, "content-type": "application/json" },
+      headers: { authorization: `Bearer ${sender.apiKey}`, "content-type": "application/json" },
       signal: AbortSignal.timeout(15_000),
       body: JSON.stringify({
-        from: options.from, to: [email], subject: `Reset your ${host} password`,
+        from: sender.from, to: [email], subject: `Reset your ${host} password`,
         text: `Someone requested a password reset for your account on ${host}.\n\nChoose a new password using this link:\n${link}\n\nThis link expires in ${LIFETIME_MS / 60_000} minutes and works once. Resetting your password signs out existing sessions.\n\nIf you did not request this, you can ignore this email. Your password will stay the same.`,
       }),
     });

package/src/server.ts

@@ -87,6 +87,7 @@ import { createThrottle, presentedCredential, type Throttle } from "@profullstac
 import { Durable } from "./durable.ts";
 import { notifyAll, resendEmail, webPush, type Notification } from "./notify.ts";
 import { inviteSubject, inviteText, isEmail, isPhone, watchLink } from "./invite.ts";
+import { EventWriter } from "./event-writer.ts";
 import { handleLiveApi } from "./live-api.ts";
 import { LiveEvents, eventStructuredData, isTicketed, type LiveEvent } from "./live-events.ts";
 import { Tickets, needsTicket, ticketFrom, ticketsFromEnv } from "./tickets.ts";
@@ -1759,6 +1760,7 @@ export interface HandlerOptions {
   settingsSync?: SettingsSync;
   /** Scheduled and live sessions, kept by NixAmp and shared by branded clients. */
   events?: LiveEvents;
+  eventWriter?: EventWriter;
   /** Versioned panel layouts, including event and user overrides. */
   layouts?: Layouts;
   /** Persistent participation state that must not be coupled to live audio. */
@@ -1944,6 +1946,7 @@ export function createHandler(engine: Engine, options: HandlerOptions) {
 
     if (options.events && await handleLiveApi(request, response, url, {
       events: options.events,
+      ...(options.eventWriter ? {eventWriter: options.eventWriter} : {}),
       ...(options.accounts ? { accounts: options.accounts } : {}),
       ...(options.layouts ? { layouts: options.layouts } : {}),
       ...(options.rooms ? { rooms: options.rooms } : {}),
@@ -6123,6 +6126,10 @@ export async function serve(argv: string[], version = "0.1.0"): Promise<void> {
   const favorites = pool ? new Favorites(pool) : undefined;
   const settingsSync = pool ? new SettingsSync(pool) : undefined;
   const nixampSite = (process.env["NIXAMP_SITE"] ?? DEFAULT_DIRECTORY).replace(/\/+$/, "");
+  const schoolMailKey = process.env["BACKTOSCHOOL_RESEND_API_KEY"] ?? process.env["RESEND_API_KEY"];
+  const schoolMail = schoolMailKey && process.env["BACKTOSCHOOL_MAIL_FROM"] ? {
+    apiKey: schoolMailKey, from: process.env["BACKTOSCHOOL_MAIL_FROM"],
+  } : undefined;
   const events = pool ? new LiveEvents(pool) : undefined;
   const layouts = pool ? new Layouts(pool) : undefined;
   const rooms = pool ? new Rooms(pool) : undefined;
@@ -6651,7 +6658,10 @@ export async function serve(argv: string[], version = "0.1.0"): Promise<void> {
     ...(follows ? { follows, vapidPublicKey } : {}),
     ...(favorites ? { favorites } : {}),
     ...(settingsSync ? { settingsSync } : {}),
-    ...(events ? { events } : {}),
+    ...(events ? { events, eventWriter: new EventWriter({
+      openaiKey: process.env["OPENAI_API_KEY"], anthropicKey: process.env["ANTHROPIC_API_KEY"],
+      openaiModel: process.env["NIXAMP_WRITER_OPENAI_MODEL"], claudeModel: process.env["NIXAMP_WRITER_CLAUDE_MODEL"],
+    }) } : {}),
     ...(layouts ? { layouts } : {}),
     ...(rooms ? { rooms } : {}),
     ...(trollbox ? { trollbox } : {}),
@@ -6668,6 +6678,7 @@ export async function serve(argv: string[], version = "0.1.0"): Promise<void> {
       resetMail: resendPasswordReset({
         apiKey: process.env["RESEND_API_KEY"],
         from: process.env["NIXAMP_MAIL_FROM"] ?? "nixamp <notifications@nixamp.com>",
+        backtoschool: schoolMail,
       }),
     } : {}),
     // Other people's OpenProfiles, read for the voice a line is spoken in,
@@ -6692,6 +6703,8 @@ export async function serve(argv: string[], version = "0.1.0"): Promise<void> {
                   email: resendEmail({
                     apiKey: process.env["RESEND_API_KEY"],
                     from: process.env["NIXAMP_MAIL_FROM"] ?? "nixamp <notifications@nixamp.com>",
+                    backtoschool: schoolMail,
+                    reason: "You received this email because a host invited you to join a live session.",
                     onEvent: (message) => console.log(message),
                   }),
                 }

package/src/shared-translation.ts

@@ -1,5 +1,6 @@
 /** One live source/language pipeline, paid access for every listening account.
  * Browsers receive the same PCM, never upload a replacement for a public feed. */
+import { transientAudioError } from "./live-recovery.ts";
 import { createHash, randomUUID } from "node:crypto";
 import { lookup } from "node:dns/promises";
 import { BlockList, isIP } from "node:net";
@@ -58,9 +59,9 @@ export function liveInput(ffmpeg: string[] = ["ffmpeg"]): OpenLiveInput {
   };
 }
 
-export type SharedEvent = { type: "status"; listeners: number } | { type: "line"; id: string; line: Caption } | { type: "audio"; id: string; data: string } | { type: "end"; id: string } | { type: "error"; error: string };
+export type SharedEvent = { type: "status"; listeners: number } | { type: "line"; id: string; line: Caption } | { type: "audio"; id: string; data: string } | { type: "end"; id: string } | { type: "error"; error: string; retryable?: boolean };
 type Member = { by: string; send: (event: SharedEvent) => void; close: () => void };
-interface Feed { id: string; source: URL; language: string; members: Set<Member>; controller: AbortController; input?: LiveInput; interpreter: Interpreter; meter: TranslationMeter; reservations: Map<string, string[]>; queue: Caption[]; speaking: boolean; previous: Buffer; pending: Buffer; until: number; heartbeat?: ReturnType<typeof setInterval>; }
+interface Feed { id: string; source: URL; language: string; members: Set<Member>; controller: AbortController; input?: LiveInput; interpreter: Interpreter; meter: TranslationMeter; reservations: Map<string, string[]>; queue: Caption[]; speaking: boolean; voiceFailures: number; previous: Buffer; pending: Buffer; until: number; heartbeat?: ReturnType<typeof setInterval>; }
 
 export class SharedTranslations {
   private readonly feeds = new Map<string, Feed>();
@@ -123,12 +124,12 @@ export class SharedTranslations {
       try { member.send(event); } catch { this.leave(feed, member); member.close(); }
     }
   }
-  private stop(feed: Feed, error: string): void {
-    this.broadcast(feed, { type: "error", error });
+  private stop(feed: Feed, error: string, retryable = false): void {
+    this.broadcast(feed, { type: "error", error, retryable });
     for (const member of [...feed.members]) { this.leave(feed, member); member.close(); }
   }
   private make(id: string, source: URL, language: string): Feed {
-    const feed = { id, source, language, members: new Set<Member>(), controller: new AbortController(), reservations: new Map<string, string[]>(), queue: [], speaking: false, previous: Buffer.alloc(0), pending: Buffer.alloc(0), until: Date.now() } as unknown as Feed;
+    const feed = { id, source, language, members: new Set<Member>(), controller: new AbortController(), reservations: new Map<string, string[]>(), queue: [], speaking: false, voiceFailures: 0, previous: Buffer.alloc(0), pending: Buffer.alloc(0), until: Date.now() } as unknown as Feed;
     // Each account uses free access first, then the same published credit rate.
     // Additional listeners do not trigger recognition or synthesis.
     feed.meter = {
@@ -163,10 +164,10 @@ export class SharedTranslations {
     feed.interpreter = new Interpreter({
       language: () => language, speakers: () => true, voices: () => voices, channel: () => id,
       status: text => { if (!feed.controller.signal.aborted && !feed.members.size) this.stop(feed, text); },
-      failed: () => this.stop(feed, "Live translation stopped. Enable it again to retry."),
+      failed: message => this.stop(feed, message),
       lines: lines => {
         feed.queue.push(...lines);
-        if (feed.queue.length > 24) { this.stop(feed, "Live translation fell behind. Enable it again to retry."); return; }
+        feed.queue = feed.queue.filter(line => Date.now() - line.until <= 12_000).slice(-24);
         if (!feed.speaking) void this.speak(feed);
       },
       fetcher: (async (url, init) => {
@@ -196,7 +197,7 @@ export class SharedTranslations {
           for (let index = 0; index < samples.length; index++) samples[index] = pcm.readInt16LE(index * 2) / 32768;
           feed.interpreter.push({ samples, at: feed.until - samples.length / 16, until: feed.until, freshAt: feed.until - 2000 });
         }
-      }, () => this.stop(feed, "The live source stopped. Enable translated audio again when playback resumes."), feed.controller.signal);
+      }, () => this.stop(feed, "The live source disconnected.", true), feed.controller.signal);
       if (feed.controller.signal.aborted) input.stop(); else feed.input = input;
     } catch (error) { this.stop(feed, error instanceof SpeechError ? error.message : "The live source could not be opened."); }
   }
@@ -205,18 +206,25 @@ export class SharedTranslations {
     try {
       while (feed.queue.length && !feed.controller.signal.aborted) {
         const line = feed.queue.shift()!;
-        if (Date.now() - line.until > 12_000) throw new SpeechError("Live translation fell behind. Enable it again to retry.", 503);
-        const response = await this.options.voice.stream({ text: line.text, language: feed.language, channel: feed.id, speaker: line.speaker, voice: feed.interpreter.tracker.speakers.get(line.speaker ?? "")?.voice }, feed.id, feed.controller.signal, feed.meter);
-        const id = randomUUID();
-        this.broadcast(feed, { type: "line", id, line });
-        const reader = response.body!.getReader();
+        if (Date.now() - line.until > 12_000) continue;
         try {
-          while (true) {
-            const { done, value } = await reader.read(); if (done) break;
-            for (let at = 0; at < value.length; at += 16_384) this.broadcast(feed, { type: "audio", id, data: Buffer.from(value.subarray(at, at + 16_384)).toString("base64") });
-          }
-        } finally { reader.releaseLock(); }
-        this.broadcast(feed, { type: "end", id });
+          const response = await this.options.voice.stream({ text: line.text, language: feed.language, channel: feed.id, speaker: line.speaker, voice: feed.interpreter.tracker.speakers.get(line.speaker ?? "")?.voice }, feed.id, feed.controller.signal, feed.meter);
+          const id = randomUUID();
+          this.broadcast(feed, { type: "line", id, line });
+          const reader = response.body!.getReader();
+          try {
+            while (true) {
+              const { done, value } = await reader.read(); if (done) break;
+              for (let at = 0; at < value.length; at += 16_384) this.broadcast(feed, { type: "audio", id, data: Buffer.from(value.subarray(at, at + 16_384)).toString("base64") });
+            }
+          } finally { reader.releaseLock(); this.broadcast(feed, { type: "end", id }); }
+          feed.voiceFailures = 0;
+        } catch (error) {
+          if (feed.controller.signal.aborted) return;
+          if (!transientAudioError(error) || ++feed.voiceFailures >= 3) throw error;
+          // A provider failure skips this phrase; the source and other listeners
+          // remain connected. Never replay partial speech or retry a charge.
+        }
       }
     } catch (error) { if (!feed.controller.signal.aborted) this.stop(feed, error instanceof SpeechError ? error.message : "Translated audio was interrupted."); }
     finally { feed.speaking = false; }

package/src/ui-aliases.ts

@@ -0,0 +1,42 @@
+import type { Message } from './i18n.ts';
+/** Existing copy can use a concise shared label in translated interfaces.
+ * English remains verbatim. Never use these aliases for user-authored content. */
+export const aliases: Record<string, Message> = {
+  '■ STOPPED': 'Stopped', '▶ PLAYING': 'Playing', 'LOADING': 'Loading…',
+  'no source': 'No source', 'not connected': 'Not connected', 'Now playing': 'Now Playing',
+  '● GO LIVE': 'Go live', '● Go live': 'Go live', '⤓ Download': 'Download',
+  'A man\'s voice': 'Male voice', 'A woman\'s voice': 'Female voice',
+  'Catalogs on this server': 'Catalogs', 'Catalog folders': 'Catalogs',
+  'Parties on this server': 'Parties', 'Servers streaming now': 'Directory',
+  'Playlist (0)': 'Playlist', 'Playlist folders': 'Playlist', 'Playlist pages': 'Playlist',
+  'Filter these files': 'Filter', 'Filter these entries': 'Filter',
+  'Filter the entries': 'Filter', 'Filter the playlist': 'Filter',
+  'Create a free account': 'Create account', 'Create one': 'Create account',
+  'Create your account': 'Create account', 'New here? Create an account': 'Create account',
+  'Already have an account? Sign in': 'Sign in', 'Your NixAmp account': 'Your account',
+  'Your public handle': 'Handle', 'handle': 'Handle', 'password': 'Password',
+  'Phone number for texts': 'Phone number', 'Back to the player': 'Back',
+  'Share what is playing': 'Share', 'Share this stream': 'Share',
+  'Link to this stream': 'Link', 'Copy this stream\'s URL': 'Copy link',
+  'A link to play': 'Link', 'A server\'s link': 'Server', 'Close translated audio purchase': 'Close',
+  'Open secure checkout ↗ (new tab)': 'Open checkout', 'Checking…': 'Loading…',
+  'Browse the directory': 'Directory', 'See what is live': 'Live now',
+  'Join live': 'Join', 'Raise Hand': 'Raise hand', 'Hand Raises': 'Hand raises',
+  'Hide this': 'Hide', 'Log': 'Activity log', 'Status:': 'Status',
+  'Nixamp player': 'Playback controls', 'Nixamp audio and video player': 'Playback controls',
+  'What is being said': 'Transcript', 'The room\'s chat': 'Chat', 'Trollbox': 'Chat',
+  'A line for the trollbox': 'Chat message', 'Say something to the room…': 'Chat message',
+  'Send it': 'Send', 'Something to add': 'Chat message', 'What to call it': 'Catalog name',
+  'call it something': 'Catalog name', 'An m3u catalog to add': 'Catalogs',
+  'On this device': 'Play', 'Play on this device': 'Play', 'What this is': 'About',
+  'Looking for servers…': 'Loading…', 'Finding today’s conversations…': 'Loading…',
+  'Coming up': 'Upcoming', 'Listen after class': 'Replay', 'Schedule live': 'Schedule class',
+  'Schedule a class': 'Schedule class', 'Plan a conversation': 'Schedule class',
+  'Your classroom': 'Event', 'Join in': 'Join', 'Open a room →': 'Start a room',
+  'Chat message': 'Chat message', 'Add to the conversation': 'Chat message',
+  'Create live': 'Create live', 'Host stage': 'Stage', 'Your host': 'Host',
+  'Class host': 'Host', 'Hand raised ✓': 'Raise hand', 'Copied ✓': 'Copied',
+  'Screen share with Pairux ↗': 'Screen share', 'Upload & broadcast in Nixamp ↗': 'Upload and broadcast',
+  'Open Music Folder…': 'Open folder', 'Choose a music folder': 'Open folder',
+  'Main navigation': 'Panels', 'Skip to a section': 'Panels',
+};

package/src/ui-languages.ts

@@ -0,0 +1,31 @@
+/** The UI and audio-translation menus share the same supported targets. */
+export const UI_LANGUAGES = [
+  { code: 'en', label: 'English' }, { code: 'de', label: 'Deutsch' },
+  { code: 'sv', label: 'Svenska' }, { code: 'es', label: 'Español' },
+  { code: 'fr', label: 'Français' }, { code: 'it', label: 'Italiano' },
+  { code: 'nl', label: 'Nederlands' }, { code: 'da', label: 'Dansk' },
+  { code: 'fi', label: 'Suomi' }, { code: 'ru', label: 'Русский' },
+  { code: 'uk', label: 'Українська' }, { code: 'cs', label: 'Čeština' },
+  { code: 'hu', label: 'Magyar' }, { code: 'zh', label: '中文' },
+  { code: 'ar', label: 'العربية' }, { code: 'hi', label: 'हिन्दी' },
+  { code: 'vi', label: 'Tiếng Việt' }, { code: 'id', label: 'Bahasa Indonesia' },
+] as const;
+export type UiLanguage = typeof UI_LANGUAGES[number]['code'];
+export const UI_LANGUAGE_KEY = 'nixamp.ui.language';
+export function uiLanguage(value: unknown): UiLanguage {
+  const code = typeof value === 'string' ? value.trim().toLowerCase().split(/[-_.@]/)[0] : '';
+  return UI_LANGUAGES.find(language => language.code === code)?.code ?? 'en';
+}
+/** A saved choice wins; otherwise use the first supported system preference. */
+export function preferredUiLanguage(saved: unknown, system: readonly unknown[] = []): UiLanguage {
+  const match = (value: unknown): UiLanguage | undefined => {
+    const code = typeof value === 'string' ? value.trim().toLowerCase().split(/[-_.@]/)[0] : '';
+    return UI_LANGUAGES.find(language => language.code === code)?.code;
+  };
+  return match(saved) ?? system.map(match).find(Boolean) ?? 'en';
+}
+export function terminalUiLanguage(env: Record<string, string | undefined>): UiLanguage {
+  if (env['NIXAMP_UI_LANGUAGE']) return uiLanguage(env['NIXAMP_UI_LANGUAGE']);
+  if (env['LC_ALL']) return preferredUiLanguage(null, [env['LC_ALL']]);
+  return preferredUiLanguage(null, env['LANGUAGE']?.split(':') ?? [env['LC_MESSAGES'] || env['LANG']]);
+}

package/web/dist/assets/ar-DK3LI2hP.js

@@ -0,0 +1 @@
+var e={"Interface language":`لغة الواجهة`,Language:`اللغة`,"Translation language":`لغة الترجمة`,"Original (auto-detect)":`الأصل (اكتشاف تلقائي)`,Play:`تشغيل`,Pause:`إيقاف مؤقت`,Stop:`إيقاف`,Next:`التالي`,Previous:`السابق`,Select:`اختيار`,"Next/Prev":`التالي/السابق`,Quit:`خروج`,"Now Playing":`قيد التشغيل`,"Spectrum Analyser":`محلل الطيف`,Playlist:`قائمة التشغيل`,Files:`الملفات`,"Open files":`فتح ملفات`,"Open folder":`فتح مجلد`,"Add to library":`إضافة إلى المكتبة`,"Replace playlist":`استبدال قائمة التشغيل`,Filter:`تصفية`,Search:`بحث`,"Nothing loaded.":`لم يُحمّل أي محتوى.`,"Empty.":`فارغ.`,"Loading…":`جارٍ التحميل…`,"Connecting…":`جارٍ الاتصال…`,Connected:`متصل`,"Not connected":`غير متصل`,"No source":`لا يوجد مصدر`,Playing:`يعمل`,Stopped:`متوقف`,Volume:`مستوى الصوت`,Seek:`موضع التشغيل`,"Full screen":`ملء الشاشة`,Download:`تنزيل`,Share:`مشاركة`,Copy:`نسخ`,"Copy link":`نسخ الرابط`,Copied:`تم النسخ`,Save:`حفظ`,Cancel:`إلغاء`,Close:`إغلاق`,Remove:`إزالة`,Delete:`حذف`,Edit:`تعديل`,Add:`إضافة`,Send:`إرسال`,Retry:`إعادة المحاولة`,Back:`رجوع`,"Next page":`الصفحة التالية`,"Previous page":`الصفحة السابقة`,"Show more":`عرض المزيد`,Panels:`اللوحات`,"Reset layout":`إعادة ضبط التخطيط`,Show:`إظهار`,Hide:`إخفاء`,Collapse:`طي`,Expand:`توسيع`,"Move up":`نقل لأعلى`,"Move down":`نقل لأسفل`,Install:`تثبيت`,"TV mode":`وضع التلفاز`,On:`مفعّل`,Off:`معطّل`,Account:`الحساب`,"Sign in":`تسجيل الدخول`,"Sign out":`تسجيل الخروج`,"Create account":`إنشاء حساب`,Email:`البريد الإلكتروني`,Password:`كلمة المرور`,"Forgot password?":`نسيت كلمة المرور؟`,"Welcome back":`مرحبًا بعودتك`,Profile:`الملف الشخصي`,Handle:`اسم المستخدم`,"Your servers":`خوادمك`,Server:`الخادم`,Connect:`اتصال`,Disconnect:`قطع الاتصال`,Directory:`الدليل`,Favourites:`المفضلة`,Follow:`متابعة`,Unfollow:`إلغاء المتابعة`,Notifications:`الإشعارات`,"Phone number":`رقم الهاتف`,"Save number":`حفظ الرقم`,Transcript:`النص المفرغ`,Captions:`الترجمة النصية`,"Translate audio":`ترجمة الصوت`,"Audio language":`لغة الصوت`,"Audio options":`خيارات الصوت`,"Keep background sound":`الاحتفاظ بأصوات الخلفية`,"Background level":`مستوى صوت الخلفية`,"Speaker voices":`أصوات المتحدثين`,"Any voice":`أي صوت`,"Male voice":`صوت رجالي`,"Female voice":`صوت نسائي`,"Original audio.":`الصوت الأصلي.`,"Buy translated audio":`شراء الصوت المترجم`,"Audio credit":`رصيد الصوت`,"Buy pass":`شراء تصريح`,Pass:`تصريح`,"Pay with":`الدفع باستخدام`,"Check payment":`التحقق من الدفع`,"Open checkout":`الانتقال للدفع`,"Free sessions":`جلسات مجانية`,"Usage rates and expiry":`الأسعار ومدة الصلاحية`,Catalogs:`الكتالوجات`,"Add catalog":`إضافة كتالوج`,"Catalog name":`اسم الكتالوج`,Link:`الرابط`,"Play link":`تشغيل الرابط`,"Go live":`بدء بث مباشر`,Publish:`نشر`,Listen:`استماع`,"Live now":`مباشر الآن`,Upcoming:`قريبًا`,Parties:`حفلات المشاهدة`,"Join party":`الانضمام للحفلة`,"Invite code":`رمز الدعوة`,Invite:`دعوة`,Chat:`الدردشة`,"Chat message":`رسالة دردشة`,People:`الأشخاص`,Speaker:`متحدث`,Speakers:`المتحدثون`,Listener:`مستمع`,Moderator:`مشرف`,"Raise hand":`رفع اليد`,"Hand raises":`الأيدي المرفوعة`,Questions:`الأسئلة`,Resources:`الموارد`,Replay:`إعادة العرض`,Schedule:`الجدول`,Event:`الفعالية`,Host:`المضيف`,About:`حول`,Stage:`المنصة`,Title:`العنوان`,Description:`الوصف`,Topic:`الموضوع`,Public:`عام`,"Anyone with the link":`أي شخص لديه الرابط`,"Invited people":`الأشخاص المدعوون`,"Who can join":`من يمكنه الانضمام`,"Date and time":`التاريخ والوقت`,"Expected length":`المدة المتوقعة`,Repeat:`تكرار`,"Does not repeat":`لا يتكرر`,"Every day":`كل يوم`,"Every week":`كل أسبوع`,Homepage:`الموقع الإلكتروني`,"Host name":`اسم المضيف`,"Profile photo URL":`رابط صورة الملف الشخصي`,"Broadcast link":`رابط البث`,"Edit event":`تعديل الفعالية`,"Save changes":`حفظ التغييرات`,"Create live":`إنشاء بث مباشر`,"Schedule class":`جدولة درس`,"Start class":`بدء الدرس`,"End event":`إنهاء الفعالية`,"End session":`إنهاء الجلسة`,"Session ended":`انتهت الجلسة`,"Event ended":`انتهت الفعالية`,Cancelled:`ملغاة`,"Replay available":`إعادة العرض متاحة`,Join:`انضمام`,"Create invite":`إنشاء دعوة`,"Invite as":`الدعوة بصفة`,"Watch now":`شاهد الآن`,"Start a room":`إنشاء غرفة`,"Recent replays":`إعادات العرض الأخيرة`,"Your account":`حسابك`,"Write with AI":`الكتابة بالذكاء الاصطناعي`,"Suggested title":`العنوان المقترح`,"Suggested description":`الوصف المقترح`,"Suggested topic":`الموضوع المقترح`,"Use these details":`استخدام هذه التفاصيل`,"Learn something live.":`تعلّم شيئًا مباشرة.`,"Screen share":`مشاركة الشاشة`,"Upload and broadcast":`رفع وبث`,Help:`مساعدة`,"Reload Player":`إعادة تحميل المشغل`,"Copy Bundled CLI Path":`نسخ مسار أداة سطر الأوامر المضمنة`,"Developer tools":`أدوات المطور`,Undo:`تراجع`,Redo:`إعادة`,Cut:`قص`,Paste:`لصق`,"Select all":`تحديد الكل`,Status:`الحالة`,"Activity log":`سجل النشاط`,Admin:`الإدارة`,"Playback controls":`عناصر التحكم بالتشغيل`,"Tracks and folders":`المقاطع والمجلدات`,"Original-language captions.":`ترجمة نصية باللغة الأصلية.`,"Skip to playback controls":`الانتقال إلى عناصر التحكم بالتشغيل`,"Skip to playlist":`الانتقال إلى قائمة التشغيل`,"Skip to transcript and translated audio":`الانتقال إلى النص المفرغ والصوت المترجم`};export{e as default};