Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

yt-dlp: update page #12580

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

yt-dlp: update page #12580

wants to merge 6 commits into from

Conversation

thrila
Copy link

@thrila thrila commented Mar 30, 2024

  • The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
  • The page(s) have at most 8 examples.
  • The page description(s) have links to documentation or a homepage.
  • The page(s) follow the content guidelines.
  • The PR title conforms to the recommended templates.
  • Version of the command being documented (if known):

@github-actions github-actions bot added the page edit Changes to an existing page(s). label Mar 30, 2024
@thrila
Copy link
Author

thrila commented Mar 30, 2024

@kbdharun please confirm

@@ -8,11 +8,11 @@

`yt-dlp "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"`

- List the available downloadable formats for a video:
- List all formats that a video or playlist is available in:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

removes some clarity, unnecessary.


`yt-dlp --list-formats "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"`

- Download a video with a defined format, in this case the best mp4 video available (default is "bv\*+ba/b"):
- Download a video or playlist at a specific quality:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This has removed key information to the user, why?


- Download all playlists of YouTube channel/user keeping each playlist in separate directory:

`yt-dlp -o "{{%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s}}" "{{https://www.youtube.com/user/TheLinuxFoundation/playlists}}"`
`yt-dlp -o "{{%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s}}" "{{url}}"`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this isn't the best of changes, how is the user to know that a playlist is needed

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree.

@thrila we try to be as clear as possible, and we use descriptive placeholder. I don't see any benefits on removing the example from the placeholder.

What about reverting this change?


- Download Udemy course keeping each chapter in separate directory under MyVideos directory in your home:

`yt-dlp -u {{user}} -p {{password}} -P "{{~/MyVideos}}" -o "{{%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s}}" "{{https://www.udemy.com/java-tutorial}}"`
`yt-dlp -u {{user}} -p {{password}} -P "{{~/MyVideos}}" -o "{{%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s}}" "{{url}}"`

- Download entire series season keeping each series and each season in separate directory under C:/MyVideos:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually needs changing, its windows specific for a common page

@thrila
Copy link
Author

thrila commented Mar 30, 2024

Thanks for the correction


- Download entire series season keeping each series and each season in separate directory under C:/MyVideos:

`yt-dlp -P "{{C:/MyVideos}}" -o "{{%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s}}" "{{https://videomore.ru/kino_v_detalayah/5_sezon/367617}}"`
`yt-dlp -P "{{C:/MyVideos}}" -o "{{%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s}}" "{{url}}"`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`yt-dlp -P "{{C:/MyVideos}}" -o "{{%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s}}" "{{url}}"`
`yt-dlp -P "{{path/to/directory}}" -o "{{%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s}}" "{{url}}"`

Please see https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#paths

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FYI, this was marked as resolved without any commits being added.
Do not close comments from maintainers without discussing or doing the suggested change.

Copy link
Member

@Magrid0 Magrid0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me

@kbdharun kbdharun changed the title chore: add page for yt-dlp yt-dlp: update page Mar 30, 2024
@@ -22,16 +22,16 @@

- Specify audio format and audio quality of extracted audio (between 0 (best) and 10 (worst), default = 5):

`yt-dlp --extract-audio --audio-format {{mp3}} --audio-quality {{0}} "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"`
`yt-dlp --extract-audio --audio-format {{mp3}} --audio-quality {{0}} "{{url}}"`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your contribution. Can you update the same in other examples?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What other examples?

Copy link
Member

@kbdharun kbdharun Mar 31, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What other examples?

The placeholder examples for URL above.

@CleanMachine1
Copy link
Member

You did not make any changes following my comments, and then proceeded to close them, saying they have been resolved.

Please actually respond to them appropriately.

Copy link
Member

@CleanMachine1 CleanMachine1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please do not approve before actually reading and commenting on my original feedback.

@thrila
Copy link
Author

thrila commented Apr 2, 2024

my apologies started using github mobile seems im yet to fully understand it , still i thought the change you made was changing the placeholder url to the keyword url

@CleanMachine1
Copy link
Member

Do you plan on changing anything suggested, or should we close this PR?

@thrila
Copy link
Author

thrila commented Apr 13, 2024

Do you plan on changing anything suggested, or should we close this PR?

yeah lemme do it now kinda forgot

@thrila thrila closed this Apr 13, 2024
@thrila thrila reopened this Apr 13, 2024
@thrila
Copy link
Author

thrila commented Apr 13, 2024

Do you plan on changing anything suggested, or should we close this PR?

Hi finished do you mind checking?

@CleanMachine1
Copy link
Member

That commit has nothing in it, did you not push your changes?

@thrila
Copy link
Author

thrila commented Apr 17, 2024

That commit has nothing in it, did you not push your changes?

Seems i didnt my bad haven't really contributed to a project before Thanks for the patience


`yt-dlp --list-formats "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"`

- Download a video with a defined format, in this case the best mp4 video available (default is "bv\*+ba/b"):
- Download a video or playlist at a specific quality:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Download a video or playlist at a specific quality:
- Download a video or playlist using best MP4 video available (default is "bv\*+ba/b"):

What about this? I agree with @CleanMachine1, your change removes key information for the user.

@thrila
Copy link
Author

thrila commented May 5, 2024

Any more corrections?

@CleanMachine1
Copy link
Member

I think you are making a mistake with adding the changes, could you share what commands you are running/what you are doing to make the suggested changes.

@vitorhcl
Copy link
Member

vitorhcl commented May 6, 2024

I think he is just merging the branch instead of commit the changes.

@thrila if you are on GitHub Mobile, you meed to click on the comments and then click om the "Commit" button.

@thrila
Copy link
Author

thrila commented May 6, 2024

I am on mobile thanks for the tip
Still there's one thing that confuses me
As you can see from the last stream of commits the placeholder was removed and a example URL was placed I don't know if this is something he did for all of them how do I check? Other than that I actually started with an example URL and some dudes said a place holder was better when I made a PR

@vitorhcl
Copy link
Member

vitorhcl commented May 7, 2024

Still there's one thing that confuses me
As you can see from the last stream of commits the placeholder was removed and a example URL was placed

I saw the last commits and it looks like it's the opposite, you replaced the example URLs with the generic placeholder text "url".

I don't know if this is something he did for all of them how do I check?

Well, the current state is replacing some examples URLs with the "url" placeholder.

Anyways, you can see the changes that would be applied if thisnPR was merged clicking on the first bar below the PR description that has green and red numbers (the quantity of modified lines).

Green = addition, red = removal.

Other than that I actually started with an example URL and some dudes said a place holder was better when I made a PR

Are you talking about #12580 (comment)? I don't know if @kbdharun thinks it is a good idea or if that was just a suggestion for improving the page consistency.

In my opinion, in this case, example URLs are more user-friendly.

@kbdharun
Copy link
Member

kbdharun commented May 9, 2024

Are you talking about #12580 (comment)? I don't know if @kbdharun thinks it is a good idea or if that was just a suggestion for improving the page consistency.

Agreed, having example URLs seems much better. I wasn't clear in my previous review comment, what I meant is since one example was updated to the URL I suggested updating it throughout the page or reverting the link in the specific line (in this case, reverting seems like the best course of action).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
page edit Changes to an existing page(s).
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

6 participants