tatsh / youtube-unofficial Goto Github PK

View Code? Open in Web Editor NEW

40.0 7.0 8.0 259 KB

Access parts of your account unavailable through normal YouTube API access.

Home Page: https://tatsh.github.io/youtube-unofficial/

License: MIT License

Python 100.00%

youtube python scraper utilities utility command-line

youtube-unofficial's Introduction

Unofficial YouTube API client

Use this library to do things the real YouTube API does not let you do. DO NOT USE THIS FOR ANY ACCOUNT OTHER THAN YOUR OWN!

This library supports Python 3.6+.

Use a netrc file

Please note for the time being, logging in is not working. For more details, see this youtube-dl issue.

Every command can take a --username and --password argument.

You should consider using a netrc file for your login. Example at ~/.netrc:

machine youtube login LOGIN password YOUR_PASSWORD

You can specify a custom netrc file with the --netrc argument.

Usage

Command line

youtube-clear-history - Clear your Watch History
youtube-clear-search-history - Clear your Search History
youtube-clear-watch-later - Clear your Watch Later queue
youtube-print-history-ids - Print Watch History video IDs
youtube-print-playlist-ids - Print video IDs from a specific playlist
youtube-print-watch-later-ids - Print Watch Later video IDs
youtube-remove-history-entries - Remove videos from your Watch History
youtube-remove-videoid - Remove a video from a playlist
youtube-remove-watch-later-videoid - Remove a video from your Watch Later queue
youtube-toggle-search-history - Turn on/off Search History
youtube-toggle-watch-history - Turn on/off Watch History

Every command takes a --debug argument.

You can use exported cookies in Netscape format with the --cookies COOKIES_FILE argument. By default, cookies are read from ~/.local/share/cookies/youtube.txt.

Some commands accept a -j/--json argument to print machine-readable output.

Download commands

ytdl-history - Use youtube-dl to download your history
ytdl-liked - Use youtube-dl to download your liked videos
ytdl-playlist - Use youtube-dl to download a playlist
ytdl-watch-later - Use youtube-dl to download your Watch Later playlist

For downloads to work, youtube-dl must be in PATH. To pass arguments to youtube-dl, specify -- before those arguments. Example with arguments to youtube-dl:

ytdl-history --output-dir ~/Downloads --delete-after -- --extract-audio --audio-format m4a --audio-quality 0

Each download command has a -D/--delete-after option, which makes the script delete the entry from the set of videos after a successful download.

In Python

from os.path import expanduser
from youtube_unofficial import YouTube

yt = YouTube(cookies_path=expanduser('~/my-cookies-file.txt'), logged_in=True)

# Clear watch history
yt.clear_watch_history()

# Remove a single video ID from Watch Later queue
yt.remove_video_id_from_playlist('WL', video_id)

# Clear entire Watch Later queue
yt.clear_watch_later()

Contributing

For a new feature to be accepted, it must be something that cannot be achieved with Google's official API.

Code must run through mypy and pylint based on the project settings.

youtube-unofficial's People

Contributors

Stargazers

Watchers

Forkers

aruelius scamcast ameyjir sdl79 kasnder moulali374 rawal8437

youtube-unofficial's Issues

Fix getting history entries

Currently the history code only grabs the first page.

New feature: community activity management

Get all entries, paginated
Delete entry

New feature: clear search history

The 'Clear All Search History' button.

Hello, after I read the document, I still don't know how to run the command to get the cookies file.

I wrote the account password to the netrc file. This configuration is correct, but after I run this command, 1.txt is empty.

Login broken by Google ?

the login function fails on "galx = re.search(r'(?s)<input.+?name="GALX".+?value="(.+?)"', login_page).group(1)" :

Traceback (most recent call last):
  File "./<edited path>.py", line 210, in <module>
    yt.login()
  File "/<edited path>/youtube_unofficial/__init__.py", line 160, in login
    login_page).group(1)
AttributeError: 'NoneType' object has no attribute 'group'

If I manually look at the source code for the login page, I can't find any "GALX" attribute anywhere.

Not Found for url: https://www.youtube.com/service_ajax?name=feedbackEndpoint

When trying to delete videos from the watch history (remove_video_ids_from_history), I get the following the following error:

Traceback (most recent call last):
  File "test.py", line 13, in <module>
    print(yt.remove_video_ids_from_history([entries[0]['videoRenderer']['videoId']]))
  File "/home/konrad/.local/lib/python3.8/site-packages/youtube_unofficial/__init__.py", line 409, in remove_video_ids_from_history
    self._download_page(
  File "/home/konrad/.local/lib/python3.8/site-packages/youtube_unofficial/download.py", line 43, in _download_page
    return download_page(self._sess, url, data, method, headers, params,
  File "/home/konrad/.local/lib/python3.8/site-packages/youtube_unofficial/download.py", line 25, in download_page
    r.raise_for_status()
  File "/usr/lib/python3/dist-packages/requests/models.py", line 940, in raise_for_status
    raise HTTPError(http_error_msg, response=self)
requests.exceptions.HTTPError: 404 Client Error: Not Found for url: https://www.youtube.com/service_ajax?name=feedbackEndpoint

New feature: pause search history

New feature: comment management

Get comments with pagination
Delete specific comment
Edit comment

login issuee

hi sir

when i try login everytime telling incorrect password

`ytdl-watch-later` and `ytdl-liked` raise `ValueError: '--' is not in list`

Reverting 3ea9d0f appears to resolve the issue.

Login state is no longer checked properly

It seems that Youtube has changed the default home page, following condition is always true (line ~146 in init.py :
if 'signin-container' not in content:
I fixed it by replacing it with :
if '<yt-formatted-string id="text" class="style-scope ytd-button-renderer style-brand">Sign in</yt-formatted-string>' not in content:, this might not be the best string to test, but I needed a quickfix.

Feature request: Get subscriptions or recommendation feed

New feature: live chat history management

List all entries paginated
Delete specific comment

KeyError: 'DELEGATED_SESSION_ID'

Hello,

I'm trying to use your wonderful API, using an extracted cookies file from my Mozilla Firefox.

Unfortunately, I get the following error, when calling toggle_watch_history:

Traceback (most recent call last):
  File "test.py", line 4, in <module>
    yt.toggle_watch_history()
  File "/home/konrad/.local/lib/python3.8/site-packages/youtube_unofficial/__init__.py", line 487, in toggle_watch_history
    return self._toggle_history(WATCH_HISTORY_URL, 3)
  File "/home/konrad/.local/lib/python3.8/site-packages/youtube_unofficial/__init__.py", line 476, in _toggle_history
    return self._single_feedback_api_call(
  File "/home/konrad/.local/lib/python3.8/site-packages/youtube_unofficial/__init__.py", line 459, in _single_feedback_api_call
    user=dict(onBehalfOfUser=ytcfg['DELEGATED_SESSION_ID'])),
KeyError: 'DELEGATED_SESSION_ID'

Hello, the new version seems to have a problem.

Looking at the error message seems to be a problem when the prepped is passed to the session.