Files
RadioPlayer-22/README.md
Joey 😎 9159ba908f ees
2025-08-01 00:54:18 +00:00

2.3 KiB

🎵 Html5 Full Page Internet Radio Player

A modern, responsive web-based radio player with a beautiful interface. Stream your favorite radio station with real-time song information, lyrics, and playback history.

Radio Player Preview

Features

  • 🎧 Live Streaming: Supports multiple streaming protocols (Icecast, Zeno, Shoutcast, Radiojar)
  • 🎨 Modern UI: Spotify-inspired interface with smooth animations
  • 📱 Responsive Design: Works perfectly on desktop, tablet, and mobile devices
  • 🎵 Real-time Metadata: Displays current song, artist, and album artwork
  • 📜 Lyrics Integration: Automatic lyrics lookup using Vagalume API
  • 📚 Playback History: Shows up to 5 recently played songs
  • 🎛️ Volume Control: Precise volume control with keyboard shortcuts
  • ⌨️ Keyboard Shortcuts: Full keyboard navigation support

🚀 Quick Start

  1. Clone the repository

    git clone https://github.com/joeyboli/radioplayer.git
    cd radioplayer
    
  2. Configure your radio stream

    • Open js/script.js
    • Update the URL_STREAMING constant with your stream URL
    • Get your API endpoint from RadioAPI.me
  3. Open in browser

    Open index.html in your browser
    

⚙️ Configuration

Edit js/script.js to configure your radio stream:

const URL_STREAMING = "https://your-stream-url.com/stream"
const API_URL = "https://prod-api.radioapi.me/metadata/YOUR-API-KEY"

🎮 Keyboard Shortcuts

Key Action
Space or P Play/Pause
Volume Up
Volume Down
M Mute/Unmute
0-9 Set volume to 0-90%

🎨 Customization

To change the number of history items displayed, edit js/script.js and modify the HISTORY_ITEMS_COUNT constant.

📱 Browser Support

  • Chrome 60+
  • Firefox 55+
  • Safari 12+
  • Edge 79+

🌐 API Integration

This player uses RadioAPI.me for metadata. Get your API endpoint from their service.

For lyrics functionality, get a Vagalume API key from Vagalume API.

🐛 Troubleshooting

  • Check browser console for errors
  • Verify stream URL is accessible
  • Ensure API endpoint is working

📄 License

MIT License