Basic playlists: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Updated for v20)
 
(36 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{mininav|[[Video library|Videos]]|[[Video playback|Playback]] {{l2| [[Video library/Management|Management]] }} }}
{{mininav|[[Playlists]] }}
{{see also|Smart playlists}}
<section begin="intro" />XBMC supports both basic playlists and '''[[smart playlists]]'''. A basic 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, such as a playlist generated from Winamp, iTunes, or other sources. Basic playlists can be created and edited directly from XBMC's GUI.<section end="intro" />


== Smart Playlists ==
{{main|Smart playlists}}
{{#lst:Smart playlist|intro}}


== Normal playlists ==
= Introduction =
The main way to create and manipulate playlists in XBMC is through the playlist editors (both for normal and smart playlists).
<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" />


=== How to create a normal playlist ===
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.
[[File:Playlist queue.png|500px|right]]
To see the currently playing playlist bring up the context menu.  The currently playing/queued 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 videos/songs or entire folders with the "Queue" action of your remote/keyboard ({{keypress|Q}} on a keyboard) or the '''"Queue Item"''' option in the context menu can be used.


While in the "Now Playing" window and pressing the '''Select''' or the '''Play''' button will start playback of your playlist.
'''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.


Once in the Now Playing view, you can save your playlist. Playlists are by default saved in a subfolder  of [[userdata]]/playlists (separate folder for music, video and mixed playlists).
{{-}}


=== Now Playing window ===
{{anchor|Now Playing}}Now Playing is a special window for the current audio or video playlist. They are 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]]. Selecting an entry will start playback.
{{-}}<br />


==== Sidebar menu ====
= Playlist Files =
[[File:Now playing 3.png|500px|right]]
The {{kodi}} generated basic playlist file is in the '''m3u''' format.
On the default skin (Confluence) you can bring up these options by bringing up the sidebar menu (press {{keypress|left}} on a keyboard or remote).
;Shuffle
:Shuffles the currently playing playlist
;Repeat
:Repeats the currently playing playlist, options are: '''All''' songs/videos, '''One''' song/video or '''Off''' for no repeating.
;Save
:Saves the currently playing playlist
;Clear
:Clears the currently playing playlist
{{-}}<br />


==== Context menu ====
[[File:Now playing 2.png|500px|right]]
The context menu (press {{keypress|C}} on a keyboard) within the Now Playing window allows you to move the order of items or remove them.


On a [[keyboard]] you can also use:
* {{keypress|U}} - Move selected up
* {{keypress|D}} - Move selected down
* {{keypress|DEL}} - Remove from playlist.


A remote control with the proper [[keymap]] additions can also use those actions.
== 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]]


== Party Mode playlists ==
{{Frodo note|This will need to be updated for XBMC v12}}<br />
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 and partymode-video.xsp files in the [[userdata folder]]. The Party Mode playlists are smart playlists and can be configured as seen below:


For more information on configuring smart playlists, see '''[[Smart playlists]]'''.
== 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.


;Example
{{#lst:Userdata|location all}}
<source lang="xml">
<xml>
<smartplaylist type="music">
    <name>Party Mode</name>
    <match>all</match>
    <rule field="genre" operator="contains">Rock</rule>
    <rule field="artist" operator="is">U2</rule>
    <rule field="year" operator="lessthan">1985</rule>
</smartplaylist>
</xml>
</source>


== Other supported playlist ==
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.


=== Cue Sheets ===
== Editing m3u Files ==
{{main|Cue sheets}}
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 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.


== 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:Video Library]]
= Use External Playlists =
[[Category:Music Library]]
If you have a playlist that you manually created, or one that was created by another media player that:
[[Category:XBMC Manual]]
# 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
 
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 '''[[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"