Fansly Scraper

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
• Intall Via Go:

go install github.com/agnosto/fansly-scraper/cmd/fansly-scraper@latest

2. Run the Program

./fansly-scraper

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)

./fansly-scraper

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]

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 creator in separate terminal instances without restarting the existing monitor process.

Update the Program

./fansly-scraper update

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:

  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)
bc1q0e78wrtc9ezp6tqv000wfewgqf2ue4tpzdk7ee	Bv3kYZcwSTHXAQtnPddTF27D3F6Gc29v2MfFLqmGF6Gf

[!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.