Skip to content

Latest commit

 

History

History
142 lines (101 loc) · 6.78 KB

playlists-livestreams-podcasts.md

File metadata and controls

142 lines (101 loc) · 6.78 KB
Raw

Playlists, Livestreams and Podcasts

By default, the Jukebox represents music based on its metadata like album name, artist or song name. The hierarchy and order of songs is determined by their original definition, e.g. order of songs within an album. If you prefer a specific list of songs to be played, you can use playlists (files ending with *.m3u). Jukebox also supports livestreams and podcasts (if connected to the internet) through playlists.

Playlists

If you like the Jukebox to play songs in a pre-defined order, you can use .m3u playlists.

A .m3u playlist is a plain text file that contains a list of file paths or URLs to multimedia files. Each entry in the playlist represents a single song, and they are listed in the order in which they should be played.

Structure of a .m3u playlist

A .m3u playlist is a simple text document with each song file listed on a separate line. Each entry is optionally preceded by a comment line that starts with a '#' symbol. The actual file paths or URLs of the media files come after the comment.

Creating a .m3u playlist

  1. You can create a .m3u playlist using a plain text editor.
  2. Open a new text file
  3. [Optional] Start by adding a comment line to provide a description or notes about the playlist.
  4. On the following lines, list the file paths or URLs of the media files you want to include in the playlist, one per line. They must refer to true files paths on your Jukebox. They can be relative or absolute paths.
  5. Save the file with the .m3u extension, e.g. my_playlist.m3u.
# Absolute
/home/<username>/RPi-Jukebox-RFID/shared/audiofolders/Simone Sommerland/Die 30 besten Kindergartenlieder/08 - Pitsch, patsch, Pinguin.mp3
/home/<username>/RPi-Jukebox-RFID/shared/audiofolders/Simone Sommerland/Die 30 besten Spiel- Und Bewegungslieder/12 - Das rote Pferd.mp3
# Relative
Bibi und Tina/bibi-tina-jetzt-in-echt-kinofilm-soundtrack/bibi-tina-jetzt-in-echt-kinofilm-soundtrack-7-ordinary-girl.mp3

Using .m3u playlists in Jukebox

The Jukebox Web App handles the playlists in a way that it allows you to browse its content just like other songs. This means, you won't see the m3u playlist itself and instead, the individual items of the playlist. They also become actionable and you can select individual songs from it to play, or play the entire playlist.

Note

Files ending with .m3u are treated as folder playlist. Regular folder processing is suspended and the playlist is built solely from the .m3u content. Only the alphabetically first .m3u file is processed, others are ignored.

Based on the note above, we suggest to use m3u playlists like this, especially if you like to manage multiple playlists.

  1. In the audiofolders directory (or any sub-directory), create a new folder.
  2. In this new folder, copy your .m3u playlist. Make sure the links to the respective songs are correct.
  3. Open the Web App. Under Library, select the Folder view and browse to the new folder you created.
  4. You should now be able to browse and play the content of the playlist.

Example folder structure

└── audiofolders
    ├── wake-up-songs
    │   └── playlist.m3u
    └── lullabies-sleep-well
        └── playlist.m3u

Assigning a .m3u playlist to a card

In the Jukebox Web App, .m3u playlists do not show up as individual files. In order to assign a playlist to a card, do the following:

  1. Follow the steps above to add a playlist to your Jukebox (make sure you have created individual folders).
  2. Open the Cards tab in the Web App and click on the + button to add a new card.
  3. As a Jukebox action, select "Play music", then select "Select music".
  4. In the Library view, select the Folder view located in the top right corner.
  5. Browse to the folder you created (representing your playlist) and click on it.

You are essentially assigning a folder (just like any other conventional folder) to your card representing the content of your playlist.

Livestreams

In order to play radio livestreams on your Jukebox, you use playlists to register your livestream and make it accessible.

Using livestream.txt playlist in Jukebox

  1. Follow the steps above to add a playlist to your Jukebox (make sure you have created individual folders).
  2. When creating the playlist file, make sure it's called or at least ends with livestream.txt instead of .m3u (Examples: awesome-livestream.txt, livestream.txt).
  3. Add URLs of your livestreams just like you would add songs in .m3u playlists.

You can now assign livestreams to cards following the example of playlists.

Example folder structure and playlist names

└── audiofolders
    ├── wdr-kids
    │   └── wdr-kids-livestream.txt
    ├── energy
    │   └── cool-livestream.txt
    └── classic
        └── livestream.txt

Example of livestream.txt

https://wdr-diemaus-live.icecastssl.wdr.de/wdr/diemaus/live/mp3/128/stream.mp3
http://channels.webradio.antenne.de/hits-fuer-kids

Podcasts

Just like you add livestreams to the Jukebox, you can also add individual Podcasts or entire Podcast feeds to the Jukebox.

You have 3 options to play Podcasts

  1. Create a playlist and reference individual direct URLs to Podcast episodes (just like livestreams)
  2. Provide a Podcast RSS feed
  3. Download the MP3 and add them like normal songs to your Jukebox. This also makes them available offline.

We will explain options 1 and 2 more closely.

Using podcast.txt playlist in Jukebox

  1. Follow the steps above to add a playlist to your Jukebox (make sure you have created individual folders).
  2. When creating the playlist file, make sure it's called or at least ends with podcasts.txt instead of .m3u. (Examples: awesome-podcast.txt, podcast.txt).
  3. Add links to your individual podcast episodes just like you would with songs in .m3u playlists
  4. As an alternative, you can provide a single RSS feed (XML). Jukebox will expand the file and refer to all episodes listed within this file.

Example folder structure and playlist names

└── audiofolders
    ├── die-maus
    │   └── die-maus-podcast.txt
    ├── miras-welt
    │   └── cool-podcast.txt
    └── kakadu
        └── podcast.txt

Example of podcast.txt for individual episodes

https://podcastb11277.podigee.io/94-ich-ware-gerne-beliebt-wie-geht-das
https://podcastb11277.podigee.io/91-wieso-kann-ich-nicht-den-ganzen-tag-fernsehen

Example of podcast.txt for RSS feeds (XML)

https://kinder.wdr.de/radio/diemaus/audio/diemaus-60/diemaus-60-106.podcast
http://www.kakadu.de/podcast-kakadu.2730.de.podcast.xml