Developer Music Companion

A VS Code extension that provides adaptive background music for coding. The music selection adapts to your productivity patterns to enhance your coding experience.

Features

• 🎵 Adaptive music playback based on coding patterns
• 🎨 Multiple music moods: Focus, Energy, Calm, and Ambient
• 🔄 Auto-adjusting music based on your coding activity
• 🎯 Easy access through status bar, activity bar, and command palette
• ⌨️ Keyboard shortcuts for quick control
• 🔗 Last.fm integration for smart music selection

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "Developer Music Companion"
4. Click Install

First-Time Setup

After installation, you'll need to configure your Last.fm API key:

1. Look for the Music Companion icon in the Activity Bar (sidebar)
2. Click "Configure API Key" or use the status bar item
3. Get a free Last.fm API key:
   • Visit Last.fm API
   • Create an account if needed
   • Create an API application
   • Copy your API key
4. Paste your API key in VS Code settings when prompted

How to Access

The extension can be accessed in multiple ways:

1. Status Bar

• Look for the "▶️ Music Companion" item in the bottom right
• Click to start/pause music
• Shows currently playing track when active

2. Activity Bar

• Find the Music Companion icon in the sidebar
• Shows detailed controls and now playing information
• Access settings and additional features

3. Command Palette

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac) and type:

• Music Companion: Play Music
• Music Companion: Pause Music
• Music Companion: Stop Music
• Music Companion: Show Welcome

4. Keyboard Shortcuts

Default shortcuts:

• Play/Pause: Ctrl+Alt+P (Windows/Linux) or Cmd+Alt+P (Mac)
• Skip Track: Ctrl+Alt+S (Windows/Linux) or Cmd+Alt+S (Mac)
• Stop: Ctrl+Alt+X (Windows/Linux) or Cmd+Alt+X (Mac)

Settings

Access settings through:

1. Command Palette → "Preferences: Open Settings (UI)"
2. Search for "Music Companion"

Available settings:

• musicCompanion.lastfmApiKey: Your Last.fm API key
• musicCompanion.autoStart: Automatically start music when VS Code launches
• musicCompanion.defaultMood: Default mood for music selection
• musicCompanion.volume: Default volume level (0-100)

Troubleshooting

If you don't see the extension after installation:

1. Check Activity Bar

   • Make sure the activity bar is visible (View → Show Activity Bar)
   • Look for the Music Companion icon

2. Check Status Bar

   • Look for "Music Companion" in the bottom right
   • If not visible, try reloading VS Code

3. Verify Installation

   • Open Extensions panel
   • Search for "Music Companion"
   • Ensure it shows as "Installed"

4. Reset Extension

   • Command Palette → "Developer: Reload Window"
   • If issues persist, try uninstalling and reinstalling

Support

If you encounter issues:

1. Check the troubleshooting guide above
2. Visit our GitHub repository
3. Submit an issue on GitHub

Contributing

We welcome contributions! Please see our for guidelines.

License

This extension is licensed under the MIT License. See the LICENSE file for details.