{"id":51159645,"url":"https://github.com/marcoduering/miq","last_synced_at":"2026-06-26T13:00:36.511Z","repository":{"id":357655908,"uuid":"1227975955","full_name":"marcoduering/MIQ","owner":"marcoduering","description":"Medical Image QuickLook — Modern, interactive macOS Quick Look extension for medical images in NIfTI, FreeSurfer mgh, MRtrix mif, and NRRD format.","archived":false,"fork":false,"pushed_at":"2026-06-13T19:47:43.000Z","size":2323,"stargazers_count":72,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-06-13T20:25:10.597Z","etag":null,"topics":["imaging","macos","mgh-images","mif-images","neuroimaging","nifti-1","nifti-2","nifti-images","nrrd","quicklook","quicklook-extension","quicklook-plugin"],"latest_commit_sha":null,"homepage":"https://miq.marco-duering.net/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marcoduering.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"marcoduering"}},"created_at":"2026-05-03T12:28:48.000Z","updated_at":"2026-06-13T19:47:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/marcoduering/MIQ","commit_stats":null,"previous_names":["marcoduering/miq"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/marcoduering/MIQ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcoduering%2FMIQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcoduering%2FMIQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcoduering%2FMIQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcoduering%2FMIQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcoduering","download_url":"https://codeload.github.com/marcoduering/MIQ/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcoduering%2FMIQ/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34817641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["imaging","macos","mgh-images","mif-images","neuroimaging","nifti-1","nifti-2","nifti-images","nrrd","quicklook","quicklook-extension","quicklook-plugin"],"created_at":"2026-06-26T13:00:21.103Z","updated_at":"2026-06-26T13:00:36.412Z","avatar_url":"https://github.com/marcoduering.png","language":"Swift","funding_links":["https://github.com/sponsors/marcoduering"],"categories":[],"sub_categories":[],"readme":"# MIQ — Medical Image Quick Look\n\nMIQ is a lightweight **macOS QuickLook extension** for medical volume images. Press **Space** on a supported file in Finder to instantly get an **interactive orthogonal slice view** alongside a metadata panel:\n\n\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_screenshot_dark.webp\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_screenshot.webp\" width=\"65%\"\u003e\n  \u003c/picture\u003e\n\u003c/div\u003e\n\n**See it in action** in the short video at the bottom of this page.\n\n## Supported Formats\n\n- :white_check_mark: **NIfTI-1 \u0026 NIfTI-2** — `.nii`, `.nii.gz`\n- :white_check_mark: **FreeSurfer** — `.mgh`, `.mgz`, `.mgh.gz`\n- :white_check_mark: **MRtrix** — `.mif`, `.mif.gz`\n- :eight_spoked_asterisk: **NRRD** — `.nrrd` *(experimental, and only the single-file variant with attached header)*\n\nAll formats are supported uncompressed and gzip-compressed. The extension relies on the file extension to determine the format, so it is **important that files have the correct extensions**.\n\n## Installation \u0026 Updates\n\nThe app and extension can be installed manually or via the package manager [Homebrew](https://brew.sh).\n\n\u003e The app is a universal binary for Apple Silicon (arm64) and Intel (x86_64) Macs and has been tested on macOS 14 (Sonoma), 15 (Sequoia), and 26 (Tahoe).\n\n### Manual installation\n\n1. 👉 **[Download the latest release (MIQ.app.zip)](https://github.com/marcoduering/MIQ/releases/latest/download/MIQ.app.zip)**\n[![Latest Release](https://img.shields.io/github/v/release/marcoduering/MIQ)](https://github.com/marcoduering/MIQ/releases/latest/download/MIQ.app.zip)\n2. Unzip and move **`MIQ.app`** to your **`/Applications`** folder.\n3. **Open `MIQ.app`** at least once to register the Quick Look extension.\n4. Press **Space** on any supported file in Finder.\n5. Optional: **Customize the preview** in the MIQ app.\n\n#### Manual update\n\n\"MIQ checks for updates, open the app occasionally to see update alerts. When a new version is available, download it and replace MIQ.app in /Applications manually.\"\n\n### Installation via Homebrew\n\n1. Install on the command line:\n\n```bash\nbrew tap marcoduering/miq\nbrew trust --cask marcoduering/miq/miq\nbrew install --cask miq\n```\n2. **Open `MIQ.app`** (in `/Applications`) at least once to register the Quick Look extension.\n3. Press **Space** on any supported file in Finder.\n4. Optional: **Customize the preview** in the MIQ app.\n\n#### Updating via Homebrew\n\n```bash\nbrew update\nbrew upgrade --cask miq\n```\n\n## Usage\n\nMIQ is a lightweight convenience tool for quickly inspecting medical image files directly from the Finder. It prioritizes speed and ease of use over advanced visualization, and is not meant to replace dedicated medical image viewers.\n\nIn addition to the image preview (spacebar), you can also enable **thumbnail generation** in the app so that the file icon in Finder shows an image slice.\n\n### Customization\n\nUse the settings (main app) to tailor the preview and thumbnails to your needs. Adjust render orientation (see explanation below), intensity scaling, label colors and the metadata panel (content and order of the items).\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings1.webp\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings1_dark.webp\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings1.webp\" width=\"32%\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings2.webp\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings2_dark.webp\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings2.webp\" width=\"32%\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings3.webp\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings3_dark.webp\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/marcoduering/MIQ/main/docs/MIQ_settings3.webp\" width=\"32%\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n### Orientation\n\nBy default, MIQ displays data **as stored on disk**, without reorienting. Depending on acquisition and processing, images may appear upside down, mirrored, or rotated. This is by design. It lets you quickly inspect the raw data including its orientation. If desired, there are settings to reorient to **Neurological view** or **Radiological view**. In both reoriented conventions, sagittal displays patient anterior on the viewer's left.\n\n### Interaction\n\nSee the **Usage** panel in the main app to learn how to control the interactive 4D view. Since version 0.5.0 MIQ supports previewing 4D data.\n\n### Performance\n\nLocal uncompressed files are memory-mapped and load instantly. Compressed NIfTI (`.nii.gz`) is partially decompressed and loads quickly. For files on a network volume, MIQ reads only the first volume of a NIfTI from disk for the preview (the rest loads on demand when you scroll into 4D), so previews stay fast even over a slow connection. Very large `.mgz` or `.mif.gz` files may take a few seconds to load.\n\n## Troubleshooting\n\n### Conflicts with Other Quick Look Extensions\n\nmacOS assigns Quick Look to file types based on their file name extensions. MIQ must claim `.gz` broadly to handle `.nii.gz` and `.mif.gz` files. This can interfere with other Quick Look extensions that also manage `.gz` files (for example, extensions for compressed archives or source code).  \nThe most recently installed Quick Look extension should have priority, but this does not work consistently. You might need to deactivate another extension to reliably open gzip-compressed files with MIQ. This is a known limitation of how macOS Quick Look handles compound extensions like `.nii.gz`.\n\n## Active Development\n\nThe extension is still in development. It was created with the support of AI coding agents. Please report any issues or feature suggestions using [**GitHub Issues**](https://github.com/marcoduering/MIQ/issues). If you would like to contribute, see [CONTRIBUTING.md](./CONTRIBUTING.md) or feel free to reach out.\n\nMIQ is free and open source. If it's useful to you and you'd like to support its development, you can [**sponsor the project**](https://github.com/sponsors/marcoduering). Entirely optional, always appreciated.\n\n## Disclaimer \u0026 License\n\nMIQ is provided \"as is\" under [MIT License](./LICENSE), without warranty of any kind, express or implied. The authors and contributors accept no liability whatsoever for any direct, indirect, incidental, special, or consequential damages arising from the use or inability to use this software, including but not limited to data loss, incorrect image rendering, or any decisions made on the basis of previews generated by this tool.\n\n\u003e [!CAUTION]\n\u003e This software is **\u003cins\u003enot\u003c/ins\u003e a medical device and is \u003cins\u003enot\u003c/ins\u003e intended for diagnostic use**. It is a developer and researcher convenience tool only. Do not use it to make clinical decisions.\n\n## See it in action\n\n\u003cdiv align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/3058f94e-4ffa-4c0a-a1b8-d1578de0f651\" width=\"600\"\u003e\u003c/video\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcoduering%2Fmiq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcoduering%2Fmiq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcoduering%2Fmiq/lists"}