NewPipeExtractor is a GPL-3.0 Java library that extracts data from streaming sites such as YouTube, SoundCloud, media.ccc.de, PeerTube and Bandcamp, and it is intended for developers who want that extraction as a dependency inside their own application rather than as a finished media player.

What it is

NewPipeExtractor is a library for extracting things from streaming sites. It is a core component of NewPipe, but the README states it can be used independently, so it ships as a standalone Java artifact in the Maven and Gradle ecosystem rather than as an end-user program. It is published through JitPack's Maven repository under the coordinates com.github.teamnewpipe:NewPipeExtractor, with snapshots also available on Maven Central's snapshot repository under net.newpipe:extractor. The project carries documentation and Javadoc on teamnewpipe.github.io, a CI workflow at .github/workflows/ci.yml running against the dev branch, and it declares support for five services: YouTube, SoundCloud, media.ccc.de, PeerTube (without P2P) and Bandcamp.

The concrete problem it solves is that every one of those services changes its own transport, signatures and page structure independently, and any application that wants their data must otherwise write and maintain one bespoke scraper per site. NewPipeExtractor replaces that per-site scraping work with a single dependency that exposes the extraction logic already maintained for the NewPipe client. A consuming project therefore does not have to reverse-engineer YouTube or SoundCloud itself, nor track each site's changes on its own schedule; it inherits the extractor's coverage of those services.

Key capabilities

• Provides extraction support for YouTube, SoundCloud, media.ccc.de, PeerTube (no P2P) and Bandcamp.
• Installs into Gradle projects by adding maven { url 'https://jitpack.io' } to repositories and implementation 'com.github.teamnewpipe:NewPipeExtractor:INSERT_VERSION_HERE' to dependencies.
• Publishes snapshots to https://central.sonatype.com/repository/maven-snapshots/ as net.newpipe:extractor:${LAST_COMMIT_SHORT_HASH}-SNAPSHOT, keyed to the commit's short hash and available for 90 days since publication.
• Requires keep rules when minifying, covering org.mozilla.javascript.** { *; }, org.mozilla.classfile.ClassFileWriter and -dontwarn org.mozilla.javascript.tools.**.
• Supports local development against a checkout through includeBuild('../NewPipeExtractor') in settings.gradle, or through ./gradlew install and mavenLocal() with a renamed LOCAL_SNAPSHOT version.
• Requires core library desugaring with the desugar_jdk_libs_nio artifact in Android projects whose minSdk is below 33.

Who uses it and how

• Android client developers, since the library is a core component of NewPipe and needs desugaring configuration in Android projects with minSdk below 33.
• JVM and Kotlin application developers who consume it as a Gradle dependency and let JitPack or Maven Central's snapshot repository resolve versions.
• Teams tracking upstream changes against snapshots identified by commit short hash, accepting the 90-day retention window on those builds.
• Contributors to the extractor itself, who substitute project(':extractor') via includeBuild and run ./gradlew install into the local Maven repository to test changes quickly.
• Projects on Android Studio that refresh a locally installed build with File → "Sync with File System" after running the install task.

Getting started

Add the JitPack repository and the com.github.teamnewpipe:NewPipeExtractor dependency to a Gradle build, replacing INSERT_VERSION_HERE with the latest release, and add the documented ProGuard keep rules if the project uses minimisation.

How it compares

No comparable library or paid replacement product is named in the facts provided, and the supported sites listed are the services it extracts from rather than rival tools. Within this registry the project accordingly stands alone, with its only stated relationship being that it is a core component of NewPipe.

When to use it — and when not to

It is a library, so a self-hoster must operate their own build, dependency resolution and, on Android, desugaring with desugar_jdk_libs_nio plus ProGuard keep rules for the bundled org.mozilla.javascript classes; no database, object storage or SMTP is mentioned in the facts. Projects that cannot accept the GPL-3.0 copyleft terms, or that need PeerTube peer-to-peer behaviour, are poor fits, and the record shows 182 open issues alongside support for only five services. The README is also thin on usage beyond dependency setup, so adopters inherit responsibility for keeping pace with upstream site changes.

### Rules for NewPipeExtractor
-keep class org.mozilla.javascript.** { *; }
-keep class org.mozilla.classfile.ClassFileWriter
-dontwarn org.mozilla.javascript.tools.**

repositories {
    maven(url = "https://central.sonatype.com/repository/maven-snapshots/")
}

dependencies {
    implementation("net.newpipe:extractor:${LAST_COMMIT_SHORT_HASH}-SNAPSHOT")
}

includeBuild('../NewPipeExtractor') {
    dependencySubstitution {
        substitute module('com.github.teamnewpipe:NewPipeExtractor') with project(':extractor')
    }
}