Skip to main content

OnlyFans Content Distribution Tool

Project description


pip3 install OnlySnarf
git clone && sudo python3 install


OnlySnarf is a python based automation tool to assist with uploading content to OnlyFans. OnlySnarf is capable of downloading and uploading a file (image or video) or gallery of files (images) from a Google Drive folder as specified by run time arguments to an OnlyFans account.




preview Gallery Video Discount Message


First run:

  • (sudo) onlysnarf-config Then from within project's OnlySnarf directory either:
  • (sudo) onlysnarf [args]
  • (sudo) onlysnarfpy (-debug) -type image|gallery|video
  • or directly via python3 (-debug) -type image|gallery|video


python3 -debug
Tests configuration. Does not upload or remove from Google Drive.

-type image
python3 -type image
Uploads an image labeled: 'imageName - %d%m%y'

-type gallery
python3 -type gallery
Uploads a gallery labeled: 'folderName - %d%m%y'

-type video
python3 -type video
Uploads a video labeled: 'folderName - %d%m%y'

python3 -type video -text "your mom"
Uploads a video labeled: 'your mom - %d%m%y'

-show-window python3 -show-window Shows the Chromium browser

more available in menu

Or include a 'config.conf' file located at '/etc/onlysnarf/config.conf' to set variables at runtime without using arguments. An example file has been provided. Please be sure to follow the key:value pattern. A starting # denotes a comment.


The use of this package requires configuring a Google App with PyDrive for access to your Google Drive. The Drive API requires OAuth2.0 for authentication.

from Auth Quickstart
  1. Go to APIs Console_ and make your own project.
  2. Search for 'Google Drive API', select the entry, and click 'Enable'.
  3. Select 'Credentials' from the left menu, click 'Create Credentials', select 'OAuth client ID'.
  4. Now, the product name and consent screen need to be set -> click 'Configure consent screen' and follow the instructions. Once finished:

a. Select 'Application type' to be Web application. b. Enter an appropriate name. c. Input http://localhost:8080 for 'Authorized JavaScript origins'. d. Input http://localhost:8080/ for 'Authorized redirect URIs'. e. Click 'Create'.

  1. Click 'Download JSON' on the right side of Client ID to download client_secret_<really long ID>.json.

Rename the file to "client_secrets.json" and place it into your installed OnlySnarf directory. To update your installation with the new file, run onlysnarf-config, select 'Update Google Creds', and enter the location of your "client_secret.json" file.



Path: /etc/onlysnarf/config.conf Create or update the "config.conf" file with the following values:

  • username -> the Twitter connected to your OnlyFans's username
  • password -> the Twitter conencted to your OnlyFans's password
Why Twitter credentials?

OnlyFans uses a captcha to prevent malicious bots from accessing user accounts. However, this captcha is only necessary when logging in with your OnlyFans username and password. Logging in with the provided Twitter authentication does not provide a captcha and thus allows a more accessible automated entrance.


Generated by Google Drive's authentication process. Saves Google authentication for repeat access.


Used to facilitate Google Drive's python authentication. Requires generating an app w/ credentials via Google Console. Credentials are authenticated once and then saved to "google_creds.txt".

Example Crons

Upload a random image once a day at noon:
* 12 * * * onlysnarfpy -type image

Upload a random gallery of images every Wednesday at 2:30pm:
30 14 * * 3 onlysnarfpy -type gallery

Upload a random video every Friday in the month of June at 6:00pm:
00 18 * 6 5 onlysnarfpy -type video

Text will be generated if not provided with -text * 12 * * * onlysnarfpy -type image -text "Your mother is a dirty whore"


Google Chrome -> sudo apt install -y google-chrome-beta


Feel free to make use of my referral code ;)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for OnlySnarf, version 2.16.0
Filename, size File type Python version Upload date Hashes
Filename, size OnlySnarf-2.16.0-py3-none-any.whl (54.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size OnlySnarf-2.16.0.tar.gz (56.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page