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.
NewPipe Material uses a pinned PipePipeExtractor Git submodule. Clone the repository together with its pinned submodule:
git clone --recurse-submodules https://github.com/wizdom13/NewPipe_Material.git
cd NewPipe_MaterialFor an existing checkout or after switching commits or tags:
git submodule sync --recursive
git submodule update --init --recursiveRequirements:
- Git with submodule support
- JDK 21
- Android SDK with the required platform and build tools
- Accepted Android SDK licenses
Build the debug APK and run JVM checks using the same committed entry point used by CI:
scripts/build.sh debugOther available build modes:
scripts/build.sh release
scripts/build.sh connected
scripts/build.sh checkstyleDo not use git submodule update --remote for release builds. Every release must use the exact extractor commit recorded by the app commit or tag.
See BUILDING.md for the complete build, signing, submodule, and reproducible-release instructions.
The 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, build the signed release APK with:
scripts/build.sh releaseThe release APK is generated under app/build/outputs/apk/release/. Verify it with:
apksigner verify --verbose --print-certs app/build/outputs/apk/release/app-release.apkA published APK must be built from the exact commit referenced by its release tag, including the pinned extractor submodule commit. Do not replace an existing release APK with one built from a newer commit; publish a new version and tag instead.
NewPipe 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 through the pinned submodule at external/NewPipeExtractor. Initialize it with:
git submodule sync --recursive
git submodule update --init --recursiveThe submodule commit recorded by the NewPipe Material repository is part of the source definition. Do not replace it with the latest extractor branch tip when preparing a release or reproducible build.
Use the shared scripts for validation:
scripts/build.sh checkstyle
scripts/build.sh debugDetailed instructions are maintained in BUILDING.md.
NewPipe 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.