Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/avnsx/fansly-downloader
Easy to use fansly.com content downloading tool. Written in python, but ships as a standalone Executable App for Windows too. 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 & specific posts 👍
https://github.com/avnsx/fansly-downloader
cross-platform database datascraping downloader fansly fansly-download fansly-downloader fansly-scraper gui image-download linux macos open-source portable python reddit scraper video video-download windows
Last synced: 3 months ago
JSON representation
Easy to use fansly.com content downloading tool. Written in python, but ships as a standalone Executable App for Windows too. 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 & specific posts 👍
- Host: GitHub
- URL: https://github.com/avnsx/fansly-downloader
- Owner: Avnsx
- License: gpl-3.0
- Archived: true
- Created: 2021-10-08T19:39:10.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-01-22T09:55:43.000Z (11 months ago)
- Last Synced: 2024-09-25T22:43:37.478Z (3 months ago)
- Topics: cross-platform, database, datascraping, downloader, fansly, fansly-download, fansly-downloader, fansly-scraper, gui, image-download, linux, macos, open-source, portable, python, reddit, scraper, video, video-download, windows
- Language: Python
- Homepage: https://fansly.com/
- Size: 197 KB
- Stars: 1,270
- Watchers: 36
- Forks: 63
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
👋 Introducing Fansly Downloader: The Ultimate Content Downloading Tool
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
[Configuration Settings in detail](https://github.com/Avnsx/fansly-downloader/wiki/Explanation-of-provided-programs-&-their-functionality#explanation-of-configini)
[Detailed description on each of the components of this software](https://github.com/Avnsx/fansly-downloader/wiki/Explanation-of-provided-programs-&-their-functionality)
## Many Thanks to all the `Stargazers`, supporting this project with stars(⭐)
## 🏗️ Set up
On windows you can just install the [Executable version](https://github.com/Avnsx/fansly-downloader/releases/latest), skip the entire set up section & go to [Quick Start](https://github.com/Avnsx/fansly-downloader#-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](https://github.com/Avnsx/fansly-downloader/archive/refs/heads/master.zip), extract the files from the folder and ensure that [Python is installed](https://www.python.org/downloads/) on your system. Once Python is installed, you can proceed by installing the following requirements using [Python's package manager](https://realpython.com/what-is-pip/) (``"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``](https://github.com/Avnsx/fansly-downloader/blob/master/requirements.txt) through opening your system's terminal (e.g.: ``cmd.exe`` on windows), [navigating to the project's download folder](https://youtu.be/8-mYKkNzjU4?t=5) 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](https://youtu.be/O2PzLeiBEuE?t=38).
After all requirements are installed into your python environment; click on *fansly_downloader.py* and it'll open up & [behave similar](https://github.com/Avnsx/fansly-downloader#-quick-start) 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](https://github.com/Avnsx/fansly-downloader/archive/refs/heads/master.zip) 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](https://github.com/Avnsx/fansly-downloader#python-version-requirements) or the [executable](https://github.com/Avnsx/fansly-downloader/releases/latest) version of Fansly Downloader, follow these steps:
1. Download the latest version of Fansly Downloader by choosing one of the options below:
- [Windows exclusive executable version](https://github.com/Avnsx/fansly-downloader/releases/latest) - "*Fansly Downloader.exe*"
- [Python code version](https://github.com/Avnsx/fansly-downloader#python-version-requirements) - "*fansly_downloader.py*"
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``](https://github.com/Avnsx/fansly-downloader/wiki/Explanation-of-provided-programs-&-their-functionality#explanation-of-configini).
4. After values for the targeted creators [Username](https://github.com/Avnsx/fansly-downloader/blob/fc7c6734061f6b61ddf3ef3ae29618aedc21e052/config.ini#L2), your fansly accounts [Authorization Token](https://github.com/Avnsx/fansly-downloader/blob/fc7c6734061f6b61ddf3ef3ae29618aedc21e052/config.ini#L5) and your web browsers [User-Agent](https://github.com/Avnsx/fansly-downloader/blob/fc7c6734061f6b61ddf3ef3ae29618aedc21e052/config.ini#L6) 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](https://github.com/Avnsx/fansly-downloader/wiki/Get-Started), 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](https://github.com/Avnsx/fansly-downloader/wiki/Explanation-of-provided-programs-&-their-functionality#4-configini) page.
## 🤔 FAQ
Do you have any unanswered questions or want to know more about Fansly Downloader? Head over to the [Wiki](https://github.com/Avnsx/fansly-downloader/wiki) or check if your topic was mentioned in [Discussions](https://github.com/Avnsx/fansly-downloader/discussions) or [Issues](https://github.com/Avnsx/fansly-downloader/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](https://github.com/Avnsx/fansly-downloader#%EF%B8%8F-set-up) 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](https://www.digicert.com/signing/code-signing-certificates), 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](https://github.com/pyinstaller/pyinstaller) compiled python executable, such as Fansly Downloader, is de-compileable with e.g. [uncompyle6](https://github.com/rocky/python-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](https://github.com/Avnsx/fansly-downloader/pulls)
+ **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](https://github.com/Avnsx/fansly-downloader/discussions/new/choose), 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](https://github.com/Avnsx/fansly-downloader/pulls) with your suggested changes!
### Special Thanks
A heartfelt thank you goes out to [@liviaerxin](https://github.com/liviaerxin) for their invaluable contribution in providing cross-platform [plyvel](https://github.com/wbolster/plyvel) (python module) builds. It is due to [these builds](https://github.com/liviaerxin/plyvel/releases/latest) 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`](LICENSE) file for details.
## Disclaimer
"Fansly" or [fansly.com](https://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.