https://github.com/iamogbz/macos-quick-look-plugin-adobe-xd
🧿 MacOS Quick Look Plugin for previewing Adobe XD files
https://github.com/iamogbz/macos-quick-look-plugin-adobe-xd
adobe-xd experience-designer finder-extension macos quick-look quicklook-plugin
Last synced: 8 months ago
JSON representation
🧿 MacOS Quick Look Plugin for previewing Adobe XD files
- Host: GitHub
- URL: https://github.com/iamogbz/macos-quick-look-plugin-adobe-xd
- Owner: iamogbz
- Created: 2022-02-10T13:49:20.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-07-07T15:46:04.000Z (over 2 years ago)
- Last Synced: 2025-02-26T18:11:33.572Z (8 months ago)
- Topics: adobe-xd, experience-designer, finder-extension, macos, quick-look, quicklook-plugin
- Language: C
- Homepage: https://ogbizi.com/macos-quick-look-plugin-adobe-xd/
- Size: 22.5 MB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AdobeXD MacOS Quick Look Plugin
[](https://github.com/iamogbz/macos-quick-look-plugin-adobe-xd/actions/workflows/xcode.yml)
Enables previews of XD files [(Adobe Experience Designer)][adobe-xd].
## Install
If you want to skip compilation and just install it, [download release][ql-xd-releases], unzip and copy `QuickLookXD.qlgenerator` to `~/Library/QuickLook/`. To reach that folder in Finder, go to your Home, click on the Go menu on the top bar, hold the Option key and `Library` will magically appear.
Or copy it from a terminal:
```sh
cp -R QuickLookXD.qlgenerator ~/Library/QuickLook/
```
### Caveats
The `QuickLookXD.qlgenerator` bundle is unsigned so you may need to de-quarantine it.
```sh
[~/Library/QuickLook/]$ xattr -r -d com.apple.quarantine QuickLookXD.qlgenerator
```
> You may need to use sudo for that command, depending on permissions.
>
> This bypasses Gatekeeper meaning that the signature isn't verified when run.
>
> Which removes an important safety feature, so only use with trusted apps.
You may need to restart finder or your system, but first refresh QuickLook plugin list.
```sh
$ qlmanage -r
qlmanage: resetting quicklookd
```
## Demo
![Image showing list of XD files with thumbnails and preview][screenshot01]
## Notes
How to find the UTI of a file:
```sh
$ mdls -name kMDItemContentType ./docs/example/file01.xd
kMDItemContentType = "com.adobe.xd.project"
```
Testing the generated quick look bundle:
```sh
$ qlmanage -g QuickLookXD.qlgenerator -c com.adobe.xd.project -p document.xd
Testing Quick Look preview with files:
/tmp/quicklookxd/document.xd
- force using content type UTI: com.adobe.xd.project
- force using generator at path: /tmp/quicklookxd/QuickLookXD.qlgenerator
```
Raise an issue or submit a PR to add more supported UTIs or fix bugs identified.
### References
* [QuickLookASE][ql-ase]
* [QL plugin discussion][ql-win-issue]
* [XD format reference][xd-format-reference]
* [Force open unsigned apps][force-open-unsigned-app]
[adobe-xd]: https://www.adobe.com/ca/products/xd.html
[force-open-unsigned-app]: https://apple.stackexchange.com/a/240610/280393
[ql-ase]: https://github.com/rsodre/QuickLookASE
[ql-win-issue]: https://github.com/QL-Win/QuickLook/issues/307#issuecomment-1473989813
[ql-xd-releases]: https://github.com/iamogbz/macos-quick-look-plugin-adobe-xd/releases
[screenshot01]: https://raw.githubusercontent.com/iamogbz/macos-quick-look-plugin-adobe-xd/main/docs/example/screenshot01.png
[xd-format-reference]: https://docs.fileformat.com/web/xd