clawspotify

# ClawSpotify 🎵

Control your Spotify playback directly from your OpenClaw agent or terminal. Works with **both Free and Premium** Spotify accounts.

---

## 📦 Installation

### Via ClawHub (recommended)
```bash
clawhub install clawspotify
```

### Manual from GitHub
```bash
# Clone main skill
git clone https://github.com/ejatapibeda/ClawSpotify.git ~/.openclaw/workspace/skills/ClawSpotify

# Create virtual environment
python3 -m venv ~/.venv-clawspotify

# Install SpotAPI (modified version with session support)
git clone https://github.com/ejatapibeda/SpotAPI.git ~/.openclaw/workspace/skills/SpotAPI
~/.venv-clawspotify/bin/pip install -e ~/.openclaw/workspace/skills/SpotAPI

# Create wrapper script
cat > ~/.local/bin/clawspotify << 'EOF'
#!/bin/bash
VENV="/home/$(whoami)/.venv-clawspotify"
SCRIPT_DIR="/home/$(whoami)/.openclaw/workspace/skills/ClawSpotify"
exec "$VENV/bin/python" "$SCRIPT_DIR/scripts/spotify.py" "$@"
EOF
chmod +x ~/.local/bin/clawspotify

# Ensure ~/.local/bin is in PATH
export PATH="$HOME/.local/bin:$PATH"
```

### Dependencies
- Python 3.10+
- SpotAPI (custom version from ejatapibeda/SpotAPI)
- Active Spotify account (Free or Premium)
- Spotify app open on at least one device (PC/phone/web) for playback commands to work

---

## 🔐 First-Time Setup (Authentication)

`clawspotify` authenticates using two session cookies from your browser (`sp_dc` and `sp_key`). You only need to do this **once per account**.

### Step-by-step

1. Open **[https://open.spotify.com](https://open.spotify.com)** in your browser and **log in**
2. Press **F12** to open DevTools
3. Go to **Application** tab → **Cookies** → `https://open.spotify.com`
4. Find and copy the value of **`sp_dc`**
5. Find and copy the value of **`sp_key`**
6. Run:
```bash
clawspotify setup --sp-dc "AQC..." --sp-key "07c9..."
```

Session is saved to `~/.config/spotapi/session.json` and reused automatically.

#### Multi-account supp...

# ClawSpotify 🎵

> An [OpenClaw](https://github.com/ejatapibeda) skill — control Spotify playback from your AI agent or terminal.

Control Spotify entirely from the command line (or via your OpenClaw agent): play songs by name, skip tracks, manage volume, shuffle, repeat, search playlists, and check what's playing — all without touching the Spotify app.

---

## Requirements

| Requirement | Notes |
|-------------|-------|
| Python 3.10+ | `python3 --version` |
| [SpotAPI](https://github.com/ejatapibeda/SpotAPI) | `pip install -e ./SpotAPI` or `pip install git+https://github.com/ejatapibeda/SpotAPI.git`|
| Active Spotify account | Free or Premium |
| Spotify open on any device | Desktop, mobile, or web player |

> **Windows users:** Running the `clawspotify` bash script natively on Windows requires WSL, Git Bash, or Cygwin. Alternatively, you can run `python scripts/spotify.py` directly.

---

## Installation

### Via ClawHub
```bash
clawhub install clawspotify
```

### Manual
```bash
git clone https://github.com/ejatapibeda/ClawSpotify.git
cd ClawSpotify

# Install SpotAPI dependency
git clone https://github.com/ejatapibeda/SpotAPI.git
pip install -e ./SpotAPI
# alternative
pip install git+https://github.com/ejatapibeda/SpotAPI.git

# Make wrapper executable and add to PATH
chmod +x clawspotify.sh
ln -s $(pwd)/clawspotify.sh ~/.local/bin/clawspotify
```

---

## First-time Setup — Getting `sp_dc` and `sp_key`

`clawspotify` authenticates using two session cookies from your browser. You only need to do this **once per account**.

### Step-by-step

1. Open **[https://open.spotify.com](https://open.spotify.com)** in your browser and **log in**
2. Press **F12** to open DevTools
3. Go to **Application** tab → **Cookies** → `https://open.spotify.com`
4. Find and copy the value of **`sp_dc`**
5. Find and copy the value of **`sp_key`**

### Save your session

```bash
clawspotify setup --sp-dc "AQCqbfRJ..." --sp-...