Fansly Scraper

Note

This is currently under development, everything is still being planned out and tested. Feel free to create issues/pr's to assist in the creation of this project. Tracker will hold a list of things to do for the project, as well as act as a kind of roadmap. I also recommend reading Program Status for more info and currently known issues before running.

A simple all in one fansly interaction tool.

The program will automatically move/download an example config into the config path from either the current directory or the github repo respectively, you will need to edit the config to run the program.

Important

ffmpeg is not needed for content saving, but for livestream recording and potentially saving higher quality videos, it is required. mt is recommended for improved contact sheet generation, be sure to have it installed to your PATH.

Installing the program

Releases

Pre-compiled binaries can be downloaded from the releases section.

Manual Compile

git clone https://github.com/agnosto/fansly-scraper && cd fansly-scraper 

go build -v -ldflags "-w -s" -o fansly-scraper ./cmd/fansly-scraper

# run the binary
./fansly-scraper

Install Via Go

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

Config

To learn about the different config options you have available, refer to config.

Running the program

Interactive TUI

Simply run the program to launch the tui:

./fansly-scraper

Non-Interactive CLI Mode

# Defaults to selecting all
./fansly-scraper --username {creator name} 
# Or using short flag 
./fansly-scraper -u {creator name}

# With Download Option 
./fansly-scraper --username {creator name} --download [all|timeline|messages|stories]
# Or using short flags
./fansly-scraper -u {creator name} -d [all|timeline|messages|stories]

# Add Models to Live Monitoring 
./fansly-scraper --monitor {creator name}
#Or with short flags
./fansly-scraper -m {creator name}

# Live Monitoring Control
./fansly-scraper monitor [start|stop]

Note

Live monitoring requires an active running shell/terminal session, you can use something like zellij/tmux. I may go back to the idea of having it be a background service, but for the time being just implemented as a go version of my fansly-recorder script.

Updating

As this is a wip tool, new versions may be made available sporadically, There's a configuration option to "phone home" and check for updates automatically. However, the user will still need to use the built-in update command to update the binary, simply run:

./fansly-scraper update

Program Status

Maybe also a faq of sorts

For the time being:

• Currently the Live Status column in monitoring for the TUI only reflects the models you are monitoring. And currently doesn't update once the model goes live/offline. You can press r to reset/refresh the list to update it.
• It's recommended to leave m3u8_dl in the config set to false if you want things to download fast depending on your hardware. Do feel free to enable to give input/issues with it if you want.

"Duplicate Files"

The scraper does what it says, it scrapes. Fansly API response for post can sometimes have the main media item (the preview image you see in the post) and another preview item (one that could be shown depending on timeline permissions), sometimes they can be the same image if that's how the model setup the post I guess.

Disclaimer

"Fansly" is operated by Select Media LLC.

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