Spotify VS Code Widget

A beautiful Spotify player widget for Visual Studio Code that displays your currently playing track with playback controls, designed to look like the Spotify mobile app.

Features

• 🎵 Real-time display of currently playing track
• 🎨 Spotify mobile app-inspired design
• ⏯️ Playback controls (Play/Pause, Next, Previous)
• 📊 Progress bar with time display
• 🖼️ Album artwork display
• 🔄 Fast auto-refresh (1 second updates)
• 🔐 Secure PKCE authentication

Setup Instructions

1. Create a Spotify Application (One Time Setup)

1. Go to Spotify Developer Dashboard
2. Log in with your Spotify account
3. Click "Create app"
4. Fill in the details:
   • App name: VS Code Spotify Widget (or any name)
   • App description: Personal Spotify widget
   • Redirect URI: https://itsnotalexy.github.io/vscode-spotify-widget/callback
   • Which API/SDKs are you planning to use?: Web API
5. Save and open your app settings
6. Copy your Client ID (NOT the Client Secret!)

2. Configure VS Code

1. Open VS Code Settings (Ctrl+, or Cmd+,)
2. Search for "Spotify Widget"
3. Paste your Client ID into Spotify Widget: Client Id

3. Authenticate

1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
2. Type "Authenticate with Spotify" and press Enter
3. Click "Open Spotify Login"
4. Log in to Spotify and authorize the app
5. Copy the authorization code from the page
6. Paste it back into VS Code
7. Done! 🎉

Commands

• Spotify Widget: Authenticate with Spotify - Log in to your Spotify account
• Spotify Widget: Show - Show the Spotify widget panel
• Spotify Widget: Hide - Hide the Spotify widget panel

Configuration

{
  "spotifyWidget.clientId": "your_client_id_here",
  "spotifyWidget.refreshInterval": 1000
}

• clientId: Your Spotify App Client ID
• refreshInterval: Update frequency in milliseconds (default: 1000ms)

Requirements

• Active Spotify account (Free or Premium)
• Spotify app must be playing music
• Internet connection

Security

• Your Client ID is stored securely in VS Code settings
• Client Secret is NOT needed (uses PKCE flow)
• Access tokens are stored locally and never shared
• No third-party servers involved

Troubleshooting

"Not authenticated" message

• Run "Authenticate with Spotify" command
• Make sure you set your Client ID in settings

Slow updates

• Reduce refresh interval in settings (minimum 500ms recommended)
• Default is 1000ms for balance between speed and API limits

Token expired

• Tokens last 1 hour
• Just re-authenticate when needed (takes 10 seconds)

Known Limitations

• Currently only supports Windows for playback controls
• Requires Spotify desktop app to be running
• Track information updates may have a slight delay

Development

To work on this extension:

1. Clone the repository
2. Run npm install
3. Press F5 to start debugging
4. The Extension Development Host will open with the extension loaded

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Credits

• Developed by itsnotalexy
• This project is not affiliated with Spotify AB. Any use of Spotify's API and trademarks is done in accordance with their Developer Terms of Service.