Skip to content

About

Powerful downloader for Fansly & OnlyFans with modern dual-platform GUI, full CLI automation, incremental downloads, smart deduplication. Download all your content efficiently.

Resources

Stars

33 stars

Watchers

2 watching

Forks

 
 

Latest commit

 

History

463 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fansly & OnlyFans Downloader NG

A downloader-focused tool for saving content from Fansly and OnlyFans. Built with both GUI and CLI interfaces for flexible interactive or automated use.

Fansly Downloader NG Screenshot GUI OF Downloader NG Screenshot GUI

This is a rewrite/refactoring of Avnsx's original Fansly Downloader, expanded to support both Fansly and OnlyFans. Fansly & OnlyFans Downloader NG supports:

  • Full command-line support for all options
  • config.ini not required to start the program anymore - a config.ini with all program defaults will be generated automatically
  • Support for minimal config.ini files - missing options will be added from program defaults automatically
  • True multi-user support - put one or more creators as a list into config.ini (username = creator1, creator2, creator3) or supply via command-line
  • Run it in non-interactive mode (-ni) without any user intervention - eg. when downloading while being away from the computer
  • You may also run it in fully silent mode without the close prompt at the very end (-ni -npox) - eg. running Fansly Downloader NG from another script or from a scheduled task/cron job
  • Logs all relevant messages (Info, Warning, Error, ...) of the last few sessions to fansly_downloader_ng.log. A history of 5 log files with a maximum size of 1 MiB will be preserved and can be deleted at your own discretion.
  • Easier-to-maintain, modern, modular and robust codebase

Fansly & OnlyFans Downloader NG is focused on bulk media downloading. Download photos, videos, audio, or other supported media from Fansly and OnlyFans without individually saving each item by hand.

Features

  • Dual-Platform Support - Separate tabs for Fansly and OnlyFans with independent configurations
  • Multiple Download Modes - Timeline posts, messages, collections (Fansly), and single post downloads (both platforms)
  • Single Post Download - Download individual posts by URL or ID with automatic creator detection
  • Modern GUI - Dark theme interface with tabbed platform switching and real-time progress tracking
  • Command-Line Support - Full CLI for automation and advanced users (both platforms)
  • Incremental Downloads - Download only new content since last run
  • Smart Deduplication - Skip files you already have
  • Cross-Platform - Windows, Linux, and macOS support
  • Automatic Retry Logic - Handles rate limiting and connection issues
  • M3U8 Support - Download streaming videos automatically
  • Bulk Processing - Easily update prior download folders
  • Customizable - Separate media into sub-folders, download previews, and more

Removed Functionality

The built-in Image Crop Tool and Watermark Auto-Crop Tool are no longer included in the public downloader app. The downloader now focuses on download management, creator configuration, deduplication, progress tracking, and platform-specific GUI/CLI workflows.

For detailed configuration settings, see the Wiki.

Quick Start

Fansly

Windows (Executable)

  1. Download the latest release from the releases page
  2. Extract and run FanslyOFDownloaderNG.exe
  3. Complete the setup wizard with your Fansly auth token
  4. Add creators and start downloading

Python (All Platforms)

Requirements: Python 3.11 or higher

  1. Clone or download this repository

  2. Install dependencies:

    pip install -r requirements.txt
  3. Run the GUI:

    python fansly_downloader_gui.py

    Or use the CLI:

    python fansly_downloader_ng.py

Note: Using a Python virtual environment is recommended but out-of-scope of this guide.

On Linux, you may need to install Tkinter separately:

sudo apt-get install python3-tk

OnlyFans

OnlyFans is supported through both GUI and CLI:

GUI (Recommended)

  1. Run FanslyOFDownloaderNG.exe (Windows) or python fansly_downloader_gui.py
  2. Switch to the OnlyFans tab
  3. Enter your OnlyFans credentials (sess, auth_id, user_agent, x-bc)
  4. Add creators and configure settings
  5. Click "Start OF Download"

For help obtaining credentials, click the "How to get credentials" link in the OnlyFans tab.

CLI

# Run OnlyFans downloader
python onlyfans_downloader.py

# Non-interactive mode
python onlyfans_downloader.py -ni

# Incremental mode
python onlyfans_downloader.py -i

Note: OnlyFans uses a separate configuration file (onlyfans_config.ini) completely independent from Fansly settings.

GUI Features

  • Dual-Platform Tabs - Separate Fansly and OnlyFans tabs with independent configurations
  • Setup Wizard - Automatic configuration on first run (Fansly)
  • Creator Management - Visual list to add/remove creators (both platforms)
  • Subscription Import - Import all subscribed creators automatically (both platforms)
  • Download Mode Selection - Choose Timeline or Single Post mode (both platforms)
  • Single Post Download - Enter post URL or ID to download individual posts
  • Real-time Progress - See downloads in progress with file counts
  • Connection Testing - Verify credentials before downloading
  • Log Access - Press Ctrl+L to view diagnostic logs
  • Incremental Mode - Toggle to download only new content

CLI Usage

The command-line version supports all features with additional options for automation.

Fansly CLI

# Basic usage
python fansly_downloader_ng.py

# Non-interactive mode (no prompts)
python fansly_downloader_ng.py -ni

# Incremental mode (download only new content)
python fansly_downloader_ng.py -i

# Specify creators via command line
python fansly_downloader_ng.py -u creator1,creator2

# Single post download (interactive - prompts for post ID)
python fansly_downloader_ng.py -m single

# Silent mode for scripts/scheduled tasks
python fansly_downloader_ng.py -ni -npox

Run with --help to see all available options.

OnlyFans CLI

# Basic usage
python onlyfans_downloader.py

# Non-interactive mode (no prompts)
python onlyfans_downloader.py -ni

# Incremental mode (download only new content)
python onlyfans_downloader.py -i

# Specify creators via command line
python onlyfans_downloader.py -u creator1,creator2

# Single post download (interactive - prompts for post ID)
python onlyfans_downloader.py -m Single

# Silent mode for scripts/scheduled tasks
python onlyfans_downloader.py -ni -npox

Run with --help to see all available options. OnlyFans uses onlyfans_config.ini for configuration.

Configuration

The application uses separate configuration files for each platform:

Fansly Configuration (config.ini)

Created automatically on first run for Fansly. Customize:

  • Download directory
  • Download modes (timeline, messages, collections)
  • Rate limiting delays
  • Duplicate handling
  • Incremental mode settings
  • Debug logging

OnlyFans Configuration (onlyfans_config.ini)

Created automatically when using OnlyFans features. Completely independent from Fansly settings:

  • Download directory
  • OnlyFans credentials (sess, auth_id, user_agent, x-bc)
  • Creator list
  • Rate limiting and retry settings
  • Incremental mode settings
  • Post limit for new creators

Note: Both platforms maintain separate download histories and states, allowing you to use both simultaneously without conflicts.

See the Wiki for detailed configuration options.

Incremental Downloads

Incremental mode downloads only new content since your last run:

  1. Enable in GUI Settings or use -i flag in CLI
  2. First run downloads everything and saves position
  3. Future runs download only new posts/messages
  4. State tracked per creator in download_history.json

This saves bandwidth and time for regular downloads.

Building from Source

Create Windows Executable

pip install pyinstaller
python build_exe.py

The executable will be in dist/FanslyOFDownloaderNG/FanslyOFDownloaderNG.exe

The build script automatically includes all required assets, icons, and dependencies.

Development

Install development dependencies:

pip install -r requirements-dev.txt

Troubleshooting

Empty fields after setup wizard:

  • Check fansly_downloader.log (Ctrl+L in GUI)
  • Ensure complete token/user agent pasted
  • Re-run setup wizard

Downloads failing:

  • Test connection using "Test Connection" button
  • Verify download path exists and writable
  • Check log file for errors
  • Ensure active creator subscriptions

Application crashes:

  • Check fansly_downloader.log in app directory
  • Delete config.ini and gui_state.json for fresh setup
  • Ensure Python 3.11+ if running from source

Log file location:

  • Same directory as executable/script
  • Named fansly_downloader.log (GUI) or fansly_downloader_ng.log (CLI)

FAQ

Q: Does this support OnlyFans? A: Yes! Full OnlyFans support with both GUI (dedicated tab) and CLI (onlyfans_downloader.py). OnlyFans uses a completely separate configuration system from Fansly, so you can use both platforms simultaneously.

Q: Is this Windows-only? A: No. The executable is Windows-only, but the Python version works on Windows, macOS, and Linux.

Q: Will I get banned? A: There are no guarantees. The tool respects rate limits and mimics normal browser behavior for both platforms, but use at your own discretion.

Q: Does this bypass paywalls? A: No. You can only download content you have legitimate access to through your subscriptions. No paywall bypassing features will be added.

Q: Why do antivirus programs flag the executable? A: The executable is not digitally signed (certificates are expensive), causing false positives. Build your own from source or run the Python version directly.

Q: Can I use this on mobile? A: No, mobile devices are not currently supported.

Q: Could you add X feature or do X change? A: Feature requests are welcome — open an issue or submit a pull request. Issue tickets are for genuine bugs, not general support questions.

What's New

For the latest release notes and version history, see ReleaseNotes.md.

Contributing

Contributions are welcome! Please open a pull request with your changes.

Special Thanks

  • @Avnsx - Original Fansly Downloader

License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

Disclaimer

This project is not affiliated with, sponsored by, or endorsed by Fansly, OnlyFans, Select Media LLC, or Fenix International Limited. This tool is for educational purposes only and is designed for downloading content you have legitimate access to. The developer is not responsible for end-user actions. No paywall bypassing features will be added. No user data is collected during usage.

Fansly: "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".

OnlyFans: "OnlyFans" or onlyfans.com is operated by Fenix International Limited. This repository and the provided content in it isn't in any way affiliated with, sponsored by, or endorsed by Fenix International Limited or "OnlyFans".

The developer of this software is not responsible for end-user actions. This software is provided "as-is" without warranty of any kind. No unlawful activities are encouraged. This code does not bypass any paywalls and no user data is collected during usage.

About

Powerful downloader for Fansly & OnlyFans with modern dual-platform GUI, full CLI automation, incremental downloads, smart deduplication. Download all your content efficiently.

Resources

Stars

33 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages