Fansly Scraper
[!IMPORTANT]
Project Status Update>
Due to a recent health scare, this project is taking a very far backseat priority in my life. Updates and support will be very minimal for the foreseeable future. Thank you for your understanding.>
If you're looking for a more actively maintained alternative with a full WebUI, live dashboard and VOD player, and automatic background monitoring and archiving, check out Accerso.
[!WARNING]
‼️ Windows Defender False Positive (literally no idea why or where this came from)>
The Windows executable of this program is frequently being flagged as Trojan:Script/Wacatac.B!ml by Windows Defender and other AV. This is a false positive.
>
Why is this happening?
The !ml in the detection name means it was flagged by a Machine Learning model, not a human. Because this is an unsigned, open-source scraper tool that makes many internet requests, the automated system incorrectly flags it as suspicious. This is a common issue for many Go and Rust-based command-line tools.
>
Recommended Solution - Install via Go (should hopefully bypass AV issues):
> go install github.com/agnosto/fansly-scraper/cmd/fansly-scraper@latest
``
>
What you can do:
1. Trust the program: You can temporarily disable Windows Defender to download and run the program, and then add it as an exception.
2. Build from source: If you have Go installed, you can build it yourself. The program is not flagged when you compile it locally or install via go.>
The code is fully open-source for you to inspect. It is safe to use. but I understand if the AV warnings are concerning.
A simple all in one tool to download and monitor content from Fansly creators.
⚠️ Currently in development - Some features may not work perfectly. See known issues below.
Requirements
- Optional but highly recommended: ffmpeg for livestream recording and saving higher quality videos. Follow this guide for installing to system path on windows.
- Optional: mt for better contact sheets
Quick Start
1. Download
- Easy way: Visit the download page (auto-detects your system)
- Manual way: Get from GitHub releases
- Install Via Go:bash
2. Run the Program
On first run, the setup wizard helps you configure everything. Press 'a' to use auto login: it opens Fansly and provides a one‑line snippet to paste in DevTools Console. Your token and user‑agent are captured automatically and saved to the config.Basic Usage
Interactive Mode (Recommended for beginners)
From the main menu you can:
- Run setup wizard (choose save location, auto login)
- Reset configuration (restore defaults, re-run wizard)
Command Line Mode
Download all content from a creator
./fansly-scraper -u {creator-name}Download specific content types
./fansly-scraper -u {creator-name} -d [all|timeline|messages|stories]Monitor for live streams
./fansly-scraper -m {creator-name}Start/stop monitoring
./fansly-scraper monitor [start|stop]bash ./fansly-scraper update `Note: Live monitoring requires keeping your terminal session active. To run monitoring in the background, consider using terminal multiplexers like tmux or zellij on Linux/WSL. Starting from v0.6.3, you can monitor additional creators by running-m creatorin separate terminal instances without restarting the existing monitor process.Update the Program
Project Roadmap & Advanced Setup
Our development is tracked publicly on our Project Roadmap. You can see what we're working on, what's planned for the future, and contribute to the discussion.
- Configuration Guide: See the Official Wiki
- Build from source:
bash
git clone https://github.com/agnosto/fansly-scraper && cd fansly-scraper
go build -v -ldflags "-w -s" -o fansly-scraper ./cmd/fansly-scraper
`
Contributing
Contributions are welcome and greatly appreciated! Whether it's reporting a bug, proposing a feature, or submitting a pull request, your help is valued.
Please read our Contributing Guidelines before you start.
Check the Issues tab to see if there's a task you'd like to take on.
Known Issues
- Redownloading: As of v0.8.3, file naming convention was changed causing redownloading of media.
- Chat recording: May occasionally miss messages during reconnections
- MacOS users: May need to allow notifications in system settings
- Live status: Press
r in TUI to refresh live status
Duplicate files: Sometimes the same image may appear twice due to Fansly's API structure
Date formats for livestream filename: In the event a stream gets interrupted and reattempts to record, if the date format isn't specific enough (ie, no timestamp), it may fail to save the stream after as both vods will be the same name, for now use one of these: 2006-01-02_15:04:05 or 20060102_150405`Support the Project
If this tool helps you, consider sponsoring on github:
Alternatively, you can make a one-time donation via cryptocurrency:
| Bitcoin (BTC) | Solana (SOL) |
|
|
[!CAUTION]
Disclaimer: This tool is not affiliated with Fansly or Select Media LLC. Use at your own risk. The developer of this script is not responsible for the end users' actions or any outcomes that may be taken upon the end users' account. Use at your own risk.
--- Tranlated By Open Ai Tx | Last indexed: 2026-06-22 ---