Live Trans

Real-time translation of Spotify song lyrics. Display synchronized translations of foreign language songs as they play.

Features

• Real-time synchronized lyrics display as songs play
• Translates titles and lyrics to English using Claude AI
• Caches translations for instant replay
• Highlights current line based on playback position

Prerequisites

• Spotify Premium account
• Anthropic API key for Claude (get one here)

Installation

Pre-built Binaries (Recommended)

macOS/Linux:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Crazytieguy/live-trans/releases/latest/download/live-trans-installer.sh | sh

Windows (PowerShell):

irm https://github.com/Crazytieguy/live-trans/releases/latest/download/live-trans-installer.ps1 | iex

Homebrew (macOS/Linux):

brew install Crazytieguy/tap/live-trans

Cargo (from source):

cargo install live-trans

Or download pre-built binaries from GitHub Releases.

Usage

live-trans

# Or provide API key via CLI
live-trans --api-key sk-ant-...

On first run:

1. Enter your Anthropic API key when prompted (or use --api-key flag)
2. Your browser will open automatically for Spotify authorization
3. Authorize and you're done - no URL pasting needed!

Then just play a song on Spotify and enjoy!

Notes

• Requires Spotify Premium and time-synchronized lyrics
• Spotify credentials embedded - no app setup needed
• Credentials and translations cached - configure once, replay instantly

Troubleshooting

No lyrics: Not all songs have synchronized lyrics - try a different song

Invalid API key: You'll be automatically prompted to re-enter your key

Insufficient credits: Add credits at https://console.anthropic.com/settings/billing

Port 8888 in use: Another application is using the port - close it or change the port in the code

Config/cache locations:

• macOS: ~/Library/Application Support/com.live-trans.live-trans/, ~/Library/Caches/com.live-trans.live-trans/
• Linux: ~/.config/live-trans/, ~/.cache/live-trans/
• Windows: %APPDATA%\live-trans\, %LOCALAPPDATA%\live-trans\

License

MIT