A Material 3-focused independent fork of NewPipe for Android.
Translations are welcome, but only native-speaker reviewed translations will be added.
NewPipe Material is an independently maintained fork of NewPipe focused on Material 3 design, app theming, and product polish.
It is not affiliated with, sponsored by, or endorsed by the official NewPipe project, TeamNewPipe, or NewPipe e.V.
NewPipe Material is built from NewPipe and keeps the NewPipe libre software license, upstream credits, and third-party license notices.
NewPipe Material keeps the core NewPipe experience while modernizing the app identity and user interface.
Current fork goals:
- Material 3-inspired app surfaces, dialogs, settings, tabs, and navigation
- Dynamic Material You color support where available
- Manual Theme color presets such as App default, Neutral, Green, Blue, Purple, Orange, Pink, and Red
- New app identity: NewPipe Material
- Separate application ID:
org.wisso.newpipematerial - Debug builds install separately as
org.wisso.newpipematerial.debug - Preserve NewPipe behavior, import/export compatibility, and supported services
This fork intentionally avoids risky behavior changes in sensitive areas such as playback, downloads, background playback, popup playback, and extractor logic unless they are handled as dedicated, tested changes.
NewPipe Material inherits NewPipe support for these services:
- YouTube and YouTube Music
- PeerTube
- Bandcamp
- SoundCloud
- media.ccc.de
Service support depends on the upstream NewPipe and NewPipe Extractor codebase.
NewPipe Material keeps the familiar NewPipe feature set, including:
- Watch videos and live streams
- Background playback
- Popup player
- Local playlists
- Subscriptions without signing in to a platform account
- Channel groups and feeds
- Search and browse supported services
- View video details, related videos, and comments where supported
- Download video, audio, and captions where supported
- Import/export app data for migration and backup
Material-focused additions include:
- Material 3 theme roles across more app surfaces
- Bottom navigation for five or fewer main tabs, with scrollable TabLayout fallback for larger tab sets
- Default bottom main tab position for new/unset installs
- Dynamic/manual Theme color support
- NewPipe Material fork attribution in the About screen
- Release signing support for fork builds
Install NewPipe Material from this repository's GitHub releases or signed build artifacts when available. Releases: https://github.com/wizdom13/NewPipe_Material/releases
NewPipe Material uses a different application ID from official NewPipe, so it can install side by side with the official app:
Official NewPipe: org.schabi.newpipe / net.newpipe.app depending on upstream build
NewPipe Material: org.wisso.newpipematerial
Debug build: org.wisso.newpipematerial.debug
NewPipe Material does not automatically share app data with official NewPipe.
To migrate:
- Open official NewPipe.
- Export your database from Settings > Backup and Restore.
- Install NewPipe Material.
- Import the exported database from Settings > Backup and Restore.
Always keep a backup before importing data between builds.
Do not publish NewPipe Material, NewPipe, or forks of NewPipe to Google Play. This project follows the same practical distribution caution as upstream NewPipe.
Requirements:
- JDK 21
- Android SDK
- Gradle wrapper from this repository
Useful validation commands:
./gradlew runCheckstyle -DskipFormatKtlint
./gradlew assembleDebug lintDebug testDebugUnitTest --stacktrace -DskipFormatKtlintBuild a debug APK:
./gradlew assembleDebug -DskipFormatKtlintThe debug APK uses the app label NewPipe Material Debug and package org.wisso.newpipematerial.debug.
Release signing is configured through environment variables:
NEWPIPE_MATERIAL_RELEASE_STORE_FILE
NEWPIPE_MATERIAL_RELEASE_STORE_PASSWORD
NEWPIPE_MATERIAL_RELEASE_KEY_ALIAS
NEWPIPE_MATERIAL_RELEASE_KEY_PASSWORD
When all four values are present, the release build uses the configured signing key. If they are missing, the release signing config is not applied.
Recommended release validation:
./gradlew assembleRelease -DskipFormatKtlint
apksigner verify --verbose --print-certs app/build/outputs/apk/release/app-release.apkNewPipe Material is a fork in active Material 3 polish and productization work.
Completed or in-progress fork areas include:
- App name and application ID
- Debug/release identity separation
- Material 3 theme colors
- Dynamic/manual Theme color handling
- Bottom navigation and main tab polish
- About screen fork attribution
- Dialog, snackbar, settings, video detail, and download UI polish
- Release signing workflow support
Deferred or high-risk areas:
- Main player overlay retheme
- Seekbar and gesture overlay colors
- Queue overlay controls
- Quality/audio/caption popup behavior
- Broad playback/download behavior changes
Those areas need dedicated QA before visual or behavior changes.
Contributions are welcome, especially focused Material 3 polish, bug fixes, QA findings, documentation, and release-readiness work.
Please keep changes focused and testable. For UI work, include before/after screenshots where possible and verify Light, Dark, Black, Follow system, and at least one manual Theme color preset.
NewPipe Material builds against the wizdom13/PipePipeExtractor fork from source through Gradle composite-build dependency substitution. Before running Gradle locally, clone the extractor source into the preferred in-repo path:
git clone https://github.com/wizdom13/PipePipeExtractor external/NewPipeExtractorAlternatively, clone it next to this repository so it is available as ../PipePipeExtractor:
git clone https://github.com/wizdom13/PipePipeExtractor ../PipePipeExtractorThe in-repo checkout directory remains external/NewPipeExtractor because the app still substitutes the upstream com.github.TeamNewPipe:NewPipeExtractor dependency with the local PipePipeExtractor :extractor project.
Useful checks before opening a pull request:
./gradlew runCheckstyle -DskipFormatKtlint
./gradlew assembleDebug lintDebug testDebugUnitTest --stacktrace -DskipFormatKtlintNewPipe Material is based on NewPipe.
Upstream resources:
- NewPipe repository: https://github.com/TeamNewPipe/NewPipe
- NewPipe website: https://newpipe.net
- NewPipe FAQ: https://newpipe.net/FAQ/
- NewPipe Extractor: https://github.com/TeamNewPipe/NewPipeExtractor
Please report issues carefully:
- Fork-specific design, identity, release, or Material 3 issues belong in this repository.
- Upstream extractor/service breakages may also need to be checked against official NewPipe.
If you want to support upstream NewPipe, see the official NewPipe donation page:
NewPipe Material is an independent fork; upstream donations go to the upstream NewPipe project, not automatically to this fork.
NewPipe Material is free software based on NewPipe and is distributed under the GNU General Public License version 3 or later.
See the repository license files and in-app license screen for full license and third-party notice details.