Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add streaming playlist to Media app #275

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
46 changes: 43 additions & 3 deletions Support/Help_Articles/Media/README.md
Expand Up @@ -31,7 +31,7 @@ From the All songs view songs can be added to playlists, added to play queue or
</span>
</div>

## Instructions for Windows and Linux PCs to transfer music to your Sailfish device.
# Instructions for Windows and Linux PCs to transfer music to your Sailfish device.
1. Connect your Sailfish device to your computer using a USB cable
2. Choose 'Media transfer (MTP)' in the dialog that appears on the screen of the Sailfish device.
3. Your Sailfish device appears on the PC, there are 'Card' and 'Mass storage'.
Expand All @@ -44,11 +44,51 @@ From the All songs view songs can be added to playlists, added to play queue or

You can read more about [moving files between a PC and a Sailfish Device](/Support/Help_Articles/Moving_Files_Between_PC_and_Sailfish_Device/) and [moving files between a Mac and a Sailfish Device](/Support/Help_Articles/Moving_Files_between_Mac_and_Sailfish_Device/)

## Backups and music files
# Backups and music files

Sailfish OS does not currently include any music files to the Backup. Therefore we recommend keeping the music in the SD card - Media app can find and play the music in the card equally well. If you have music in the device memory it is best to make sure that your only copy of the music is not in Sailfish device memory. However playlists are included in the backups.

## Related articles
# Adding a playlist for Internet streaming

The Media app supports Internet streaming (e.g. Internet radio stations) but there is no support for this in the user-interface of this app.

This chapter has the instructions for adding a playlist for Internet streaming. The playlist makes it easy to use the streaming as the list appears among the song playlists and can be used in the same way.See the two pictures below.

Making the streaming playlist requires that some lines of text are written to a new playlist file in directory ```/home/defaultuser/Music/playlists/```. We have given the name "SomeRadios.pls" for the file but feel free to change it (the extension must remain as pls). You will need to enable the **[Developer mode](/Support/Help_Articles/Enabling_Developer_Mode/)** on your phone.
Get the root permissions and create/edit the file like this:

```
devel-su
vi /home/defaultuser/Music/playlists/SomeRadios.pls
```

Our example file below has three examples (a random selection) of radio stations streaming music. The file must have the section name `[playlist]` on the first line and `NumberOfEntries=` with the correct digit on the last line.
```
[playlist]
File1=http://live.radiogrenouille.com:80/live
Title1=Radio Grenouille
File2=http://ice1.somafm.com/groovesalad-128-mp3
Title2=Soma FM: Groove Saladi
File3=http://uk2.internet-radio.com:8024/listen.pls&t=.pls
Title3=Internet Radio: Dance UK Radio
NumberOfEntries=3
```

<div class="flex-images" markdown="1">

* <a href="playlists_showing_streaming_pl.png"><img src="playlists_showing_streaming_pl.png" alt="Playlist view"></a>
<span class="md_figcaption">
Streaming playlist in the playlist view
</span>
* <a href="media_streaming_playlist.png"><img src="media_streaming_playlist.png" alt="Example playlist"></a>
<span class="md_figcaption">
Example of a streaming playlist with 3 radio stations
</span>
</div>



# Related articles

[Ringtones and Notifications](/Support/Help_Articles/Ringtones_and_Notifications/).

Expand Down
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.