# viu

> View images on the terminal.
> More information: <https://github.com/atanunq/viu>.

- Render an image or animated GIF:

`viu {{path/to/file}}`

- Render an image or GIF from the internet using `curl`:

`curl {{[-s|--silent]}} {{https://example.com/image.png}} | viu -`

- Render an image with a transparent background:

`viu {{[-t|--transparent]}} {{path/to/file}}`

- Render an image with a specific width and height in pixels:

`viu {{[-w|--width]}} {{width}} {{[-h|--height]}} {{height}} {{path/to/file}}`

- Render an image or GIF and display its file name:

`viu {{[-n|--name]}} {{path/to/file}}`