Skip to content

EchterAlsFake/PHUB

Repository files navigation

Downloads PyPI version API Tests

PHUB is an easy-to-use API wrapper for Pornhub. It can access most used or useful PH features, such as video searching, account features, video downloading, and more.

Warning

This project is against PornHub's Terms of Services. Redistributing copyright protected content is a crime under DMCA. Usage of this API is intended for PRIVATE non-commercial purposes only. We are not responsible for damages caused by this project. Please use it responsibly to ensure the continued development for everyone!

Installation

  • Install using pip (python 3.9 or higher required):
pip install --upgrade phub
  • Or from this repo to get the latest fixes/features:
pip install --upgrade git+https://github.com/EchterAlsFake/PHUB.git

Usage from command line

# Download a single video
phub -url https://www.pornhub.com/view_video.php?viewkey=abcdef
# Download multiple videos from a text file
phub -file path/to/file.txt --quality best --downloader threaded --output video.mp4

Quickstart

Note

You can find the beautiful outdated docs on this project here.
Or use the ugly but UPDATED docs (xD) here

import phub

# Initialise a client
client = phub.Client()

# Fetch and download a video
video = client.get('https://...')
video.download('my-video.mp4', quality="best") # See docs for more options

# Fetch user videos
user = client.get_user('this-user')
for video in user.videos:
    print(video.title)

# Perform a research
for video in client.search('my-query'):
    print(video.title)

# Connect to an account
client = phub.Client('my-email', 'my-password')

# Access account history, liked and recommended stuff
client.account.watched
client.account.liked
client.account.recommended

License

PHUB uses GPLv3. See the LICENSE file.

This repository was initiated and maintained by Egsagon He doesn't have any time to maintain this and transferred me the ownership. I'll do my best to maintain this repository functional.

Donations

If you want to donate, I and Egsagon will gladly appreciate it. Donations will be split 50/50 between us. Please use PayPal for donating, as it makes it easier. Thanks a lot!

Contributing

Feel free to contribute to this project by submitting feature requests, issues, bugs, or whatever.