Giter Club home page Giter Club logo

mpradio's Introduction

mpradio

Morrolinux's Pirate radio (PiFmRDS implementation with Bluetooth and mp3 support) for all Raspberry Pi models

Exclusively tested on Minimal Raspbian (ARM)

Features

  • safely shutdown your Pi by unplugging the USB stick
  • persistent playlists (remember the playlist/playback status across reboots)
  • resume track from its playback status hh:mm:ss
  • shuffle on/off
  • scrolling RDS to overcome 8-chars limitation
  • skip to the next song by pressing a push-button (GPIO-connected on pin 18)
  • safely shutdown by holding the push-button (GPIO-connected on pin 18)
  • stream audio over FM or 3.5mm Jack
  • Android app to edit settings via bluetooth?
  • Bluetooth speaker via jack audio output?
  • Read metadata from the mp3 files
  • Display Android notifications over RDS?

Known issues

  • The first bluetooth connection after boot is known to fail after few seconds. All subsequent connections will work just fine.
  • Due to a design flaw in BCM43438 WIFI/BT chipset, you might need to disable WiFi if you experience BT audio stuttering on Pi Zero W and Pi 3: raspberrypi/linux#1402

installation

git clone https://github.com/morrolinux/mpradio.git mpradio-master

cd mpradio-master/install

sudo ./install.sh

configuration

By default, mpradio will always be running automatically after boot once installed. No additional configuration is needed. However, you can change the FM streaming frequency (which is otherwise defaulted to 107.0) by placing a file named pirateradio.config in the root of a USB key (which of course, will need to stay plugged for the settings to be permanent)

pirateradio.config example:

[PIRATERADIO]
frequency=107.0
btGain=1.7            	;gain setting for bluetooth streaming
storageGain=1.3       	;gain setting for stored files streaming
output=fm		;[analog/fm] to stream thru FM or 3.5mm jack 

[PLAYLIST]
persistentPlaylist=true
resumePlayback=true   	;require persistentPlaylist to be enabled 
shuffle=true 

[RDS]
updateInterval=3      	;seconds between RDS refresh. lower values could result in RDS being ignored by your radio receiver
charsJump=6           	;how many characters should shift between updates [1-8]

usage

It (should) work out of the box. You need your mp3 files to be on a FAT32 usb stick. (along with the config file if you need to override default settings) You can safely shut down the Pi by unplugging the stick and waiting for about 5 seconds until the status led stops blinking. If you enabled "persistentPlaylist" option, your Pi will never play the same song twice before consuming the full playlist. If you add new songs on the usb stick, with "persistentPlaylist" enabled they won't be played until the current playlist is consumed. You can "rebuild" the playlist (looking for new recently added files) if needed:

  • boot your Pi with usb stick unplugged. (current playlist will be erased)
  • plug in your usb stick and unplug it again (this will cause a shut down)
  • power on your Pi once again, with the usb key in it.
  • You're done! (mpradio will rebuild the playlist, counting the new files as well)

update

rm -rf mpradio-master/ and then:

installation steps

OR, if you are a git guy:

cd mpradio-master && git fetch origin && git reset --hard origin/master && cd install && sudo ./install.sh

uninstallation / removal

cd mpradio-master/install ./install.sh remove

Debugging / Troubleshooting

mpradio is launched as a service (via systemd) after boot completed

check whether the service is running or not:

$ sudo systemctl status mpradio

start or stop the service:

$ sudo systemctl [start/stop] mpradio

As for Bluetooth:

Bluetooth connection logs are under /var/log/bluetooth_dev

if Raspberry's Bluetooth is not showing up, check if the interface is UP and the bt-setup script has been executed:

$ hciconfig

$ sudo systemctl status bt-setup

if you are having issues with bluetooth audio pairing, please also check if simple-agent service is running:

$ sudo systemctl status simple-agent

if you are having issues with bluetooth not connecting once it's paired, please check weather bluealsa is running or not:

$ sudo systemctl status bluealsa

A simple schematic of how things work together:

Alt text

Warning and Disclaimer

mpradio relays on PiFmRds for FM-Streaming feature. Please note that in most states, transmitting radio waves without a state-issued licence specific to the transmission modalities (frequency, power, bandwidth, etc.) is illegal. Always use a shield between your radio receiver and the Raspberry. Never use an antenna. See PiFmRds Waring and Disclamer for more informations.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.