//Simple initializing
var link = "https://www.youtube.com/watch?v=Q7ajZiT1Yms";
var context = new YoutubeContext(link);

//Defining download directory
var context = new YoutubeContext(Url) 
    {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
//The file name is automatically set by the video's title
//and can later be accessible from context.AudioPath

string url = "https://www.youtube.com/watch?v=Q7ajZiT1Yms";
//init a simple context to temp dir.
var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
//Finds the best quality audio and sets it to the context
DownloadUrlResolver.FindHighestAudioQualityDownloadUrl(yc);

//Init a AudioDownloader with the current context and the rest is magic.
var ad = new AudioDownloader(yc);
ad.Execute();
Console.WriteLine(yc.AudioPath.FullName);
yc.AudioPath.Delete();

string url = "https://www.youtube.com/watch?v=Q7ajZiT1Yms";
var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
await DownloadUrlResolver.FindHighestAudioQualityDownloadUrlAsync(yc);
var ad = new AudioDownloader(yc);
await ad.ExecuteAsync();
Console.WriteLine(yc.AudioPath.FullName);
yc.AudioPath.Delete();

var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
var ad = new AudioDownloader(yc, true); //true for auto-find highest quality into `yc`
ad.Execute();

var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
//cant use auto-find for highest quality since it is ran serially
//so this is called instead
await DownloadUrlResolver.FindHighestAudioQualityDownloadUrlAsync(yc);
var ad = new AudioDownloader(yc);
await ad.ExecuteAsync();

var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
var vd = new VideoDownloader(yc, true);
vd.Execute();

var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
await DownloadUrlResolver.FindHighestVideoQualityDownloadUrlAsync(yc);
var ad = new VideoDownloader(yc);
await ad.ExecuteAsync();

var yc = new YoutubeContext(url) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
var tn = new YoutubeThumbnail(yc);
//it will wait for the task that gets the thumbnail to finish.

var thumbnailurl = tn.Thumbnail;

//true in the context constructor is for initialize a thumbnail getter asap.
var yc = new YoutubeContext(url, true) {BaseDirectory = new DirectoryInfo(Path.GetTempPath())};
//If thumbnail getter hasn't finished or context initialized with false,
//The following will return "Resources/default.png".
var thumbnailurl = yc.Thumbnail;
//To wait the getter to finish call:
yc.WaitForThumbnail();
//Once thumbnail is found, ProgressStateChanged is raised with YoutubeStage.ThumbnailFound
var realthumbnail = yc.Thumbnail;

context.ProgresStateChanged += (sender, args) => {
    switch (args.Stage) {
        case YoutubeStage.ThumbnailFound:
            //do something about it, I dare you.
            //This event is out of sync with others as it is run parallerly
            break;
        case YoutubeStage.ProcessingUrls:
            ReportProgress(context, "Processing Urls");
            break;
        case YoutubeStage.DecipheringUrls:
            ReportProgress(context, "Deciphering Urls");
            break;
        case YoutubeStage.StartingDownload:
            ReportProgress(context, "Download Starting");
            break;
        case YoutubeStage.Downloading:
            ReportProgress(context, $"{args.Precentage.ToString("F1")}%");
            break;
        case YoutubeStage.DownloadFinished:
            ReportProgress(context, "Download Finished");
            break;
        case YoutubeStage.StartingAudioExtraction:
            ReportProgress(context, "Starting Extracting Audio");
            break;
        case YoutubeStage.ExtractingAudio:
            ReportProgress(context, $"{args.Precentage.ToString("F1")}%");
            break;
        case YoutubeStage.FinishedAudioExtraction:
            ReportProgress(context, "Finished Extracting Audio");
            break;
        case YoutubeStage.Completed:
            ReportProgress(context, "Completed");
            break;
        default:
            throw new ArgumentOutOfRangeException();
    }
};

public void ReportProgress(YoutubeContext context, string stage) {
    //do something with the stage change
}

yc.DownloadFailed += (sender, args) => {
    if (args.NumberOfTries >= 5)
        args.ShouldRetry = false;
    Console.WriteLine("args.Subject\n"+args.Exception);
};