feat: enhance ydotool integration for direct typing on Linux; improve error handling and logging in audio processing; update build scripts for better installation guidance

internal/audio/recorder/recorder.go

@@ -6,6 +6,7 @@ import (
 	"encoding/binary"
 	"fmt"
 	"os"
+	"runtime"
 	"sync"
 	"sync/atomic"
 
@@ -207,16 +208,15 @@ func (r *AudioRecorder) Stop() error {
 	// callbacks from writing to a closed file.
 	atomic.StoreInt32(&r.writing, 0)
 
-	// Stop the capture device. We keep the device initialized between recordings
-	// to avoid the expensive re-initialization cycle. ALSA privacy indicators
-	// will still turn off because we've stopped the stream.
+	// Stop the capture device.
 	if r.device != nil {
 		if err := r.device.Stop(); err != nil {
 			logger.Error("Failed to stop audio device: %v", err)
 		}
-		// Do NOT Uninit the device between recordings. Keeping it alive
-		// avoids expensive ALSA device re-probe and reduces CPU spikes.
-		// The device will be fully cleaned up in Cleanup().
+		if runtime.GOOS == "linux" {
+			r.device.Uninit()
+			r.device = nil
+		}
 	}
 
 	// Finalize WAV file

internal/xhotkey/hotkey_linux_portal.go

@@ -338,34 +338,37 @@ func (hk *Hotkey) registerPortal() error {
 	return nil
 }
 
-// safeSendKeydown sends a keydown event to the hotkey channel, recovering from panic
-// if the channel has been closed (e.g. during hotkey re-registration).
-func (hk *Hotkey) safeSendKeydown() {
+func (hk *Hotkey) sendPortalEvent(name string, ch chan<- Event) {
+	hk.mu.Lock()
+	stopCh := hk.portalStop
+	registered := hk.registered
+	hk.mu.Unlock()
+	if !registered || stopCh == nil {
+		return
+	}
+
 	defer func() {
 		if r := recover(); r != nil {
-			logger.Debug("safeSendKeydown: recovered from panic: %v", r)
+			logger.Debug("sendPortalEvent(%s): recovered from panic: %v", name, r)
 		}
 	}()
+
 	select {
-	case hk.keydownIn <- Event{}:
-	default:
-		// Channel buffer is full or closed; skip.
+	case ch <- Event{}:
+	case <-stopCh:
+	case <-time.After(2 * time.Second):
+		logger.Error("Timed out delivering Linux portal hotkey %s event", name)
 	}
 }
 
-// safeSendKeyup sends a keyup event to the hotkey channel, recovering from panic
-// if the channel has been closed (e.g. during hotkey re-registration).
+// safeSendKeydown sends a keydown event to the hotkey channel.
+func (hk *Hotkey) safeSendKeydown() {
+	hk.sendPortalEvent("keydown", hk.keydownIn)
+}
+
+// safeSendKeyup sends a keyup event to the hotkey channel.
 func (hk *Hotkey) safeSendKeyup() {
-	defer func() {
-		if r := recover(); r != nil {
-			logger.Debug("safeSendKeyup: recovered from panic: %v", r)
-		}
-	}()
-	select {
-	case hk.keyupIn <- Event{}:
-	default:
-		// Channel buffer is full or closed; skip.
-	}
+	hk.sendPortalEvent("keyup", hk.keyupIn)
 }
 
 func (hk *Hotkey) portalSignalLoop() {
@@ -458,4 +461,4 @@ func (hk *Hotkey) cleanupPortal() error {
 		_ = conn.Close()
 	}
 	return nil
-}
+}