Skip to main content

OnlyFans Content Distribution Tool

Project description

OnlySnarf

Shnarf

Please refer to the Menu for help with the available arguments and config settings.

Description

OnlySnarf is a python based automation tool to assist with uploading content to OnlyFans by interacting with the site purely via web scraping. OnlySnarf carries no weapons, but it has been known to use its tail, teeth and claws when improperly configured.

Here are some fuzzy debugging previews of how it looks when everything works:

Installation

There are two installation options:

  1. via pip for the latest official package: python3 -m pip install onlysnarf
  2. or clone the repo & setup a virtual environment to install locally like in the bash script at bin/virtualenv.sh

Once installed run the command: snarf config

  1. Select 'reset' to reset / copy the main configuration file to its default location
  2. Add an OnlyFans user profile to login with via 'Add'

Here is an output of the command: snarf -h

Command example: snarf --username $username -text "suck my giant balls" /path/to/imageOfBalls.jpeg
Version: snarf -version or snarf --version

Config

Example config files are provided. There are two main types of config files that should be provided to affect runtime behavior as well as one optional method to help distinguish between user logins for multiple accounts.

  1. the config for the general app's behavior: $HOME/.onlysnarf/config.conf
  2. one config for each user containing their credentials: $HOME/.onlysnarf/users/$username.conf
  3. (optional) one config containing the default user credentials to use: $HOME/.onlysnarf/users/default.conf

The user config to use at runtime can be specificed with the "--username" argument. User config example: "--username alexdicksdown" --> $HOME/.onlysnarf/users/alexdicksdown.conf When no "--username" argument is passed at runtime or in the config file then the default config file containing the default user credentials is used.

The command snarf config is available for help adding, listing, updating, and removing user config files.

Note for Windows: the user's $HOME path works out to C:\Users\YOUR_USERNAME so the base directory for config files and such can instead be found at C:\Users\YOUR_USERNAME\.onlysnarf

No, the user credentials are not handled in the safest manner because they are very clearly stored in plain text with no encryption. Yes, a better way can be figured out. Do I think a better way is necessary for this project? No. So please be careful with your own credentials.

API

The api server is super basic and as such runs with the Flask development server behind the standard port 5000. Be sure to remember to open this port when attempting to make requests and don't spam your own server. The api fulfills a niche role built by request and allows OnlySnarf to passively wait to receive requests from the internet with the necessary data to post or message appropriately.

Make POST requests with the same basic discount, message, or post data to: /discount or /message or /post

Menu

The snarf menu command has been semi-restored and still requires further updates to return to the same pointless iteration of glory.

Dependencies

Selenium's webdriver manager should install everything it needs automatically. If left unspecified the default browser argument is "auto" which will cylce throuch each web driver available and attempt to spawn a working browser. If you are using a Raspberry Pi 4, be sure to run sudo apt-get install chromium-chromedriver on your device to be able to launch chrome. Firefox should work via the firefox-snap. The only working browsers for me have been chrome and firefox and so the others are unlikely to work without extra tinkering by yourself.

Platforms

Code versions:

  • Python: 3.10.12
  • selenium: 4.8.3
  • webdriver_manager: 4.0.0

Runs successfully on:

  • Linux Ubuntu : 86_64
  • Windows 11

Runs sucessfully with browsers:

  • Chrome
  • Firefox

Runs successfully on devices:

  • Raspberry Pi 4 : aarch64

Dev

If you are doing your own development or webscraping all of the related files are available at: OnlySnarf/lib/webdriver
And the shortcut file for webdriver behaviors that I'm not quire sure if I want to be a class or not but is used to funnel proper interactions through.
More in code commenting / documentation will come later.

Tests

The test environment uses the config file found at: OnlySnarf/conf/test-config.conf

Basic unittesting behavior organized by classes:

  • python -m unittest tests/classes/test_discount.py
  • python -m unittest tests/classes/test_post.py
  • python -m unittest tests/classes/test_message.py
  • python -m unittest tests/classes/test_users.py and by webdriver interactions:
  • python -m unittest tests/webdriver/test_discount.py
  • python -m unittest tests/webdriver/test_post.py
  • python -m unittest tests/webdriver/test_message.py
  • python -m unittest tests/webdriver/test_users.py

Pytests available under /tests:

  • pytest tests
  • pytest tests/classes
  • pytest tests/selenium
  • pytest tests/webdriver

Updates

7/5/2023 : clarifications to readme and menu text...
4/18/2023 : to further reduce repo size, preview gifs have been relocated to IPFS.
9/20/2023 : major cleanup of webdriver structure & overlap with classes; test scripts overhaul to match


Feel free to make use of my referral code ;)

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

onlysnarf-4.7.2.tar.gz (91.6 kB view details)

Uploaded Source

Built Distribution

OnlySnarf-4.7.2-py3-none-any.whl (100.4 kB view details)

Uploaded Python 3

File details

Details for the file onlysnarf-4.7.2.tar.gz.

File metadata

  • Download URL: onlysnarf-4.7.2.tar.gz
  • Upload date:
  • Size: 91.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for onlysnarf-4.7.2.tar.gz
Algorithm Hash digest
SHA256 51bb27b6145e24f2743e8d285941b1c523c7dfd520d5ed79234b7e8b430c4520
MD5 5dc9e96cfdd2400e6e6b201cfdef50c0
BLAKE2b-256 7485138d466db91e8eea603d195c8401d3f2689f9520aeb4a161fa0fa83cd6ec

See more details on using hashes here.

Provenance

File details

Details for the file OnlySnarf-4.7.2-py3-none-any.whl.

File metadata

  • Download URL: OnlySnarf-4.7.2-py3-none-any.whl
  • Upload date:
  • Size: 100.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for OnlySnarf-4.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9f64b66810fb52b920be4f4ff3d13f27defff0e909c3e7a5a6ab3f90285ffb11
MD5 570015a8ad26a844bbd0e696a02f5f52
BLAKE2b-256 518b15834258853267924b749e4f604f7112747e3ee061b22fb396c1c1009b51

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page