Basic playlists: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Rootat127.0.0.1
(→‎Playlist Locations: semicolons needed for independent clauses)
(Updated for v20)
 
(75 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{cleanup}}
{{mininav|[[Playlists]] }}
{{XBMC wiki toc}}
A Playlist is a normal text file that lists one or more media files (Audio or Video), and plays them in succession.
You can either create your own or use existing playlists from other sources, e.g. Winamp M3U playlists.


== Supported Playlists ==
XBMC supports [http://en.wikipedia.org/wiki/PLS_%28file_format%29 PLS], Winamp [http://en.wikipedia.org/wiki/M3U M3U], [http://en.wikipedia.org/wiki/Cue_sheet Cue Sheets], and [[Smart playlists|XBMC Smart Playlist (XSP)]] playlists.


== Playlist Locations ==
= Introduction =
Playlists are by default stored in subfolders of the Playlists folder in [[The UserData Folder]].
<section begin="intro" />The Basic Playlist is a user created list of music or video that does not require a correctly scraped library as it uses the folder paths to the media files. As the playlist is based on paths, different classes of media can be mixed, like movies and episodes. The list can be created within {{kodi}} or transferred from another media player.<section end="intro" />
Playlists can be run from anywhere, but the [[Music Library|music]] and [[Music Library|video]] library playlist nodes look in the following folders:
* '''mixed''' - playlists containing both audio and music videos; will show in both the Music and Video Libraries.
* '''music''' - playlists containing audio only; will show in the Music Library.
* '''video''' - playlists containing videos only; will show in the Video Library.


== Working with Playlists ==
If your list of music or video has a common theme like genre, year, artist, studio, actor, etc, then you should consider using '''[[Smart playlists]]''' which will automatically generate the playlist based on rules. If the titles are random and there is no similarity between the items you want to group, then a manually created Basic Playlist is the best option.
The main way to create and manipulate playlists in XBMC is through the playlist editors (both for normal and smart playlists).


===How to create a normal playlist===
To see the currently playing playlist bring up the context menu.  The currently playing playlist is accessible via the [[Now Playing]] item.  If the playlist is currently empty, that option will not be visible in the context menu.


You can add songs or entire folders with the "Queue" action of your control device.   Alternatively, the "Queue Item" option in the context menu can be used.
'''Note:''' Depending on your setup, the m3u file may use relative paths to local content. If you then transfer a playlist file to another media player on different hardware, even though it has access to the same content, the paths may be different and {{kodi}} will be unable to find the media. Use Absolute paths where possible.


While in the "Now Playing" window and pressing the '''Select''' or the '''Play''' button will start playback of your playlist.


Once in The Playlists view, you can save your playlist. Playlists are by default saved in a subfolder  of $HOME\[[The UserData Folder|UserData]]\playlists (separate folder for music, video and mixed playlists).


== Now Playing ==
= Playlist Files =
{|
The {{kodi}} generated basic playlist file is in the '''m3u''' format.
| [[File:Music.now.playing.jpg|right|360px]]
| valign="top" |
Now playing is a special screen for audio and video [[Playlists]] that can be called up via the respective [[Music Navigation and Control#The Context Menu|audio]] and [[Videos Navigation and Control#The Context Menu|video]] context menus and [[Music#OSD .28On Screen Display.29|OSD]].
;Shuffle
:Shuffles the currently playing playlist
;Repeat
:Repeats the currently playing playlist, options are '''All''' songs, '''One''' song or '''Off'''.
;Save
:Saves the currently playing playlist
;Clear
:Clears the currently playing playlist
|}


== Playlists on Remote Computers ==
If you use playlists to play files on a remote computer, make sure the contents of the playlist file match the file structure relative to XBMC.---(ie, if your using samba, you'll need to use <code>smb://fullpath/file.mp3</code>).


'''Example:'''
You want to play several files located in <code>C:\music\mp3\</code> on your PC with XBMC.


<code>C:\music\mp3s\</code> is shared out as mp3 on your PC using [[Configuring PC Shares|PC file sharing]]  
== Supported Formats ==
{{kodi}} supports the following playlist files:
* [http://en.wikipedia.org/wiki/Cue_sheet Cue Sheets for music]
* [http://en.wikipedia.org/wiki/M3U m3u] (default)
* m3u8 <small>(added in v21 Omega)</small><ref>https://github.com/xbmc/xbmc/pull/21992</ref>
* [http://en.wikipedia.org/wiki/PLS_%28file_format%29 PLS]
* [[Internet_video_and_audio_streams|Stream files (.strm)]]
* [https://en.wikipedia.org/wiki/Windows_Media_Player_Playlist| Windows Media Player .wpl files]
* [[Smart playlists|Smart playlist .xsp files]]


For that to work each item in your playlist file must be formatted thus:


smb://workgroup;someuser:somepass@computer/mp3/fileN.mp3
== Location of Playlist Files ==
Playlist files are are located in the '''[[userdata]]/playlists''' folder. The location of this folder for each platform is shown in the table below.


Alternatively, there are settings in [[advancedsettings.xml]] for [[path substitution]]s in playlists. For instance, by adding
{{#lst:Userdata|location all}}


<source lang="xml">
<pathsubstitution>
<substitute>
  <from>C:\music\mp3s\</from>
  <to>smb://workgroup;someuser:somepass@computer/mp3/</to>
</substitute>
</pathsubstitution>
</source>


You could use the same playlist file on your PC and XBMC. That is, anywhere the path <code>c:\music\mp3s\</code> is found in a playlist, XBMC would substitute <code>smb://workgroup;someuser:somepass@computer/mp3/</code>.
== Editing m3u Files ==
If you choose to manually create your m3u playlists, then any text editor will suffice, but we recommend using an editor that can parse XML such as [https://code.visualstudio.com/Download Visual Studio Code] or [https://notepad-plus-plus.org/ Notepad++].


== Cue Sheets ==
''[[Cue Sheet]]'', or a "'''cue'''" file, is a metadata file which describes how the tracks of a AudioCD or AudioDVD are laid out. Cue sheets are stored as plain text files and commonly have a "'''.cue'''" filename extension. CDRWIN first introduced cue sheets, which are now supported by many optical disc authoring applications and media players, including XBMC Media Center.


For an AudioCD, a cue sheet specifies titles and performers for the disc and its tracks as well as the names of one or more audio files to be used. MP3, AAC, FLAC, WAV, and DTS files are often used, although any audio formats is really supported. Cue sheets are especially useful when burning or listening to live sets where all tracks are recorded in one single file.


For more information on ''[[Cue Sheet]]s'' and "'''cue'''" files please see our main article on [[Cue Sheet]].
= Use External Playlists =
If you have a playlist that you manually created, or one that was created by another media player that:
# Is in a format supported by {{kodi}} as detailed above, and
# The file paths are valid as described in the Introduction note, and
# Is saved in the correct playlist subfolder


== Party Mode Playlists ==
Then you can use {{kodi}} to play it.
The Party Mode [[Music Library#Party Mode|music]] and [[Video Library#Party Mode|music video]] playlists are the only predefined playlists in XBMC. They can be further configured via the [[partyMode.xsp|partymode.xsp]] and [[partyMode.xsp|partymode-video.xsp]] files in [[The UserData Folder]]. The Party Mode playlists are smart playlists and can be configured as seen below.


== Smart Playlists ==
XBMC supports "Smart" playlists for all types of media, which essentially use a set of rules to limit the results from the databases. They can be created either by using the built-in GUI Smart Playlist Editor accessible from the Playlist section, or by creating an xml file with the extension .xsp (XBMC Smart Playlist).


For more details see '''[[Smart Playlist]]'''
= Playlist Editor =
{{kodi}} has a built in Playlist Editor where playlists can be created and edited.


==Playlist folder location==
* '''Windows XP:''' <code>Documents and Settings\<your_user_name>\Application Data\XBMC\userdata\playlists\</code>
* '''Vista/Windows 7:''' <code>Users\<your_user_name>\AppData\Roaming\XBMC\userdata\playlists\</code>
* '''Mac OS X:''' <code>/Users/<your_user_name>/Library/Application Support/XBMC/userdata/playlists/</code>
* '''iOS:''' <code>/private/var/mobile/Library/Preferences/XBMC/userdata/playlists/</code>
* '''Linux:''' <code>$HOME/.xbmc/userdata/playlists/</code>


[[Category:User Interface]]
== Playlist Editor Location ==
[[Category:Video Library]]
The Playlist Managers are located as follows:
[[Category:Music Library]]
 
; Music library
: From the '''[[Basic_controls#Introduction|Main Menu]]''' navigate to {{highlight|Music > Playlists}}
:* Select ''New Playlist...'' to create a new playlist
:* Highlight an existing Playlist and from the '''[[Basic_controls#Context_Menu|Context menu]]''' select ''Edit playlist'' to edit an existing playlist
 
 
; Video library
: There is no playlist editor for the Video library. Use the Queue Method (next section) or create the playlist externally.
 
 
== Using Playlist Editor ==
<gallery mode="packed" widths="600px" heights="337px">
File:Music-Playlist02.jpg|Image 1- Starting a new playlist in Music
File:Music-Playlist03.jpg|Image 2- Adding music items to the playlist
</gallery>
 
; Editor Layout
:* '''Left panel''' contains the Action buttons
:* '''Middle panel''' used to navigate to your music
:* '''Right panel''' contains the songs in the  playlist
 
; Create New Playlist
: Decide how to locate your music files to add to the playlist-
:* '''Files'''- Navigate the folder structure of your files
:* '''Library'''- Navigate the library nodes
:* '''Music Videos'''- Also add music videos to the playlist
: Whichever method you choose, the file paths are stored in the playlist.
 
; What can be added to the Playlist
:* '''Artist'''- Selecting an Artist will add all songs attributed to the Artist
:* '''Album'''- Adding an Album will add all songs in the album
:* '''Song'''- Add an individual song
 
; Adding Items
: Highlight the item to be added then using one of the following two methods
:* Press {{keypress|Q}} on your keyboard, or
:* From the ''[[Basic_controls#Context_Menu|Context Menu]]'' select '''Add'''
: The items will appear in the right panel in the order they are added.
 
; Reorganise Items
: To reorganise the order of the playlist items, move across to the right panel and on a [[Keyboard_controls|keyboard]] select
:* {{keypress|U}} - Move selected up
:* {{keypress|D}} - Move selected down
:* {{keypress|DEL}} - Remove from playlist.
: Alternatively, use the ''[[Basic_controls#Context_Menu|Context Menu]]'' which contains the same action options.
: A remote control with the proper [[keymap]] additions can also use those actions.
 
; Save the Playlist
: Select '''Save''' from the left panel and enter a playlist name when prompted. The playlist will be accessible from {{highlight|Music > Playlists}}
: A music m3u playlist is always saved in \playlists\music\ even if it contains music videos.
 
; Edit Existing Playlist
: To open and edit an existing playlist, use one of the following methods
:* From the left panel, select '''Open''' and navigate to your playlist
:* In your list of Playlists, highlight the playlist and select '''Edit playlist''' from the ''[[Basic_controls#Context_Menu|Context Menu]]''
 
; Delete Playlist
: From your list of Playlists, highlight the playlist and select '''Delete''' from the ''[[Basic_controls#Context_Menu|Context Menu]]''
 
 
 
= Queue Method =
While browsing your library, you have the ability to queue items for playback. These items are added to a temporary playlist.
 
This temporary playlist can be accessed from the ''[[Basic_controls#Sideblade_Menu|Sideblade menu]]'' and can be further edited and saved as a Basic playlist.
 
Using this method, Basic Playlists can be created for Music and Videos from either the files or library structure.
 
<gallery mode="packed" widths="400px" heights="225px">
File:Music-Playlist04.jpg|Image 3- Browse your library or browse your folder structure
File:Music-Playlist05.jpg|Image 4- Select '''Go to playlist''' from the left sideblade menu
File:Music-Playlist06.jpg|Image 5- The playlist view. Note the combined Movies and Episodes.
</gallery>
 
; Adding Items
: Highlight the item to be added then using one of the following two methods
:* Press {{keypress|Q}} on your keyboard, or
:* From the ''[[Basic_controls#Context_Menu|Context Menu]]'' select '''Queue item'''
: Repeat as necessary and all items will be added to the temporary playlist.
 
; Accessing the Playlist
: From the ''[[Basic_controls#Sideblade_Menu|Sideblade menu]]'' select '''Go to playlist'''
: Once you enter the playlist, the options for editing and saving are similar to the Playlist Editor detailed above.
 
 
 
= References =
<references />
 
 
 
 
{{top}}
 
{{updated|20}}
[[Category:Karellen]]
[[Category:Video library]]
[[Category:Music library]]

Latest revision as of 00:07, 13 February 2023

Home icon grey.png   ▶ Playlists ▶ Basic playlists


Introduction

The Basic Playlist is a user created list of music or video that does not require a correctly scraped library as it uses the folder paths to the media files. As the playlist is based on paths, different classes of media can be mixed, like movies and episodes. The list can be created within Kodi or transferred from another media player.

If your list of music or video has a common theme like genre, year, artist, studio, actor, etc, then you should consider using Smart playlists which will automatically generate the playlist based on rules. If the titles are random and there is no similarity between the items you want to group, then a manually created Basic Playlist is the best option.


Note: Depending on your setup, the m3u file may use relative paths to local content. If you then transfer a playlist file to another media player on different hardware, even though it has access to the same content, the paths may be different and Kodi will be unable to find the media. Use Absolute paths where possible.


Playlist Files

The Kodi generated basic playlist file is in the m3u format.


Supported Formats

Kodi supports the following playlist files:


Location of Playlist Files

Playlist files are are located in the userdata/playlists folder. The location of this folder for each platform is shown in the table below.


The Userdata folder is a subfolder of the Kodi Data Folder and is located as shown in the table below.

Operating system Userdata Folder
Android Android/data/org.xbmc.kodi/files/.kodi/userdata/ (see note)
iOS /private/var/mobile/Library/Preferences/Kodi/userdata/
LibreELEC /storage/.kodi/userdata/
Linux ~/.kodi/userdata/
macOS /Users/<your_user_name>/Library/Application Support/Kodi/userdata/
Nvidia Shield (SMB) smb://<nvidiashieldurl>/internal/Android/data/org.xbmc.kodi/files/.kodi/userdata
OSMC /home/osmc/.kodi/userdata/
tvOS /private/var/mobile/Library/Preferences/Kodi/userdata/
webOS /media/developer/apps/usr/palm/applications/org.xbmc.kodi/.kodi/userdata/
Windows %APPDATA%\Kodi\userdata
Windows Portable <Install location chosen by you>\portable_data\userdata\
Windows via Microsoft Store %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
Windows Xbox %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
Note: In some Android setups the path may be slightly different to the one stated above.


Editing m3u Files

If you choose to manually create your m3u playlists, then any text editor will suffice, but we recommend using an editor that can parse XML such as Visual Studio Code or Notepad++.


Use External Playlists

If you have a playlist that you manually created, or one that was created by another media player that:

  1. Is in a format supported by Kodi as detailed above, and
  2. The file paths are valid as described in the Introduction note, and
  3. Is saved in the correct playlist subfolder

Then you can use Kodi to play it.


Playlist Editor

Kodi has a built in Playlist Editor where playlists can be created and edited.


Playlist Editor Location

The Playlist Managers are located as follows:

Music library
From the Main Menu navigate to Music > Playlists
  • Select New Playlist... to create a new playlist
  • Highlight an existing Playlist and from the Context menu select Edit playlist to edit an existing playlist


Video library
There is no playlist editor for the Video library. Use the Queue Method (next section) or create the playlist externally.


Using Playlist Editor

  • Image 1- Starting a new playlist in Music

    Image 1- Starting a new playlist in Music

  • Image 2- Adding music items to the playlist

    Image 2- Adding music items to the playlist

Editor Layout
  • Left panel contains the Action buttons
  • Middle panel used to navigate to your music
  • Right panel contains the songs in the playlist
Create New Playlist
Decide how to locate your music files to add to the playlist-
  • Files- Navigate the folder structure of your files
  • Library- Navigate the library nodes
  • Music Videos- Also add music videos to the playlist
Whichever method you choose, the file paths are stored in the playlist.
What can be added to the Playlist
  • Artist- Selecting an Artist will add all songs attributed to the Artist
  • Album- Adding an Album will add all songs in the album
  • Song- Add an individual song
Adding Items
Highlight the item to be added then using one of the following two methods
  • Press Q on your keyboard, or
  • From the Context Menu select Add
The items will appear in the right panel in the order they are added.
Reorganise Items
To reorganise the order of the playlist items, move across to the right panel and on a keyboard select
  • U - Move selected up
  • D - Move selected down
  • DEL - Remove from playlist.
Alternatively, use the Context Menu which contains the same action options.
A remote control with the proper keymap additions can also use those actions.
Save the Playlist
Select Save from the left panel and enter a playlist name when prompted. The playlist will be accessible from Music > Playlists
A music m3u playlist is always saved in \playlists\music\ even if it contains music videos.
Edit Existing Playlist
To open and edit an existing playlist, use one of the following methods
  • From the left panel, select Open and navigate to your playlist
  • In your list of Playlists, highlight the playlist and select Edit playlist from the Context Menu
Delete Playlist
From your list of Playlists, highlight the playlist and select Delete from the Context Menu


Queue Method

While browsing your library, you have the ability to queue items for playback. These items are added to a temporary playlist.

This temporary playlist can be accessed from the Sideblade menu and can be further edited and saved as a Basic playlist.

Using this method, Basic Playlists can be created for Music and Videos from either the files or library structure.

  • Image 3- Browse your library or browse your folder structure

    Image 3- Browse your library or browse your folder structure

  • Image 4- Select Go to playlist from the left sideblade menu

    Image 4- Select Go to playlist from the left sideblade menu

  • Image 5- The playlist view. Note the combined Movies and Episodes.

    Image 5- The playlist view. Note the combined Movies and Episodes.

Adding Items
Highlight the item to be added then using one of the following two methods
  • Press Q on your keyboard, or
  • From the Context Menu select Queue item
Repeat as necessary and all items will be added to the temporary playlist.
Accessing the Playlist
From the Sideblade menu select Go to playlist
Once you enter the playlist, the options for editing and saving are similar to the Playlist Editor detailed above.


References

  1. ↑ https://github.com/xbmc/xbmc/pull/21992



Return to top


Retrieved from "https://kodi.wiki/index.php?title=Basic_playlists&oldid=244224"