---
name: "pngphoon"
section: "1"
platform: "linux"
package: "pngphoon"
version: "1.3-3.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pngphoon"
---

# pngphoon(1)

Creates a png file with the current phase of the moon

## NAME

pngphoon — Creates a png file with the current phase of the moon

## SYNOPSIS

**pngphoon** \[**-w** *width\]  \[***-h** *height\]  \[***-f** *filename\]  \[***-x** *moons\_in\_x\]  \[***-y** *moons\_in\_y\]  \[***-F** *foreground\_color\]  \[***-B** *background\_color\]  \[***-s** *density\]  \[***-b***\]  \[***-S***\]  \[***-q***\]*

## DESCRIPTION

*This manual page documents briefly the*  **pngphoon** command.

This manual page was written for the **Debian** distribution  because the original program does not have a manual page.

**pngphoon** is a program that creates a PNG image  of the current phase of the moon. It is a successor to xphoon but does not  write to the root window, but to a file.  You can use it with window  managers that accept commands for their background image settings.    It is pronounced "pingphoon" (like "typhoon").

## OPTIONS

This program takes the following options.

- **-h**

  Mandatory. Gives the image height. The image must be at least 760px high to be able to contain the moon. If the image is smaller only the stars will be plotted.

- **-w**

  Mandatory. Gives the image width. The image must be at least 760px wide to be able to contain the moon. If the image is smaller only the stars will be plotted.

- **-f**

  Mandatory. File name the PNG image shall be written to, for output to stdout use - instead of a filename

- **-x**

  Number of moons in x axis (for multihead configurations)

- **-y**

  Number of moons in y axis (for multihead configurations)

- **-s**

  Star density

- **-b**

  Black (no earthlight)

- **-S**

  Southern hemisphere (rotate image 180 degrees)

- **-q**

  Quiet (disable warnings)

## AUTHOR

This manual page was written by Sven Oliver Moll svolli@svolli.de for  the **Debian** system (but may be used by others).  Permission is  granted to copy, distribute and/or modify this document under  the terms of the GNU General Public License, Version 2.

On Debian systems, the complete text of the GNU General Public  License can be found in /usr/share/common-licenses/GPL-2.