• This repository has been archived on 06/Jan/2024
  • Stars
    star
    766
  • Rank 58,903 (Top 2 %)
  • Language
    Python
  • License
    GNU General Publi...
  • Created almost 4 years ago
  • Updated 9 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

OnlyFans content downloader

THE GREAT KORNHOLIO PRESENTS

OnlyFans Profile Downloader/Archiver

This tool downloads all photos/videos from an OnlyFans profile, creating a local archive. You must be subscribed to the profile to download their content.

onlyfans-dl will create a directory called profiles in the repo directory. Each profile you download will be stored as a subdirectory of profiles. Inside each profile directory, some information will be saved in info.json, and all media will be downloaded to photos/ and videos/.

DON'T OPEN AN ISSUE ABOUT THE REQUESTS LIBRARY. ( #8 #25 #28 #29 #33 #44 #45 #104 #125 )

LOOK: python -m pip install requests

If you have installed requests and it still doesn't work, then this is an issue with your local environment, not onlyfans-dl.

Usage

First, make sure to set your session variables in auth.json.

./onlyfans-dl.py

Session Variables

Requests to the API now need to be signed. This is an obfuscation technique from the developers to discourage scraping. Thanks for the most recent patch goes to DIGITALCRIMINAL.

You need your browser's user-agent, onlyfans session cookie, x-bc HTTP header, and user-id HTTP header. Here's how to get them:

  • Get your user-agent here: ipchicken
  • Session Cookie
    1. Login to OnlyFans as normal
    2. Open the dev console Storage Inspector (SHIFT+F9 on FireFox). or the Application tab of Chrome DevTools
    3. Click Cookies -> https://onlyfans.com
    4. Copy the value of the sess cookie
  • x-bc and user-id
    1. Login to OnlyFans
    2. Open dev console F12 -> Network tab (Ctrl+Shift+E in FireFox)
    3. Go to the home page
    4. In dev tools, click Headers sub-tab (default)
    5. Click on one of the JSON elements (may need to refresh page) and look under request headers on the right. The hints request is a good request to look at, as not all requests have both headers.

There are variables for each of these values at the top of the script. Make sure to update them every time you login or your browser updates.

Contributing

PRs are welcome; be sure to take some time to familiarize yourself with OnlyFans' API if you would like to extend/modify the functionality of this script.