Explanation of provided programs & their functionality

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 within the program itself, 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: Determines the name of the creator you want to scrape. Replace ReplaceMe with the desired creator's name, only one username at a time!

2. MyAccount > authorization_token: Requires your fansly authentication token. Replace ReplaceMe with your own authorization token.

3. MyAccount > user_agent: Requires your browser's user agent. 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.

4. download_mode: Determines what parts of a fansly creator's content should be scraped. You can choose from the following values:

   • Normal: Downloads Timeline + Messages one after another.
   • Timeline: Scrapes only the creator's timeline content.
   • Messages: Scrapes only the creator's messages content.
   • Single: Fetch a single post by the post's ID. Click on a post to see its ID in the url bar e.g. ../post/1283493240234
   • Collection: Download all content listed within the "Purchased Media Collection"

   Note: Only one value can be set at a time!

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

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

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

8. 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).

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

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

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

12. utilize_duplicate_threshold: Prevents unnecessary computation or requests to fansly. Set it to either True (Recommended) or False. Enabling this feature reduces the workload for fansly downloader when updating previous download folders, leading to faster completion times. However, it does come with the trade-off of not attempting to search for the last 50% of remaining content if a significant amount of duplicate media has already been identified during the first half of the scraping process.

13. metadata_handling: Setting this to Advanced, will embed the media ID and filehash as Exif metadata within supported fileformats. Simple will incorporate them into the file's name.

The following setting is under the Other category:

14. version: Indicates the version of the program. It is automatically changed by the system, so you should not edit it manually.