IMPORTANT — ANTIVIRUS SOFTWARE

Some antivirus programs may block or remove the included download utilities
because they download and process online media.

The installer attempts to add C:\YTD as a Microsoft Defender exclusion.
This applies only to Microsoft Defender. Other antivirus programs may require
you to add the C:\YTD folder as an exclusion manually.

Do not disable antivirus protection completely. Only exclude C:\YTD, and only
use files obtained from a source you trust.


INSTALLATION

1. Extract the entire ZIP file to its own temporary folder. Do not run the
   installer directly from inside the ZIP file.

2. Double-click RunMe1st.bat.

3. Windows may ask whether you want to allow the program to make changes to
   your computer. Click Yes.

The installer automatically:

- Copies all YTD files to C:\YTD
- Creates the C:\YTD\Songs and C:\YTD\Videos folders
- Removes Windows downloaded-file security prompts from the installed files
- Adds C:\YTD\FFMPEG\bin to the Windows system PATH
- Attempts to add C:\YTD as a Microsoft Defender exclusion
- Checks for the latest yt-dlp version
- Downloads and installs the latest FFmpeg release
- Verifies that yt-dlp and FFmpeg can run
- Removes the temporary extracted installation folder after successful setup

After installation, use only the batch files located in C:\YTD.


DOWNLOADING MULTIPLE SONGS

1. Open C:\YTD\SongsToGet.txt.

2. Enter one song per line. Include the artist name for a more specific search.

Example:

Fleetwood Mac Dreams
Elton John Rocket Man
The Beatles Let It Be

3. Save and close SongsToGet.txt.

4. Double-click C:\YTD\DownloadBatchSongs.bat.

Completed MP3 files are saved in C:\YTD\Songs.


DOWNLOADING AUDIO FROM A URL

Double-click C:\YTD\DownloadSongURL.bat and enter the URL of an individual
video, song, or playlist.

Audio downloads are converted to MP3 files and saved in C:\YTD\Songs.


DOWNLOADING VIDEOS

Double-click C:\YTD\DownloadVideoURL.bat and enter the URL of an individual
video or playlist.

The best available video and audio streams are downloaded and merged using
FFmpeg. Completed videos are saved in C:\YTD\Videos.


UPDATING YT-DLP

The installer checks for a yt-dlp update during installation.

To update it again later, double-click:

C:\YTD\UpdateYTDLP.bat

Try updating yt-dlp first if downloads that previously worked begin failing.


UPDATING FFMPEG

The installer downloads the latest FFmpeg release during installation.

To update it again later, double-click:

C:\YTD\UpdateFFMPEG.bat

The updater downloads the current FFmpeg release essentials ZIP, verifies its
published SHA-256 checksum, installs it into C:\YTD\FFMPEG, and preserves the
previous installation if the update fails.


TROUBLESHOOTING

Always run the download batch files from C:\YTD.

If a batch file opens and immediately closes, open Command Prompt and run:

cd /d C:\YTD
DownloadVideoURL.bat

The error will remain visible in the Command Prompt window.

You can verify the required tools with:

C:\YTD\yt-dlp.exe --version
C:\YTD\FFMPEG\bin\ffmpeg.exe -version
