🎵 CodeTunes
A sleek, modern music player for Visual Studio Code powered by JioSaavn
Search and play millions of songs directly in your editor with a beautiful interface and automatic song suggestions.
✨ Features
🔍 Powerful Search & Discovery
- Global Search - Search across millions of songs, albums, artists, and playlists
- Instant Results - Fast, responsive search with rich metadata and album art
- Smart Suggestions - Get personalized song recommendations based on what you're listening to
- Auto-Play Next - Never run out of music! Songs automatically continue with similar tracks
🎵 High-Quality Audio Playback
- Direct Streaming - Play music directly from JioSaavn's high-quality servers
- Multiple Quality Options - Choose from 12kbps to 320kbps audio quality
- Seamless Playback - Smooth audio streaming with no interruptions
- Intuitive Controls - Play, pause, and control your music effortlessly
🎨 Beautiful Modern UI
- Vinyl Record Player - Aesthetic spinning album art display with visual effects
- Glassmorphism Design - Modern frosted glass effects and smooth animations
- Custom Purple Theme - Unique purple color scheme that matches VS Code
- Responsive Layout - Adapts perfectly to different sidebar sizes
- Dark Theme Optimized - Seamless integration with VS Code's dark themes
🚀 Smart Features
- Continuous Playback - Songs automatically transition to similar tracks
- "Up Next" Display - See what's coming up in your listening queue
- Activity Bar Integration - Dedicated music icon in VS Code's activity bar
- Explorer View Support - Available in both activity bar and file explorer
- No Authentication Required - Start listening immediately, no setup needed
🚀 Quick Start
1. Install CodeTunes
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X)
- Search for "CodeTunes"
- Click Install
2. Start Listening
- Click the music note icon (♪) in the Activity Bar
- Type any song, artist, or album name in the search box
- Click the play button next to any result
- Enjoy continuous music as similar songs play automatically!
3. How It Works
- Search: Type any song name, artist, or album
- Play: Click play on any search result
- Auto-Continue: When songs end, similar tracks play automatically
- Control: Use play/pause controls anytime
- Discover: Explore new music through smart suggestions
🎯 Key Benefits
For Developers
- Zero Distraction - Listen to music without leaving your coding environment
- Background Audio - Music plays while you code, debug, and develop
- Productivity Boost - Maintain focus with your favorite tunes
- Quick Access - Instant music search and playback
For Music Lovers
- Unlimited Access - Millions of songs from JioSaavn's vast library
- Smart Discovery - Never run out of music with automatic suggestions
- High Quality - Crystal clear audio up to 320kbps
- Seamless Experience - No ads, no interruptions, pure music
🛠️ Technical Details
API Integration
- Custom JioSaavn API - Direct integration with JioSaavn's music database
- Real-time Search - Instant search results with metadata
- Song Suggestions - AI-powered music recommendations
- Multiple Formats - Support for various audio qualities
VS Code Integration
- Webview API - Native VS Code webview for smooth UI
- Command System - VS Code commands for all music controls
- State Management - Persistent playback state across sessions
- Theme Support - Automatic adaptation to VS Code themes
- Fast Compilation - Optimized build process with esbuild
- TypeScript - Full type safety and modern JavaScript features
- Efficient Rendering - Smooth animations and responsive design
- Low Resource Usage - Minimal impact on VS Code performance
📦 Installation
From VS Code Marketplace (Recommended)
- Open VS Code
- Press
Ctrl+Shift+X (or Cmd+Shift+X on Mac)
- Search for "CodeTunes"
- Click Install
- Restart VS Code if prompted
Manual Installation
- Download the
.vsix file from releases
- In VS Code:
Extensions → Install from VSIX...
- Select the downloaded file
- Restart VS Code
🎮 Usage Guide
Basic Playback
- Open CodeTunes: Click the music icon in the activity bar
- Search: Type song names, artists, or albums
- Play: Click the play button on any result
- Control: Use play/pause buttons as needed
Advanced Features
- Continuous Listening: Songs automatically continue with similar tracks
- Quality Selection: Different audio qualities available
- Queue Preview: See "Up Next" suggestions
- Multiple Views: Access from activity bar or explorer
Keyboard Shortcuts
Ctrl+Shift+P → "CodeTunes: Search Music"Ctrl+Shift+P → "CodeTunes: Play Song"Ctrl+Shift+P → "CodeTunes: Pause"Ctrl+Shift+P → "CodeTunes: Resume"
🔧 Configuration
CodeTunes works out-of-the-box with no configuration required. The extension automatically:
- Connects to JioSaavn's API
- Manages audio playback
- Handles search and suggestions
- Adapts to your VS Code theme
🐛 Troubleshooting
Common Issues
Music not playing?
- Check your internet connection
- Try refreshing the extension view
- Restart VS Code
Search not working?
- Verify API connectivity
- Check for typos in search terms
- Try different search terms
UI not loading?
- Reload VS Code window (
Ctrl+Shift+P → "Developer: Reload Window")
- Check VS Code version (requires 1.106.0+)
Getting Help
🤝 Contributing
We welcome contributions! See our Contributing Guide for details.
Development Setup
- Clone the repository
- Run
npm install
- Use
npm run compile to build
- Press
F5 to launch debug session
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- JioSaavn - For providing the music database and API
- VS Code Team - For the amazing extension platform
- Contributors - For helping improve CodeTunes
📞 Support
| |
