1# QDirStat Screenshots
2
3Qt-based directory statistics: KDirStat without any KDE -- from the original KDirStat author.
4
5(c) 2015-2021 Stefan Hundhammer <Stefan.Hundhammer@gmx.de>
6
7Target Platforms: Linux, BSD, Unix-like systems
8
9License: GPL V2
10
11
12## QDirStat Main Window
13
14![Main Window Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-main-win.png)
15
16
17### Different Main Window Layouts
18
19![Layout 1 (short)](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-file-L1.png)
20_Layout 1 (short): Only the bare minimum of tree columns plus the details panel for the selected item._
21
22![Layout 2 (classic)](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-file-L2.png)
23_Layout 2 (classic): The classic QDirStat tree columns plus the details panel for the selected item._
24
25![Layout 3 (full)](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-file-L3.png)
26_Layout 3 (full): All tree columns including file owner, group and permissions in both "rwxrwxrwx" and octal,
27but no details panel to make room for all the columns._
28
29
30### Details Panel
31
32![Details Panel for a File](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-file-L2.png)
33
34_File selected. Notice the "Package" field: For system files, QDirStat queries
35the package manager (dpkg / rpm / pacman) which package the file belongs to._
36
37![Details Panel for a Directory](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-dir.png)
38
39_Directory selected_
40
41![Details Panel for a "Files" Pseudo Directory](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-dot-entry.png)
42
43_"Files" pseudo directory selected_
44
45![Details Panel for Multiple Selected Items](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-details-multi-sel.png)
46
47_Multi-selection_
48
49
50## Open Directory Dialog
51
52![Custom Open Directory Dialog Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-open-dir-dialog.png)
53
54_Custom "Open Directory" dialog with quick access to the home directory and to
55mounted filesystems. The "Cross Filesystems" check box here is a temporary
56override (just for this program run) of the configuration setting of the same
57name._
58
59
60## Output During Cleanup Actions
61
62![Cleanup Action Output Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-cleanup-output.png)
63
64_Screenshot of output during cleanup actions. Of course this window is purely optional._
65
66
67## Error Reporting
68
69![Reporting Directory Read Errors Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-err-dirs-light.png)
70
71_Reporting errors during directory reading. Typically this is because of
72missing permissions, so it may or may not be important to the user. Those
73errors are reported in small panels at the bottom of the directory tree
74widget. The user can leave them open or close them._
75
76![Details about Directory Read Errors](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-unreadable-dirs-window.png)
77
78_Clicking on the "Details..." link opens a separate window that lists all the
79directories that could not be read. This window is non-modal, i.e. the user can
80interact with the main window while it is open. A click on any directory in
81that list locates that directory in the main window, i.e. opens all parent
82branches and scrolls to ensure that directory is visible._
83
84
85## Mounted Filesystems Window
86
87![Custom Open Directory Dialog Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-filesystems-window.png)
88
89_This window (opened from the menu with View -> Show Mounted Filesystems) shows
90the currently mounted filesystems. It does not show system mounts like /dev,
91/proc, /sys, and also no bind mounts, no Btrfs subvolumes and no multiple
92mounts of the same filesystem._
93
94_The "Reserved" column shows the amount of disk space that is reserved for the
95root user; "Free" is what is available for non-privileged users._
96
97
98## File Type Statistics
99
100![File Type Statistics Window Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-file-type-stats.png)
101
102_Menu View -> File Type Statistics..._
103
104
105## Locating Files by Type
106
107![Locate Files Window](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-locate-file-types-window.png)
108
109_Results after clicking on the "Locate" button in the "File Type Statistics" window._
110
111![Locating Files](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-locating-file-types.png)
112
113_Locating files with a specific extension. That branch is automatically opened
114in the tree view in the main window, and all matching files in that directory are selected._
115
116
117## File Age Statistics
118
119![File Age Statistics: Years](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-file-age-years.png)
120
121_This window (opened fom the menu with View -> Show File Age Statistics) shows
122the modification time (mtime) of files (not directories) in the selected
123subtree broken down by years; i.e., it shows in what year the files were last
124modified._
125
126_For each year, it shows the number of files that were last modified in that
127year, the percent of that number relative to all files in that subtree both as
128a percentage bar and as a number, the total size of those files and the percent
129of that total size relative to the total size of that subtree, again as a
130percentage bar and as a number._
131
132
133![File Age Statistics: Years and Months](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-file-age-months.png)
134
135_File age statistics with the months of the current year expanded. It goes into
136finer detail for the months of the current year and the year before, i.e. the
137most recent 13-24 months. The percentages in the months are relative to that
138year, not to the complete subtree._
139
140_Notice that the months breakdown is always only displayed for the current year
141and the year before, no matter in what year any activity in that subtree
142starts._
143
144
145![File Age Statistics: Some Years Ago](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-file-age-long-ago.png)
146
147_File age statistics for a subtree where there was no activity at all for the
148last couple of years. Notice how the years up to that first active year are
149also displayed, but greyed out: You can instantly see that the last activity
150was some years ago, even without looking at the year numbers._
151
152
153## Discovering Files
154
155![Discovering Files](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-discover.png)
156
157_Discovering files of certain categories. Similar to "locating by type" above,
158clicking a file in the list selects it in the tree view in the main window._
159
160
161## Packages View
162
163![Packages View Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-pkg-details.png)
164
165_Packages view: All packages of a Xubuntu 18.04 LTS installation. Notice that
166each directory contains only the files that belong to that package: /usr/bin
167only contains the chromium-browser binary in this view._
168
169
170![Packages Summary Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-pkg-summary.png)
171
172_Packages Summary_
173
174
175![Packages View Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-pkg-emacs.png)
176
177_Packages view limited to package names starting with "emacs"._
178
179
180!["Open Packages" Dialog Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-open-pkg-dialog.png)
181
182_Dialog for selecting which packages to display. Use menu "File" -> "Show
183Installed Packages"._
184
185_To avoid the initial "Choose Directory" dialog, start QDirStat with the "-d"
186or "--dont-ask" command line parameter (or simply click "Cancel" in the "Choose
187Directory" dialog)._
188
189
190## Unpackaged Files View
191
192![Unpackaged Files Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-unpkg-usr-share-qt5.png)
193
194_Unpackaged files view: Some files that obviously belong to Qt 5 on openSUSE
195Tumbleweed, but that are not in the file list of any package. It is still
196possible that some post-uninstall script removes them, but it is also possible
197that they will be left behind when the packages are uninstalled._
198
199_Notice the greyed-out ignored directories which only contain files that are
200properly packaged._
201
202
203![Unpackaged Files Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-unpkg-boot-grub2.png)
204
205_Unpackaged files view: I created my own font for Grub2 which clearly stands out as an unpackaged file._
206
207
208!["Show Unpackaged Files" Dialog Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-show-unpkg-dialog.png)
209
210_Dialog to start the "unpackaged files" view (Menu "File" -> "Show Unpackaged
211Files"). Some directories are excluded by default because they are expected to
212contain a lot of unpackaged files. You can add more directories or remove
213predefined ones._
214
215_Since Python tends to leave behind so many unpackaged files, all `*.pyc` files
216are ignored by default. You can add more wildcard patterns to ignore or remove
217the predefined one._
218
219
220
221## Configuration
222
223
224![Cleanup Action Configuration Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-config-cleanups.png)
225
226_Screenshot of cleanup actions configuration._
227
228![MIME Categories Configuration Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-config-mime.png)
229
230_Screenshot of MIME category configuration where you can set the treemap colors
231for different file types (MIME types), complete with a real treemap widget as preview._
232
233![Exclude Rules Configuration Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-config-exclude.png)
234
235_Screenshot of the exclude rules configuration where you can define rules which
236directories to exclude when reading directory trees._
237
238![General Options Configuration Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-config-general.png)
239
240_Screenshot of the general (miscellaneous) configuration options._
241
242------------------
243
244![Tree Column Configuration Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-column-config.png)
245
246_Context menu of the tree header where you can configure the columns._
247
248
249-----------------
250
251## File Size Statistics
252
253
254![File Size Histogram Screenshot](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-histogram.png)
255
256_File size histogram for a directory_
257
258![Histogram with only JPGs](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-histogram-jpg-work.png)
259
260_File size histogram for all files of type .jpg (start from the File Type Statistics window)_
261
262![Histogram Options](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-histogram-options.png)
263
264_Histogram settings can be tweaked_
265
266![Logarithmic Scale](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-histogram-log-scale.png)
267
268_Logarithmic scale for the vertical axis if needed_
269
270
271![Histogram with P100](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-histogram-P100.png)
272
273_Degenerated histogram if the last percentiles are too far spread out_
274
275![Histogram with P99](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-histogram-P99.png)
276
277_Just one percentile less makes all the difference: Scaled down from P100 to P99_
278
279
280
281![Percentiles Table](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-percentiles-table.png)
282
283_Numeric percentiles table_
284
285
286![Full Percentiles Table](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-percentiles-table-full.png)
287
288_Full percentiles table_
289
290![Extreme Percentiles](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-percentiles-extreme.png)
291
292_Notice the leap from P99 to P100_
293
294
295
296![Buckets Table](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-buckets-table.png)
297
298_Buckets table (information also available by tooltips in the histogram)_
299
300
301![File Size Help](https://github.com/shundhammer/qdirstat/blob/master/screenshots/QDirStat-stats-help.png)
302
303_Dedicated help start page for file size statistics_
304
305
306--------------------
307
308## Navigation
309
310[Top: QDirStat home page](https://github.com/shundhammer/qdirstat)
311
312[Statistics help page](https://github.com/shundhammer/qdirstat/blob/master/doc/stats/Statistics.md)
313