ThunarPreferences: Thunar Internal Functions Reference Manual

## ThunarPreferences ThunarPreferences |

## Functions

ThunarPreferences * | thunar_preferences_get ()
void | thunar_preferences_xfconf_init_failed ()

## Properties

char * | default-view | Read / Write
GStrv | hidden-bookmarks | Read / Write
GStrv | hidden-devices | Read / Write
ThunarZoomLevel | last-compact-view-zoom-level | Read / Write
char * | last-details-view-column-order | Read / Write
char * | last-details-view-column-widths | Read / Write
gboolean | last-details-view-fixed-columns | Read / Write
char * | last-details-view-visible-columns | Read / Write
ThunarZoomLevel | last-details-view-zoom-level | Read / Write
int | last-focused-tab-left | Read / Write
int | last-focused-tab-right | Read / Write
ThunarZoomLevel | last-icon-view-zoom-level | Read / Write
gboolean | last-image-preview-visible | Read / Write
char * | last-location-bar | Read / Write
gboolean | last-menubar-visible | Read / Write
gboolean | last-restore-tabs | Read / Write
int | last-separator-position | Read / Write
gboolean | last-show-hidden | Read / Write
char * | last-side-pane | Read / Write
ThunarColumn | last-sort-column | Read / Write
GtkSortType | last-sort-order | Read / Write
int | last-splitview-separator-position | Read / Write
gboolean | last-statusbar-visible | Read / Write
GStrv | last-tabs-left | Read / Write
GStrv | last-tabs-right | Read / Write
char * | last-toolbar-item-order | Read / Write
char * | last-toolbar-visible-buttons | Read / Write
char * | last-view | Read / Write
int | last-window-height | Read / Write
gboolean | last-window-maximized | Read / Write
int | last-window-width | Read / Write
gboolean | misc-always-show-tabs | Read / Write
gboolean | misc-case-sensitive | Read / Write
gboolean | misc-change-window-icon | Read / Write
int | misc-compact-view-max-chars | Read / Write
gboolean | misc-confirm-close-multiple-tabs | Read / Write
char * | misc-date-custom-style | Read / Write
ThunarDateStyle | misc-date-style | Read / Write
gboolean | misc-directory-specific-settings | Read / Write
gboolean | misc-exec-shell-scripts-by-default | Read / Write
gboolean | misc-file-size-binary | Read / Write
ThunarFolderItemCount | misc-folder-item-count | Read / Write
gboolean | misc-folders-first | Read / Write
gboolean | misc-full-path-in-tab-title | Read / Write
gboolean | misc-full-path-in-window-title | Read / Write
gboolean | misc-highlighting-enabled | Read / Write
gboolean | misc-horizontal-wheel-navigates | Read / Write
ThunarImagePreviewMode | misc-image-preview-mode | Read / Write
gboolean | misc-image-size-in-statusbar | Read / Write
gboolean | misc-middle-click-in-tab | Read / Write
gboolean | misc-open-new-window-as-tab | Read / Write
gboolean | misc-open-new-windows-in-split-view | Read / Write
ThunarParallelCopyMode | misc-parallel-copy-mode | Read / Write
ThunarRecursivePermissions | misc-recursive-permissions | Read / Write
ThunarRecursiveSearch | misc-recursive-search | Read / Write
gboolean | misc-remember-geometry | Read / Write
gboolean | misc-show-about-templates | Read / Write
gboolean | misc-show-delete-action | Read / Write
gboolean | misc-single-click | Read / Write
guint | misc-single-click-timeout | Read / Write
gboolean | misc-small-toolbar-icons | Read / Write
guint | misc-status-bar-active-info | Read / Write
gboolean | misc-switch-to-new-tab | Read / Write
gboolean | misc-tab-close-middle-click | Read / Write
gboolean | misc-text-beside-icons | Read / Write
gboolean | misc-thumbnail-draw-frames | Read / Write
guint64 | misc-thumbnail-max-file-size | Read / Write
ThunarThumbnailMode | misc-thumbnail-mode | Read / Write
ThunarUsePartialMode | misc-transfer-use-partial | Read / Write
ThunarVerifyFileMode | misc-transfer-verify-file | Read / Write
int | misc-undo-redo-history-size | Read / Write
gboolean | misc-vertical-split-pane | Read / Write
gboolean | misc-volume-management | Read / Write
gboolean | shortcuts-icon-emblems | Read / Write
ThunarIconSize | shortcuts-icon-size | Read / Write
gboolean | tree-icon-emblems | Read / Write
ThunarIconSize | tree-icon-size | Read / Write

## Object Hierarchy

        GObject
        ╰── ThunarPreferences

## Description

## Functions

### thunar_preferences_get ()

    ThunarPreferences *
    thunar_preferences_get (void);

Queries the global ThunarPreferences instance, which is shared by all modules. The function automatically takes a reference for the caller, so you'll need to call `g_object_unref()` when you're done with it.

#### Returns

the global ThunarPreferences instance.

### thunar_preferences_xfconf_init_failed ()

    void
    thunar_preferences_xfconf_init_failed (void);

## Property Details

### The `“default-view”` property

      “default-view”             char *

The name of the widget class, which should be used for the view pane in new ThunarWindows or "void" to use the last selected view from the "last-view" preference.

Owner: ThunarPreferences

Flags: Read / Write

Default value: "void"

### The `“hidden-bookmarks”` property

      “hidden-bookmarks”         GStrv

List of URI's that are hidden in the bookmarks (obtained from ~/.gtk-bookmarks). If an URI is not in the bookmarks file it will be removed from this list.

Owner: ThunarPreferences

Flags: Read / Write

### The `“hidden-devices”` property

      “hidden-devices”           GStrv

List of hidden devices. The value could be an UUID or name. Visibility of the device can be obtained with `thunar_device_get_hidden()`.

Owner: ThunarPreferences

Flags: Read / Write

### The `“last-compact-view-zoom-level”` property

      “last-compact-view-zoom-level” ThunarZoomLevel

The last selected ThunarZoomLevel for the ThunarCompactView.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_ZOOM_LEVEL_25_PERCENT

### The `“last-details-view-column-order”` property

      “last-details-view-column-order” char *

The comma separated list of columns that specifies the order of the columns in the ThunarDetailsView.

Owner: ThunarPreferences

Flags: Read / Write

Default value: "THUNAR_COLUMN_NAME,THUNAR_COLUMN_SIZE,THUNAR_COLUMN_SIZE_IN_BYTES,THUNAR_COLUMN_TYPE,THUNAR_COLUMN_DATE_MODIFIED"

### The `“last-details-view-column-widths”` property

      “last-details-view-column-widths” char *

The comma separated list of column widths used for fixed width ThunarDetailsViews.

Owner: ThunarPreferences

Flags: Read / Write

Default value: ""

### The `“last-details-view-fixed-columns”` property

      “last-details-view-fixed-columns” gboolean

`TRUE` to use fixed column widths in the ThunarDetailsView. Else the column widths will be automatically determined from the model contents.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“last-details-view-visible-columns”` property

      “last-details-view-visible-columns” char *

The comma separated list of visible columns in the ThunarDetailsView.

Owner: ThunarPreferences

Flags: Read / Write

Default value: "THUNAR_COLUMN_DATE_MODIFIED,THUNAR_COLUMN_NAME,THUNAR_COLUMN_SIZE,THUNAR_COLUMN_TYPE"

### The `“last-details-view-zoom-level”` property

      “last-details-view-zoom-level” ThunarZoomLevel

The last selected ThunarZoomLevel for the ThunarDetailsView.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_ZOOM_LEVEL_38_PERCENT

### The `“last-focused-tab-left”` property

      “last-focused-tab-left”    int

The index (starting from 0) of the last focused tab in left split-view

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= 0

Default value: 0

### The `“last-focused-tab-right”` property

      “last-focused-tab-right”   int

The index (starting from 0) of the last focused tab in right split-view

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= 0

Default value: 0

### The `“last-icon-view-zoom-level”` property

      “last-icon-view-zoom-level” ThunarZoomLevel

The last selected ThunarZoomLevel for the ThunarIconView.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_ZOOM_LEVEL_100_PERCENT

### The `“last-image-preview-visible”` property

      “last-image-preview-visible” gboolean

Whether to display an image preview in new windows by default.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“last-location-bar”` property

      “last-location-bar”        char *

The name of the widget class, which should be used for the location bar in ThunarWindows or "void" to hide the location bar.

Owner: ThunarPreferences

Flags: Read / Write

Default value: "ThunarLocationEntry"

### The `“last-menubar-visible”` property

      “last-menubar-visible”     gboolean

Whether to display a menubar in new windows by default.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“last-restore-tabs”` property

      “last-restore-tabs”        gboolean

`TRUE` to restore the tabs as they were before closing Thunar.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“last-separator-position”` property

      “last-separator-position”  int

The last position of the gutter in the main window, which separates the side pane from the main view.

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= 0

Default value: 170

### The `“last-show-hidden”` property

      “last-show-hidden”         gboolean

Whether to show hidden files by default in new windows.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“last-side-pane”` property

      “last-side-pane”           char *

The name of the widget class, which should be used for the side pane in ThunarWindows or "void" to hide the side pane completely.

Owner: ThunarPreferences

Flags: Read / Write

Default value: "ThunarShortcutsPane"

### The `“last-sort-column”` property

      “last-sort-column”         ThunarColumn

The default sort column for new views.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_COLUMN_NAME

### The `“last-sort-order”` property

      “last-sort-order”          GtkSortType

The default sort order for new views.

Owner: ThunarPreferences

Flags: Read / Write

Default value: GTK_SORT_ASCENDING

### The `“last-splitview-separator-position”` property

      “last-splitview-separator-position” int

The last position of the gutter in the main window, which separates the notebooks in split-view.

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= 0

Default value: 0

### The `“last-statusbar-visible”` property

      “last-statusbar-visible”   gboolean

Whether to display a statusbar in new windows by default.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“last-tabs-left”` property

      “last-tabs-left”           GStrv

List of URI's that are used to reopen tabs on restart. There is one URI for each tab/folder that was open at the time of the last program exit. This preference holds the tabs of the default view (or the left split-view).

Owner: ThunarPreferences

Flags: Read / Write

### The `“last-tabs-right”` property

      “last-tabs-right”          GStrv

List of URI's that are used to reopen tabs on restart. There is one URI for each tab/folder that was open at the time of the last program exit. This preference holds the tabs of the right split-view.

Owner: ThunarPreferences

Flags: Read / Write

### The `“last-toolbar-item-order”` property

      “last-toolbar-item-order”  char *

Owner: ThunarPreferences

Flags: Read / Write

Default value: "0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16"

### The `“last-toolbar-visible-buttons”` property

      “last-toolbar-visible-buttons” char *

The comma separated list that specifies the visibility of toolbar items. The order of the default value corresponds to the order in which the buttons are added inside 'thunar_window_location_toolbar_create'

Owner: ThunarPreferences

Flags: Read / Write

Default value: "0,1,1,1,1,0,0,0,0,0,0,0,0,0,1,0,1"

### The `“last-view”` property

      “last-view”                char *

The name of the widget class, which should be used for the main view component in ThunarWindows.

Owner: ThunarPreferences

Flags: Read / Write

Default value: "ThunarIconView"

### The `“last-window-height”` property

      “last-window-height”       int

The last known height of a ThunarWindow, which will be used as default height for newly created windows.

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= 1

Default value: 480

### The `“last-window-maximized”` property

      “last-window-maximized”    gboolean

The last known maximized state of a ThunarWindow, which will be used as default width for newly created windows.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“last-window-width”` property

      “last-window-width”        int

The last known width of a ThunarWindow, which will be used as default width for newly created windows.

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= 1

Default value: 640

### The `“misc-always-show-tabs”` property

      “misc-always-show-tabs”    gboolean

If the view tabs should always be visible.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-case-sensitive”` property

      “misc-case-sensitive”      gboolean

Whether to use case-sensitive sort.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-change-window-icon”` property

      “misc-change-window-icon”  gboolean

Whether to change the window icon to the folder's icon.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-compact-view-max-chars”` property

      “misc-compact-view-max-chars” int

Owner: ThunarPreferences

Flags: Read / Write

Default value: 100

### The `“misc-confirm-close-multiple-tabs”` property

      “misc-confirm-close-multiple-tabs” gboolean

Ask the user for confirmation before closing a window with multiple tabs.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-date-custom-style”` property

      “misc-date-custom-style”   char *

If 'custom' is selected as date format, this date-style will be used

Owner: ThunarPreferences

Flags: Read / Write

Default value: "%Y-%m-%d %H:%M:%S"

### The `“misc-date-style”` property

      “misc-date-style”          ThunarDateStyle

The style used to display dates in the user interface.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_DATE_STYLE_SIMPLE

### The `“misc-directory-specific-settings”` property

      “misc-directory-specific-settings” gboolean

Whether to use directory specific settings.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-exec-shell-scripts-by-default”` property

      “misc-exec-shell-scripts-by-default” gboolean

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-file-size-binary”` property

      “misc-file-size-binary”    gboolean

Show file size in binary format instead of decimal.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-folder-item-count”` property

      “misc-folder-item-count”   ThunarFolderItemCount

Tells when the size column of folders should show the number of containing files

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_FOLDER_ITEM_COUNT_NEVER

### The `“misc-folders-first”` property

      “misc-folders-first”       gboolean

Whether to sort folders before files.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-full-path-in-tab-title”` property

      “misc-full-path-in-tab-title” gboolean

Show the full directory path in the tab title, instead of only the directory name.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-full-path-in-window-title”` property

      “misc-full-path-in-window-title” gboolean

Show the full directory path in the window title, instead of only the directory name.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-highlighting-enabled”` property

      “misc-highlighting-enabled” gboolean

If true file highlighting feature across the various views is enabled. Can be toggled using the View > Show File Highlight.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-horizontal-wheel-navigates”` property

      “misc-horizontal-wheel-navigates” gboolean

Whether the horizontal mouse wheel is used to navigate forth and back within a Thunar view.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-image-preview-mode”` property

      “misc-image-preview-mode”  ThunarImagePreviewMode

Whether the image preview functionality uses its own sidepane or is embedded in the left sidepane.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_IMAGE_PREVIEW_MODE_EMBEDDED

### The `“misc-image-size-in-statusbar”` property

      “misc-image-size-in-statusbar” gboolean

When a single image file is selected, show its size in the statusbar. This heavily increases I/O in image folders when moving the selection across files.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-middle-click-in-tab”` property

      “misc-middle-click-in-tab” gboolean

If middle click opens a folder in a new window (FALSE) or in a new window (TRUE);

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-open-new-window-as-tab”` property

      “misc-open-new-window-as-tab” gboolean

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-open-new-windows-in-split-view”` property

      “misc-open-new-windows-in-split-view” gboolean

If true, all thunar windows will have split view enabled.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-parallel-copy-mode”` property

      “misc-parallel-copy-mode”  ThunarParallelCopyMode

Do parallel copy (or not) on files copy.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_PARALLEL_COPY_MODE_ONLY_LOCAL

### The `“misc-recursive-permissions”` property

      “misc-recursive-permissions” ThunarRecursivePermissions

Whether to apply permissions recursively every time the permissions are altered by the user.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_RECURSIVE_PERMISSIONS_ASK

### The `“misc-recursive-search”` property

      “misc-recursive-search”    ThunarRecursiveSearch

Whether to search only in the current folder or recursively

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_RECURSIVE_SEARCH_ALWAYS

### The `“misc-remember-geometry”` property

      “misc-remember-geometry”   gboolean

Whether Thunar should remember the size of windows and apply that size to new windows. If `TRUE` the width and height are saved to "last-window-width" and "last-window-height". If `FALSE` the user may specify the start size in "last-window-with" and "last-window-height".

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-show-about-templates”` property

      “misc-show-about-templates” gboolean

Whether to display the "About Templates" dialog, when opening the Templates folder from the Go menu.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-show-delete-action”` property

      “misc-show-delete-action”  gboolean

Whether to display a "delete" action to permanently delete files and folders If trash is not supported, "delete" is displayed by default.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-single-click”` property

      “misc-single-click”        gboolean

Whether to use single click navigation.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-single-click-timeout”` property

      “misc-single-click-timeout” guint

If single-click mode is enabled this is the amount of time in milliseconds after which the item under the mouse cursor will be selected automatically. A value of `0` disables the automatic selection.

Owner: ThunarPreferences

Flags: Read / Write

Default value: 500

### The `“misc-small-toolbar-icons”` property

      “misc-small-toolbar-icons” gboolean

Use small icons on the toolbar instead of the default toolbar size.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-status-bar-active-info”` property

      “misc-status-bar-active-info” guint

What kind of info is presented in the statusbar..

Owner: ThunarPreferences

Flags: Read / Write

Default value: 15

### The `“misc-switch-to-new-tab”` property

      “misc-switch-to-new-tab”   gboolean

Whether to switch to the new tab after opening a folder in a new tab.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-tab-close-middle-click”` property

      “misc-tab-close-middle-click” gboolean

Whether to close tabs when the tab label is clicked with the 2nd mouse button.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“misc-text-beside-icons”` property

      “misc-text-beside-icons”   gboolean

Whether the icon view should display the file names beside the file icons instead of below the file icons.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-thumbnail-draw-frames”` property

      “misc-thumbnail-draw-frames” gboolean

Whether to draw black frames around thumbnails. This looks neat, but will delay the first draw a bit. May have an impact on older systems, on folders with many pictures.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-thumbnail-max-file-size”` property

      “misc-thumbnail-max-file-size” guint64

Maximum file size (in bytes) allowed to be thumbnailed. 0 means no limit is in place.

Owner: ThunarPreferences

Flags: Read / Write

Default value: 0

### The `“misc-thumbnail-mode”` property

      “misc-thumbnail-mode”      ThunarThumbnailMode

Whether to generate and display thumbnails for previewable files.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_THUMBNAIL_MODE_ONLY_LOCAL

### The `“misc-transfer-use-partial”` property

      “misc-transfer-use-partial” ThunarUsePartialMode

Whether to use intermediate file(*.partial~) to copy.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_USE_PARTIAL_MODE_NEVER

### The `“misc-transfer-verify-file”` property

      “misc-transfer-verify-file” ThunarVerifyFileMode

Whether to verify copied file with checksum.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_VERIFY_FILE_MODE_NEVER

### The `“misc-undo-redo-history-size”` property

      “misc-undo-redo-history-size” int

Maximum number of ThunarJobOperations which can be undone/redone -1 for unlimited

Owner: ThunarPreferences

Flags: Read / Write

Allowed values: >= -1

Default value: 10

### The `“misc-vertical-split-pane”` property

      “misc-vertical-split-pane” gboolean

If true, split the thunar window vertically instead of horizontally when splitting the thunar window into two panes.

Owner: ThunarPreferences

Flags: Read / Write

Default value: FALSE

### The `“misc-volume-management”` property

      “misc-volume-management”   gboolean

Whether to enable volume management capabilities (requires HAL and the thunar-volman package).

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“shortcuts-icon-emblems”` property

      “shortcuts-icon-emblems”   gboolean

Whether to display emblems for file icons (if defined) in the shortcuts side pane.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“shortcuts-icon-size”` property

      “shortcuts-icon-size”      ThunarIconSize

The icon size to use for the icons displayed in the shortcuts side pane.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_ICON_SIZE_24

### The `“tree-icon-emblems”` property

      “tree-icon-emblems”        gboolean

Whether to display emblems for file icons (if defined) in the tree side pane.

Owner: ThunarPreferences

Flags: Read / Write

Default value: TRUE

### The `“tree-icon-size”` property

      “tree-icon-size”           ThunarIconSize

The icon size to use for the icons displayed in the tree side pane.

Owner: ThunarPreferences

Flags: Read / Write

Default value: THUNAR_ICON_SIZE_16