Skip to content

Latest commit

 

History

History
192 lines (156 loc) · 15.7 KB

README.md

File metadata and controls

192 lines (156 loc) · 15.7 KB

👋 Introducing Fansly Downloader: The Ultimate Content Downloading Tool

Fansly Downloader UI Banner

Fansly Downloader 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, with just a few clicks.

✨ Features

Whether functionality you're looking for, Fansly Downloader has it all:
📥 Download Modes
  • Bulk: Timeline, Messages, Collection
  • or specific 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
  • Development based on popularity

Computer Mouse IconConfiguration Settings in detail

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

Many Thanks to all the Stargazers, supporting this project with stars(⭐)

🏗️ Set up

On windows you can just install the Executable version, skip the entire set up section & go to Quick Start

Python Version Requirements

If your operating system is not compatible with executable versions of Fansly Downloader (only Windows supported for .exe) or you just generally intend to use the Python source directly, please download the repository, extract the files from the folder and ensure that Python is installed on your system. Once Python is installed, you can proceed by installing the following requirements using Python's package manager ("pip"), within your systems terminal copy & paste:

pip3 install requests loguru python-dateutil plyvel-ci psutil imagehash m3u8 av pillow rich pyexiv2 mutagen

Alternatively you can use requirements.txt through opening your system's terminal (e.g.: cmd.exe on windows), navigating to the project's download folder and executing the following command: pip3 install --user -r requirements.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 installed into your python environment; click on fansly_downloader.py and it'll open up & behave similar to how the executable version would.

Raw python code versions of Fansly Downloader do not receive automatic updates. If an update is available, you will be notified, but will need to manually download the repository as zip again, extract files and set-up the latest version of fansly downloader yourself.

🚀 Quick Start

To quickly get started with either the python or the executable version of Fansly Downloader, follow these steps:

  1. Download the latest version of Fansly Downloader 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 file by clicking on it. This action will initiate the initial interactive setup tutorial for a configuration file called config.ini.

  4. After values for the targeted creators Username, your fansly accounts Authorization Token and your web browsers User-Agent within the configuration file are acquired & populated through; either in the previous step mentioned interactive set-up help provided after the first ever launch of the program Fansly_Downloader itself, or with the use of the manual set-up tutorial, you're good to go 🎉

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

🤔 FAQ

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

  • Q: "Is Fansly Downloader exclusive to Windows?" A: No, Fansly Downloader 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 through the raw python source 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, or any other available means.

  • Q: "Why do some executables show detections on them in VirusTotal?" A: The Fansly Downloader executables are not digitally signature signed, as it comes with continous prohibitively expensive costs. So the executables tend to produce alot of false positives (invalid detections). Instead each release of the scraper is e-mailed to antivirus providers for manual analysis, and the not 💩 providers actually analyse and unflag them, while others don't even bother reading their e-mails, but for some reason managed to get on VirusTotals file scanning system. If you're knowledgeable with the python programming language; any pyinstaller compiled python executable, such as Fansly Downloader, is de-compileable with e.g. uncompyle6, so you could additionally assure yourself that no harmful code is being distributed to your local machine.

  • Q: "Could you add X feature or do X change?" A: Star the project and I'll think about it. Otherwise you could always open a pull request

  • Q: "Will you add any payment bypassing features to Fansly Downloader?" A: No, as the intention of this repository is not to harm fansly or its 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.

If you still need help with something open up a New Discussion, instead of a issue ticket, as that is super annoying and it'll only get you banned from interacting entirely with the repository. Issue tickets are reserved for reporting genuine or suspected bugs in the codebase of the Downloader, which require immediate attention from the maintainers.

🤝 Contributing to Fansly Downloader

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 cross-platform plyvel (python module) builds. It is due to these builds that fansly downloaders initial interactive set-up configuration functionality, has become a cross-platform reality.

🙏 Support

  • Please give this project a star(⭐️) to encourage further development

  • Maximise your support for Fansly Downloader by recommending it to others online 🌍

🛡️ 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: "Avnsx" 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.