Quicklook extension for source files
This application offers a quicklook extension for MacOS 10.15 Catalina for previewing source files.
Inside it uses Highlight to render source code with syntax highlighting.
The application is distributed with a version of the
highlight. If you want you can use a different version customizing the preferences.
MacOS 10.15 Catalina has deprecated the qlgenerator APIs. Moreover a .qlgenerator package inside Library/QuickLook must be notarized on 10.15.0 to works. In version 10.15.1 it seems that notarization is no longer required.
This project consists of these components:
- a standalone app that can view source files and provide the interface for the preferences;
- a quicklook system extension to preview the source files;
- an XPC service that generate the preview of source file and pass the formatted data to the app or the quicklook extension.
MacOS 10.15 Catalina require sandboxed extension that prevent the execution of external processes (like shell script). To work around this problem, it is possible to use an XPC service that may have different security policies than the application / extension that invokes it. In this case the XPC service is not sandboxed.
The XPC service is executed automatically when requested by the application or the quicklook extension. After closing the quicklook preview the process is automatically closed after some seconds releasing the resources.
The app and quicklook extension can preview files showing the formatted code as html, inside a WKWebView, or as rtf inside a NSTextView.
To use the quicklook preview you must launch the application at least once. In this way the quicklook extension will be discovered by the system. After the first execution, the quicklook extension will be available among those present in the System preferences/Extensions.
This extension don't provide a thumbnail service for the Finder icon.
SyntaxHighlight is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY.
File format management
The quicklook extension uses the Uniform Type Identifier (UTI) to handle the supported formats (and not simply the file name extension). Inside the definition on an UTI there are the list of extensions and mime type associated with it.
Some file types are directly associated to an UTI by the system. Other formats are registered by the owner application. In this way some extensions can be associated to multiple UTIs based on the applications currently installed.
For this reason, this application supports many UTIs even if they are apparently redundant.
Apparently the operating system does not allow to manage some file formats including (but not limited to) .xml, .plist, .html, .ts, .dart.
It's likely that I didn't associate all the possible extensions managed by
With the inquiry window you can see if a specific file type is handled by the quicklook extension and also if it is recognized by
On Terminal you can see the UTI of a file with this command:
$ mdls -name kMDItemContentType -name kMDItemContentTypeTree filename.ext
If you found an unhandled format please send me the output of above command.
Only the formats supported by
highlight can be managed by this application.
To view the info about
highlight with the supported file formats and extensions go to the menu
Syntax Highlight/About highlight…, or in the Preferences window click the i info button near the highlight popup button.
In the standalone app, with the preferences window you can customize the preview settings used by the plugin extension.
highlight features, such as theme, words wrap, line numbers and tabs, are managed through the preferences gui. It is also possible to choose a different theme when OS use light or dark style.
In addition to the global settings for all supported file formats, you can set specific settings for individual file formats.
In the file type Specific settings, there is a list of all file types supported by the quicklook extension. In this list the grayout items are those currently managed by others UTI. Clicking on the exclamation mark icon you will show which UTI is used for a given file extension.
The debug option on settings panel enable the creation of two files on your Desktop:
- colorize.log: log of the colorize operations
- colorize.[html|rtf] output of the syntax highlight
The settings are stored in
Custom themes and styles are saved in
~/Library/Application Support/Syntax Highlight.
The application has a gui theme editor accessible form menu
With this interface you can create a custom theme to use with highlight.
Standard themes provided by
highlight cannot be edited but can be duplicated and then customized.
Clicking on an element of the preview blinks the corresponding item in the editor and vice versa.
Customized themes are saved in
~/Library/Application Support/Syntax Highlight/Themes.
Note for download precompiled release
The precompiled app is not notarized or signed. When you download the precompiled app you must strip quarantine flag before execute:
$ xattr -r -d com.apple.quarantine "Syntax Highlight.app"
This must resolve the error of damage application when launch the app.
Note for developers
After cloning remember to fetch submodules:
$ git submodule init $ git submodule update
This application has originated from the anthonygelibert/QLColorCode.
Help us keep the lights on
1.0.b16 - Nov 29, 2019
- XPC service splitted into two services. One is used by the quicklook extension with only the code to read the current settings and format the preview. The second one has also the code to change the settings, inquiry the themes and all the requested features for the main application interface. I hope this change makes the quicklook extension more reactive and consume less resources.
- Rewrite the settings engine.
1.0.b15 - Nov 26, 2019
- Support for .h header files.
- Target to 10.15 (now the standard swift library is not embedded).
- New interactive preview setting to allow the execution of js code inside the quicklook preview.
- Removed markdown support in the quicklook extension.
- Fix little space for theme name on popover theme selector.
- Images of help files have been compressed.
- Added a margin aroud the preview on the quicklook window.
- Fast generation of theme icons.
1.0.b14 - Nov 25, 2019
- merge pull request https://github.com/sbarex/SourceCodeSyntaxHighlight/pull/18 (support for awk, bash, clojure, diff, haskell, lua, patch, rust, scala, text, zsh)
- added support for .r file format.
- Correction of many typos.
1.0.b13 - Nov 25, 2019
- Embedded highlight updated to 5.3.4.
- Info panel about highlight (from App menu and from a info butto on preferences window).
- Menu item inside app menu for open in the Finder the application support folder.
- Redesign of preferences window for the theme selection.
- GUI to view and edit the themes.
- Inside the application support folder are saved the custom css styles and customized themes.
- Now double click on the quicklook preview open the file.
- Bugfix on font preferences.
- System for purging and migrating old settings to new system.