Raspberry Pi Internet Radio

Raspberry Pi Internet Radio

These pages describe how to create an Internet radio (radiod) using the Raspberry PI computer. The radiod package is simply the most comprehensive product available on the Raspberry Pi and has the most supported hardware and features of any other known RPi Internet Radio software. It uses MPD (Music Player Daemon) for handling Radio and Media streams. On this page you will find the description of the project including Python source files, documentation and installation instructions, Download the constructors manual below (Requires Adobe PDF Reader). The features of the radio are shown at the end of this page. There are two main manuals namly Raspberry Pi Radio Beginners Guide and  a comprehensive Constructors Guide. On the Constructors Pages you will see examples of other constructors examples of the radio using this design. Beta releases will be found here.

 

Version 8.3 released 28th February 2026

A new version (8.3) of the radio software has been released on the 28th February 2026. This version includes :

  • Radio and associated 3rd party components converted to run on Debian Trixie OS.  Bookworm OS continues to be supported.
  • The graphical version of the radio (gradio.py) now displays station and album artwork
  • The number of rows in the graphical version of the radio (gradio.py) is configurable
  • Support for the Wayfire compositor removed. The graphic desktop is now provided by Wayland
  • Support added for Osoyoo 3.5 and 5-inch touch screens
  • General bug fixes

    • Full details will be found in the README file.

    Beta test versions will be found in the beta test directory (developers only)

    Click in the middle of the pictures below for more details.

    For examples by other constructors Pi Internet Radio Constructors page

    Features
    • Runs on Raspberry Pi OS (Previously Raspbian) Trixie or Bookworm. Earlier  OS versions not supported
    • Comprehensive Constructors Guide and Beginners Guides
    • Menu and script driven installation and maintenance procedures (radio-config)
    • Raspberry PI running standard Music Player Daemon (MPD) version 0.23.12. (Later versions can be installed)
    • Supports all new board types, revision 3B, 3B+, 4B+, 5, Rpi400 and Zero/W (Version 1.0 26-pin Raspberry Pi's unsupported)
    • Supports the following displays: including LCDs, OLEDs, PiFace CAD, HDMI screens, Osoyoo, Adafruit and Pimoroni products
    • User interfaces include push buttons, rotary encoders and touchscreens
    • Audio using on-board jack, most popular DACs, bonnets and Bluetooth speakers 
    • Clock display or Information display (IP address, hostname, versions)
    • Displays Radio station and Album artwork (Graphical version of the radio only)
    • Artist and track search function
    • Timer (Snooze) and Alarm functions (LCD/Character OLED versions only)
    • Icecast streaming to a Personal Computer or to mobile devices
    • Optional Spotify and Airplay (shairport-sync) receiver
    • Plays music from a USB stick, SD card or from a Network drive (NAS)
    • Option to display RSS news feeds
    • Web interface using O!MPD
    • Fully integrated with MpDroid and mPod mobile apps.
    • Espeak support for blind or visually impaired persons
    • New record radio stations function using liquidsoap utility

    See full specification

    Download the software below.

    Documentation          Download software
    Raspberry PI Radio.pdf radiod_8.3_all.deb (32 and 64-bit OS)
    RPi Radio beginners guide.pdf radiod_7.8_armhf.deb (26-pin versions)
    PI Vintage Radio.pdf radiodweb_2.3_armhf.deb (Bullseye)
    PI Vintage Radio Operating Instructions.pdf radiodweb_3.2_all.deb (Bookworm)
    Updating MPD (Music Player Daemon) radiodweb_3.3_all.deb (Trixie)
    Radio release notes    
       
    Wiki (GitHub)   Playlists
     
    Archived versions of the software can be found here

    Top

    Advert