NewPipeExtractor-KMP

1.2.1indexed

Extracts YouTube videos and comments, maintaining compatibility with original usage. Refactored for improved readability, structure, and platform compatibility, with a pure Kotlin JSON implementation.

AndroidJVMNativeWasm·yushosei/NewPipeExtractor-KMP

Stars

—

Used by

dependents

—

Health

/ 100

NewPipeExtractor-KMP

This repository is a Compose Multiplatform-compatible adaptation of the NewPipeExtractor, forked from version v0.24.5. It is intended for extracting YouTube and SoundCloud content within Kotlin Multiplatform projects.

📌 Overview

Migrated to Kotlin (Multiplatform).
Based on NewPipeExtractor v0.24.5.
Internal modules have been refactored and improved for better readability, structure, and platform compatibility.
Replaced nanojson with a pure Kotlin implementation.
Public APIs and function call patterns remain unchanged to ensure compatibility with the original usage.
✅ Audio stream extraction supports both YouTube and SoundCloud.
This project aims to serve as a foundation for integrating content extraction logic into Compose Multiplatform applications.

🚀 Usage

1. Add Dependency

implementation("io.github.yushosei:newpipe-extractor-kmp:1.2.1")

2. Initialization

NewPipe.init(DefaultDownloaderImpl.initDefault())

3. Search

ExtractorHelper.searchFor(
    SERVICE_ID, searchText, listOf("videos"),
    "",
)

4. Get More Search Items

ExtractorHelper.getMoreSearchItems(
    SERVICE_ID, searchText, listOf("videos"), "", page
)

5. Search Suggestions

ExtractorHelper.suggestionsFor(SERVICE_ID, searchText)

6. Stream Extraction

ExtractorHelper.getStreamInfo(SERVICE_ID, item.url)

For more details, refer to the sampleApp.

🎥 Demo Video

Android & iOS

https://github.com/user-attachments/assets/d4221163-619f-49fa-83a5-48b580da29af

Web

https://github.com/user-attachments/assets/5f8ab309-4e46-40fb-9911-ff82c18c5a3e

Desktop

https://github.com/user-attachments/assets/35e628ea-50ad-4cba-a970-7e5cb4705823

✅ This demo showcases and on both and using Kotlin Multiplatform code. Although the test focused on audio streams for simplicity, the extractor is also capable of handling (TODO) All core logic is written in , making it platform-independent and theoretically usable across too.

⚠️ Note on `nanojson` Replacement

This project includes a reimplementation of nanojson in pure Kotlin, rewritten from scratch to work within the Kotlin Multiplatform (NewPipeExtractor).

✅ The implementation has been tested in conjunction with NewPipe and verified to extract data correctly.
⚠ However, this Kotlin version of nanojson is an interim solution. It was built for functional compatibility and does not guarantee performance parity with the original Java version.
It exists only to enable current operation and may be replaced in the future with a more robust or performant JSON parser tailored for KMP.

✅ Migration Themes & Checklist

Java Dependency Removal

Remove core Java-only APIs (e.g. Serializable, Optional, Pattern, URL, Objects)
Replace Java collections, streams, and IO with Kotlin equivalents

Rhino JavaScript Handling

Decide on Rhino integration approach (e.g. maintain, isolate, or replace)

Custom Kotlin Object Replacement

Convert Java utility classes (Pair, ManifestCache, etc.) to idiomatic Kotlin

Serialization Strategy Change

Replace Serializable with @Serializable and kotlinx.serialization

Lightweight JSON Optimization

Remove nanojson dependency
Reimplement nanojson using pure Kotlin logic
Evaluate long-term direction for JSON handling:
- Convert to a pure Kotlin @Serializable-based structure