# handiandi/filejoker_downloader_cli architecture

> Architecture diagram of the GitHub repository handiandi/filejoker_downloader_cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/handiandi/filejoker_downloader_cli
- Repository: https://github.com/handiandi/filejoker_downloader_cli

## Overview

FileJokerDownloader is a premium-account CLI that accepts links directly or from a text file, authenticates with FileJoker, resolves each link to a downloadable file, and saves it locally. Its principal workflow runs through a thread pool; the README also documents per-link renaming and choosing an existing output directory. The script contains the CLI, orchestration, network/session logic, and file handling in one source file. The excerpt omits some connections, so the graph shows only documented or excerpt-visible relationships.

Main entry points: [`FilejokerDownloader.py`](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py) (Download Worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["CLI and Inputs"]
  node_cli["Argument Parser"]
  node_link_inputs["Link Inputs"]
end

subgraph group_workflow["Download Workflow"]
  node_scheduler["Download Orchestrator"]
  node_worker["Download Worker"]
  node_capacity["Space Checker"]
end

subgraph group_remote["FileJoker Integration"]
  node_session["Authenticated Session"]
  node_resolver["Link Resolver"]
end

subgraph group_output["Local Output"]
  node_streamer["File Streamer"]
end

node_user(("CLI User"))
node_filejoker{{"FileJoker.net"}}
node_filesystem[("Local Filesystem")]

node_user -->|"provides options"| node_cli
node_cli -->|"accepts links"| node_link_inputs
node_cli -->|"starts downloads"| node_scheduler
node_link_inputs -->|"supplies links"| node_scheduler
node_scheduler -->|"submits tasks"| node_worker
node_worker -->|"requests source"| node_session
node_session -->|"logs in"| node_filejoker
node_worker -->|"checks space"| node_capacity
node_capacity -->|"checks free space"| node_filesystem
node_worker -->|"finds download link"| node_resolver
node_resolver -->|"requests link"| node_filejoker
node_worker -->|"starts download"| node_streamer
node_streamer -->|"fetches stream"| node_session
node_streamer -->|"writes file"| node_filesystem

click node_cli "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_link_inputs "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_scheduler "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_worker "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_capacity "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_session "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_resolver "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"
click node_streamer "https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_link_inputs,node_user toneBlue
class node_scheduler,node_worker,node_capacity,node_filesystem toneAmber
class node_session,node_resolver toneMint
class node_streamer toneRose
class node_filejoker toneIndigo
```

## Components

### CLI and Inputs

- [Argument Parser](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`
- [Link Inputs](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`

### Download Workflow

- [Download Orchestrator](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`
- [Download Worker](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`
- [Space Checker](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`

### FileJoker Integration

- [Authenticated Session](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`
- [Link Resolver](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`

### Local Output

- [File Streamer](https://github.com/handiandi/filejoker_downloader_cli/blob/master/FilejokerDownloader.py): `FilejokerDownloader.py`

### Other components

- **CLI User**
- **FileJoker.net**
- **Local Filesystem**

## Connections

- CLI User → Argument Parser: provides options (evidence: `README.md`)
- Argument Parser → Link Inputs: accepts links (evidence: `README.md`)
- Argument Parser → Download Orchestrator: starts downloads (evidence: `FilejokerDownloader.py`)
- Link Inputs → Download Orchestrator: supplies links (evidence: `README.md`)
- Download Orchestrator → Download Worker: submits tasks (evidence: `FilejokerDownloader.py`)
- Download Worker → Authenticated Session: requests source (evidence: `FilejokerDownloader.py`)
- Authenticated Session → FileJoker.net: logs in (evidence: `FilejokerDownloader.py`)
- Download Worker → Space Checker: checks space (evidence: `FilejokerDownloader.py`)
- Space Checker → Local Filesystem: checks free space (evidence: `FilejokerDownloader.py`)
- Download Worker → Link Resolver: finds download link (evidence: `FilejokerDownloader.py`)
- Link Resolver → FileJoker.net: requests link (evidence: `FilejokerDownloader.py`)
- Download Worker → File Streamer: starts download (evidence: `FilejokerDownloader.py`)
- File Streamer → Authenticated Session: fetches stream (evidence: `FilejokerDownloader.py`)
- File Streamer → Local Filesystem: writes file (evidence: `FilejokerDownloader.py`)
