{"id":15723969,"url":"https://github.com/leiless/quicklook_plugin","last_synced_at":"2025-03-13T00:31:23.454Z","repository":{"id":140255208,"uuid":"166055912","full_name":"leiless/quicklook_plugin","owner":"leiless","description":"Makefile of a barebone Quick Look plugin","archived":false,"fork":false,"pushed_at":"2019-02-24T16:01:17.000Z","size":59,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-06T01:40:14.687Z","etag":null,"topics":["quicklook","quicklook-bundle","quicklook-plugin"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leiless.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-16T14:42:09.000Z","updated_at":"2024-05-27T02:56:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"91364148-6fe0-405a-bfc8-927eb1819d6c","html_url":"https://github.com/leiless/quicklook_plugin","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leiless%2Fquicklook_plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leiless%2Fquicklook_plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leiless%2Fquicklook_plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leiless%2Fquicklook_plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leiless","download_url":"https://codeload.github.com/leiless/quicklook_plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243318767,"owners_count":20272136,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["quicklook","quicklook-bundle","quicklook-plugin"],"created_at":"2024-10-03T22:13:59.372Z","updated_at":"2025-03-13T00:31:23.436Z","avatar_url":"https://github.com/leiless.png","language":"C","readme":"## *ExampleQL* - Makefile for macOS Quick Look plugin\n\n*ExampleQL* is a Makefile for a barebone Quick Look plugin, without Xcode project intervention.\n\nTheoretically, this plugin can be run in macOS \u003e= 10.5, yet only tested in macOS [10.10, 10.14]\nIf you tested it under macOS 10.10, please let me know.\n\n\u003cbr\u003e\n\n### Mandatory variables\n\nYou must define at least following Makefile variables in ```Makefile.inc```\n\n```\nPLUGIN_NAME\n\nPLUGIN_VERSION\n\nPLUGIN_BUILD\n\n# Reversed domain  Example: com.example\nBUNDLE_DOMAIN\n\n# Supported UTI types to generate preview/thumbnail\nPLUGIN_SUPPORTED_UTI\n```\n\n### Optional variables\n\nYou may alternatively specify following variables(default value will be used if not specified)\n\n```\n# Plugin bundle identifier\nPLUGIN_BID\n\n# Supported architectures\nARCHFLAGS\n\n# Quick Look installation prefix\nPREFIX\n\n# macOS SDK root path\nSDKROOT\n\n# Minimal supported macOS version(should \u003e= 10.5)\nMACOSX_VERSION_MIN\n\n# Copyright string embedded in Info.plist\nCOPYRIGHT\n\n# Code signature identity\nSIGNCERT\n```\n\nFor a full list of optional variables, please check `Makefile`\n\n### Compile \u0026 load\n\n```\n# Use `release' target for release build; default is `debug'\nmake\n\nmkdir -p ~/Library/QuickLook\ncp -r ExampleQL.qlgenerator ~/Library/QuickLook\n\n# Reset Quick Look Server\nqlmanage -r cache\nqlmanage -r\n\n# Check if this Quick Look loaded\nqlmanage -m plugins | grep ExampleQL\n```\n\nIn side `Finder`, open a directory with supported-UTI files, so your  Quick Look plugin can be invoked to generate thumbnail/preview.\n\nAlternatively, you can use [qlmanage(1)](x-man-page://1/qlmanage) command line utility to generate thumbnail/preview manually.\n\n### Debugging \u0026 test\n\n```\n# for macOS \u003e= 10.13\nlog stream --style compact --predicate 'process == \"QuickLookSatellite\" AND eventMessage CONTAINS \"ExampleQL\"' --color=auto\n\n# for macOS \u003e= 10.12\nlog stream --style compact --predicate 'process == \"QuickLookSatellite\" AND eventMessage CONTAINS \"ExampleQL\"'\n\n# for macOS \u003c 10.12\nsyslog -w 0 -k Sender QuickLookSatellite -k Message S ExampleQL\n```\n\nPlease check [Debugging and Testing a Generator](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/Quicklook_Programming_Guide/Articles/QLDebugTest.html) for a comprehensive debugging tips.\n\n### Install/uninstall\n\n```\n# Install/uninstall Quick Look plugin for current user\nmake install\nmake uninstall\n\n# Install/uninstall Quick Look plugin for all users\nPREFIX=/Library/QuickLook sudo make install\nPREFIX=/Library/QuickLook sudo make uninstall\n```\n\n### Caveats\n\n* This Quick Look plugin was written in Objective-C \u0026 C.\n\n* `main.c` contains the generic CFPlug-in code necessary for a Quick Look generator to use, don't touch it.\n\n* Mojave(10.14) is the last macOS release to support 32-bit apps, Apple LLVM 10.0.0 and above don't support `i386` architecture, thus you should eliminate `-arch i386` in `ARCHFLAGS` for 10.14 and above.\n\n  Apple LLVM 10.0.0 and above drop library linkage with `gcc_s.10.5`(need confirmation), you should specify `MACOSX_VERSION_MIN=10.6` before make(or declare it in `Makefile.inc`)\n\n  ```shell\n  # Make example for macOS 10.14 Mojave and above\n  MACOSX_VERSION_MIN=10.6 ARCHFLAGS=\"-arch x86_64\" make [release]\n  ```\n\n\u003cbr\u003e\n\n### *References*\n\n[Introduction to Quick Look Programming Guide](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/Quicklook_Programming_Guide/Introduction/Introduction.html)\n\n[sindresorhus/quick-look-plugins](https://github.com/sindresorhus/quick-look-plugins)\n\n[phracker/MacOSX-SDKs](https://github.com/phracker/MacOSX-SDKs)\n\n[QuickLook Plugins List](http://www.quicklookplugins.com)\n\n---\n\n*Created 190121+0800*\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleiless%2Fquicklook_plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleiless%2Fquicklook_plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleiless%2Fquicklook_plugin/lists"}