/fansly-downloader-ng

Easy-to-use fansly.com content downloading tool. Written in Python and available as a standalone Windows Executable. Enjoy your Fansly content offline anytime, anywhere in the highest possible content resolution! Fully customizable to download in bulk or single: photos, videos & audio from timeline, messages, collection & single posts.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Fansly Downloader NG: The Ultimate Content Downloading Tool

Downloads Latest Release Commits since latest release Active Bugs
Compatible with text Compatibility Compatible with Windows Compatible with Linux Compatible with macOS

Fansly Downloader NG Screenshot

This is a rewrite/refactoring of Avnsx's original Fansly Downloader. Fansly Downloader NG supports new features:

  • Full command-line support for all options
  • config.ini not required to start the program anymore - a config.ini with all program defaults will be generated automatically
  • Support for minimal config.ini files - missing options will be added from program defaults automatically
  • True multi-user support - put one or more creators as a list into config.ini (username = creator1, creator2, creator3) or supply via command-line
  • Run it in non-interactive mode (-ni) without any user intervention - eg. when downloading while being away from the computer
  • You may also run it in fully silent mode without the close prompt at the very end (-ni -npox) - eg. running Fansly Downloader NG from another script or from a scheduled task/cron job
  • Logs all relevant messages (Info, Warning, Error, ...) of the last few sessions to fansly_downloader_ng.log. A history of 5 log files with a maximum size of 1 MiB will be preserved and can be deleted at your own discretion.
  • Easier-to-extend, modern, modular and robust codebase
  • It doesn't care about starring the repository

There are still pieces missing like an appropriate wiki update.

Fansly Downloader NG is the go-to app for all your bulk media downloading needs. Download photos, videos, audio or any other media from Fansly. This powerful tool has got you covered! Say goodbye to the hassle of individually downloading each piece of media – now you can download them all or just some in one go.

✨ Features

📥 Download Modes
  • Bulk: Timeline, Messages, Collection
  • Single Posts by post ID
♻️ Updates
  • Easily update prior download folders
  • App keeps itself up-to-date with fansly
🖥️ Cross-Platform Compatibility
  • Compatible with Windows, Linux & MacOS
  • Executable app only ships for Windows
⚙️ Customizability
  • Separate media into sub-folders?
  • Want to download previews?
🔎 Deduplication
  • Downloads only unique content
  • resulting in less bandwidth usage
💸 Free of Charge
  • Open source, community driven project

Computer Mouse IconConfiguration Settings in detail

Detailed description on each of the components of this softwareComputer Mouse Icon

📰 What's New (Release Notes)

⚠️ Due to a hashing bug duplicate videos might be downloaded if a creator re-posts a lot. Downloaded videos will have to be renamed in a future version when video hashing is perfected.

v0.9.7 2024-03-22

Fix for update checks (hopefully) and disabled SSL verification for WebSockets due to a specific issue. Things are complicated for you now, check key must be deciphered by evaluating a JavaScript expression.

For more details and history see: Release Notes

🏗️ Setup

On Windows you can just download and run the executable version - skip the entire setup section and go directly to Quick Start.

Python Environment

If your operating system is not compatible with executable versions of Fansly Downloader NG (only Windows supported for .exe) or you want to use the Python sources directly please download and extract or clone the repository and ensure that Python 3.11+ is installed on your system.

Note: Using a Python virtual environment is recommended but out-of-scope of this guide.

Once Python is installed, you can then proceed by installing the required packages using Python's package manager ("pip3"/"pip") from your system's terminal:

pip3 install -r requirements.txt

On Windows pip3 is just called pip:

pip install -r requirements.txt

Developers should also install requirements-dev.txt:

pip3 install -r requirements-dev.txt

For Linux operating systems you may need to install the Python Tkinter module separately by using the command:

sudo apt-get install python3-tk

On Windows and macOS the Tkinter module is typically included in the Python installer itself.

After all requirements are met run fansly_downloader_ng.py.

Raw Python code versions of Fansly Downloader NG do not receive automatic updates. If an update is available you will be notified but need to manually download and set-up the current repository again.

🚀 Quick Start

Follow these steps to quickly get started with either the Python or the Executable:

  1. Download the latest version of Fansly Downloader NG by choosing one of the options below:

    and extract the files from the zip folder.

  2. Ensure that you have recently logged into your Fansly account and accessed the Fansly website using one of the following web browsers: Chrome, Firefox, Microsoft Edge, Brave, Opera, or Opera GX on the operating systems Windows 10/11, macOS or Linux.

  3. Open and run the Fansly Downloader NG.exe file by clicking on it or run fansly_downloader_ng.py from a terminal. This will initiate the interactive setup tutorial for the configuration file called config.ini.

  4. After values for the targeted creators Username, your Fansly account Authorization Token and your web browser's User-Agent are filled you're good to go 🎉! See the manual set-up tutorial if anything could not be configured automatically.

Once you have completed the initial configuration of Fansly Downloader NG, for every future use case, you will only need to adapt the creator(s) in Targeted Creator > Username section in the config.ini using a text editor of your choice. Additional settings can also be found in the config.ini file, which are documented in the Wiki page.

🤔 FAQ

Do you have any unanswered questions or want to know more about Fansly Downloader NG? Head over to the Wiki or check if your topic was mentioned in Discussions or Issues

  • Q: "Is Fansly Downloader NG exclusive to Windows?"

  • A: No, Fansly Downloader NG can be ran on Windows, MacOS or Linux. It's just that the executable version of the downloader, is currently only being distributed for the windows 10 & 11 operating systems. You can use Fansly Downloader NG from the raw Python sources on any other operating system and it'll behave the exact same as the Windows executable version.

  • Q: "Is it possible to download Fansly files on a mobile device?"

  • A: Unfortunately, downloading Fansly files on a mobile device is currently not supported by Fansly Downloader NG or any other available means.

  • Q: "Why do some executables show detections on them in VirusTotal?"

  • A: The Fansly Downloader NG executables are not digitally signed as software certificates are very expensive. Thus the executables tend to produce a lot of false positives (invalid detections). Antivirus providers can be mailed to update their detections but not all do care. If you're knowledgeable with the Python programming language you can decompile a PyInstaller executable such as Fansly Downloader NG using a tool like uncompyle6 - and assure yourself that no harmful code is included. Or you could just create your own PyInstaller executable.

  • Q: "Could you add X feature or do X change?"

  • A: I'm regrettably very limited on time and thus primarily do stuff I find useful myself. You can contribute code by opening a pull request

  • Q: "Will you add any payment bypassing features to Fansly Downloader NG?"

  • A: No, as the intention of this repository is not to harm Fansly or it's content creators.

  • Q: "Is there a possibility of being banned?" A: While there are no guarantees, it's worth noting that among the 24.000+ previous users, there have been no reported incidents.

Please note that "Issue" tickets are reserved for reporting genuine or suspected bugs in the codebase of the downloader which require attention from the developer. They are not for general computer user problems.

🤝 Contributing to Fansly Downloader NG

Any kind of positive contribution is welcome! Please help the project improve by opening a pull request with your suggested changes!

Special Thanks

A heartfelt thank you goes out to @liviaerxin for their invaluable contribution in providing the cross-platform package plyvel. Due to these builds Fansly downloader NG's initial interactive cross-platform setup has become a reality.

🛡️ License

This project (including executables) is licensed under the GPL-3.0 License - see the LICENSE file for details.

Disclaimer

"Fansly" or fansly.com is operated by Select Media LLC as stated on their "Contact" page. This repository and the provided content in it isn't in any way affiliated with, sponsored by, or endorsed by Select Media LLC or "Fansly". The developer(referred to: "prof79" in the following) of this code is not responsible for the end users actions, no unlawful activities of any kind are being encouraged. Statements and processes described in this repository only represent best practice guidance aimed at fostering an effective software usage. The repository was written purely for educational purposes, in an entirely theoretical environment. Thus, any information is presented on the condition that the developer of this code shall not be held liable in no event to you or anyone else for any direct, special, incidental, indirect or consequential damages of any kind, or any damages whatsoever, including without limitation, loss of profit, loss of use, savings or revenue, or the claims of third parties, whether the developer has advised of the possibility of such loss, however caused and on any theory of liability, arising out of or in connection with the possession, use or performance of this software. The material embodied in this repository is supplied to you "as-is" and without warranty of any kind, express, implied or otherwise, including without limitation, any warranty of fitness. This code does not bypass any paywalls & no end user information is collected during usage. Finally it is important to note that this GitHub repository is the sole branch maintained and owned by the developer and any third-party websites or entities, that might refer to or be referred from it are in no way affiliated with Fansly Downloader, either directly or indirectly. This disclaimer is preliminary and is subject to revision.