OnTube

OnTube is a library that provides an interface to easily convert YouTube videos to audio files and download them with any resolution. Behind a layer of abstraction, this library works by scraping raw page data and exploiting reverse-engineered internal endpoints.

Extension packages:

OnTube.Converter — provides the ability to download and convert videos using FFmpeg.

You are free by using this project or its source code, for any purpose that will improve this package for future.

Installation

OnTube is available on NuGet. Install the provider package. See the in the docs for additional downloads.

dotnet add package OnTube --version 1.0.0

Download package using nuget

Only search for OnTube and please ignore this -> Ond.Util.OnTube

Usage

OnTube exposes its functionality through a single entry point — the OntubeAudioConverter class. Create an instance of this class and use the provided operations on Videos and Audio properties to send requests.

Videos

To download the video from YouTube.

using ontubePackage;

var youtube = new OntubeAudioConverter();

// You can specify the video URL 
var videoUrl = "https://www.youtube.com/watch?v=BcmUqwC_2Uc";
// You can specify the Folder path for example in D 
var folderPath = @"D:\music";
//You can specify the file name as you like
var fileName = "song1";
//Finally, you can specify the resolution of video
int quality = 360;
 var downloadedVideo = await youtube.DownloadVideoAsync(videoUrl, folderPath, fileName, quality);
 //check if every thing is going well
if (downloadedVideo.IsSuccess != false)
{
    Console.WriteLine($"Audio file saved at: {downloadedVideo.Data}");
}
else
{
    Console.WriteLine($"{downloadedVideo.Message}");
}

Downloading video streams

Every YouTube video has a number of streams available, differing in containers, video quality, bitrate, framerate, and other parameters.

Warning: Muxed streams contain both audio and video, but these streams are limited in quality (up to 720p30). Some videos when you download them in a low quality you got a video without sound so, try to download with high quality.

Audios

To convert the YT video to audio.

using ontubePackage;

var youtube = new OntubeAudioConverter();

// You can specify the video URL 
var videoUrl = "https://www.youtube.com/watch?v=BcmUqwC_2Uc";
// You can specify the Folder path for example in D 
var folderPath = @"D:\music";
//You can specify the file name as you like
var fileName = "song1";

 var convertedAudio = await youtube.ConvertToAudioAsync(videoUrl, folderPath, fileName);
 
 //check if every thing is going well
if (convertedAudio.IsSuccess != false)
{
    Console.WriteLine($"Audio file saved at: {convertedAudio.Data}");
}
else
{
    Console.WriteLine($"{convertedAudio.Message}");
}

Once the audio is obtained, you can find it in the purposed folder with a format of type mp3.

In the end don't hesitate to share your ability in developing this packge.

Use it with MVC Apps

using ontubePackage;

// This is the controller
public class HomeController : Controller
{
    private readonly OntubeAudioConverter _ontube;
    public HomeController(OntubeAudioConverter ontube)
    {
        _ontube = ontube;      
    }

    public IActionResult Index()
    {
        return View();
    }

    public IActionResult Privacy()
    {
        return View();
    }

    [HttpPost]
    public async Task<IActionResult>Download(string url)
    {
        var folderPath =@"D:\visualstudiocodes\Csharp\Test_Template\wwwroot\music";
        //You can specify the file name as you like
        var fileName = "song1";

        await _ontube.DownloadVideoAsync(url, folderPath, fileName, 360);

        return View("Index");
    }
}


//This is the view Download.cshtml
 <form asp-action="Download" asp-controller="Home" method="post">
     <input type="text"  name="url"/>
     <div>
         <button type="submit">Download</button>
     </div>
 </form>


// This is the program.cs
builder.Services.AddScoped<OntubeAudioConverter>();

😁 Contributing

Pull requests are welcome but before that please open an issue first to discuss what you want to change. please follow me for more C# blogs linkedin

📎 License

This project is licensed under the MIT License.

OND10 / OnTubenu