Advanced configurations - QL-Win/QuickLook GitHub Wiki

Adding advanced configurations

  1. Quit QuickLook if it is running.
  2. Navigate to the data location.
  3. Open QuickLook.config with a text editor. If this file does not exist then run and quit QuickLook once.
    • If the file contains only one line, copy and paste the following to overwrite the content:
      <?xml version="1.0" encoding="utf-8"?>
      <Settings>
      </Settings>
      
  4. Add your desired config and save the file.
    • The final config should look like this (ShowTrayIcon and UseTransparency are just for example):
      <?xml version="1.0" encoding="utf-8"?>
      <Settings>
        <ShowTrayIcon>True</ShowTrayIcon>
        <UseTransparency>True</UseTransparency>
      </Settings>
      
  5. Run QuickLook again.

Show/hide the tray icon (since v3.6.10)

Default is True (show the icon).

  • To hide the icon, write: <ShowTrayIcon>False</ShowTrayIcon>.
  • To show the icon, write: <ShowTrayIcon>True</ShowTrayIcon> or delete the existing line.

Enable/disable window transparency (since v3.6.11-23)

Default is True (enable transparency).

  • To disable transparency, write: <UseTransparency>False</UseTransparency>.
  • To enable transparency, write: <UseTransparency>True</UseTransparency> or delete the existing line.

Enable/disable monitor color profile conversion (since v3.1.7-6)

Default is False (disable color profile conversion). Note that enabling this feature will slow down image previewing, especially on large images.

Open QuickLook.Plugin.ImageViewer.config with a text editor.

  • To disable conversion, write: <UseColorProfile>False</UseColorProfile> or delete the existing line.
  • To enable conversion, write: <UseColorProfile>True</UseColorProfile>.

Enable/disable modern messagebox (since v3.8.0)

Default is True (enable modern messagebox).

  • To disable the modern messagebox, write: <ModernMessageBox>False</ModernMessageBox>.
  • To enable the modern messagebox, write: <ModernMessageBox>True</ModernMessageBox> or delete the existing line.

Enable/disable dark theme in the Text editor (since v3.7.3)

Default is False (do not use the dark theme for the text viewer). Note that enabling this feature will invalidate all syntax highlighting themes, i.e., no syntax highlighting is available in the dark theme.

Open QuickLook.Plugin.TextViewer.config with a text editor.

  • To disable the dark theme, write: <AllowDarkTheme>False</AllowDarkTheme> or delete the existing line.
  • To enable the dark theme, write: <AllowDarkTheme>True</AllowDarkTheme>.
⚠️ **GitHub.com Fallback** ⚠️