A Material 3-focused streaming app based on NewPipe.
Project notice • About • Screenshots • Services • Features • Device sync • Installation • Build • Signing • Development • Contributing • Upstream • Donate • License
Translations are welcome, but only native-speaker reviewed translations will be added.
WizeStream is an independently maintained Android streaming app based on NewPipe, focused on Material 3 design, app theming, playback enhancements, and product polish.
It is not affiliated with, sponsored by, or endorsed by the official NewPipe project, TeamNewPipe, or NewPipe e.V.
WizeStream preserves the NewPipe libre software license, upstream credits, and third-party license notices.
This project was previously distributed as NewPipe Material. In July 2026, NewPipe e.V. asked the project to adopt a unique name that does not use the registered NewPipe word mark, in accordance with its trademark policy. The project was therefore renamed to WizeStream.
The rebranding changes the public app name, visual identity, repository name, and distribution metadata. It does not change the app's technical identity or update path: existing installations continue to use the same application ID, and can receive normal updates signed with the same release key. User data and settings are not reset by the name change.
WizeStream remains based on NewPipe and continues to preserve upstream attribution, licensing, and third-party notices. The rename is intended to clearly distinguish this independently maintained project from official NewPipe while respecting the upstream project's trademark policy. See issue #34 for the original request.
WizeStream has its own release cycle and follows semantic versioning:
MAJOR.MINOR.PATCH, such as1.0.0,1.1.0, and1.1.1- Git tags use the corresponding
vMAJOR.MINOR.PATCHform - WizeStream version numbers do not contain or follow NewPipe version numbers
NewPipe remains an upstream source and is credited as required, but its version is development metadata rather than part of WizeStream's public version identity. The currently tracked upstream baseline is recorded in UPSTREAM.md.
WizeStream keeps the lightweight, privacy-friendly NewPipe experience while modernizing the interface and adding playback-focused features.
Project highlights:
- Material 3-inspired app surfaces, dialogs, settings, tabs, and navigation
- Dynamic Material You color support where available
- Manual theme color presets
- Bottom navigation with a configurable default main tab
- SponsorBlock integration
- YouTube dislike count support
- Swipe seek, fullscreen swipe, and hold-to-speed-up player gestures
- Swipe down from the video player to return to the miniplayer
- Optional keep-video-visible mode while scrolling the details page
- Secure peer-to-peer synchronization between trusted WizeStream devices
- Automatic background synchronization on Wi-Fi or Ethernet
- Search filters and sorting, channel video sorting, and podcast channel tabs
- Per-channel playback profiles
- Multi-audio track selection with original, dubbed, and descriptive labels
- Import/export compatibility with supported NewPipe backup data
Sensitive areas such as playback, downloads, background playback, popup playback, and extractor logic are changed only through focused and tested work.
WizeStream inherits support for these services from the NewPipe and NewPipe Extractor codebase:
- YouTube and YouTube Music
- PeerTube
- Bandcamp
- SoundCloud
- media.ccc.de
Service support depends on the pinned upstream-derived extractor code.
Core features include:
- 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 and export app data for migration and backup
WizeStream additions include:
- Material 3 theme roles across more app surfaces
- Bottom navigation for five or fewer main tabs, with a scrollable tab layout for larger tab sets
- Configurable default main tab
- Dynamic and manual theme color support
- SponsorBlock and dislike-count support
- Enhanced player gestures
- Optional pinned video while scrolling
- Secure peer-to-peer synchronization for subscriptions, feed groups, playlists, watch and search history, playback progress, selected settings, channel playback profiles, and completed-download metadata
- Manual synchronization and automatic background synchronization on Wi-Fi or Ethernet
- A Download on this device action when synchronized download metadata has no matching local media file
- Search filters and sorting
- Latest, popular, and oldest sorting for channel videos
- Podcast tabs on supported channels
- Per-channel playback profiles
- Multi-audio track selection with original, dubbed, descriptive, and secondary track labels
- Playback-speed retention for live streams
- Independent release signing
WizeStream can synchronize supported app data directly between trusted WizeStream devices without requiring a platform account or a WizeStream cloud account.
Open Settings > Device synchronization on both devices. One device displays a one-time QR code and the other scans it. The pairing code expires after five minutes and can be used only once. After pairing, use Sync now for an immediate exchange or leave Automatic background synchronization enabled. Background synchronization runs approximately once per hour when the device has sufficient battery and can reach a trusted device on the same Wi-Fi or Ethernet network.
Supported synchronized data includes:
- Subscriptions and feed groups
- Local and remote playlists
- Watch history and playback progress
- Home tabs, content-filter selections, channel playback profiles, and allowlisted settings
- Search history when explicitly enabled on both devices
- Completed-download metadata
Synchronization uses an encrypted peer-to-peer connection between paired devices. Downloaded media files are not transferred. If another device reports a completed download but its media file is missing locally, the Downloads screen marks it Not local and offers Download on this device using the original source. Existing local and pending copies are deduplicated.
See Device synchronization for pairing instructions, synchronized data details, background behavior, and privacy notes.
Install WizeStream through an F-Droid-compatible client from the IzzyOnDroid repository.
Install WizeStream from this repository's GitHub releases or signed build artifacts when available.
Releases: https://github.com/wizdom13/WizeStream/releases
WizeStream uses a different application ID from official NewPipe, so both apps can be installed side by side:
WizeStream: org.wisso.newpipematerial
Debug build: org.wisso.newpipematerial.debug
Install WizeStream through GitHub Store.
WizeStream does not automatically share app data with official NewPipe.
To migrate:
- Open official NewPipe.
- Export your database from Settings > Backup and Restore.
- Install WizeStream.
- Import the exported database from Settings > Backup and Restore.
Always keep a backup before importing data between builds.
Automated nightly builds of the latest pipe commit are available here:
https://github.com/wizdom13/WizeStream_Nightly/releases
Nightly builds are unstable testing versions and use the separate application ID
org.wisso.newpipematerial.nightly, so they can be installed alongside the stable app.
See Nightly build documentation for details.
Do not publish WizeStream or forks of NewPipe to Google Play without first reviewing all applicable upstream, platform, and trademark requirements.
WizeStream uses a pinned WizeStreamExtractor Git submodule. Clone the repository together with its pinned submodule:
git clone --recurse-submodules https://github.com/wizdom13/WizeStream.git
cd WizeStreamFor 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:
scripts/build.sh debugOther 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 extractor commit recorded by the app commit or tag.
See BUILDING.md for complete build, signing, submodule, and reproducible-release instructions.
The debug APK uses the app label WizeStream Debug and package org.wisso.newpipematerial.debug.
Configure release signing with the WizeStream environment-variable names:
WIZESTREAM_RELEASE_STORE_FILE
WIZESTREAM_RELEASE_STORE_PASSWORD
WIZESTREAM_RELEASE_KEY_ALIAS
WIZESTREAM_RELEASE_KEY_PASSWORD
The legacy NEWPIPE_MATERIAL_RELEASE_* names remain accepted as fallbacks for existing environments.
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.
WizeStream is under active development for Material 3 polish, playback improvements, and release readiness.
Completed or in-progress areas include:
- Public WizeStream identity
- Debug and release identity separation
- Material 3 theme colors
- Dynamic and manual theme color handling
- Bottom navigation and main-tab polish
- About-screen attribution
- Player gestures and pinned-video behavior
- Secure device pairing and peer-to-peer synchronization
- Automatic background synchronization and download-metadata recovery
- Search filters, channel sorting, podcast tabs, and channel playback profiles
- Multi-audio selection and clearer audio-track labels
- Dialog, snackbar, settings, video-detail, and download UI polish
- Release-signing workflow support
High-risk areas receive dedicated QA before broad 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-and-after screenshots where possible and verify Light, Dark, Black, Follow system, and at least one manual theme color preset.
WizeStream builds against the wizdom13/WizeStreamExtractor fork through the pinned submodule at external/WizeStreamExtractor.
git submodule sync --recursive
git submodule update --init --recursiveThe recorded submodule commit is part of the source definition. Do not replace it with the latest branch tip when preparing a release or reproducible build.
WizeStream is based on NewPipe.
WizeStream does not mirror NewPipe's release numbers. See UPSTREAM.md for the upstream baseline currently tracked by this repository.
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:
- WizeStream-specific design, identity, release, and feature issues belong in this repository.
- Upstream extractor or service breakages may also need to be checked against official NewPipe.
To support upstream NewPipe, see its official donation page:
Upstream donations go to the upstream NewPipe project, not automatically to WizeStream.
WizeStream 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.