Skip to content

bwalid13/musictab

Repository files navigation

🎵 MusicTab - Local MP3 Player

Chrome Web Store License Version

Transform your Chrome browser into a powerful local music player. Play your MP3 files directly from your computer with a beautiful, modern interface featuring album artwork and artist information.


✨ Features

🎧 Core Features

  • Local MP3 Playback - Play MP3 files directly from your device
  • iTunes Metadata Integration - Automatically fetch album covers, artist photos, and track information
  • Beautiful Interface - Clean, modern design with multiple themes (iOS, Windows 11, Neumorphism, and more)
  • Folder Support - Load entire music folders automatically
  • Audio Visualizer - Watch your music come to life with stunning visual effects
  • Ambiance Mode - Dynamic background effects that match your music

🔒 Privacy First

  • ✅ All files processed locally on your device
  • ✅ No file uploads - your music stays on your computer
  • ✅ Metadata requests only fetch public information
  • ✅ No tracking, no ads, no data collection

🎨 User Experience

  • Multiple professional themes (iOS, Windows 11, Neumorphism, etc.)
  • Album artwork display with dynamic ambiance effects
  • Artist information and photos from Wikipedia
  • Intuitive playback controls with beautiful animations
  • Volume control and progress bar
  • Shuffle and loop modes

📥 Installation

From Chrome Web Store (Recommended)

  1. Visit the MusicTab Chrome Web Store page (coming soon)
  2. Click "Add to Chrome"
  3. Enjoy your music!

Manual Installation

  1. Download the latest release
  2. Extract the ZIP file
  3. Open Chrome and go to chrome://extensions/
  4. Enable "Developer mode" (top right)
  5. Click "Load unpacked"
  6. Select the extracted folder
  7. Click the MusicTab icon to start!

🚀 Quick Start

  1. Open MusicTab

    • Click the MusicTab icon in your browser toolbar
    • Or open a new tab (if configured)
  2. Add Your Music

    • Click "Select Folder" to load an entire music folder
    • Or click "Add Files" to select individual MP3 files
  3. Enjoy!

    • Album covers and artist info load automatically
    • Explore different themes and visual effects

⌨️ Keyboard Shortcuts

Action Shortcut
Play/Pause Space
Next Track (Right Arrow)
Previous Track (Left Arrow)

🎵 Supported Audio Format

  • MP3 (.mp3) - Full support with ID3 tag reading

🔧 Technical Details

Built With

  • Vanilla JavaScript (no frameworks)
  • HTML5 Audio API
  • Chrome Extension Manifest V3
  • iTunes Search API
  • Wikipedia API
  • jsmediatags library for ID3 tag reading

Permissions

  • storage - Save preferences locally
  • tabs - Open player in new tab
  • https://itunes.apple.com/* - Fetch album artwork
  • https://*.wikipedia.org/* - Fetch artist information

See Privacy Policy for detailed information.


🛠️ Development

Project Structure

musictab/
├── manifest.json           # Extension configuration
├── background.js           # Service worker
├── player.html            # Player interface
├── player.js              # Player logic
├── jsmediatags.min.js     # ID3 tag reader
├── icon16.png             # Extension icon (16x16)
├── icon48.png             # Extension icon (48x48)
├── icon128.png            # Extension icon (128x128)
└── package.ps1            # Build script

Contributing

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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🔐 Privacy

MusicTab respects your privacy:

  • No data collection
  • No tracking or analytics
  • All processing happens locally
  • Music files never leave your device

Read our full Privacy Policy.


📞 Contact & Support


🙏 Acknowledgments


📝 Changelog

See CHANGELOG.md for version history and updates.


⭐ Show Your Support

If you like MusicTab, please:

  • ⭐ Star this repository
  • 🐛 Report bugs or suggest features in Issues
  • 📢 Share with your friends
  • ✍️ Leave a review on Chrome Web Store

Made with ❤️ for music lovers

Enjoy your local music collection with style!

About

Local MP3 player Chrome extension with iTunes metadata integration

Resources

License

Stars

Watchers

Forks

Packages

No packages published