YouTubeDownloader

YouTubeDownloader is a user-friendly console application for effortlessly downloading content from various sources in different qualities and formats. It includes a CSV auditing system to track download results.

Table of Contents

1. Installation
2. Getting Started
3. Configuration
4. Technologies Used
5. License

Installation

Prerequisites

• .NET 8.0: Ensure you have .NET 8.0 installed on your system.

Console Font Setup (Recommended for Better Experience)

To enhance readability in the console:

1. Download: Get the Cascadia Code font from here.
2. Install: Double-click the downloaded font file and follow the installation prompts.
3. Set Font in Console:
   • Open Command Prompt or PowerShell.
   • Right-click the title bar, select "Properties."
   • Go to the "Font" tab, choose "Cascadia Code," click "OK."

Setting the console font to Cascadia Code will improve your experience while using app.

Getting Started

1. Launch the Application

   You'll be presented with options to choose your download source:

   • From video link: Enter the video ID or URL.
   • From playlist link: Enter the playlist ID or URL, then select videos by title.
   • From channel uploads: Enter the channel ID or URL, then select videos by title.
   • From YouTube exported file: Enter the exported file path on your machine to download all videos from the file. You can use Google Takeout for this.
   • From failed downloads: Choose video IDs for redownloading, then specify whether to 'Keep original' format and quality or 'Override with new' format and quality.

2. Specify Format & Quality

   • MP3
     • Low Bitrate: Suitable for small size downloads with lower quality.
     • High Bitrate: Provides high quality audio but the file size will be larger.
   • MP4
     • SD (480p): Standard Definition video, smaller file size but lower quality.
     • HD (720p): High Definition video, good balance between quality and file size.
     • Full HD (1080p): Full High Definition video, provides the best quality but the file size will be the largest. Using FFmpeg.

3. Initiate Download

   With all information entered, YouTubeDownloader will start downloading asynchronously. Track the progress in the console until completion.

Configuration

In the appsettings.json file, you can adjust the configuration settings.
The program creates necessary files and folders and downloads FFmpeg compatible with your system.

downloaderSettings

• saveFolderPath: Specifies the folder where downloaded files will be stored.
• ffmpegPath: Path to the FFmpeg executable.
• fileNameTemplate: Determines the naming template for downloaded files, supports placeholders like Id, Title, and ChannelId within {} to specify where actual values should be inserted in the file names. Default template: "{Title}".

auditSettings.csvSettings

• auditSuccessful: Enable/disable auditing for successful downloads.
• auditFailed: Enable/disable auditing for failed downloads.
• successfulDownloadsFilePath: File path for storing details of successful downloads.
• failedDownloadsFilePath: File path for storing details of failed downloads.

Technologies Used

• YoutubeExplode: A .NET library for interacting with YouTube.
• FluentValidation: A popular .NET library for building strongly-typed validation rules.
• Custom CSV Audit: A CSV auditing system for logging successful and failed downloads.
• AnsiConsole: A library for enhancing console output with ANSI escape codes.
• Terminalizer: A tool for recording terminal sessions into animated GIFs or JSON files.

License

This project is licensed under the MIT License - see the LICENSE file for details.