Commit 9dcb15c4 for libheif
commit 9dcb15c42667425e085ce0acf4cfd700af1ce904
Author: Dirk Farin <dirk.farin@gmail.com>
Date: Sat Jan 17 13:41:12 2026 +0100
Update README with usage and tool documentation
Added usage instructions and details for command line tools.
diff --git a/README.md b/README.md
index 933aee1e..26607f26 100644
--- a/README.md
+++ b/README.md
@@ -295,6 +295,16 @@ You can also add plugin directories programmatically.
## Usage
+libheif comes with a set of command line tools:
+* `heif-dec` for decoding HEIF images to JPEG or PNG. It can also decode image sequences or MP4 video.
+* `heif-enc` for encoding JPEG, PNG, TIFF, or Y4M images to HEIF images, image sequences or MP4 video.
+* `heif-info` for getting some overview information about the HEIF file or (using the `-d` option) to dump the full box structure of the file.
+* `heif-view` for displaying HEIF image sequences
+
+### `heif-enc` command line tool
+
+You can find more documentation for the `heif-enc` tool on the [wiki page](https://github.com/strukturag/libheif/wiki/heif%E2%80%90enc-Command-Line-Tool).
+
### Security limits
Libheif defines some security limits that prevent that very large images exceed the available memory or malicious input files can be used for a denial-of-service attack.