HTMLStarter

iradio — HTML Starter Template

By walexi

iradio is a web client template for internet radio aimed at Icecast servers, built with HTML and jQuery/jPlayer. By editing two addresses in main.js, you can connect to your own radio stream.

Open Source SiteDownload Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided previewTop of page

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-04View source

What stands out

A quick read of the recorded project description.

01

Web radio client template optimized for Icecast servers

02

Audio stream playback via jPlayer

03

Retrieves current track information from an xspf address

04

Connect to a radio station by modifying only two URLs in main.js

05

Replaceable logo image in the img directory

06

MIT license, allowing modification and commercial use

Template Details

iradio is an internet radio website template positioned as a web client for Icecast servers. It uses HTML pages with the main.js script in the js directory, plays audio streams via jPlayer, and retrieves current track information from Icecast's xspf address. The project README provides clear integration steps: edit main.js, replace the url variable in the radioTitle function on line 3 with the address for fetching current playback information (an Icecast server such as 192.000.000/iradio.xspf), and on line 55 replace the mp3 parameter of setMedia with the actual stream address. Additionally, you can replace the logo image in the img directory to match your brand. The template repository includes demo.png as the author's preview image and a GitHub Pages demo link. The project is under the MIT license, allowing free use, modification, commercial use, and distribution of the code, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services like domains and hosting may incur costs.

HTMLStarter

Is it right for your project?

Use Cases

  • Set up a simple web listening entry point for an existing Icecast server
  • Use as a starting point for further development of an internet radio front-end
  • Learn how jPlayer works with the Icecast metadata interface

Suitable For

  • Individuals or small radio stations that already run an Icecast server and need a web client
  • Developers who want to quickly launch a radio page with minimal configuration
  • Users who need an MIT-licensed template for modification and distribution

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Edit the main.js file in the js directory

  2. 2

    On line 3 in the radioTitle function, change the url variable to the address for fetching current playback information; an Icecast server such as 192.000.000/iradio.xspf

  3. 3

    On line 55, change the mp3 parameter of jPlayer setMedia to the actual stream address

  4. 4

    You can replace the logo image in the img directory

  5. 5

    You need to prepare a working Icecast server and audio stream address before use

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in a public repository; the free scope applies to this version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • This template is designed specifically for Icecast servers as their web client; if using other streaming servers, you must modify the metadata and stream address logic in main.js yourself.
  • Retrieving current track information depends on Icecast's xspf interface; you must provide an accessible server address, otherwise track information cannot be displayed.
  • Audio playback requires filling in an actual working streaming server address in main.js; the template itself does not include any audio stream or server.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

This is a template for an internet radio site. It's optimized as a web client for an Icecast server.

Original README

put the url to fetch currently playing here. For an icecast server, it looks like this 192.000.000/iradio.xspf

Original README

Put the url of the server here such as 192.000.000.000/iradio

Original README
https://github.com/walexi/iradio/blob/master/LICENSEhttps://github.com/walexi/iradio/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-04. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 56 / 100
Technologies
HTML
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2017-07-25
Screenshot last checked
2026-10-04

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

The catalog identifies HTML as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-04

Inspect the recorded source material

SHA-256: 014c81e7cc76f61a39b8030f52efe0c782cceeb19be072adcfd5f2aa6e7335fb

2026-10-04T03:19:54.851Z

Source file / repository
# iradio
This is a template for an internet radio site. It's optimized as a web client for an Icecast server.

See demo here https://walexi.github.io/iradio/


![Alt text](/demo.png?raw=true "Demo")



To use this

1. Edit the main.js file in the js directory

2. Change the url on line 3 in the radioTitle function  
 `var url = ' '; //put the url to fetch currently playing here. For an icecast server, it looks like this 192.000.000/iradio.xspf`

3.  Modify the url on line 55  
 `$(this).jPlayer("setMedia", {mp3: " " //Put the url of the server here such as 192.000.000.000/iradio}).jPlayer("play");`


4.  You can also change the logo in the img folder and edit to suit your taste

Credits:
jplayer https://github.com/jplayer/jPlayer

zen player https://github.com/simurai/ZEN-Player
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

startbootstrap-simple-sidebar

startbootstrap-simple-sidebar

A Bootstrap off-canvas sidebar navigation HTML starter template from Start Bootstrap. It provides directly editable HTML and CSS in the dist directory, while the source uses Pug, SCSS, and JavaScript with npm build scripts for live preview and compilation.

HTML · Starter

adminkit

adminkit

AdminKit is a free, MIT-licensed HTML admin and dashboard template built on Bootstrap 5. The free version includes 15 demo pages, 1 plugin, and 1 color scheme, with hundreds of UI components, forms, tables, charts, and icons.

HTML · Admin dashboard

Landing-Page

Landing-Page

A general-purpose landing page HTML template maintained by Tailwind Toolbox, written in pure HTML and loading the complete Tailwind CSS via CDN.

HTML · Corporate Website

light-bootstrap-dashboard

light-bootstrap-dashboard

Light Bootstrap Dashboard is a free, MIT-licensed admin dashboard template from Creative Tim, built on Bootstrap with a responsive static HTML structure.

HTML · Admin dashboard

sing-app

sing-app

Sing App Lite is a free, open-source admin dashboard template from Flatlogic, built with Bootstrap 4.5 and SCSS. It provides a responsive layout, dashboard examples, typography, tables, notifications, basic charts, icons, maps, and a hover sidebar, along with styled Bootstrap components.

HTML · Admin dashboard

startbootstrap-modern-business

startbootstrap-modern-business

Modern Business is a multipurpose Bootstrap full-site HTML template from Start Bootstrap with 17 standalone pages covering home, about, services, portfolio, pricing, blog, FAQ, and contact.

HTML · Starter