[!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+
• A Fansly account
• An active subscription to the creator whose content you want to download

---

🚀 Installation

Download using pip:

pip install Fansly-DL

---

🛠 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. Run the downloader

fansly-dl --session-token YOUR_TOKEN

---

⚙ Arguments

Required

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

Optional

Argument	Description
--destination PATH	Download directory (default: ./Downloads)
--debug	Enable debug logging
--concurrent	Amount of simultaneous downloads (default: 5)
--timeout	Requests timeout in seconds (default: 10)
--chunk-size	Amount of chunks to download in a request stream. (default: 1024 * 1024)

---

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

---