Latest revision as of 00:07, 13 February 2023

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:

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 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 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 4- Select Go to playlist from the left sideblade menu
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

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

Return to top

[1] ttps://github.com/xbmc/xbmc/pull/21992

[1]

@@ Line 1: / Line 1: @@
-{{mininav|[[Playlists]] }} {{to do}}
+{{mininav|[[Playlists]] }}
-<section begin="intro" />Kodi 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 Kodi's GUI.<section end="intro" />
-== Basic playlists ==
-The main way to create and manipulate playlists in Kodi is through the playlist editors (both for normal and smart playlists).
-=== How to create a normal playlist ===
+= Introduction =
-[[File:Playlist queue.png|500px|right]]
+<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" />
-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. Kodi will add the selected item to the playlist and then advance to the next item in the window.
+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.
-To see the currently loaded playlist, bring up the context menu.  The currently playing/queued playlist is accessible via the '''"Current playlist"''' item in the left hand sidebar menu.  If the playlist is currently empty then that option will not be visible in the sidebar menu.
+'''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 "Current playlist" window and pressing the '''Select''' or the '''Play''' button will start playback of your playlist.
-When in the "Current playlist" view, you can save your playlist by bringing up the options in the left hand sidebar menu. Playlists are, by default, saved in a subfolder  of [[userdata]]/playlists (separate folder for music, video and mixed playlists).
+= Playlist Files =
-{{-}}
+The {{kodi}} generated basic playlist file is in the '''m3u''' format.
-=== Current playlist window ===
-{{anchor|Now Playing}}
-The current playlist is a special window for the current audio or video playlist. This list is accessible from the [[Music_navigation#Sideblade_Menu|left hand sidebar menu]]. Selecting an entry will start playback.
-{{-}}<br />
-==== Sidebar menu ====
-[[File:Now playing 3.png|500px|right]]
-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 ====
+== Supported Formats ==
-[[File:Now playing 2.png|500px|right]]
+{{kodi}} supports the following playlist files:
-The context menu (press {{keypress|C}} on a keyboard) within the current playlist allows you to move the order of items or remove them.
+* [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]]
-On a [[Keyboard_controls|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.
+== 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.
-== Party Mode playlists ==
+{{#lst:Userdata|location all}}
-{{see|Party Mode}}
-== Smart playlists ==
-{{main|Smart playlists}}
-{{#lst:Smart playlists|intro}}
-== Other supported playlist ==
+== Editing m3u Files ==
-Kodi 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|Kodi Smart Playlist (XSP)]] playlists.
+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++].
-== Playlist folder location ==
-The playlists should be placed into a folder named “music“, “mixed” or “video” in the following location:
-* '''Windows XP:''' <code>Documents and Settings\<your_user_name>\Application Data\Kodi\userdata\playlists\</code>
-* '''Vista/Windows 7:''' <code>Users\<your_user_name>\AppData\Roaming\Kodi\userdata\playlists\</code>
-* '''Mac OS X:''' <code>/Users/<your_user_name>/Library/Application Support/Kodi/userdata/playlists/</code>
-* '''iOS:''' <code>/private/var/mobile/Library/Preferences/Kodi/userdata/playlists/</code>
-* '''Linux:''' <code>$HOME/.kodi/userdata/playlists/</code>
-{{Helix updated}}
+= 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
+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]]
-[[Category:Manual]]

Basic playlists: Difference between revisions

Latest revision as of 00:07, 13 February 2023

Contents

Introduction

Playlist Files

Supported Formats

Location of Playlist Files

Editing m3u Files

Use External Playlists

Playlist Editor

Playlist Editor Location

Using Playlist Editor

Queue Method

References

Navigation menu

Basic playlists: Difference between revisions

Latest revision as of 00:07, 13 February 2023

Introduction

Playlist Files

Supported Formats

Location of Playlist Files

Editing m3u Files

Use External Playlists

Playlist Editor

Playlist Editor Location

Using Playlist Editor

Queue Method

References

Navigation menu

Search