YoutubeExplodeDart

Add the youtube_explode_dart dependency to your pubspec.yaml file and import the library in your Dart code.

youtube_explode_dart: ^2.3.4

import 'package:youtube_explode_dart/youtube_explode_dart.dart';

Always call yt.close() when you are finished using the library to close the underlying HTTP client and prevent the Dart process from hanging.

yt.close();

To change the launch screen image in your Flutter iOS application, you can either replace the image files directly in the filesystem or use Xcode.

Option 1: Filesystem replacement Replace the existing image files located in the ios/Runner/Assets.xcassets/LaunchImage.imageset/ directory with your own assets.

Option 2: Using Xcode

1. Open the iOS project in Xcode by running open ios/Runner.xcworkspace from your terminal.
2. In the Xcode Project Navigator, navigate to Runner/Assets.xcassets.
3. Drag and drop your desired images into the asset catalog.

Some YouTube clients require a JavaScript challenge to be completed for downloads. This requires a JS runtime. Currently, the library supports DenoEJSSolver which requires the Deno runtime. Initialize the solver and pass it to the YoutubeExplode constructor via the jsSolver parameter.

import 'package:youtube_explode_dart/solvers.dart';

final solver = await DenoEJSSolver.init();
var yt = YoutubeExplode(jsSolver: solver);

The SearchResult class is an abstract base for different types of items returned from a YouTube search. When performing a search, you will receive a list of these objects, which you can distinguish using type checks (e.g., is SearchVideo).

There are three main implementations of SearchResult:

1. SearchVideo: Represents a single video.
2. SearchPlaylist: Represents a playlist.
3. SearchChannel: Represents a YouTube channel.

All search results include a list of thumbnails and a unique id.

If you encounter issues, enable fine-grained logging using the logging package before initializing any YoutubeExplode code. This will help in capturing detailed logs and stack traces for reporting.

import 'package:logging/logging.dart';

// Before any YoutubeExplode code
Logger.root.level = Level.FINER;
Logger.root.onRecord.listen((e) {
  print(e);
  if (e.error != null) {
   print(e.error);
   print(e.stackTrace);
  }
});

Retrieve a list of related videos for a specific Video instance using yt.videos.getRelatedVideos(video). If the list is long, you can fetch subsequent pages using the nextPage() method on the returned object. If no related videos are found, the method returns null.

var video = yt.videos.get('https://youtube.com/watch?v=Dpp1sIL1m5Q');
var relatedVideos = await yt.videos.getRelatedVideos(video);

if (relatedVideos != null) {
  print(relatedVideos);
  // To get the next page
  relatedVideos = await relatedVideos.nextPage();
}

To get closed captions, first retrieve the track manifest using yt.videos.closedCaptions.getManifest(videoId). Use manifest.getByLanguage(languageCode) to find a specific track. Once you have the trackInfo, use yt.videos.closedCaptions.get(trackInfo) to get the actual caption track, which allows you to retrieve text at specific timestamps using track.getByTime(duration).

var yt = YoutubeExplode();
var trackManifest = await yt.videos.closedCaptions.getManifest('_QdPW8JrYzQ');
var trackInfo = trackManifest.getByLanguage('en');

if (trackInfo != null) {
  var track = await yt.videos.closedCaptions.get(trackInfo);
  var caption = track.getByTime(Duration(seconds: 61));
  var text = caption?.text; // "And the game was afoot."
}

Use yt.playlists.get(id) to retrieve playlist metadata. To iterate through the videos in a playlist, use yt.playlists.getVideos(playlistId), which returns a stream of videos. You can also fetch the entire list as a collection using await yt.playlists.getVideos(playlistId) or use .take(n) to limit the results.

var yt = YoutubeExplode();

// Get playlist metadata.
var playlist = await yt.playlists.get('xxxxx');
var title = playlist.title;

// Iterate through videos
await for (var video in yt.playlists.getVideos(playlist.id)) {
  var videoTitle = video.title;
}

// Get first 20 playlist videos
var somePlaylistVideos = await yt.playlists.getVideos(playlist.id).take(20);

You can retrieve metadata for a YouTube video by providing either a video ID or a URL string to yt.videos.get(). This returns a Video instance containing properties like title, author, and duration.

// You can provide either a video ID or URL as String or an instance of `VideoId`.
var video = yt.videos.get('https://youtube.com/watch?v=Dpp1sIL1m5Q'); // Returns a Video instance.

var title = video.title; // "Scamazon Prime"
var author = video.author; // "Jim Browning"
var duration = video.duration; // Instance of Duration - 0:19:48.00000