{"id":13686348,"url":"https://github.com/wkjarosz/hdrview","last_synced_at":"2026-01-04T23:15:33.156Z","repository":{"id":44549384,"uuid":"360719653","full_name":"wkjarosz/hdrview","owner":"wkjarosz","description":"A simple research-oriented image viewer with an emphasis on examining and comparing high-dynamic range (HDR) images, and including minimalistic editing and tonemapping capabilities.","archived":false,"fork":false,"pushed_at":"2024-04-05T03:47:53.000Z","size":45188,"stargazers_count":284,"open_issues_count":26,"forks_count":11,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-03T15:05:15.797Z","etag":null,"topics":["comparison-tool","exr","hdr","hdr-images","high-dynamic-range","image","image-processing","macos","openexr","pfm"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wkjarosz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2021-04-23T00:40:35.000Z","updated_at":"2024-07-23T22:27:12.000Z","dependencies_parsed_at":"2023-02-13T00:15:54.564Z","dependency_job_id":"ee1745c1-62ab-47b0-9fb1-74cd9c6dc491","html_url":"https://github.com/wkjarosz/hdrview","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wkjarosz%2Fhdrview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wkjarosz%2Fhdrview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wkjarosz%2Fhdrview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wkjarosz%2Fhdrview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wkjarosz","download_url":"https://codeload.github.com/wkjarosz/hdrview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224250215,"owners_count":17280522,"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":["comparison-tool","exr","hdr","hdr-images","high-dynamic-range","image","image-processing","macos","openexr","pfm"],"created_at":"2024-08-02T15:00:30.307Z","updated_at":"2026-01-04T23:15:33.114Z","avatar_url":"https://github.com/wkjarosz.png","language":"C++","funding_links":[],"categories":["Texture","C++"],"sub_categories":[],"readme":"# HDRView\n\nMaster branch:\n[![macOS build](https://github.com/wkjarosz/hdrview/actions/workflows/ci-mac.yml/badge.svg?branch=master)](https://github.com/wkjarosz/hdrview/actions/workflows/ci-mac.yml)\n[![Linux build](https://github.com/wkjarosz/hdrview/actions/workflows/ci-linux.yml/badge.svg?branch=master)](https://github.com/wkjarosz/hdrview/actions/workflows/ci-linux.yml)\n[![Windows build](https://github.com/wkjarosz/hdrview/actions/workflows/ci-windows.yml/badge.svg?branch=master)](https://github.com/wkjarosz/hdrview/actions/workflows/ci-windows.yml)\n\nHDRView is a simple research-oriented high-dynamic range image viewer with an emphasis on examining and comparing images. HDRView currently supports reading (EXR, HDR, PFM, and Ultra HDR JPEG) and writing (EXR, HDR, PFM) several HDR image formats, as well as reading (PNG, TGA, BMP, JPG, GIF, PNM, and PSD) and writing (PNG, TGA, PPM, PFM, and BMP) standard LDR images.\n\nHDRView can display images in true HDR on Apple extended dynamic range (EDR) and 10-bit displays.\n\nHDRView runs on macOS, Linux, Windows, and directly in your browser -- just go to [wkjarosz.github.io/hdrview/](https://wkjarosz.github.io/hdrview/) for the latest release version and [wkjarosz.github.io/hdrview/dev](https://wkjarosz.github.io/hdrview/dev) for the development version. This even works on an iPhone or iPad! Try it out.\n\n## Example screenshots\nHere's a screenshot of HDRView viewing a JPEG on macOS:\n![Screenshot](resources/screenshot-mac.png \"Screenshot macOS\")\n\nOr, running on an iPad as a webapp, viewing a luminance-chroma EXR image stored using XYZ primaries with chroma subsampling:\n![Screenshot](resources/screenshot-ipad.jpg \"Screenshot iPad\")\n\nWhen sufficiently zoomed in, HDRView can overlay the pixel grid and numeric color values on each pixel to facilitate inspection:\n![Screenshot](resources/screenshot-zoomed.png \"Screenshot Zoomed-in\")\n\nHDRView features extensive keyboard shortcuts, and pressing `Cmd+Shift+P` brings up a VS Code/Atom/Sublime Text-style command palette allowing you to find any command with keyboard-based fuzzy searching:\n![Screenshot](resources/screenshot-command-palette.png \"Screenshot of command palette\")\n\nHDRView supports the extended dynamic range (XDR, 30 bit) capabilities of recent Macs, allowing it to use finer precision (reducing banding) and brighter whites (reducing clipping) when displaying HDR images.\n\nWhen displaying images on a standard dynamic range (SDR, 24 bit) display (or saving to an LDR file format), HDRView uses blue-noise dithering:\n![Screenshot](resources/screenshot-dithered.png \"Screenshot dithering on\")\n\nThis reduces apparent banding artifacts in smooth gradients compared to naively displaying HDR images on such displays:\n![Screenshot](resources/screenshot-no-dither.png \"Screenshot dithering off\")\n\n\n## Obtaining/running HDRView\n\nIf you are running a recent version of macOS or Windows, you can download the pre-built binary installer DMG or zip file from the [releases page](https://github.com/wkjarosz/hdrview/releases). For Linux, you will need to build HDRView from source for now. Or, just run the [web app version](https://wkjarosz.github.io/hdrview/) directly in your browser.\n\n## Compiling\n\nCompiling from scratch requires CMake and a recent version of the XCode build tools on macOS, Visual Studio on Windows, and GCC on Linux.\n\nCompiling should be as simple as:\n```bash\n1 ~ % git clone https://github.com/wkjarosz/hdrview.git\n2 ~ % cd hdrview\n3 ~ % mkdir build\n4 ~ % cmake -B build\n5 ~ % cmake --build build/ --parallel 4\n```\n\nOn macOS and Linux you can add `-G Ninja` to line 4 (on Windows Ninja fails to build the OpenEXR dependency).\n\nTo support Ultra HDR JPEG images, you will either need to have the dependencies for `libultrahdr` (namely `libjpeg-turbo`) installed, or pass the option `-DUHDR_BUILD_DEPS=ON` in line 4.\n\nAlternatively, you should be able to do all this via VS Code if you have the CMake extension set up properly.\n\nOr, you can start via ``cmake-gui`` if you prefer. Run ``Configure`` and select your desired build system. Then click ``Generate``. Then open the solution/project/makefile in your IDE of choice.\n\n## Installation\nOn macOS you can just copy the `HDRView.app` bundle to your `/Applications` folder. \n\nOn Windows you'll need to copy `HDRView.exe` together with the accompanying `assets` folder to your desired installation location.\n\nRecent version of macOS will complain that the app is unsigned and from an unknown developer. You will need to go to the Security and Privacy part of system Settings to allow the app to run.\n\n## Running from the terminal\n\nYou can also run HDRView from the terminal. Run ``HDRView --help`` to see the command-line options. On macOS the executable is stored within the app bundle in `HDRView.app/Contents/MacOS/HDRView`. You might want to add it, or a symlink, to your path.\n\n## License\n\nCopyright (c) Wojciech Jarosz\n\n3-clause BSD. For details, see the ``LICENSE.txt`` file.\n\nHDRView builds on a number libraries. See the details in the Credits tab of the About dialog.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwkjarosz%2Fhdrview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwkjarosz%2Fhdrview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwkjarosz%2Fhdrview/lists"}