Skip to content

A command-line tool to browse the NASA Astronomy Picture of the Day archive.

License

Notifications You must be signed in to change notification settings

marcusziade/apod-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

cf4bdf4 · Jun 6, 2024

History

38 Commits
Feb 13, 2023
Feb 12, 2023
Feb 21, 2023
Aug 31, 2023
Feb 12, 2023
Jun 6, 2024
Aug 31, 2023
Feb 18, 2023
Feb 12, 2023
Feb 12, 2023
Aug 31, 2023
Aug 31, 2023

Repository files navigation

APOD CLI

Github All Releases

apod-cli-banner

The APOD CLI is a command-line interface that allows you to fetch and view Astronomy Picture of the Day (APOD) data from NASA's API.

Features

  • Fetch APOD data for a specified date range
  • Show APOD title, date, and URL in the terminal
  • Optional command-line flags to specify the date range

Installation

Download and run (Linux, macOS, Windows)

Download the executable from releases

Homebrew (macOS)

brew tap marcusziade/apod-cli
brew install apod-cli

Build and run

  1. Make sure you have Go installed on your computer.
  2. Clone this repository to your local machine.
  3. Generate an API key from api.nasa.gov.
  4. Create a "Keys.json" file in the project directory and add your API key to it in the following format:
{
    "APIKey": "your_api_key_here"
}
  1. Run go build in the project directory to build the binary.
  2. Optionally, you can move the built binary to a directory in your system PATH to make it available globally.

Usage

Basic usage:

$ apod-cli

This will fetch APOD data for the last week and display it in the terminal.

Specifying a date range:

$ apod-cli -start=2019-04-20 -end=2019-06-09

This will fetch APOD data for the specified date range (inclusive) and display it in the terminal.

Contributing

If you find any issues or have a feature request, feel free to create an issue on the GitHub repository. Pull requests are also welcome!

License

This project is licensed under the MIT License. See the LICENSE file for details.