# xfce-mirror/thunar architecture

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

- Interactive diagram: https://gitdiagram.com/xfce-mirror/thunar
- Repository: https://github.com/xfce-mirror/thunar

## Overview

Thunar is an Xfce graphical file manager. A user navigates to a folder, inspects files, and invokes actions such as opening, transferring, or renaming them. The tree also shows extension points for custom actions, file-property pages, wallpaper selection, and bulk renaming. The graph highlights these product branches, plus file and application layers. Evidence is limited to the README, tree, and sampled/indexed files; some subsystem links are therefore omitted or marked unverified.

Main entry points: [`thunar/thunar-window.c`](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-window.c) (File manager window), [`thunarx/thunarx.h`](https://github.com/xfce-mirror/thunar/blob/master/thunarx/thunarx.h) (Plugin interfaces), [`thunar/thunar-application.c`](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-application.c) (Application services), [`thunarx/thunarx-renamer.c`](https://github.com/xfce-mirror/thunar/blob/master/thunarx/thunarx-renamer.c) (Renamer interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and navigation"]
  node_entry["Application entry<br/>[main.c]"]
  node_application["Application services"]
  node_window["File manager window<br/>[thunar-window.c]"]
  node_views["Folder views"]
  node_navigation["Navigation panes<br/>[thunar-browser.c]"]
end

subgraph group_files["Files and operations"]
  node_filemodel["File metadata<br/>[thunar-file.h]"]
  node_clipboard["Clipboard transfer"]
  node_actions["File actions"]
  node_jobs["File operation jobs<br/>[thunar-io-jobs.c]"]
end

subgraph group_extensions["Extensions and actions"]
  node_extensionapi["Plugin interfaces<br/>[thunarx.h]"]
  node_customactions["Custom actions"]
  node_properties["Property pages"]
  node_wallpaper["Wallpaper action<br/>[twp-provider.c]"]
end

subgraph group_rename["Bulk renaming"]
  node_renamer["Renamer interface<br/>[thunarx-renamer.c]"]
  node_renamers["Rename strategies"]
  node_renameui["Bulk rename dialog"]
end

node_user(("User"))

node_user -->|"starts"| node_entry
node_entry -->|"initializes"| node_application
node_application -->|"manages windows"| node_window
node_user -.->|"uses"| node_window
node_window -.->|"presents folders"| node_views
node_window -.->|"supports browsing"| node_navigation
node_views -.->|"displays metadata"| node_filemodel
node_actions -.->|"acts on files"| node_filemodel
node_actions -.->|"dispatches operations"| node_jobs
node_clipboard -->|"requests paste operation"| node_application
node_user -.->|"copies or pastes"| node_clipboard
node_extensionapi -.->|"provides extension API"| node_customactions
node_extensionapi -.->|"provides extension API"| node_properties
node_extensionapi -->|"provides extension API"| node_wallpaper
node_user -.->|"requests batch rename"| node_renamer
node_renamer -.->|"specialized by"| node_renamers
node_renameui -.->|"uses renamer API"| node_renamer

click node_entry "https://github.com/xfce-mirror/thunar/blob/master/thunar/main.c"
click node_application "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-application.c"
click node_window "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-window.c"
click node_views "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-standard-view.c"
click node_navigation "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-browser.c"
click node_filemodel "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-file.h"
click node_clipboard "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-clipboard-manager.c"
click node_actions "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-action-manager.c"
click node_jobs "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-io-jobs.c"
click node_extensionapi "https://github.com/xfce-mirror/thunar/blob/master/thunarx/thunarx.h"
click node_customactions "https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-uca/thunar-uca-provider.c"
click node_properties "https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-apr/thunar-apr-provider.c"
click node_wallpaper "https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-wallpaper/twp-provider.c"
click node_renamer "https://github.com/xfce-mirror/thunar/blob/master/thunarx/thunarx-renamer.c"
click node_renamers "https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-sbr/thunar-sbr-date-renamer.c"
click node_renameui "https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-renamer-dialog.c"

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_entry,node_application,node_window,node_views,node_navigation,node_user toneBlue
class node_filemodel,node_clipboard,node_actions,node_jobs toneAmber
class node_extensionapi,node_customactions,node_properties,node_wallpaper toneMint
class node_renamer,node_renamers,node_renameui toneRose
```

## Components

### Application and navigation

- [Application entry](https://github.com/xfce-mirror/thunar/blob/master/thunar/main.c): `thunar/main.c`
- [Application services](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-application.c): `thunar/thunar-application.c`
- [File manager window](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-window.c): `thunar/thunar-window.c`
- [Folder views](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-standard-view.c): `thunar/thunar-standard-view.c`
- [Navigation panes](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-browser.c): `thunar/thunar-browser.c`

### Files and operations

- [File metadata](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-file.h): `thunar/thunar-file.h`
- [Clipboard transfer](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-clipboard-manager.c): `thunar/thunar-clipboard-manager.c`
- [File actions](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-action-manager.c): `thunar/thunar-action-manager.c`
- [File operation jobs](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-io-jobs.c): `thunar/thunar-io-jobs.c`

### Extensions and actions

- [Plugin interfaces](https://github.com/xfce-mirror/thunar/blob/master/thunarx/thunarx.h): `thunarx/thunarx.h`
- [Custom actions](https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-uca/thunar-uca-provider.c): `plugins/thunar-uca/thunar-uca-provider.c`
- [Property pages](https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-apr/thunar-apr-provider.c): `plugins/thunar-apr/thunar-apr-provider.c`
- [Wallpaper action](https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-wallpaper/twp-provider.c): `plugins/thunar-wallpaper/twp-provider.c`

### Bulk renaming

- [Renamer interface](https://github.com/xfce-mirror/thunar/blob/master/thunarx/thunarx-renamer.c): `thunarx/thunarx-renamer.c`
- [Rename strategies](https://github.com/xfce-mirror/thunar/blob/master/plugins/thunar-sbr/thunar-sbr-date-renamer.c): `plugins/thunar-sbr/thunar-sbr-date-renamer.c`
- [Bulk rename dialog](https://github.com/xfce-mirror/thunar/blob/master/thunar/thunar-renamer-dialog.c): `thunar/thunar-renamer-dialog.c`

### Other components

- **User**

## Connections

- User → Application entry: starts
- Application entry → Application services: initializes (evidence: `thunar/main.c`)
- Application services → File manager window: manages windows
- User → File manager window: uses
- File manager window → Folder views: presents folders
- File manager window → Navigation panes: supports browsing
- Folder views → File metadata: displays metadata
- File actions → File metadata: acts on files
- File actions → File operation jobs: dispatches operations
- Clipboard transfer → Application services: requests paste operation (evidence: `thunar/thunar-clipboard-manager.c`)
- User → Clipboard transfer: copies or pastes
- Plugin interfaces → Custom actions: provides extension API
- Plugin interfaces → Property pages: provides extension API
- Plugin interfaces → Wallpaper action: provides extension API (evidence: `plugins/thunar-wallpaper/twp-provider.c`)
- User → Renamer interface: requests batch rename
- Renamer interface → Rename strategies: specialized by
- Bulk rename dialog → Renamer interface: uses renamer API
