---
name: "penguineyes"
section: "6"
platform: "linux"
package: "penguineyes"
version: "0.10-22"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/penguineyes"
---

# penguineyes(6)

A themable xeyes replacement.

## NAME

penguineyes - A themable xeyes replacement.

## SYNOPSIS

**penguineyes** \[ *OPTIONS* \]

## DESCRIPTION

*Penguineyes* (pronounced as "penguinise" - or "penguinize" if you're American;) allows the user to have Tux the loveable Linux penguin sitting in the corner  of his (or her) desktop, following the cursor with his eyes, not only that, but several other characters, or even one created by the user, can be substituted for Tux.

## OPTIONS

*Pengiuneyes* accepts the following options:

- **-g**, **--geometry** (**w**x**h**+**x**+**y**)

  set the geometry of the window

- **-w**, **--width** (width)

  set the width of the window (height is calculated automatically)

- **-h**, **--height** (height)

  set the height of the window (width is calculated automatically)

- **-V**, **--flipv**

  start with the window flipped vertically

- **-H**, **--fliph**

  start with the window flipped horizontally

- **-t**, **--theme** (theme)

  use the theme of the specified name

- **-r**, **--random**

  use a random theme

- **-f**, **--fps** (fps)

  set the number of redraws a second (default 24)

- **-g**, **--guilty** (fps)

  This option causes the eyes to look *away* from the mouse

- **-c**, **--config** (filename)

  use an alternative defaults file - used to record restart information

- **-s**, **--spawn** (n)

  spawn *n* instances of *Penguineyes*, each with its own config file

- **-a**, **--applet**

  Run *Penguineyes* as an applet (GNOME only)

- **-d**, **--disable\_always\_on\_top**

  Allow other windows to hide *Penguineyes*

- **-v**, **--version**

  print the version number, and then exit

- **-?**, **--help**

  print usage information, and then exit

## USAGE

Once *Penguineyes* has been started, you can use the mouse to interact with it, the mouse commands are:

- **Left mouse button:**

  click this, then drag to move the window around the screen

- **Middle mouse button:**

  click this, then drag to resize the window, if you hold down shift while doing this, the window will retain its scale

- **Right mouse button:**

  brings up a menu that allows you to change the theme

- **mouse wheel:**

  If you have a mouse wheel (and its actions are configured to buttons 4 and 5), you can use it to resize penguineyes.

As well as setting the theme, the menu offers the following functions, these are bound the keys in brackets

- **Flip horizontally/vertically (v/h)**

  Flip the image either horizontally, or vertically

- **Reset size (r)**

  Reset the size of the image to its original value

- **Random theme (space)**

  Set the theme randomly

- **Save (s)**

  Save the current theme and geometry settings to the defaults file - this information is used when *Penguineyes* is restarted, although this is automatically done on quitting.

- **Quit (q)**

  Useless function ...

## SEE ALSO

Inspired by [xeyes(1)](/xeyes/1.md)

## AUTHOR

Neil Howie (\<tacticalnuclearchicken@yahoo.co.uk\>), with some invaluable help from Tuxedo T. Penguin