[!WARNING] This project may violate Fansly's Terms of Service. Use it at your own risk and ensure you comply with any applicable terms and laws.

---

📖 About

I originally wrote this project because the downloaders I tried weren't consistently downloading the highest-quality media available.

Fansly-DL retrieves a creator's timeline and downloads the highest quality media your account is authorized to access.

It does not bypass subscriptions or paid content—your account must already have permission to view the media.

---

✨ Features

• 📷 Downloads the highest available image quality
• 🎥 Downloads videos
• 📁 Organises downloads by year/month
• 📅 Preserves upload dates in filenames
• 📊 Progress bars with download statistics
• 🔄 Resume partially downloaded files
• 🧹 Simple command-line interface

---

📑 Table of Contents

• Requirements
• Installation
• Usage
• Arguments
• Limitations
• FAQ
• Disclaimer

---

📦 Requirements

• Python 3.11+
• Git
• A Fansly account
• An active subscription to the creator whose content you want to download

---

🚀 Installation

Clone the repository:

git clone https://github.com/Mogrul/Fansly-DL
cd Fansly-DL

Create a virtual environment:

python -m venv .venv

Activate it.

Windows

.venv\Scripts\activate

Linux / macOS

source .venv/bin/activate

Install dependencies:

pip install -r requirements.txt

---

🛠 Usage

1. Obtain your session token

Log into Fansly using your browser.

Open Developer Tools → Console and run:

localStorage.getItem("session_active_session")

Example:

{
    "id": "...",
    "accountId": "...",
    "token": "YOUR_TOKEN"
}

Copy the value of token.

---

2. Export your cookies

Export your logged-in browser cookies using an extension such as:

• Firefox: cookies.txt
• Chrome/Brave: any compatible Netscape Cookie exporter

Save the exported file as:

.credentials/
└── cookie.txt

---

3. Run the downloader

python main.py --session-token YOUR_TOKEN

Example:

python main.py ^
    --session-token OTM3NDUwNDY4...

---

⚙ Arguments

Required

Argument	Description
--session-token TOKEN	Session token obtained from localStorage.getItem("session_active_session")

Optional

Argument	Description
--download-path PATH	Download directory (default: ./Downloads)
--debug	Enable debug logging
--concurrent-downloads	Amount of simultaneous downloads (default: 5)
--timeout	Requests timeout in seconds (default: 10)

---

📂 Example Output

Downloads/
└── Creator/
    ├── 2026/
    │   ├── 07 - July/
    │   │   ├── [2026-07-29] d600a1e88eff.jpeg
    │   │   ├── [2026-07-29] 50db93fc1110.mp4
    │   │   └── ...

---

⚠ Limitations

• You must have permission to access the creator's content.
• The downloader currently supports timeline posts only.
• Message attachments are not currently supported because they have not been reverse engineered or tested.

---

❓ FAQ

Why do I need both cookies and the session token?

Fansly validates requests using both your authenticated session and browser cookies. Supplying both allows the application to make authenticated requests in the same way your browser does.

Can I download paid content?

Only if your account has already purchased or subscribed to it.

Does this bypass subscriptions?

No.

---

🐞 Issues

Found a bug?

Please open an issue:

https://github.com/Mogrul/Fansly-DL/issues

Feature requests and pull requests are welcome.

---

⚖ Disclaimer

This project is provided for educational purposes.

The author is not responsible for how this software is used, including any account restrictions or other consequences that may result from its use. Users are responsible for ensuring they comply with Fansly's Terms of Service and all applicable laws.

---