https://github.com/codecanna/spacepix

A desktop application for discovering exciting facts and images about space. Made using Rust, and egui, powered by the NASA API.
https://github.com/codecanna/spacepix

desktop-application educational educational-project educational-software egui images nasa nasa-api nasa-apod planets rust-lang space

Last synced: 26 days ago
JSON representation

A desktop application for discovering exciting facts and images about space. Made using Rust, and egui, powered by the NASA API.

• Host: GitHub
• URL: https://github.com/codecanna/spacepix
• Owner: CodeCanna
• License: agpl-3.0
• Created: 2024-10-21T23:28:09.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2025-01-02T00:23:42.000Z (about 1 month ago)
• Last Synced: 2025-01-02T01:26:38.633Z (about 1 month ago)
• Topics: desktop-application, educational, educational-project, educational-software, egui, images, nasa, nasa-api, nasa-apod, planets, rust-lang, space
• Language: Rust
• Homepage:
• Size: 782 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Spacepix

## Welcome!

Hello and welcome to the Spacepix repository.  Spacepix is educational software that allows the user to explore the NASA API and it's data from a desktop application written in Rust and built on the [egui](https://github.com/emilk/egui) crate.

## Building and Running

Because Spacepix is written in Rust, it should run roughly the same on Linux, Mac, and Windows.

### To Build Spacepix

Run `gh repo clone CodeCanna/spacepix` or `git clone https://github.com/CodeCanna/spacepix.git`

Spacepix uses `Make` and `cargo` to build and run:

* `make all` Builds optimized for both Linux and Windows x64 targets (MAC to come) uses `--release`

* `make linux` Builds for both Linux and Windows optmized uses `--release`

* `make linuxdev` Builds for Linux x64 unoptmized

* `make windows` Builds for Windows x64 optimized uses `--release`

* `make windowsdev` Builds for Windows x64 unoptimized

### To Run Spacepix

#### Running with Cargo

If you just want to run Spacepix you can use `cargo run` or `cargo run --release` (optimizations)

#### Running with Make

You can run Spacepix with Make using `make run` or `make rrun` for optimizations using `--release`

# "Activating" Spacepix

### Obtaining an API key

Spacepix uses NASA's API to get it's data.  NASA requires that you [register here](https://api.nasa.gov/) to get a free API key.  This will allow you to use Spacepix with no limitations.

Once you get your API key, you can enter it in Spacepix by going to Settings->Set API Key.  The next time you start Spacepix your key should be used instead of `DEMO_KEY`.

### Using NASA's demo API Key

Spacepix uses `DEMO_KEY` by default.  This can be changed by going to Settings->Set API Key and entering in you API key.

### DEMO_KEY Rate Limits

In documentation examples, the special DEMO_KEY api key is used. This API key can be used for initially exploring APIs prior to signing up, but it has much lower rate limits, so you’re encouraged to signup for your own API key if you plan to use the API (signup is quick and easy). The rate limits for the DEMO_KEY are:

* Hourly Limit: 30 requests per IP address per hour

* Daily Limit: 50 requests per IP address per day