#  `recolor_images`

Convert images to grayscale
## Usage
> pdftl `<input>` `recolor_images` `[<spec>...]` `[quality=val]` `output` `<output>`

## Details
The `recolor_images` operation walks targeted page content streams to locate
bitmap image XObjects, permanently transforming their pixel data and
colorspace entries to grayscale (/DeviceGray).

Arguments:
  * `<specs>`: Optional page ranges to limit the operation.

  * `quality=<q>`: The JPEG compression quality (1-100) used when writing back
    originally lossy images. (Default: 75)
## Examples

> Convert all bitmap images to grayscale document-wide.
```
pdftl in.pdf recolor_images output out.pdf
```

> Convert images on pages 1-5 to grayscale using high-quality JPEG settings.
```
pdftl in.pdf recolor_images 1-5 quality=85 output out.pdf
```


**Tags**: in_place, images, color

*Source: pdftl.operations.recolor_images*

*Read online: [https://pdftl.readthedocs.io/en/latest/operations/recolor_images.html](https://pdftl.readthedocs.io/en/latest/operations/recolor_images.html)*

*Type: Operation*