Tzahi12345 / YoutubeDL-Material

Self-hosted YouTube downloader built on Material Design
MIT License
2.63k stars 272 forks source link

Configuration explanation #357

Open jwillmer opened 3 years ago

jwillmer commented 3 years ago

I have setup the app and it works great. Now I would like to fine tune the settings but the options do not tell me anything. I also haven't found any wiki entry that explains the options. Could someone help me out?

What is the difference between the downloaders? image

What are these options doing? image

For what is this URL used? For me all seams to work without defining it. image

Tzahi12345 commented 3 years ago

Warning: incoming wall of text

Something I've wanted to do for a while is just add a little tooltip by each setting that explains them. I could do it in a wiki page but I feel like it would be better to do it in-app. I'll try to get it in for the next version! But just to explain some of the stuff you asked here and eventually move these into the UI:

What is the difference between the downloaders?

There isn't much, they are all just different forks of youtube-dl (the tool we use to actually download the videos). Some have new features, some work when the main repo is broken, etc. I'm planning on adding yt-dlp support soon as they just introduced a fix that will allow me to support it. Basically, if you are not having issues with youtube-dl, you can just keep using it.

What is the file and download manager doing?

The file manager is basically the "My videos" section on the home page. I want users to be able to set this up as a public YT downloader as well, so that would naturally mean you wouldn't want to display any of the videos downloaded.

The download manager is kind of a misnomer, it's just another sidebar page (like subscriptions) which just shows all the downloads you've done and their status. It's kinda old and buggy and requires rework or just straight removal.

If I disable quality select it will always download the best?

Yup!

Download only mode will hide downloaded videos in the UI?

No, and this setting is kind of a misnomer as well (I'll add this to a cleanup todo at the bottom of this comment). Basically it just means that the video/audio file gets downloaded locally automatically after downloading, but it'll still show up in the UI if the file manager is enabled.

What is multi download mode?

It adds a checkbox to the home page that let's users download multiple videos at a time, meaning they will not be redirected once one is finished.

Allow playlist categorization

This is an optional feature for categories. If this option is enabled, the first video in a downloaded playlist to fit into a category will make every video in that playlist part of the category. Otherwise, if you download a playlist, your categories will just be ignored.

Use youtube-dl archive

Basically just a way to avoid redownloading the same video, you can see a short explanation here. Also let's you keep track of downloaded videos in a single file if you decide to use another video downloading program.

What is advanced download?

Adds a new tab to the home screen which gives you a few more features. Let's you run purely custom youtube-dl commands, crop your downloaded videos, and auto name the files.

Set custom cookies in case some website requires it?

Pretty much! Or sometimes youtube-dl might block your IP and this sometimes helps.

For what is this URL used? For me all seams to work without defining it.

I think it's only useful if you run this in a non-Docker environment as CORS gets upset in some cases. I think!

So basically here are the main takeaways from this issue:

I think that's everything! Let me know if you have any more questions

jwillmer commented 3 years ago

Thanks for the details! Now all is clear except for Auto-download locally. Does that mean the downloaded files will be stored in a temp folder instead of the specified dl folder. So the next time the docker container restarts (or a cron triggers) they are gone?

ghost commented 3 years ago

I'm planning on adding yt-dlp support soon as they just introduced a fix that will allow me to support it.

Any updates on support for yt-dlp? Would like to try it out.

GlassedSilver commented 2 years ago

I'm planning on adding yt-dlp support soon as they just introduced a fix that will allow me to support it.

Any updates on support for yt-dlp? Would like to try it out.

Sorry for the late reply. It is included in the nightly branch!

GlassedSilver commented 2 years ago

Thanks for the details! Now all is clear except for Auto-download locally. Does that mean the downloaded files will be stored in a temp folder instead of the specified dl folder. So the next time the docker container restarts (or a cron triggers) they are gone?

Sorry that you never got an explanation for this, hopefully you already learnt it elsewhere, otherwise here's the very late reply.

The files load to your YTDLM instance normally as they would without this setting, nothing changes about your server-side.

The difference is that at the end of the download from the source to your server a download for the pulled file will be initiated towards your client (your browser) so that you can also download it to your local hard drive or a thumb stick or whatever. Basically a second copy of the file. :)