# devmoi-dev/orgnize architecture

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

- Interactive diagram: https://gitdiagram.com/devmoi-dev/orgnize
- Repository: https://github.com/devmoi-dev/orgnize

## Overview

This repository provides two standalone ways to organize files by extension: a PyQt desktop application with folder selection and optional recursive scanning, and a command-line script that organizes a hard-coded folder. Both create category folders and move files; the GUI version additionally skips hidden/system files and avoids overwriting existing destinations. The scripts do not import or call one another. The README is empty, so capabilities and relationships here are based on the two source excerpts.

Main entry points: [`ui_orgnize.py`](https://github.com/devmoi-dev/orgnize/blob/main/ui_orgnize.py) (Desktop UI), [`orgnize_files.py`](https://github.com/devmoi-dev/orgnize/blob/main/orgnize_files.py) (CLI Organizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_desktop["Desktop UI<br/>[ui_orgnize.py]"]
node_folder_picker["Folder Picker"]
node_gui_organizer["GUI Organizer<br/>[ui_orgnize.py]"]
node_folder_storage["Selected Folder"]
node_cli_organizer["CLI Organizer<br/>[orgnize_files.py]"]
node_cli_folder["Configured Folder"]

node_user -->|"uses"| node_desktop
node_desktop -->|"opens"| node_folder_picker
node_folder_picker -->|"returns path"| node_desktop
node_user -->|"starts organizing"| node_desktop
node_desktop -->|"dispatches"| node_gui_organizer
node_gui_organizer -->|"scans and moves"| node_folder_storage
node_cli_organizer -->|"scans and moves"| node_cli_folder

click node_desktop "https://github.com/devmoi-dev/orgnize/blob/main/ui_orgnize.py"
click node_gui_organizer "https://github.com/devmoi-dev/orgnize/blob/main/ui_orgnize.py"
click node_cli_organizer "https://github.com/devmoi-dev/orgnize/blob/main/orgnize_files.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_user,node_desktop,node_gui_organizer toneBlue
class node_folder_picker,node_folder_storage,node_cli_folder toneIndigo
class node_cli_organizer toneTeal
```

## Components

### Other components

- **User**
- [Desktop UI](https://github.com/devmoi-dev/orgnize/blob/main/ui_orgnize.py): `ui_orgnize.py`
- **Folder Picker**
- [GUI Organizer](https://github.com/devmoi-dev/orgnize/blob/main/ui_orgnize.py): `ui_orgnize.py`
- **Selected Folder**
- [CLI Organizer](https://github.com/devmoi-dev/orgnize/blob/main/orgnize_files.py): `orgnize_files.py`
- **Configured Folder**

## Connections

- User → Desktop UI: uses (evidence: `ui_orgnize.py`)
- Desktop UI → Folder Picker: opens (evidence: `ui_orgnize.py`)
- Folder Picker → Desktop UI: returns path (evidence: `ui_orgnize.py`)
- User → Desktop UI: starts organizing (evidence: `ui_orgnize.py`)
- Desktop UI → GUI Organizer: dispatches (evidence: `ui_orgnize.py`)
- GUI Organizer → Selected Folder: scans and moves (evidence: `ui_orgnize.py`)
- CLI Organizer → Configured Folder: scans and moves (evidence: `orgnize_files.py`)
