nasa-wallpaper

A lightweight tool to automatically set your desktop wallpaper with stunning NASA images. You can choose images from:

• APOD (Astronomical Picture of the Day)
• NASA Image Library
• NASA on Unsplash

🌍 Supported Platforms

• Windows
• macOS
• GNOME, KDE, Cinnamon, Unity, Budgie, XFCE, LXDE, MATE, Deepin
• Wayland (set only, requires swaybg)
• i3 (set only, requires feh)

⚡ Installation

Download the executable that matches your operating system and architecture from the Releases page. Open a terminal and simply run it.

On Arch Linux, you can install it directly from the AUR.

🔧 Build from Source

Requirements: Rust 2021 edition or newer.

Clone the repository and run:

cargo build --release

The compiled binary will be available under target/release/.

🚀 Quick Usage

• Set today’s APOD as wallpaper:

  nasa-wallpaper -a
  

• Set the APOD for March 27, 1999:

  nasa-wallpaper -a -d 1999-03-27
  

• Set a random image from the NASA Image Library:

  nasa-wallpaper -n
  

• Set a random image with the keyword earth:

  nasa-wallpaper -n -q earth
  

• Show help:

  nasa-wallpaper --help
  nasa-wallpaper -h
  

📖 Full documentation: Wiki – Command Line Help

🤝 Contributing

Contributions are welcome! 🎉

If you’d like to contribute:

1. Fork this repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add your feature')
4. Push the branch (git push origin feature/your-feature)
5. Open a Pull Request

Bug reports, feature requests, and improvements are also welcome via the Issues page.

📜 License

This project is licensed under the APACHE 2.0 License.