# tahmidulkhan24/linux-file-organizer architecture

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

- Interactive diagram: https://gitdiagram.com/tahmidulkhan24/linux-file-organizer
- Repository: https://github.com/tahmidulkhan24/linux-file-organizer

## Overview

This is a small Bash file-management utility. The documented workflow is that a user runs the script and uses its file-organization, search, cleanup, and inspection capabilities; it can also save reports and demonstrate permissions. The tree identifies `org.sh` as the sole implementation file, but no source excerpt was provided, so the feature relationships below rely on the README and do not assert an internal call sequence.

Main entry points: [`org.sh`](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh) (Organizer utility)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_utility["Organizer utility<br/>[org.sh]"]
node_organize["Organize by extension<br/>[org.sh]"]
node_search["Search by name<br/>[org.sh]"]
node_cleanup["Empty-file cleanup<br/>[org.sh]"]
node_statistics["File statistics<br/>[org.sh]"]
node_largest["Largest file<br/>[org.sh]"]
node_reports["Saved reports<br/>[org.sh]"]
node_permissions["Permission demo<br/>[org.sh]"]
node_filesystem[("Linux filesystem")]

node_user -->|"runs"| node_utility
node_utility -->|"offers"| node_organize
node_utility -->|"offers"| node_search
node_utility -->|"offers"| node_cleanup
node_utility -->|"offers"| node_statistics
node_utility -->|"offers"| node_largest
node_utility -->|"offers"| node_reports
node_utility -->|"offers"| node_permissions
node_organize -->|"moves files"| node_filesystem
node_search -->|"searches files"| node_filesystem
node_cleanup -->|"deletes empty files"| node_filesystem
node_statistics -->|"inspects files"| node_filesystem
node_largest -->|"finds largest"| node_filesystem
node_reports -->|"saves reports"| node_filesystem
node_permissions -->|"demonstrates permissions"| node_filesystem

click node_utility "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_organize "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_search "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_cleanup "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_statistics "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_largest "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_reports "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"
click node_permissions "https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh"

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 toneBlue
class node_utility,node_organize,node_search,node_cleanup,node_statistics,node_largest,node_reports,node_permissions toneTeal
class node_filesystem toneAmber
```

## Components

### Other components

- **User**
- [Organizer utility](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [Organize by extension](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [Search by name](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [Empty-file cleanup](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [File statistics](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [Largest file](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [Saved reports](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- [Permission demo](https://github.com/tahmidulkhan24/linux-file-organizer/blob/main/org.sh): `org.sh`
- **Linux filesystem**

## Connections

- User → Organizer utility: runs (evidence: `README.md`)
- Organizer utility → Organize by extension: offers (evidence: `README.md`)
- Organizer utility → Search by name: offers (evidence: `README.md`)
- Organizer utility → Empty-file cleanup: offers (evidence: `README.md`)
- Organizer utility → File statistics: offers (evidence: `README.md`)
- Organizer utility → Largest file: offers (evidence: `README.md`)
- Organizer utility → Saved reports: offers (evidence: `README.md`)
- Organizer utility → Permission demo: offers (evidence: `README.md`)
- Organize by extension → Linux filesystem: moves files (evidence: `README.md`)
- Search by name → Linux filesystem: searches files (evidence: `README.md`)
- Empty-file cleanup → Linux filesystem: deletes empty files (evidence: `README.md`)
- File statistics → Linux filesystem: inspects files (evidence: `README.md`)
- Largest file → Linux filesystem: finds largest (evidence: `README.md`)
- Saved reports → Linux filesystem: saves reports (evidence: `README.md`)
- Permission demo → Linux filesystem: demonstrates permissions (evidence: `README.md`)
