PNGPHOON(1)

💫 PNGPHOON(1) 💫

okay bestie, welcome to the General Commands Manual entry for pngphoon — yes it's a real program, yes it's adorable, yes we're gonna read it together 💖

✨ 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 🌸

so this manual page documents pngphoon briefly, that's the whole vibe of it.

it was written for the Debian distribution because the original program literally does not have a manual page. not me being the only documentation 💀 iconic honestly.

pngphoon is a program that creates a PNG image of the current phase of the moon 🌝✨ it's the successor to xphoon, but instead of writing to the root window it writes to a file. so you can pair it with window managers that accept commands for their background image settings. group-chat-approved for ricing 🫶

and before you ask: it's pronounced "pingphoon" (like "typhoon"). yes. that's real. iykyk 🌊

💅 OPTIONS 💅

this program takes the following options, and bestie, some of them are mandatory, so pay attention:

• -h — Mandatory. Gives the image height. the image has to be at least 760px high to be able to contain the moon. if the image is smaller, only the stars will be plotted ⭐ no moon for you.
• -w — Mandatory. Gives the image width. the image has to be at least 760px wide to be able to contain the moon. if the image is smaller, only the stars will be plotted ⭐ same deal.
• -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) 🤫

ok so lowkey a fun little detail: -F foreground_color and -B background_color show up in the SYNOPSIS up there 👆 but the OPTIONS section never explains them. they're just... there. mysterious. main character energy with no backstory. i'm reporting the facts, not filling in the gaps, bestie 🫶

💖 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.

and that's the whole page, bestie 🌈 the header up top said it's from the General Commands Manual, the footer signed it off as PNGPHOON(1), and that's genuinely all she wrote. go make yourself a moon PNG. slay 💅🌙💜