A downloader-focused tool for saving content from Fansly and OnlyFans. Built with both GUI and CLI interfaces for flexible interactive or automated use.
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.ininot required to start the program anymore - aconfig.iniwith all program defaults will be generated automatically- Support for minimal
config.inifiles - 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 tofansly_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.
- 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
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.
- Download the latest release from the releases page
- Extract and run
FanslyOFDownloaderNG.exe - Complete the setup wizard with your Fansly auth token
- Add creators and start downloading
Requirements: Python 3.11 or higher
-
Clone or download this repository
-
Install dependencies:
pip install -r requirements.txt
-
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-tkOnlyFans is supported through both GUI and CLI:
- Run
FanslyOFDownloaderNG.exe(Windows) orpython fansly_downloader_gui.py - Switch to the OnlyFans tab
- Enter your OnlyFans credentials (sess, auth_id, user_agent, x-bc)
- Add creators and configure settings
- Click "Start OF Download"
For help obtaining credentials, click the "How to get credentials" link in the OnlyFans tab.
# Run OnlyFans downloader
python onlyfans_downloader.py
# Non-interactive mode
python onlyfans_downloader.py -ni
# Incremental mode
python onlyfans_downloader.py -iNote: OnlyFans uses a separate configuration file (onlyfans_config.ini) completely independent from Fansly settings.
- 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
The command-line version supports all features with additional options for automation.
# 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 -npoxRun with --help to see all available options.
# 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 -npoxRun with --help to see all available options. OnlyFans uses onlyfans_config.ini for configuration.
The application uses separate configuration files for each platform:
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
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 mode downloads only new content since your last run:
- Enable in GUI Settings or use
-iflag in CLI - First run downloads everything and saves position
- Future runs download only new posts/messages
- State tracked per creator in
download_history.json
This saves bandwidth and time for regular downloads.
pip install pyinstaller
python build_exe.pyThe executable will be in dist/FanslyOFDownloaderNG/FanslyOFDownloaderNG.exe
The build script automatically includes all required assets, icons, and dependencies.
Install development dependencies:
pip install -r requirements-dev.txtEmpty 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.login app directory - Delete
config.iniandgui_state.jsonfor fresh setup - Ensure Python 3.11+ if running from source
Log file location:
- Same directory as executable/script
- Named
fansly_downloader.log(GUI) orfansly_downloader_ng.log(CLI)
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.
For the latest release notes and version history, see ReleaseNotes.md.
Contributions are welcome! Please open a pull request with your changes.
- @Avnsx - Original Fansly Downloader
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
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.

