') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - pinebit/monoko: A fast, native image viewer for macOS, built for Apple Silicon. · GitHub
Skip to content
BranchesTags

Repository files navigation

Monoko

A fast, native image viewer for macOS, built for Apple Silicon.

Monoko is designed for quickly opening, reviewing, and adjusting images without the weight of a full photo editor. It uses Metal for rendering, Apple ImageIO for broad format support, and a minimal interface that stays out of the way until you need it.

Why Monoko

  • Instant image review — open an image and move through the folder with the arrow keys.
  • Native Metal rendering — smooth zooming and panning on Apple Silicon Macs.
  • RAW-friendly workflow — supports system RAW codecs and shows embedded previews while full-resolution images load.
  • Useful adjustments, not clutter — exposure, contrast, vibrance, sharpness, auto tone, rotation, and mirror.
  • Real image metadata — inspect camera, lens, exposure, GPS, color space, and pixel dimensions.
  • Made for focus — no library import, no account, no timeline, no extra workflow.

Supported Formats

Monoko uses Apple ImageIO, so it supports the image formats available on your macOS system, including JPEG, PNG, HEIC/HEIF, TIFF, GIF, BMP, WebP, ICNS/ICO, and RAW formats such as DNG, CR2, NEF, ARW, RW2, and more through Apple's system RAW codecs.

Getting Started

Open an image with Monoko from Finder:

  1. Right-click an image.
  2. Choose Open With -> Monoko.
  3. Optionally set Monoko as the default image viewer.

You can also launch it from Terminal:

open Monoko.app --args /path/to/image

Or run the app executable directly:

Monoko.app/Contents/MacOS/Monoko /path/to/image

Controls

InputAction
ScrollZoom at cursor
Double-clickToggle fit / actual pixels
DragPan
← / →Previous / next image in folder
0Fit to window
1Actual pixels
2 - 9Zoom to 2:1 ... 9:1
Tab or ⌘AToggle Adjustments
⌘IToggle Image Info
EscExit fullscreen or fit to window
⌃⌘FToggle fullscreen
⌘QQuit

Adjustments

Open the Adjustments panel with Tab or ⌘A.

Monoko includes lightweight, non-destructive session adjustments:

  • Exposure
  • Contrast
  • Color / vibrance
  • Sharpness
  • Auto tone
  • Rotate left / right
  • Mirror
  • Reset

Adjustments are remembered while you browse during the current session.

Image Info

Open Image Info with ⌘I to inspect metadata such as:

  • Camera make and model
  • Lens
  • Date and time
  • Shutter speed, aperture, ISO, focal length
  • GPS coordinates
  • Color model and bit depth
  • Pixel dimensions

Build From Source

Requirements:

  • macOS
  • Xcode command-line tools
  • Metal Toolchain component
  • Git submodules

Install prerequisites:

xcode-select --install
xcodebuild -downloadComponent MetalToolchain

Clone and build:

git clone --recurse-submodules git@github.com:pinebit/monoko.git
cd monoko
make

Useful commands:

make # build Monoko.app
make run # build and launch
make clean # remove build output

Technology

Monoko is intentionally small and native:

  • Metal / MetalKit for rendering
  • ImageIO for image decoding and metadata
  • Cocoa for macOS integration
  • Dear ImGui for lightweight panels

License

MIT. See LICENSE.

About

A fast, native image viewer for macOS, built for Apple Silicon.

Topics

gpumacosmetalviewer

Resources

Readme
MIT license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages