# Hash Enricher
```{admonition} Module type

<span style='color: #0000FF'>[enricher](/core_modules.md#enricher-modules)</a></span>
```

Generates cryptographic hashes for media files to ensure data integrity and authenticity.

### Features
- Calculates cryptographic hashes (SHA-256 or SHA3-512) for media files stored in `Metadata` objects.
- Ensures content authenticity, integrity validation, and duplicate identification.
- Efficiently processes large files by reading file bytes in configurable chunk sizes.
- Supports dynamic configuration of hash algorithms and chunk sizes.
- Updates media metadata with the computed hash value in the format `<algorithm>:<hash>`.

### Notes
- Default hash algorithm is SHA-256, but SHA3-512 is also supported.
- Chunk size defaults to 16 MB but can be adjusted based on memory requirements.
- Useful for workflows requiring hash-based content validation or deduplication.


## Configuration Options

### YAML
```{code} yaml
hash_enricher:
  algorithm: SHA-256
  chunksize: 16000000

```

### Command Line:
| Option | Description | Default | Type|
| --- | --- | --- | --- |
| `hash_enricher.algorithm` | Optional. hash algorithm to use | SHA-256 | string |
| `hash_enricher.chunksize` | Optional. number of bytes to use when reading files in chunks (if this value is too large you will run out of RAM), default is 16MB | 16000000 | int |

[API Reference](../../../autoapi/hash_enricher/index)