# wolfterro/projetos-em-python architecture

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

- Interactive diagram: https://gitdiagram.com/wolfterro/projetos-em-python
- Repository: https://github.com/wolfterro/projetos-em-python

## Overview

This repository is a collection of independent Python utilities rather than one application. Its clearest end-to-end workflow is Heavier: a user selects automatic or ID-based downloading, the entry point delegates to the download manager, which reads configuration, scrapes video-page metadata, prepares a destination, and downloads the video. Other scripts cover image and animation downloads, IP lookup, post-number checking, and media cutting. Several local READMEs and unsampled scripts were not available, so those components are represented only at the level supported by the tree and excerpts.

Main entry points: [`Heavier/HeavierDownloader/DownloadManager.py`](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/DownloadManager.py) (Download Manager), [`FCutter/FCutter.py`](https://github.com/wolfterro/projetos-em-python/blob/master/FCutter/FCutter.py) (FCutter), [`IPyInfo/IPyInfo.py`](https://github.com/wolfterro/projetos-em-python/blob/master/IPyInfo/IPyInfo.py) (IPyInfo), [`Heavier/Heavier.py`](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/Heavier.py) (Heavier CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_heavier["Heavier Downloader"]
  node_heavier_cli["Heavier CLI<br/>[Heavier.py]"]
  node_manager["Download Manager<br/>[DownloadManager.py]"]
  node_config["Configuration<br/>[ConfigReader.py]"]
  node_scraper["Page Scraper<br/>[PageScrapper.py]"]
  node_structure["Video Structure<br/>[VideoStructure.py]"]
end

subgraph group_media["Media Utilities"]
  node_heavy_r["Heavy-R Downloader"]
  node_guro["GUROchan Downloader"]
  node_z0r["z0r Downloader<br/>[z0r-downloader.py]"]
  node_fcutter["FCutter<br/>[FCutter.py]"]
end

subgraph group_lookup["Lookup Utilities"]
  node_ipinfo["IPyInfo<br/>[IPyInfo.py]"]
end

subgraph group_checking["Post Checking"]
  node_checkem["Check'em<br/>[Checkem.py]"]
end

node_user(("User"))
node_video_site{{"Video Website"}}
node_video_files[("Video Files")]
node_ffmpeg{{"FFmpeg"}}
node_media_files[("Media Files")]
node_ip_service{{"IP Info Service"}}
node_maps_service{{"Google Maps API"}}
node_fourchan{{"4chan"}}

node_user -->|"selects mode"| node_heavier_cli
node_heavier_cli -->|"delegates downloads"| node_manager
node_manager -->|"reads settings"| node_config
node_manager -->|"requests pages and videos"| node_video_site
node_manager -->|"parses page"| node_scraper
node_manager -->|"prepares destination"| node_structure
node_structure -->|"reads output path"| node_config
node_manager -.->|"writes downloads"| node_video_files
node_user -->|"provides video URL"| node_heavy_r
node_heavy_r -->|"fetches video pages"| node_video_site
node_user -->|"provides topic URL"| node_guro
node_guro -->|"saves images"| node_media_files
node_user -->|"selects animation IDs"| node_z0r
node_z0r -->|"saves animations"| node_media_files
node_user -->|"provides source and output"| node_fcutter
node_fcutter -->|"runs cut command"| node_ffmpeg
node_fcutter -.->|"cuts media files"| node_media_files
node_user -->|"provides optional IP"| node_ipinfo
node_ipinfo -->|"looks up IP data"| node_ip_service
node_ipinfo -->|"geocodes location"| node_maps_service
node_user -->|"provides thread URL"| node_checkem
node_checkem -.->|"retrieves thread posts"| node_fourchan

click node_heavier_cli "https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/Heavier.py"
click node_manager "https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/DownloadManager.py"
click node_config "https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/ConfigReader.py"
click node_scraper "https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/PageScrapper.py"
click node_structure "https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/VideoStructure.py"
click node_heavy_r "https://github.com/wolfterro/projetos-em-python/blob/master/Heavy-R%20Downloader/HeavyRDownloader.py"
click node_guro "https://github.com/wolfterro/projetos-em-python/blob/master/GUROchan%20Image%20Downloader/GUROchan-Image-Downloader.py"
click node_z0r "https://github.com/wolfterro/projetos-em-python/blob/master/z0r%20Downloader/z0r-downloader.py"
click node_fcutter "https://github.com/wolfterro/projetos-em-python/blob/master/FCutter/FCutter.py"
click node_ipinfo "https://github.com/wolfterro/projetos-em-python/blob/master/IPyInfo/IPyInfo.py"
click node_checkem "https://github.com/wolfterro/projetos-em-python/blob/master/Checkem/Checkem.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_heavier_cli,node_manager,node_config,node_scraper,node_structure,node_user toneBlue
class node_heavy_r,node_guro,node_z0r,node_fcutter,node_video_files,node_media_files toneAmber
class node_ipinfo,node_maps_service toneMint
class node_checkem toneRose
class node_video_site,node_ffmpeg,node_ip_service,node_fourchan toneIndigo
```

## Components

### Heavier Downloader

- [Heavier CLI](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/Heavier.py): `Heavier/Heavier.py`
- [Download Manager](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/DownloadManager.py): `Heavier/HeavierDownloader/DownloadManager.py`
- [Configuration](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/ConfigReader.py): `Heavier/HeavierDownloader/ConfigReader.py`
- [Page Scraper](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/PageScrapper.py): `Heavier/HeavierDownloader/PageScrapper.py`
- [Video Structure](https://github.com/wolfterro/projetos-em-python/blob/master/Heavier/HeavierDownloader/VideoStructure.py): `Heavier/HeavierDownloader/VideoStructure.py`

### Media Utilities

- [Heavy-R Downloader](https://github.com/wolfterro/projetos-em-python/blob/master/Heavy-R%20Downloader/HeavyRDownloader.py): `Heavy-R Downloader/HeavyRDownloader.py`
- [GUROchan Downloader](https://github.com/wolfterro/projetos-em-python/blob/master/GUROchan%20Image%20Downloader/GUROchan-Image-Downloader.py): `GUROchan Image Downloader/GUROchan-Image-Downloader.py`
- [z0r Downloader](https://github.com/wolfterro/projetos-em-python/blob/master/z0r%20Downloader/z0r-downloader.py): `z0r Downloader/z0r-downloader.py`
- [FCutter](https://github.com/wolfterro/projetos-em-python/blob/master/FCutter/FCutter.py): `FCutter/FCutter.py`

### Lookup Utilities

- [IPyInfo](https://github.com/wolfterro/projetos-em-python/blob/master/IPyInfo/IPyInfo.py): `IPyInfo/IPyInfo.py`

### Post Checking

- [Check'em](https://github.com/wolfterro/projetos-em-python/blob/master/Checkem/Checkem.py): `Checkem/Checkem.py`

### Other components

- **User**
- **Video Website**
- **Video Files**
- **FFmpeg**
- **Media Files**
- **IP Info Service**
- **Google Maps API**
- **4chan**

## Connections

- User → Heavier CLI: selects mode (evidence: `Heavier/Heavier.py`)
- Heavier CLI → Download Manager: delegates downloads (evidence: `Heavier/Heavier.py`)
- Download Manager → Configuration: reads settings (evidence: `Heavier/HeavierDownloader/DownloadManager.py`)
- Download Manager → Video Website: requests pages and videos (evidence: `Heavier/HeavierDownloader/DownloadManager.py`)
- Download Manager → Page Scraper: parses page (evidence: `Heavier/HeavierDownloader/DownloadManager.py`)
- Download Manager → Video Structure: prepares destination (evidence: `Heavier/HeavierDownloader/DownloadManager.py`)
- Video Structure → Configuration: reads output path (evidence: `Heavier/HeavierDownloader/VideoStructure.py`)
- Download Manager → Video Files: writes downloads
- User → Heavy-R Downloader: provides video URL (evidence: `Heavy-R Downloader/HeavyRDownloader.py`)
- Heavy-R Downloader → Video Website: fetches video pages (evidence: `Heavy-R Downloader/HeavyRDownloader.py`)
- User → GUROchan Downloader: provides topic URL (evidence: `GUROchan Image Downloader/GUROchan-Image-Downloader.py`)
- GUROchan Downloader → Media Files: saves images (evidence: `GUROchan Image Downloader/GUROchan-Image-Downloader.py`)
- User → z0r Downloader: selects animation IDs (evidence: `z0r Downloader/z0r-downloader.py`)
- z0r Downloader → Media Files: saves animations (evidence: `z0r Downloader/z0r-downloader.py`)
- User → FCutter: provides source and output (evidence: `FCutter/FCutter.py`)
- FCutter → FFmpeg: runs cut command (evidence: `FCutter/FCutter.py`)
- FCutter → Media Files: cuts media files
- User → IPyInfo: provides optional IP (evidence: `IPyInfo/IPyInfo.py`)
- IPyInfo → IP Info Service: looks up IP data (evidence: `IPyInfo/IPyInfo.py`)
- IPyInfo → Google Maps API: geocodes location (evidence: `IPyInfo/IPyInfo.py`)
- User → Check'em: provides thread URL (evidence: `Checkem/Checkem.py`)
- Check'em → 4chan: retrieves thread posts
