youtube-unofficial
Access parts of your account unavailable through normal YouTube API access.
Science Score: 54.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
1 of 4 committers (25.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (10.0%) to scientific vocabulary
Keywords
Keywords from Contributors
Repository
Access parts of your account unavailable through normal YouTube API access.
Basic Info
- Host: GitHub
- Owner: Tatsh
- License: mit
- Language: Python
- Default Branch: master
- Homepage: https://tatsh.github.io/youtube-unofficial/
- Size: 3.16 MB
Statistics
- Stars: 50
- Watchers: 5
- Forks: 9
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
youtube-unofficial
Access parts of your account unavailable through normal YouTube API access.
Installation
Poetry
shell
poetry add youtube-unofficial
Pip
shell
pip install youtube-unofficial
Usage
This uses a browser cookie storage to be able to access authorised endpoints. There is no feature to log in. You must be logged on in a supported browser. This supports any browser that yt-dlp supports.
Command line
```plain Usage: youtube [OPTIONS] COMMAND [ARGS]...
Unofficial YouTube CLI.
Options: -h, --help Show this message and exit.
Commands: clear-watch-history Clear watch history. clear-watch-later Clear watch later queue. print-history Print your watch history. print-playlist Print a playlist. print-watch-later Print your Watch Later playlist. remove-history-entries Remove videos from Watch History. remove-video-id Remove videos from a playlist. remove-watch-later-video-id Remove videos from your Watch Later queue. toggle-watch-history Disable or enable watch history ```
Every command takes a --debug or -d argument to show very verbose logs.
Some commands accept a -j/--json argument to print machine-readable output as JSON lines.
In Python
```python from youtube_unofficial import YouTubeClient
Arguments are the browser name and profile.
yt = YouTubeClient('chrome', 'Default')
Clear watch history
yt.clearwatchhistory()
Remove a single video ID from Watch Later queue
yt.removevideoidfromplaylist('WL', video_id)
Clear entire Watch Later queue
yt.clearwatchlater() ```
Contributing
For a new feature to be accepted, it must be something that cannot be achieved with Google's official API. It also has to be on the youtube.com/youtu.be website or app and not a place like My Activity.
Code must run through yarn qa and have zero issues.
Owner
- Login: Tatsh
- Kind: user
- Repositories: 87
- Profile: https://github.com/Tatsh
Citation (CITATION.cff)
authors:
- family-names: 'Udvare'
given-names: 'Andrew'
cff-version: '1.2.0'
date-released: '2025-08-27'
message: 'If you use this software, please cite it as below.'
title: 'youtube-unofficial'
version: '0.3.0'
GitHub Events
Total
- Issues event: 1
- Watch event: 7
- Delete event: 45
- Issue comment event: 49
- Push event: 108
- Pull request event: 88
- Fork event: 1
- Create event: 40
Last Year
- Issues event: 1
- Watch event: 7
- Delete event: 45
- Issue comment event: 49
- Push event: 108
- Pull request event: 88
- Fork event: 1
- Create event: 40
Committers
Last synced: 7 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Andrew Udvare | a****e@g****m | 215 |
| dependabot[bot] | 4****] | 28 |
| Dave Nicolson | d****n@g****m | 4 |
| Konrad Kollnig | k****g@r****e | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 4 months ago
All Time
- Total issues: 17
- Total pull requests: 98
- Average time to close issues: 7 months
- Average time to close pull requests: about 2 hours
- Total issue authors: 8
- Total pull request authors: 3
- Average comments per issue: 2.47
- Average comments per pull request: 0.91
- Merged pull requests: 85
- Bot issues: 0
- Bot pull requests: 93
Past Year
- Issues: 0
- Pull requests: 93
- Average time to close issues: N/A
- Average time to close pull requests: about 2 hours
- Issue authors: 0
- Pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 0.94
- Merged pull requests: 80
- Bot issues: 0
- Bot pull requests: 93
Top Authors
Issue Authors
- Tatsh (7)
- kasnder (2)
- tym-project (2)
- Aruelius (2)
- fhartavi (1)
- ax-sh (1)
- walking-octopus (1)
- dnicolson (1)
Pull Request Authors
- dependabot[bot] (93)
- dnicolson (4)
- kasnder (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 16 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 3
- Total maintainers: 1
pypi.org: youtube-unofficial
Access parts of your account unavailable through normal YouTube API access.
- Homepage: https://tatsh.github.io/youtube-unofficial/
- Documentation: https://youtube-unofficial.readthedocs.org
- License: MIT
-
Latest release: 0.3.0
published 8 months ago
Rankings
Maintainers (1)
Dependencies
- actions/stale v5 composite