# pistachio-noir/pistachio-fm architecture

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

- Interactive diagram: https://gitdiagram.com/pistachio-noir/pistachio-fm
- Repository: https://github.com/pistachio-noir/pistachio-fm

## Overview

Pistachio FM is a Qt/QML Linux file manager. The user workflow is browsing folders and selecting files, then previewing, organizing, or opening them; navigation, search, tabs, and split panes support that work. C++ backends provide folder models, file operations, previews, and desktop integration. The README documents several capabilities whose QML wiring was not sampled, so those connections are marked dashed without evidence paths rather than presented as verified calls.

Main entry points: [`qml/FileView.qml`](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/FileView.qml) (Folder Views), [`qml/Main.qml`](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/Main.qml) (Main Window), [`src/FolderModel.cpp`](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/FolderModel.cpp) (Folder Model), [`src/FileOps.cpp`](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/FileOps.cpp) (File Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Browse and Navigate"]
  node_main_ui["Main Window<br/>[Main.qml]"]
  node_tabs["Tabs and Panes<br/>[TabPage.qml]"]
  node_file_view["Folder Views<br/>[FileView.qml]"]
  node_sidebar["Places Sidebar<br/>[Sidebar.qml]"]
  node_folder_model["Folder Model<br/>[FolderModel.cpp]"]
  node_format["File Formatting<br/>[Format.cpp]"]
  node_shared_theme["Shared Theme<br/>[SharedTheme.h]"]
end

subgraph group_files["File Operations"]
  node_fileops_ui["File Actions UI<br/>[FileMenu.qml]"]
  node_file_ops["File Operations<br/>[FileOps.cpp]"]
  node_transfer["Copy and Move<br/>[Transfer.cpp]"]
end

subgraph group_preview_apps["Preview and Open"]
  node_preview_ui["Preview Dialog<br/>[PreviewDialog.qml]"]
  node_preview["Preview Backend<br/>[Preview.cpp]"]
  node_apps["Open With<br/>[Apps.cpp]"]
end

subgraph group_desktop["Linux Integration"]
  node_places["Places and Devices<br/>[Places.cpp]"]
  node_mime_settings["Default App Settings<br/>[MimeSettings.cpp]"]
end

node_user(("User"))
node_local_files[("Local Filesystem")]
node_desktop_apps["Installed Desktop Apps"]
node_linux_tools["Linux Utilities"]

node_user -.->|"uses"| node_main_ui
node_main_ui -.->|"shows"| node_tabs
node_tabs -.->|"displays"| node_file_view
node_file_view -.->|"browses"| node_folder_model
node_sidebar -.->|"shows places"| node_places
node_folder_model -.->|"lists and watches"| node_local_files
node_folder_model -->|"formats entries"| node_format
node_file_view -.->|"offers actions"| node_fileops_ui
node_fileops_ui -.->|"requests operations"| node_file_ops
node_file_ops -->|"delegates transfers"| node_transfer
node_file_ops -.->|"changes files"| node_local_files
node_preview_ui -.->|"requests previews"| node_preview
node_preview -.->|"reads files"| node_local_files
node_preview -.->|"renders PDFs"| node_linux_tools
node_file_view -.->|"opens selections"| node_apps
node_apps -.->|"launches"| node_desktop_apps
node_apps -.->|"sets defaults"| node_mime_settings
node_mime_settings -.->|"uses xdg-mime"| node_linux_tools
node_places -.->|"reads bookmarks"| node_local_files
node_places -.->|"mounts via udiskie"| node_linux_tools
node_main_ui -.->|"uses theme"| node_shared_theme

click node_main_ui "https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/Main.qml"
click node_tabs "https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/TabPage.qml"
click node_file_view "https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/FileView.qml"
click node_sidebar "https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/Sidebar.qml"
click node_folder_model "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/FolderModel.cpp"
click node_format "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Format.cpp"
click node_fileops_ui "https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/FileMenu.qml"
click node_file_ops "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/FileOps.cpp"
click node_transfer "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Transfer.cpp"
click node_places "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Places.cpp"
click node_preview_ui "https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/PreviewDialog.qml"
click node_preview "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Preview.cpp"
click node_apps "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Apps.cpp"
click node_mime_settings "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/MimeSettings.cpp"
click node_shared_theme "https://github.com/pistachio-noir/pistachio-fm/blob/main/src/SharedTheme.h"

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_main_ui,node_tabs,node_file_view,node_sidebar,node_folder_model,node_format,node_shared_theme,node_user toneBlue
class node_fileops_ui,node_file_ops,node_transfer,node_local_files toneAmber
class node_preview_ui,node_preview,node_apps toneMint
class node_places,node_mime_settings toneRose
class node_desktop_apps,node_linux_tools toneIndigo
```

## Components

### Browse and Navigate

- [Main Window](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/Main.qml): `qml/Main.qml`
- [Tabs and Panes](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/TabPage.qml): `qml/TabPage.qml`
- [Folder Views](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/FileView.qml): `qml/FileView.qml`
- [Places Sidebar](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/Sidebar.qml): `qml/Sidebar.qml`
- [Folder Model](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/FolderModel.cpp): `src/FolderModel.cpp`
- [File Formatting](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Format.cpp): `src/Format.cpp`
- [Shared Theme](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/SharedTheme.h): `src/SharedTheme.h`

### File Operations

- [File Actions UI](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/FileMenu.qml): `qml/FileMenu.qml`
- [File Operations](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/FileOps.cpp): `src/FileOps.cpp`
- [Copy and Move](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Transfer.cpp): `src/Transfer.cpp`

### Preview and Open

- [Preview Dialog](https://github.com/pistachio-noir/pistachio-fm/blob/main/qml/PreviewDialog.qml): `qml/PreviewDialog.qml`
- [Preview Backend](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Preview.cpp): `src/Preview.cpp`
- [Open With](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Apps.cpp): `src/Apps.cpp`

### Linux Integration

- [Places and Devices](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/Places.cpp): `src/Places.cpp`
- [Default App Settings](https://github.com/pistachio-noir/pistachio-fm/blob/main/src/MimeSettings.cpp): `src/MimeSettings.cpp`

### Other components

- **User**
- **Local Filesystem**
- **Installed Desktop Apps**
- **Linux Utilities**

## Connections

- User → Main Window: uses
- Main Window → Tabs and Panes: shows
- Tabs and Panes → Folder Views: displays
- Folder Views → Folder Model: browses
- Places Sidebar → Places and Devices: shows places
- Folder Model → Local Filesystem: lists and watches
- Folder Model → File Formatting: formats entries (evidence: `src/FolderModel.cpp`)
- Folder Views → File Actions UI: offers actions
- File Actions UI → File Operations: requests operations
- File Operations → Copy and Move: delegates transfers (evidence: `src/FileOps.cpp`)
- File Operations → Local Filesystem: changes files
- Preview Dialog → Preview Backend: requests previews
- Preview Backend → Local Filesystem: reads files
- Preview Backend → Linux Utilities: renders PDFs (evidence: `README.md`)
- Folder Views → Open With: opens selections (evidence: `README.md`)
- Open With → Installed Desktop Apps: launches (evidence: `README.md`)
- Open With → Default App Settings: sets defaults (evidence: `README.md`)
- Default App Settings → Linux Utilities: uses xdg-mime (evidence: `README.md`)
- Places and Devices → Local Filesystem: reads bookmarks
- Places and Devices → Linux Utilities: mounts via udiskie (evidence: `README.md`)
- Main Window → Shared Theme: uses theme
