Skip to content
This repository has been archived by the owner on Jan 31, 2024. It is now read-only.

Explanation of provided programs & their functionality

Jump to bottom
Mika C edited this page Jun 9, 2023 · 39 revisions

Fansly Downloader

Raw code is compatible with python 3.7+ on Windows, Linux & macOS

Executable is compatible with Windows only

When the program is booted up, it will try to read a configuration file called config.ini, which needs to have specific information that allows the downloader to run directly through your fansly account and have access to the content that your account has access to (stuff that you bought / that is only available to your account for whatever reason). This is why it is important for you to make sure your configuration file is properly set up. You can read more about it on Get Started. Essentially it logs into your account, pretending you are browsing fansly, but actually it's downloading each media content one after another, while on Fanslys network traffic it looks like you are basically opening different sections of the website and are scrolling down forever, which would result in loading every image / video available.

Fansly Downloader needs an authentication token and a user-agent to be able to utilise the fansly API. They can be interactively set up by the program, when it is launched for the first time.

Finally please make sure not to remove the id and hash out of downloaded filenames, as it will break the content de-duplication algorithms.

Explanation of config.ini

The config.ini file is a configuration file that allows you to directly influence the behavior of Fansly Downloader. It contains various settings that you can change to suit your needs.

To be able to use fansly-downloader at all, you are forcefully required to replace the ReplaceMe placeholders with the appropriate values for each setting. Specifically these settings can be set semi-automatically (interactively by your written input - simple yes or no questions), by first launching fansly downloader which will basically start it in a "Tutorial" kind of mode.

Here's a breakdown of the different settings:

  1. TargetedCreator > username: This setting determines the name of the creator you want to scrape. You should replace ReplaceMe with the desired creator's name.

  2. MyAccount > authorization_token: This setting requires your fansly authentication token. You should replace ReplaceMe with your own token.

  3. MyAccount > user_agent: This setting requires your browser's user agent. You can also find your user agent by visiting this website. Replace ReplaceMe with your user agent.

The following settings are under the Options category:

Settings within this category are not mandatory to modify and can be left on default values.

  1. download_mode: Determines what parts of a fansly creator's content should be scraped. You can choose from the following values: Normal, Timeline, Messages, Single or Collection. Only one value can be set at a time!

  2. show_downloads: Decides whether the downloaded file names are visible during the scraping process. Set it to either True or False.

  3. download_media_previews: Determines whether media previews will be downloaded. Set it to either True or False.

  4. open_folder_when_finished: Decides whether the download folder will be opened once the download is finished. Set it to either True or False.

  5. download_directory: Determines where the downloaded files will be saved. Choose between saving them in the local folder (Local_directory) or specifying a custom directory file path (e.g., C:\MyCustomFolderFilePath).

  6. separate_messages: Determines whether the downloads from messages should be categorized into subfolders. Set it to either True or False.

  7. separate_previews: Determines whether the downloads from previews should be categorized into subfolders. Set it to either True or False.

  8. separate_timeline: Determines whether the downloads from timeline should be categorized into subfolders. Set it to either True or False.

  9. utilize_duplicate_threshold: Prevents unnecessary computation or requests to fansly. Set it to either True or False. The only time you would ever want to disable this, is when you were recently downloading something and in the middle of the download fansly-downloader crashed and now you want to complete downloading to the end of the content (e.g. last 50% of content).

The following setting is under the Other category:

  1. version: Indicates the version of the program. It is automatically changed by the system, so you should not edit it manually.
Clone this wiki locally