Skip to content

Fix: update README.md to align with default config.yaml for oauth#7

Merged
mgoltzsche merged 8 commits into
mgoltzsche:mainfrom
varia-fur:patch-1
Jul 15, 2025
Merged

Fix: update README.md to align with default config.yaml for oauth#7
mgoltzsche merged 8 commits into
mgoltzsche:mainfrom
varia-fur:patch-1

Conversation

@varia-fur

@varia-fur varia-fur commented Jul 11, 2025

Copy link
Copy Markdown
Contributor
  • mention oauth_client_id and oauth_client_secret within the readme.
  • add new --cookiefile option.

@mgoltzsche mgoltzsche left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

@varia-fur thanks for creating the PR!
Looks good but the documentation still needs another update.

Comment thread beetsplug/ytimport/__init__.py Outdated
Comment on lines +187 to +189
p.add_option('--cookiefile', type='string', metavar='FILE',
default=self.config['cookiefile'].get(),
dest='cookiefile', help='cookiefile to use')

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

The CLI documentation within the readme should be updated (dumping the help output of the CLI into the corresponding section within the README).

Did you test the new cookiefile option manually and verified that it makes the plugin really download the high quality audio?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

it did download a format that requires premium, yes

Comment thread README.md
Comment on lines +49 to +50
oauth_client_id: ''
oauth_client_secret: ''

@mgoltzsche mgoltzsche Jul 11, 2025

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Please also add/document the cookiefile config option here.

Also, I think it would be good to keep all the authentication options listed together (next to auth_headers).

Also, would you mind briefly explaining in the README how to obtain the cookies file or link to another page that's explaining that?

(Similarly, we/I should document how to obtain the oauth client credentials but that's not blocking your PR.)

@mgoltzsche

Copy link
Copy Markdown
Owner

Also, the CI build failed due to the convention commits format not being followed. Ideally, you should fix that by rewriting/squashing your commits but in doubt alternatively I can do that when merging the PR.

@varia-fur varia-fur changed the title Update README.md to align with default config.yaml Fix: update README.md to align with default config.yaml for oauth Jul 11, 2025
@varia-fur

Copy link
Copy Markdown
Contributor Author

have tried to squash the commits, tho don't know if i did so correctly
also I have added an explanation on how to get the cookies and oauth

@mgoltzsche mgoltzsche left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

@varia-fur thanks again!

@mgoltzsche mgoltzsche merged commit ea667b1 into mgoltzsche:main Jul 15, 2025
github-actions Bot pushed a commit that referenced this pull request Jul 15, 2025
## v1.12.0 (2025-07-15)

### Features

- add --cookiefile option, document auth options (#7) (ea667b1)
mgoltzsche added a commit that referenced this pull request Jul 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants