A parser for simple and extended M3U playlist files written in Kotlin.
This parser can also be used in Java projects.
Due to the underspecified nature of the M3U format, the parser tries to accept all files it gets,
as weird as they may are.
This especially includes extended M3U files with missing "#EXTM3U" headers and
mixed extended/simple files.
The library is available in Maven Central. Java 8 or higher is required to use it.
build.gradle.kts
dependencies {
implementation("com.github.bjoernpetersen:m3u-parser:$m3uParserVersion")
// or
implementation(
group = "com.github.bjoernpetersen",
name = "m3u-parser",
version = "$m3uParserVersion",
)
}build.gradle
dependencies {
implementation "com.github.bjoernpetersen:m3u-parser:$m3uParserVersion"
}pom.xml
<dependency>
<groupId>com.github.bjoernpetersen</groupId>
<artifactId>m3u-parser</artifactId>
<version>${m3uParser.version}</version>
</dependency>// Simply pass in a file
val m3uFile = Paths.get("myplaylist.m3u")
val fileEntries: List<M3uEntry> = M3uParser.parse(m3uFile)
// You may also pass in an InputStreamReader
val m3uStream: InputStream = javaClass.getResourceAsStream("myplaylist.m3u")
val m3uReader: InputStreamReader = m3uStream.reader()
val streamEntries: List<M3uEntry> = M3uParser.parse(m3uReader)
// Passing in the content of an M3U file as a String also works
val someApi = TODO("Not a real API object")
// Returns a playlist in the M3U format
val m3uContent: String = someApi.getPlaylist("Best of Willy Astor")
val entries: List<M3uEntry> = M3uParser.parse(m3uContent)If your M3U file contains the path of another playlist file
MyPlaylist.m3u
AnotherPlayList.m3u
then you'll get a M3uEntry with a MediaPath location for that file.
To get the contents of that playlist, you'll need to pass it to the parser again:
val nestedM3uLocation: MediaPath = TODO("...")
M3uParser.parse(nestedM3uLocation.path)You can use the M3uParser.resolveNestedPlaylists() method to recursively parse all nested playlist file references:
val entries: List<M3uEntry> = M3uParser.parse(Paths.get("playlist.m3u"))
// Doesn't contain any .m3u file references anymore
val resolvedEntries: List<M3uEntry> = M3uParser.resolveNestedPlaylists(entries)This project is released under the MIT License. That includes every file in this repository, unless explicitly stated otherwise at the top of a file. A copy of the license text can be found in the LICENSE file.
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent