Deezer ARL Extractor 🎧

A lightweight Python tool that automates the extraction of Deezer ARL cookies through browser automation using Playwright.

---

📌 Overview

Deezer ARL Extractor simplifies the process of retrieving valid ARL cookies from Deezer accounts by automating the login procedure in a headless (or optionally visible) Chromium session. It is designed for developers, researchers, and technical users who need to automate session handling for integration, testing, or data retrieval.

⚠️ Note: This tool requires manual user interaction to solve CAPTCHA challenges during login (see below for an example).

---

🚀 Feature Checklist

• Standalone script in a single file (main.py)
• Quick installation with minimal dependencies
• Easy configuration through sessions.json
• Secure session and credential management
• Automatic screenshot capture on errors
• Support for multiple accounts with parallel processing
• Manual CAPTCHA support during login
• Detailed account-specific log generation
• Automatic saving of extracted ARL cookies
• Automatic verification of ARL status
• Graphical User Interface (GUI) for easier use
• Export results to CSV or HTML
• Full multiplatform compatibility (Windows, Linux, macOS)
• Proxy configuration support
• Support for scheduled execution (cron job or scheduler)
• Automate CAPTCHA completion using Anti Captcha or 2captcha

---

📦 Prerequisites

• Python 3.8 or later
• Playwright (installed automatically via script)

---

⚙️ Installation

Follow the steps below to get started:

1. Clone the Repository

git clone https://github.com/tutitoos/deezer_arl_extractor.git
cd deezer_arl_extractor

2. Install Dependencies

To install the required dependencies, you can use either pip or pip3 depending on your environment:

pip install -r requirements.txt
playwright install

---

🔧 Configuration

Step 1: Prepare the Session File

Copy the example config:

cp data/sessions.json.example data/sessions.json

Step 2: Define Accounts

Edit data/sessions.json with your credentials:

[
  {
    "email": "your_email@domain.com",
    "password": "your_password",
    "arl": null,
    "lastUpdated": null,
    "enable": true
  }
]

Only accounts with "enable": true will be processed.

---

🖥️ Usage

Execute the script with:

python main.py

If credentials are valid and no errors occur, the arl field will be updated in the same JSON file.

---

🧩 CAPTCHA Handling (Manual Step)

Due to security measures, Deezer may require CAPTCHA verification during login.

When prompted, the Chromium browser will open and you must complete the CAPTCHA manually:

Once verified, the script will resume automatically.

---

📂 Output Structure

• ARL Cookies: stored in data/sessions.json
• Logs: located at logs/<email>/logs.txt
• Screenshots: saved in screenshots/<email>/ with timestamped filenames

---

🛡️ License

This project is licensed under the MIT License. See LICENSE for details.

---

⚠️ Disclaimer

This tool is intended for educational and personal use only. You are solely responsible for how you use it. Respect the terms of service of any platform you interact with.