---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# gh screensaver

> Extension for GitHub CLI that runs animated terminal screensavers.
> See also: `gh extension`.
> More information: <https://github.com/vilmibm/gh-screensaver>.

- Run a random screensaver:

`gh screensaver`

- Run a specific screensaver:

`gh screensaver {{[-s|--saver]}} {{fireworks|life|marquee|pipes|pollock|starfield}}`

- Run the "marquee" screensaver with a specific text and font:

`gh screensaver {{[-s|--saver]}} marquee -- --message="{{message}}" --font={{font_name}}`

- Run the "starfield" screensaver with a specific density and speed:

`gh screensaver {{[-s|--saver]}} starfield -- --density {{500}} --speed {{10}}`

- List available screensavers:

`gh screensaver {{[-l|--list]}}`
