[!WARNING] This project is probably against Pornhub TOS. Use at your own risks.

Installation

• Install using pip (python 3.11 or higher required, recommended version):

pip install --upgrade phub

• Or from this repo to get the latest fixes/features:

pip install --upgrade git+https://github.com/EchterAlsFake/PHUB.git

• Or, for python 3.10 and higher.

pip install --upgrade git+https://github.com/EchterAlsFake/[email protected]

• Or, for even lower python versions, there is automatic branch with several features removed (might be unstable).

pip install --upgrade git+https://github.com/EchterAlsFake/PHUB.git@compat

Usage from command line

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

Note: It does not matter how the URLs in the files are aranged, preferably one per line.

Quickstart

[!NOTE] You can find the docs on this project here.

import phub
from phub.locals import *

# Initialise a client
client = phub.Client()

# Fetch and download a video
video = client.get('https://...')
video.download('my-video.mp4', Quality.BEST)

# 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-username', 'my-password')

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

Note

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.

License

PHUB uses GPLv3. See the LICENSE file.

Contributing

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