Fix linux bluetooth bug

Author: nukeop

packages/hifi/src/Sound.tsx

@@ -26,6 +26,7 @@ export const Sound: React.FC<SoundProps> = ({
   status,
   seek,
   volume,
+  sampleRate,
   preload = 'auto',
   crossOrigin = '',
   onTimeUpdate,
@@ -36,7 +37,7 @@ export const Sound: React.FC<SoundProps> = ({
   children,
 }) => {
   const audioRef = useRef<HTMLAudioElement | null>(null);
-  const context = useAudioContext();
+  const context = useAudioContext(sampleRate);
   const { source } = useAudioElementSource(audioRef, context);
   const isReady = !!source;
   const [audioNodes, setAudioNodes] = useState<AudioNode[]>([]);

packages/hifi/src/hooks/useAudioContext.ts

@@ -1,16 +1,16 @@
 import { useEffect, useState } from 'react';
 
-export const useAudioContext = () => {
+export const useAudioContext = (sampleRate?: number) => {
   const [context, setContext] = useState<AudioContext | null>(null);
 
   useEffect(() => {
-    const ctx = new AudioContext({ latencyHint: 'playback' });
+    const ctx = new AudioContext({ latencyHint: 'playback', sampleRate });
     setContext(ctx);
 
     return () => {
       ctx.close();
     };
-  }, []);
+  }, [sampleRate]);
 
   return context;
 };

packages/hifi/src/test/Sound.test.tsx

@@ -136,4 +136,31 @@ describe('Sound', () => {
     expect(playMock).toHaveBeenCalled();
     restore();
   });
+
+  it('passes the sampleRate prop through to the AudioContext constructor', () => {
+    const { restore } = setupAudioContextMock();
+
+    render(<Sound src={httpSource} status="paused" sampleRate={48000} />);
+
+    expect(window.AudioContext).toHaveBeenCalledWith(
+      expect.objectContaining({ sampleRate: 48000, latencyHint: 'playback' }),
+    );
+
+    restore();
+  });
+
+  it('constructs the AudioContext without a sampleRate when none is given', () => {
+    const { restore } = setupAudioContextMock();
+
+    render(<Sound src={httpSource} status="paused" />);
+
+    expect(window.AudioContext).toHaveBeenCalledWith(
+      expect.objectContaining({
+        sampleRate: undefined,
+        latencyHint: 'playback',
+      }),
+    );
+
+    restore();
+  });
 });

packages/hifi/src/types.ts

@@ -13,6 +13,7 @@ export type SoundProps = {
   status: SoundStatus;
   seek?: number;
   volume?: number;
+  sampleRate?: number;
   preload?: HTMLAudioElement['preload'];
   crossOrigin?: ScriptHTMLAttributes<HTMLAudioElement>['crossOrigin'];
   onTimeUpdate?: (args: { position: number; duration: number }) => void;

packages/player/changelog.json

@@ -1,4 +1,16 @@
 [
+  {
+    "date": "2026-07-01T00:00",
+    "description": "Fix audio going silent after about a second over Bluetooth on Linux",
+    "type": "fix",
+    "contributors": ["nukeop"],
+    "tags": [
+      {
+        "label": "Playback",
+        "color": "green"
+      }
+    ]
+  },
   {
     "date": "2026-07-01T00:00",
     "description": "Fix yt-dlp playback stalling at segment boundaries (e.g. 0:09, 0:29) when buffered audio drifted past the next segment's start time",

packages/player/src-tauri/src/main.rs

@@ -58,4 +58,16 @@ fn apply_linux_workarounds() {
             std::env::set_var("WEBKIT_DISABLE_COMPOSITING_MODE", "1");
         }
     }
+
+    // WebKitGTK's Web Audio GStreamer pipeline stalls on Bluetooth A2DP when
+    // GStreamer autoselects pipewiresink: the pipeline is hardcoded to 44100 Hz
+    // while A2DP sinks on PipeWire expect 48000 Hz, and audio goes silent after
+    // about a second. Demoting pipewiresink's rank makes autoaudiosink fall back
+    // to pulsesink (via pipewire-pulse), which resamples correctly.
+    // Reported here: https://github.com/nukeop/nuclear/discussions/1980
+    if std::env::var("GST_PLUGIN_FEATURE_RANK").is_err() {
+        unsafe {
+            std::env::set_var("GST_PLUGIN_FEATURE_RANK", "pipewiresink:NONE");
+        }
+    }
 }

packages/player/src/components/SoundProvider.tsx

@@ -2,6 +2,7 @@ import type { FC, PropsWithChildren } from 'react';
 import { useCallback, useEffect } from 'react';
 
 import { Sound, Volume } from '@nuclearplayer/hifi';
+import { usePlatform } from '@nuclearplayer/ui';
 
 import { useCoreSetting } from '../hooks/useCoreSetting';
 import { eventBus } from '../services/eventBus';
@@ -10,6 +11,11 @@ import { useQueueStore } from '../stores/queueStore';
 import { useSoundStore } from '../stores/soundStore';
 import { resolveErrorMessage } from '../utils/logging';
 
+// WebKitGTK's Web Audio GStreamer pipeline is hardcoded to 44100 Hz, which
+// causes silent audio over Bluetooth A2DP (PipeWire sinks expect 48000 Hz).
+// Forcing the AudioContext to 48000 Hz on Linux avoids the mismatch.
+const LINUX_SAMPLE_RATE_HZ = 48000;
+
 export const SoundProvider: FC<PropsWithChildren> = ({ children }) => {
   const { src, status, seek } = useSoundStore();
   const [crossfadeMs] = useCoreSetting<number>('playback.crossfadeMs');
@@ -18,6 +24,8 @@ export const SoundProvider: FC<PropsWithChildren> = ({ children }) => {
   const [volume01] = useCoreSetting<number>('playback.volume');
   const [muted] = useCoreSetting<boolean>('playback.muted');
   const volumePercent = muted ? 0 : Math.round((volume01 ?? 1) * 100);
+  const platform = usePlatform();
+  const sampleRate = platform === 'linux' ? LINUX_SAMPLE_RATE_HZ : undefined;
 
   useEffect(() => {
     if (crossfadeMs !== undefined) {
@@ -71,6 +79,7 @@ export const SoundProvider: FC<PropsWithChildren> = ({ children }) => {
           status={status}
           seek={seek}
           volume={volumePercent}
+          sampleRate={sampleRate}
           preload={preload}
           crossOrigin={crossOrigin}
           onTimeUpdate={handleTimeUpdate}