Skip to content

README.md

Latest commit

 

History

History
323 lines (210 loc) · 4.16 KB

README.md

File metadata and controls

323 lines (210 loc) · 4.16 KB
Raw

📻 SIGNAL • FM

Tune the World, Live.

A futuristic web radio player that lets you discover and stream live internet radio stations from around the world using the free Radio Browser API.

Built as a single-page application with a modern cyberpunk-inspired interface featuring animated radio controls, live station discovery, glassmorphism effects, and an integrated streaming player.

Preview

✨ Features

  • 🌎 Browse radio stations from around the world
  • 🔍 Search live stations instantly
  • 🎲 Random Station mode
  • ❤️ Favorite stations
  • 🎵 Built-in audio player
  • 🎚️ 3-Band Equalizer
  • 🔊 Volume control
  • 📡 Live broadcasting indicators
  • 📻 Animated tuning dial
  • 📺 LCD-style "Now Playing" display
  • 🎨 Dynamic accent colours
  • ⚡ Fast and lightweight
  • 📱 Fully responsive
  • 🌙 Cyberpunk-inspired UI
  • 🚀 No backend required

🚀 Technologies

  • HTML5
  • CSS3
  • Vanilla JavaScript
  • Web Audio API
  • Fetch API
  • Radio Browser API
  • Google Fonts

No frameworks.

No build tools.

No dependencies.

Simply open the HTML file in your browser.

📡 Powered By

SIGNAL FM uses the free community-maintained Radio Browser project.

Website:

https://www.radio-browser.info/

Features provided by Radio Browser include:

  • Thousands of live radio stations
  • Hundreds of countries
  • Community-maintained directory
  • Multiple API mirrors
  • Completely free API

🎛 Main Features

Hero Section

  • Animated radio tuning dial
  • Live frequency display
  • Dynamic sweep needle
  • Quick Start button
  • Random Station button

Browse Stations

Browse stations by:

  • Country
  • Genre
  • Search
  • Favorites

Station cards include:

  • Station logo
  • Bitrate
  • Codec
  • Country
  • Tags
  • Live status

Audio Player

Built-in player includes:

  • Play
  • Pause
  • Stop
  • Volume control
  • Live indicator
  • Album/station artwork
  • Animated visualizer
  • Equalizer

Equalizer

Powered by the Web Audio API.

Bands:

  • Bass
  • Mid
  • Treble

Included presets:

  • Flat
  • Bass+
  • Vocal
  • Treble+

Search

Quickly search stations by:

  • Name
  • Genre
  • City

Results are loaded directly from the Radio Browser API.

Favorites

Save stations for quick access during your session.

Future versions may include:

  • Local Storage
  • User Accounts
  • Cloud Sync

🎨 Design

Inspired by:

  • Cyberpunk
  • Synthwave
  • Retro radios
  • Glassmorphism
  • Neon interfaces
  • Modern dashboards

Primary colours:

  • Cyan
  • Magenta
  • Violet
  • Lime
  • Amber
  • Coral

📱 Responsive Design

Optimized for:

  • Desktop
  • Laptop
  • Tablet
  • Mobile

The interface automatically adapts to different screen sizes.

⚡ Performance

Designed to be:

  • Lightweight
  • Fast
  • Responsive
  • Framework-free

Performance features include:

  • Lazy-loaded station icons
  • Multiple API failover
  • Skeleton loading screens
  • Efficient DOM rendering
  • Minimal network requests

📂 Project Structure

SIGNAL/

├── index.html

├── README.md

└── LICENSE

🔧 Installation

Clone the repository

git clone https://github.com/yourusername/signal-fm.git

Open:

index.html

using any modern web browser.

No installation required.

🌐 Browser Support

Works with:

  • Google Chrome
  • Microsoft Edge
  • Firefox
  • Safari
  • Brave
  • Opera

Requires support for:

  • ES6 JavaScript
  • Fetch API
  • Web Audio API

🛣 Roadmap

Planned features:

  • Persistent favorites
  • Recently played stations
  • User accounts
  • Cloud synchronization
  • Song metadata
  • Album artwork
  • World map browsing
  • Trending stations
  • Popularity charts
  • Listening history
  • Multi-language support
  • Light theme
  • Podcast support

🤝 Contributing

Contributions are welcome.

Feel free to submit:

  • Bug reports
  • Feature requests
  • Pull requests
  • UI improvements

📜 License

This project is released under the MIT License.

❤️ Acknowledgements

Special thanks to:

  • Radio Browser Community
  • Open Source Contributors
  • Radio Station Owners Worldwide

📻 SIGNAL • FM

Tune the World, Live.

"Every station tells a story. Every frequency connects the world."

🌍 📻