Skip to content

linux voice service support - v2.4 #545

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
m8ryx wants to merge 1 commit into
base: main
Choose a base branch
from
Open

linux voice service support - v2.4 #545

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
185 changes: 185 additions & 0 deletions Releases/v2.4/.claude/VoiceServer/linux-service/install.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,185 @@
#!/bin/bash

# Voice Server Linux Installation Script
# Installs the voice server as a systemd user service

set -e

# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m'

SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
VOICE_DIR="$(dirname "$SCRIPT_DIR")"
SERVICE_NAME="pai-voice-server"
SERVICE_DIR="$HOME/.config/systemd/user"
SERVICE_FILE="$SERVICE_DIR/${SERVICE_NAME}.service"
ENV_FILE="$HOME/.claude/.env"

echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE} Voice Server Linux Installation${NC}"
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo

# Check for Bun
echo -e "${YELLOW}▶ Checking prerequisites...${NC}"
if ! command -v bun &> /dev/null; then
echo -e "${RED}✗ Bun is not installed${NC}"
echo " Install Bun first:"
echo " curl -fsSL https://bun.sh/install | bash"
exit 1
fi
echo -e "${GREEN}✓ Bun is installed${NC}"

# Check for audio player
if command -v mpv &> /dev/null; then
echo -e "${GREEN}✓ mpv is installed (audio playback)${NC}"
elif command -v ffplay &> /dev/null; then
echo -e "${GREEN}✓ ffplay is installed (audio playback)${NC}"
else
echo -e "${RED}✗ No audio player found${NC}"
echo " Install one of:"
echo " sudo apt install mpv # Recommended"
echo " sudo apt install ffmpeg # Alternative (provides ffplay)"
exit 1
fi

# Check for notify-send
if command -v notify-send &> /dev/null; then
echo -e "${GREEN}✓ notify-send is installed (desktop notifications)${NC}"
else
echo -e "${YELLOW}⚠ notify-send not found (optional, for desktop notifications)${NC}"
echo " Install with: sudo apt install libnotify-bin"
fi

# Check for ElevenLabs configuration
echo -e "${YELLOW}▶ Checking ElevenLabs configuration...${NC}"
ELEVENLABS_CONFIGURED=false
if [ -f "$ENV_FILE" ] && grep -q "ELEVENLABS_API_KEY=" "$ENV_FILE"; then
API_KEY=$(grep "ELEVENLABS_API_KEY=" "$ENV_FILE" | cut -d'=' -f2 | tr -d "'" | tr -d '"')
if [ "$API_KEY" != "your_api_key_here" ] && [ -n "$API_KEY" ]; then
echo -e "${GREEN}✓ ElevenLabs API key configured${NC}"
ELEVENLABS_CONFIGURED=true
fi
fi

if [ "$ELEVENLABS_CONFIGURED" = false ]; then
echo -e "${YELLOW}⚠ ElevenLabs API key not configured${NC}"
echo " Add your key to ~/.claude/.env:"
echo " echo 'ELEVENLABS_API_KEY=your_key_here' >> ~/.claude/.env"
echo " Get a free key at: https://elevenlabs.io"
echo
fi

# Check if already installed
if systemctl --user is-active "$SERVICE_NAME" &> /dev/null; then
echo -e "${YELLOW}⚠ Voice server is already running${NC}"
read -p "Do you want to reinstall? (y/n): " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
echo -e "${YELLOW}▶ Stopping existing service...${NC}"
systemctl --user stop "$SERVICE_NAME" 2>/dev/null || true
systemctl --user disable "$SERVICE_NAME" 2>/dev/null || true
echo -e "${GREEN}✓ Existing service stopped${NC}"
else
echo "Installation cancelled"
exit 0
fi
fi

# Create systemd user service directory
echo -e "${YELLOW}▶ Creating systemd user service...${NC}"
mkdir -p "$SERVICE_DIR"

# Generate service file with resolved paths
BUN_PATH="$(which bun)"
cat > "$SERVICE_FILE" << EOF
[Unit]
Description=PAI Voice Server - ElevenLabs TTS notification server
After=network.target sound.target

[Service]
Type=simple
ExecStart=${BUN_PATH} run ${VOICE_DIR}/server.ts
WorkingDirectory=${VOICE_DIR}
Restart=on-failure
RestartSec=5
Environment=HOME=${HOME}
Environment=PATH=${HOME}/.bun/bin:/usr/local/bin:/usr/bin:/bin
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=default.target
EOF

echo -e "${GREEN}✓ Systemd service file created${NC}"

# Enable and start the service
echo -e "${YELLOW}▶ Starting voice server service...${NC}"
systemctl --user daemon-reload
systemctl --user enable "$SERVICE_NAME"
systemctl --user start "$SERVICE_NAME"

# Wait for server to start
sleep 2

# Test the server
echo -e "${YELLOW}▶ Testing voice server...${NC}"
if curl -s -f -X GET http://localhost:8888/health > /dev/null 2>&1; then
echo -e "${GREEN}✓ Voice server is running${NC}"

# Send test notification
echo -e "${YELLOW}▶ Sending test notification...${NC}"
curl -s -X POST http://localhost:8888/notify \
-H "Content-Type: application/json" \
-d '{"message": "Voice server installed successfully on Linux"}' > /dev/null
echo -e "${GREEN}✓ Test notification sent${NC}"
else
echo -e "${RED}✗ Voice server is not responding${NC}"
echo " Check logs: journalctl --user -u $SERVICE_NAME -f"
echo " Try running manually: bun run $VOICE_DIR/server.ts"
exit 1
fi

# Enable lingering so service runs even when not logged in (optional)
if command -v loginctl &> /dev/null; then
loginctl enable-linger "$(whoami)" 2>/dev/null || true
fi

# Summary
echo
echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${GREEN} ✓ Installation Complete!${NC}"
echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo
echo -e "${BLUE}Service Information:${NC}"
echo " Service: $SERVICE_NAME"
echo " Status: Running"
echo " Port: 8888"
echo " Logs: journalctl --user -u $SERVICE_NAME"

if [ "$ELEVENLABS_CONFIGURED" = true ]; then
echo " Voice: ElevenLabs AI"
else
echo " Voice: Not configured (add ELEVENLABS_API_KEY to ~/.claude/.env)"
fi

echo
echo -e "${BLUE}Management Commands:${NC}"
echo " Status: systemctl --user status $SERVICE_NAME"
echo " Stop: systemctl --user stop $SERVICE_NAME"
echo " Start: systemctl --user start $SERVICE_NAME"
echo " Restart: systemctl --user restart $SERVICE_NAME"
echo " Logs: journalctl --user -u $SERVICE_NAME -f"
echo " Uninstall: $SCRIPT_DIR/uninstall.sh"
echo
echo -e "${BLUE}Test the server:${NC}"
echo " curl -X POST http://localhost:8888/notify \\"
echo " -H 'Content-Type: application/json' \\"
echo " -d '{\"message\": \"Hello from PAI\"}'"
echo
echo -e "${GREEN}The voice server will start automatically on login.${NC}"
18 changes: 18 additions & 0 deletions Releases/v2.4/.claude/VoiceServer/linux-service/pai-voice-server.service
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
[Unit]
Description=PAI Voice Server - ElevenLabs TTS notification server
After=network.target sound.target
Wants=pulseaudio.service

[Service]
Type=simple
ExecStart=%h/.bun/bin/bun run %h/.claude/VoiceServer/server.ts
WorkingDirectory=%h/.claude/VoiceServer
Restart=on-failure
RestartSec=5
Environment=HOME=%h
Environment=PATH=%h/.bun/bin:/usr/local/bin:/usr/bin:/bin
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=default.target
33 changes: 33 additions & 0 deletions Releases/v2.4/.claude/VoiceServer/linux-service/uninstall.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
#!/bin/bash

# Voice Server Linux Uninstall Script

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

SERVICE_NAME="pai-voice-server"
SERVICE_FILE="$HOME/.config/systemd/user/${SERVICE_NAME}.service"

echo -e "${YELLOW}▶ Uninstalling Voice Server...${NC}"

if systemctl --user is-active "$SERVICE_NAME" &> /dev/null; then
echo -e "${YELLOW}▶ Stopping service...${NC}"
systemctl --user stop "$SERVICE_NAME"
echo -e "${GREEN}✓ Service stopped${NC}"
fi

if systemctl --user is-enabled "$SERVICE_NAME" &> /dev/null; then
echo -e "${YELLOW}▶ Disabling service...${NC}"
systemctl --user disable "$SERVICE_NAME"
echo -e "${GREEN}✓ Service disabled${NC}"
fi

if [ -f "$SERVICE_FILE" ]; then
rm "$SERVICE_FILE"
systemctl --user daemon-reload
echo -e "${GREEN}✓ Service file removed${NC}"
fi

echo -e "${GREEN}✓ Voice server uninstalled${NC}"
63 changes: 52 additions & 11 deletions Releases/v2.4/.claude/VoiceServer/server.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,12 @@

import { serve } from "bun";
import { spawn } from "child_process";
import { homedir } from "os";
import { homedir, platform } from "os";
import { join } from "path";

// Platform detection for cross-platform support
const IS_LINUX = platform() === "linux";
const IS_MACOS = platform() === "darwin";
import { existsSync, readFileSync } from "fs";

// Load .env from ~/.claude directory
Expand Down Expand Up @@ -274,7 +278,7 @@ function getVolumeSetting(requestVolume?: number): number {
return 1.0; // Default to full volume
}

// Play audio using afplay (macOS)
// Play audio using platform-appropriate player
async function playAudio(audioBuffer: ArrayBuffer, requestVolume?: number): Promise<void> {
const tempFile = `/tmp/voice-${Date.now()}.mp3`;

Expand All @@ -284,22 +288,53 @@ async function playAudio(audioBuffer: ArrayBuffer, requestVolume?: number): Prom
const volume = getVolumeSetting(requestVolume);

return new Promise((resolve, reject) => {
// afplay -v takes a value from 0.0 to 1.0
const proc = spawn('/usr/bin/afplay', ['-v', volume.toString(), tempFile]);
let proc;

if (IS_LINUX) {
// Linux: use mpv (preferred) or ffplay (fallback)
proc = spawn('mpv', [
'--no-video',
'--no-terminal',
`--volume=${Math.round(volume * 100)}`,
tempFile,
]);
proc.on('error', () => {
// mpv not found, try ffplay
console.warn('mpv not found, trying ffplay...');
const ffProc = spawn('ffplay', [
'-nodisp', '-autoexit',
'-volume', Math.round(volume * 100).toString(),
tempFile,
]);
ffProc.on('error', (error) => {
console.error('No audio player found. Install mpv or ffmpeg:', error);
spawn('rm', ['-f', tempFile]);
reject(error);
});
ffProc.on('exit', (code) => {
spawn('rm', ['-f', tempFile]);
code === 0 ? resolve() : reject(new Error(`ffplay exited with code ${code}`));
});
});
} else {
// macOS: afplay -v takes a value from 0.0 to 1.0
proc = spawn('/usr/bin/afplay', ['-v', volume.toString(), tempFile]);
}

proc.on('error', (error) => {
if (IS_LINUX) return; // Already handled above with fallback
console.error('Error playing audio:', error);
reject(error);
});

proc.on('exit', (code) => {
// Clean up temp file
spawn('/bin/rm', [tempFile]);
spawn('rm', ['-f', tempFile]);

if (code === 0) {
resolve();
} else {
reject(new Error(`afplay exited with code ${code}`));
reject(new Error(`Audio player exited with code ${code}`));
}
});
});
Expand Down Expand Up @@ -400,12 +435,18 @@ async function sendNotification(
}
}

// Display macOS notification - escape for AppleScript
// Display desktop notification
try {
const escapedTitle = escapeForAppleScript(safeTitle);
const escapedMessage = escapeForAppleScript(safeMessage);
const script = `display notification "${escapedMessage}" with title "${escapedTitle}" sound name ""`;
await spawnSafe('/usr/bin/osascript', ['-e', script]);
if (IS_LINUX) {
// Linux: notify-send (libnotify)
await spawnSafe('notify-send', ['--app-name=PAI', safeTitle, safeMessage]);
} else {
// macOS: AppleScript notification
const escapedTitle = escapeForAppleScript(safeTitle);
const escapedMessage = escapeForAppleScript(safeMessage);
const script = `display notification "${escapedMessage}" with title "${escapedTitle}" sound name ""`;
await spawnSafe('/usr/bin/osascript', ['-e', script]);
}
} catch (error) {
console.error("Notification display error:", error);
}
Expand Down
Loading