# admiralsyn-ackbar/bulkcheck architecture

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

- Interactive diagram: https://gitdiagram.com/admiralsyn-ackbar/bulkcheck
- Repository: https://github.com/admiralsyn-ackbar/bulkcheck

## Overview

Bulk Checker is a desktop utility for submitting a CSV of IP addresses to AbuseIPDB and saving returned abuse, ISP, domain, and country information as a CSV report. The Python workflow uses a Tkinter GUI to gather paths and an API key, then runs the checks and reports progress. The README also identifies a PowerShell implementation, but its internals were not sampled, so no workflow links are inferred for it.

Main entry points: [`AbuseIPDB_Bulk_Checker.py`](https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.py) (Bulk check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_python_gui["Tkinter GUI"]
  node_powershell["PowerShell version"]
end

subgraph group_checking["IP checking"]
  node_input_csv["Input CSV"]
  node_bulk_check["Bulk check"]
  node_abuseipdb["AbuseIPDB API"]
end

subgraph group_reporting["Report output"]
  node_temp_json["Temporary JSON"]
  node_output_csv["CSV report"]
end

node_user(("Operator"))

node_user -->|"configures"| node_python_gui
node_python_gui -->|"starts check"| node_bulk_check
node_input_csv -->|"reads rows"| node_bulk_check
node_bulk_check -->|"checks IPs"| node_abuseipdb
node_bulk_check -->|"writes responses"| node_temp_json
node_temp_json -->|"reads responses"| node_bulk_check
node_bulk_check -->|"writes report"| node_output_csv

click node_python_gui "https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.py"
click node_powershell "https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.ps1"
click node_bulk_check "https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.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_python_gui,node_powershell toneBlue
class node_input_csv,node_bulk_check,node_abuseipdb toneAmber
class node_temp_json,node_output_csv toneMint
class node_user toneIndigo
```

## Components

### User interface

- [Tkinter GUI](https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.py): `AbuseIPDB_Bulk_Checker.py`
- [PowerShell version](https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.ps1): `AbuseIPDB_Bulk_Checker.ps1`

### IP checking

- **Input CSV**
- [Bulk check](https://github.com/admiralsyn-ackbar/bulkcheck/blob/master/AbuseIPDB_Bulk_Checker.py): `AbuseIPDB_Bulk_Checker.py`
- **AbuseIPDB API**

### Report output

- **Temporary JSON**
- **CSV report**

### Other components

- **Operator**

## Connections

- Operator → Tkinter GUI: configures (evidence: `AbuseIPDB_Bulk_Checker.py`)
- Tkinter GUI → Bulk check: starts check (evidence: `AbuseIPDB_Bulk_Checker.py`)
- Input CSV → Bulk check: reads rows (evidence: `AbuseIPDB_Bulk_Checker.py`)
- Bulk check → AbuseIPDB API: checks IPs (evidence: `AbuseIPDB_Bulk_Checker.py`)
- Bulk check → Temporary JSON: writes responses (evidence: `AbuseIPDB_Bulk_Checker.py`)
- Temporary JSON → Bulk check: reads responses (evidence: `AbuseIPDB_Bulk_Checker.py`)
- Bulk check → CSV report: writes report (evidence: `AbuseIPDB_Bulk_Checker.py`)
