# hackerd-825/filemaster architecture

> Architecture diagram of the GitHub repository hackerd-825/filemaster, 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/hackerd-825/filemaster
- Repository: https://github.com/hackerd-825/filemaster

## Overview

FileMaster is a local Tkinter file explorer. The main workflow is user-driven browsing and file management: the UI displays directory contents and dispatches file actions, while separate modules provide search, analysis, previews, and themes. The README documents additional capabilities such as favorites, bulk rename, and logging. Some UI internals were not sampled, so those branches rely on README evidence rather than inferred call chains.

Main entry points: [`ui.py`](https://github.com/hackerd-825/filemaster/blob/main/ui.py) (Tkinter app), [`file_ops.py`](https://github.com/hackerd-825/filemaster/blob/main/file_ops.py) (File operations), [`preview.py`](https://github.com/hackerd-825/filemaster/blob/main/preview.py) (File preview), [`search.py`](https://github.com/hackerd-825/filemaster/blob/main/search.py) (Search engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Explorer interface"]
  node_app["Tkinter app<br/>[ui.py]"]
  node_navigation["Navigation and listing<br/>[ui.py]"]
  node_favorites["Favorites<br/>[ui.py]"]
  node_preview["File preview<br/>[preview.py]"]
end

subgraph group_file_work["File workflows"]
  node_fileops["File operations<br/>[file_ops.py]"]
  node_bulkrename["Bulk rename<br/>[file_ops.py]"]
  node_searchui["Search interface<br/>[ui.py]"]
  node_searchengine["Search engine<br/>[search.py]"]
  node_analysis["Folder analysis<br/>[file_ops.py]"]
end

subgraph group_support["Application support"]
  node_themes["Theme management<br/>[themes.py]"]
  node_utilities["File utilities<br/>[utils.py]"]
  node_logger["Action logger<br/>[utils.py]"]
  node_icon_generator["Icon generation<br/>[generate_icons.py]"]
end

subgraph group_local_data["Local data"]
  node_filesystem[("Local filesystem")]
  node_theme_files["Theme definitions"]
  node_action_log["Action log"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"presents"| node_navigation
node_app -->|"shows selection"| node_preview
node_app -->|"dispatches actions"| node_fileops
node_app -->|"offers renaming"| node_bulkrename
node_app -->|"opens search"| node_searchui
node_searchui -->|"starts search"| node_searchengine
node_app -->|"starts analysis"| node_analysis
node_app -->|"manages favorites"| node_favorites
node_app -->|"loads and applies"| node_themes
node_navigation -->|"lists and opens"| node_filesystem
node_fileops -->|"reads and modifies"| node_filesystem
node_bulkrename -->|"renames files"| node_filesystem
node_searchengine -->|"scans directories"| node_filesystem
node_analysis -->|"scans folder"| node_filesystem
node_preview -->|"reads selected file"| node_filesystem
node_app -->|"generates on startup"| node_icon_generator
node_themes -->|"loads JSON"| node_theme_files
node_fileops -->|"uses helpers"| node_utilities
node_searchengine -->|"uses predicates"| node_utilities
node_preview -->|"formats file details"| node_utilities
node_fileops -->|"logs actions"| node_logger
node_logger -->|"writes entries"| node_action_log

click node_app "https://github.com/hackerd-825/filemaster/blob/main/ui.py"
click node_navigation "https://github.com/hackerd-825/filemaster/blob/main/ui.py"
click node_favorites "https://github.com/hackerd-825/filemaster/blob/main/ui.py"
click node_preview "https://github.com/hackerd-825/filemaster/blob/main/preview.py"
click node_fileops "https://github.com/hackerd-825/filemaster/blob/main/file_ops.py"
click node_bulkrename "https://github.com/hackerd-825/filemaster/blob/main/file_ops.py"
click node_searchui "https://github.com/hackerd-825/filemaster/blob/main/ui.py"
click node_searchengine "https://github.com/hackerd-825/filemaster/blob/main/search.py"
click node_analysis "https://github.com/hackerd-825/filemaster/blob/main/file_ops.py"
click node_themes "https://github.com/hackerd-825/filemaster/blob/main/themes.py"
click node_utilities "https://github.com/hackerd-825/filemaster/blob/main/utils.py"
click node_logger "https://github.com/hackerd-825/filemaster/blob/main/utils.py"
click node_icon_generator "https://github.com/hackerd-825/filemaster/blob/main/generate_icons.py"
click node_theme_files "https://github.com/hackerd-825/filemaster/tree/main/assets/themes"
click node_action_log "https://github.com/hackerd-825/filemaster/tree/main/logs"

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_app,node_navigation,node_favorites,node_preview,node_user toneBlue
class node_fileops,node_bulkrename,node_searchui,node_searchengine,node_analysis toneAmber
class node_themes,node_utilities,node_logger,node_icon_generator toneMint
class node_filesystem,node_theme_files,node_action_log toneRose
```

## Components

### Explorer interface

- [Tkinter app](https://github.com/hackerd-825/filemaster/blob/main/ui.py): `ui.py`
- [Navigation and listing](https://github.com/hackerd-825/filemaster/blob/main/ui.py): `ui.py`
- [Favorites](https://github.com/hackerd-825/filemaster/blob/main/ui.py): `ui.py`
- [File preview](https://github.com/hackerd-825/filemaster/blob/main/preview.py): `preview.py`

### File workflows

- [File operations](https://github.com/hackerd-825/filemaster/blob/main/file_ops.py): `file_ops.py`
- [Bulk rename](https://github.com/hackerd-825/filemaster/blob/main/file_ops.py): `file_ops.py`
- [Search interface](https://github.com/hackerd-825/filemaster/blob/main/ui.py): `ui.py`
- [Search engine](https://github.com/hackerd-825/filemaster/blob/main/search.py): `search.py`
- [Folder analysis](https://github.com/hackerd-825/filemaster/blob/main/file_ops.py): `file_ops.py`

### Application support

- [Theme management](https://github.com/hackerd-825/filemaster/blob/main/themes.py): `themes.py`
- [File utilities](https://github.com/hackerd-825/filemaster/blob/main/utils.py): `utils.py`
- [Action logger](https://github.com/hackerd-825/filemaster/blob/main/utils.py): `utils.py`
- [Icon generation](https://github.com/hackerd-825/filemaster/blob/main/generate_icons.py): `generate_icons.py`

### Local data

- **Local filesystem**
- [Theme definitions](https://github.com/hackerd-825/filemaster/tree/main/assets/themes): `assets/themes`
- [Action log](https://github.com/hackerd-825/filemaster/tree/main/logs): `logs`

### Other components

- **User**

## Connections

- User → Tkinter app: uses (evidence: `README.md`)
- Tkinter app → Navigation and listing: presents (evidence: `README.md`)
- Tkinter app → File preview: shows selection (evidence: `ui.py`)
- Tkinter app → File operations: dispatches actions (evidence: `ui.py`)
- Tkinter app → Bulk rename: offers renaming (evidence: `README.md`)
- Tkinter app → Search interface: opens search (evidence: `README.md`)
- Search interface → Search engine: starts search (evidence: `README.md`)
- Tkinter app → Folder analysis: starts analysis (evidence: `README.md`)
- Tkinter app → Favorites: manages favorites (evidence: `README.md`)
- Tkinter app → Theme management: loads and applies (evidence: `ui.py`)
- Navigation and listing → Local filesystem: lists and opens (evidence: `README.md`)
- File operations → Local filesystem: reads and modifies (evidence: `README.md`)
- Bulk rename → Local filesystem: renames files (evidence: `README.md`)
- Search engine → Local filesystem: scans directories (evidence: `search.py`)
- Folder analysis → Local filesystem: scans folder (evidence: `file_ops.py`)
- File preview → Local filesystem: reads selected file (evidence: `preview.py`)
- Tkinter app → Icon generation: generates on startup (evidence: `main.py`)
- Theme management → Theme definitions: loads JSON (evidence: `README.md`)
- File operations → File utilities: uses helpers (evidence: `file_ops.py`)
- Search engine → File utilities: uses predicates (evidence: `search.py`)
- File preview → File utilities: formats file details (evidence: `preview.py`)
- File operations → Action logger: logs actions (evidence: `file_ops.py`)
- Action logger → Action log: writes entries (evidence: `README.md`)
