# HDFView

A visual Java tool for browsing and editing HDF4 and HDF5 files.

> This is the Markdown version of the HDFView page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/hdfview>

- **Latest version**: `3.5.0`
- **Developer**: The HDF Group
- **Homepage**: <https://www.hdfgroup.org/download-hdfview/>
- **Categories**: [Data Analysis](https://opennavo.com/categories/data-analysis)
- **Install**: `brew install --cask hdfview`
- **30-day installs**: 47
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/HDFGroup/hdfview/releases/download/v3.5.0/HDFView-3.5.0App-Darwin-arm64.tar.gz>
- **SHA-256**: `3bf23866c99e9baf85b32e31fd89386a593ee782a5e5a4170162d266f83a2c1b`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "HDFView.app"
      ],
      "target": "/Applications/HDFView.app"
    },
    "phase": "install",
    "sources": [
      "HDFView.app"
    ],
    "target": "/Applications/HDFView.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.hdfview*",
            "~/Library/Preferences/hdf.view.plist",
            "~/Library/Preferences/HDFView.hdfgroup.org.plist",
            "~/Library/Saved Application State/hdf.view.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

HDFView is a visual Java application for exploring and editing files in the HDF4 and HDF5 formats. It presents a file’s hierarchy as a tree and uses the Java HDF Object Package to work with HDF data objects.

With HDFView, you can:
- Browse a file hierarchy in a tree view.
- Create HDF files, and add or delete groups and datasets.
- View and modify dataset contents.
- Add, delete, and modify attributes.

To install the macOS application with Homebrew, run `brew install --cask hdfview`. The cask installs `HDFView.app` in `/Applications`. Open the app and choose an HDF file to begin exploring it. The cask provides Apple silicon and Intel variants.

HDFView is a graphical application, not a command-line utility. Its documented file-format scope is HDF4 and HDF5.

Sources: [HDFView](https://www.hdfgroup.org/download-hdfview/) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/h/hdfview.rb)

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 3.5.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · Checked 2026-11-22
  - <https://github.com/HDFGroup/hdfview/releases/download/v3.5.0/HDFView-3.5.0App-Darwin-x86_64.tar.gz>
  - SHA-256: `e5b02e5af56b8d641722acab4ae258020877774a1ad6f914cfa6f439bc831815`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 3.5.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · Checked 2026-11-22
  - <https://github.com/HDFGroup/hdfview/releases/download/v3.5.0/HDFView-3.5.0App-Darwin-arm64.tar.gz>
  - SHA-256: `3bf23866c99e9baf85b32e31fd89386a593ee782a5e5a4170162d266f83a2c1b`

## Uninstall

- `brew uninstall --cask hdfview`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask hdfview`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.hdfview*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/hdf.view.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/HDFView.hdfgroup.org.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/hdf.view.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 99.99.99-prerelease (2024-06-20)

HDFView version 99.99.99

### 🔺 HDFView Changelog
All notable changes to this project will be documented in this file. This document describes the differences between this release and the previous HDFView release, platforms tested, and known problems in this release.

### 🔗 Quick Links
* [HDFView releases](https://github.com/HDFGroup/hdfview/releases)
* [HDFView source](https://github.com/HDFGroup/hdfview)
* [Getting help, questions, or comments](https://github.com/HDFGroup/hdfview/issues)

#### 📖 Contents
* [Executive Summary](#-executive-summary-hdfview-version-430)
* [New Features & Improvements](#-new-features--improvements)
* [Bug Fixes](#-bug-fixes)
* [Platforms Tested](#%EF%B8%8F-platforms-tested)
* [Known Problems](#-known-problems)

### 🔆 Executive Summary: HDFView Version 3.4.0

#### Enhanced Features:

* **Float16 Datatype Support**: Added comprehensive support for operating with float16 datatypes
* **Plugin Path Configuration**: New user option for editing the plugin path and managing plugins

#### Updated Foundation:

> [!IMPORTANT]
>
> - Built and tested with **HDF 4.3.X** and **HDF5 2.Y.Z**
> - Built and tested with **OpenJDK 21**
> - Uses Java modules for improved modularity
> - Utilizes newest `jpackage` for distribution

### 🚀 New Features & Improvements

#### Major Enhancements

* Build system converted to Maven

* **[GH #117](https://github.com/HDFGroup/hdfview/issues/117)** - Add User Option for editing the plugin path and include plugins
* **[GH #138](https://github.com/HDFGroup/hdfview/issues/138)** - Add Support for operating with float16 and complex datatypes

### 🪲 Bug Fixes

#### Major Bug Fixes

* **HDFVIEW-284** - Fixed crashes on NETCDF-4 grids

  The problem was that references in variable-length containers were handled like strings. Upon investigation, the problem found was that references in any container were handled like strings.

  The table display code for vlen references also changed to account for the changes which fixed the hdf5 Java API. The fix required that variable-length types in the Java wrappers in the hdf5 library for read and write also be fixed.

  Related work:
  - **HDFView-221** - Add support for true Variable-length types in Java
  - **HDFView-222** - Fixed the read/write support for variable-length in the Java wrappers. This fix involved handling the data object as a list of lists and using the datatype of the list.
  - **HDFView-222** - Fixed the object library to handle the List of Lists concept
  - **HDFView-223** - Updated the DataProviders, DataDisplayConverters and DataValidators to work with variable-length List of Lists

#### Minor Bug Fixes

* **[GH #171](https://github.com/HDFGroup/hdfview/issues/171)** - HDFView fails to find input files on command line when using relative paths

* **[GH #387](https://github.com/HDFGroup/hdfview/issues/387)** (checkHDF5Filters shows 'NONE') Replace corrupted tfilters.h5 test data file with correct version.

* **[GH #352](https://github.com/HDFGroup/hdfview/issues/352)** (isn't displaying attribute values correctly) Incorrectly using the array value as a character limit.

### ☑️ Platforms Tested

HDFView is tested on the following platforms:

* Linux (x86_64, aarch64)
* Windows
* macOS

Current test results and detailed platform information are available in the [GitHub repository](https://github.com/HDFGroup/hdfview).

### ⛔ Known Problems

* **Large Dataset Handling**: HDFView currently cannot nicely handle large datasets when using the default display mode, as the data is loaded in its entirety. To view large datasets, it is recommended to right click on a data object and use the "Open As" menu item, where a subset of data to view can be selected.

* **Large Number of Objects**: HDFView also cannot nicely handle large numbers of objects, because of a design issue that requires HDFView to visit all the objects in a file.

* **Object/Region References in Compound Types**: Object/region references can't be opened by a double-click or by right-clicking and choosing "Show As Table/Image" when inside a compound datatype.

* **Export Dataset in Read-Only Mode**: If a file is opened in read-only mode, right-clicking on a dataset in the tree view and choosing any of the options under the "Export Dataset" menu item will fail with a message of 'Unable to export dataset: Unable to open file'. The current workaround is to re-open the file in read/write mode.

* **Recent Files Button on Mac**: The 'Recent Files' button does not work on Mac due to a cross-platform issue with SWT.

* **PaletteView Selection**: Selecting and changing individual points in PaletteView for an image palette is broken.

* **Source Rebuild Requirements**: Logging and optional HDF4 requires rebuilds from source.

* **Mac File Display**: Automatically opening HDFView and displaying a file selected still does not display the file on a mac.

Please report any new problems found to the [HDFView issue tracker](https://github.com/HDFGroup/hdfview/issues).

## Facts and sources

- <https://opennavo.com/apps/hdfview>
- <https://opennavo.com/apps/hdfview/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/hdfview>
