TeamNewPipe/NewPipe · error · ResolverException

Empty stream URL

Error message

Empty stream URL

What it means

Thrown by PlaybackResolver.throwResolverExceptionIfUrlNullOrEmpty when the stream URL is an empty string (""). The helper distinguishes null and empty to aid debugging; both are invalid for playback. Called after the stream is expected to have a URL.

Source

Thrown at app/src/main/java/org/schabi/newpipe/player/resolver/PlaybackResolver.java:549

                        .setTag(metadata)
                        .setUri(Uri.parse(stream.getContent()))
                        .setCustomCacheKey(cacheKey)
                        .build());
    }
    //endregion


    //region Utils
    private static Uri manifestUrlToUri(final String manifestUrl) {
        return Uri.parse(Objects.requireNonNullElse(manifestUrl, ""));
    }

    private static void throwResolverExceptionIfUrlNullOrEmpty(@Nullable final String url)
            throws ResolverException {
        if (url == null) {
            throw new ResolverException("Null stream URL");
        } else if (url.isEmpty()) {
            throw new ResolverException("Empty stream URL");
        }
    }
    //endregion


    //region Resolver exception
    final class ResolverException extends Exception {
        public ResolverException(final String message) {
            super(message);
        }

        public ResolverException(final String message, final Throwable cause) {
            super(message, cause);
        }
    }
    //endregion
}

View on GitHub (pinned to 9e8be09156)

Solutions

  1. Validate stream.getContent() is non-empty before invoking the resolver.
  2. Update/fix the extractor so the content URL is fully populated.
  3. Trace where the empty string originates in the StreamInfo build pipeline.
Defensive patterns

Strategy: validation

Validate before calling

if (stream.getContent() == null || stream.getContent().isEmpty()) {
    // skip stream; do not invoke resolver
}

Type guard

static boolean hasNonEmptyStreamUrl(final Stream stream) {
    final String c = stream.getContent();
    return c != null && !c.isEmpty();
}

Try / catch

try {
    throwResolverExceptionIfUrlNullOrEmpty(stream.getContent());
} catch (final ResolverException e) {
    // empty content; skip this stream and pick another
}

Prevention

When it happens

Trigger: throwResolverExceptionIfUrlNullOrEmpty receives an empty ("") String from stream.getContent() on a stream expected to carry a URL. Same call sites as the null case (progressive, DASH-URL, HLS, SS, YouTube progressive/HLS/OTF).

Common situations: The extractor set the content field to an empty string instead of a real URL, a string-processing step trimmed the URL to empty, or the stream was constructed from incomplete parsed data. Indicates a data-quality/extractor issue.

Related errors


AI-assisted analysis of TeamNewPipe/NewPipe@9e8be09156 (2026-08-14). Data as JSON: /api/errors/ffd77fabf38f61c2. Report an issue: GitHub.