---

📖 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 chats, downloading 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)
--my-messages	Downloads messages you sent in chats. (default: False)
--no-chats	Skips downloading media from chats. (default: False)

---

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

---

❓ FAQ

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.

---