Files

Joey 😎 c951dc70e0 Update cover image and switch lyrics API integration

Replaced cover.png with cover.jpeg and updated CSS references. Changed radio name, streaming URL, and API endpoint in script.js. Removed Vagalume lyrics API integration in favor of using lyrics from RadioAPI.me, simplifying the lyrics fetching logic.

2025-08-19 00:14:40 +00:00

3.3 KiB

Original Blame Histórico

🎵 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.

✨ 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

🔌 Supported APIs

This radio player supports integration with multiple radio streaming APIs through RadioAPI.me:

Azuracast API - Open-source radio broadcasting suite
Live365 API - Professional internet radio platform
RadioKing API - European radio streaming service

📡 Supported Stream Types

This radio player supports various streaming protocols and platforms:

Icecast - Open-source streaming media server
Shoutcast - Nullsoft's streaming media server
Zeno - Modern streaming platform
Radiojar - Cloud-based radio streaming
HTTP/HTTPS Streams - Direct audio stream URLs

Get detailed song information from multiple music platforms:

iTunes (Apple Music) - Apple's music catalog
Spotify - World's largest music streaming platform
YouTube Music - Google's music streaming service
Deezer - French music streaming service
KKBOX - Asian music streaming platform
Line Music - Japanese music streaming service
FLOMusic - Korean music streaming platform

🚀 Quick Start

Clone the repository

git clone https://github.com/joeyboli/radioplayer.git
cd radioplayer

Configure your radio stream
- Open js/script.js
- Update the URL_STREAMING constant with your stream URL
- Get your API endpoint from RadioAPI.me
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 and its lyrics. Get your API endpoint from their service.

🐛 Troubleshooting

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

📄 License

MIT License

3.3 KiB Original Blame Histórico