starfetch(1)

✨ NAME ✨

starfetch — a command line tool that displays constellations. yes bestie, your terminal is about to become a planetarium 💫

🌌 Description 🌌

okay so picture this: starfetch prints out a scheme of a random given constellation, and it tells you everything about it — its quadrant, its right ascension, its declination, its area and its main stars number. 🎀 like a little star ID card, right there in your shell.

and the best part? the constellation may be set at run time. you're not stuck with whatever the cosmos hands you, you get to choose. main character energy, honestly. 🌸

💅 Options 💅

• -r — display a random constellation. this is the default behavior if no options are supplied, so literally just running it with nothing gives you a surprise star 🌟
• -n — display the selected constellation. starfetch supports many common Greek constellations such as Gemini, Orion and Scorpio. for a full list of constellations, see -l 👀
• -l — list the available constellations 📜 (go peek, the options are lowkey stunning)
• -c — display the constellation with a specific color. valid colors are black, white, cyan, magenta, yellow, red, blue. 🎨

⚠️ real talk though: if using this option, it must be before any other options. not after, not in the middle — before. periodt. 💅

• -h — display the help message 🆘

🐛 Reporting Bugs 🐛

found a bug? 🦋 not you being a detective, we love that. the starfetch issue tracker is right here:

https://github.com/Haruno19/starfetch/issues

and that's the whole starfetch(1) page, straight out of the General Commands Manual 🫶 (there's no date stamp on this one, the footer is just starfetch(1) — she's timeless like that ✨) go point your terminal at the sky for me, bestie 💖🌠