References

APIs & Services

The platforms and services Earth Jukebox relies on, from NASA's visualizations to the API that serves them.

External APIs and services

  • NASA Scientific Visualization Studio (SVS)

    Visualizations

    NASA's library of animated Earth science visualizations. Every timelapse we turn into sound starts here.

    Uses in the project:

    • Frames downloaded from 9 SVS frame folders (GEOS-FP weather and air quality, ECCO2 currents, CO₂ globe)
    • Frames extracted from 5 SVS videos (humidity, ISS lightning, Perpetual Ocean 2)
    • 13 color bars used to rebuild the value scale of each visualization
    • Timelapse frames and thumbnails shown in the player

    Used byBackendFrontend

  • NASA Global Imagery Browse Services (GIBS)

    Satellite

    NASA's satellite imagery service, with the official color tables (colormaps v1.3) of each layer.

    Uses in the project:

    • Official color tables for IMERG precipitation, GHRSST sea temperature anomalies and MODIS NDVI
    • Turning each pixel color back into its physical value (mm/h, °C, NDVI)
    • Satellite maps behind the rain, sea temperature and vegetation tracks

    Used byBackend

  • NASA Earth Information Center (EIC)

    Catalog

    The Earth visualization content database provided by the Space Apps challenge.

    Uses in the project:

    • Starting point to choose the datasets of each playlist
    • 11 challenge resources, listed on the NASA Data page
    • Inspiration from NASA's own data sonification work (Caldwell 73)

    Used byWhole project

  • Natural Earth · world-atlas

    Cartography

    Public domain map data. The world-atlas package ships its 1:110m country borders as TopoJSON.

    Uses in the project:

    • Country borders loaded by the player map
    • Naming the country and continent you click on (Map voice)
    • Telling land apart from seas and oceans

    Used byFrontend

  • Web Speech API

    Accessibility

    The browser's built-in speech synthesis. No keys, no accounts, no external servers.

    Uses in the project:

    • Voice guide (V key) that reads buttons and sections while moving with the keyboard
    • Announcing the playlist or track when a page opens
    • Map voice: saying the name of the place you click

    Used byFrontend

  • Versilian Community Sample Library (VCSL)

    Sound

    A free library of recorded acoustic instruments, released into the public domain (CC0) by Versilian Studios.

    Uses in the project:

    • 100 instrument samples (kalimba, marimba, harp, organ, saxello, wine glasses, psaltery, didgeridoo, bells, percussion)
    • The melody of every track and the musical textures of the air quality, wind, ocean, CO₂ and lightning tracks
    • The notes of the map radar and of the click on the map
    • Trimmed, normalized and converted to MP3 to keep the player light (about 4 MB)

    Used byFrontend

  • Google Fonts

    Typography

    Open source font library, loaded with next/font.

    Uses in the project:

    • Manrope for body text and Instrument Serif for headings
    • Downloaded at build time and served from our own site: visitors' browsers never contact Google

    Used byFrontend

  • PostgreSQL

    Database

    Open source relational database, running from the postgres:18-alpine image.

    Uses in the project:

    • Stores every playlist and track
    • Keeps each track's measurements (frames, grid and regions) as JSONB
    • Read by the SpotiEarth API to answer the front

    Used byBackend

  • Docker

    Infrastructure

    Containers for a development environment that is the same on every machine.

    Uses in the project:

    • Dev container for the API (Python 3.13)
    • Runs the API and PostgreSQL together with Docker Compose

    Used byBackend

Backend

Our own API

SpotiEarth API

REST API

Our backend. It measures each NASA frame with its color table, saves the results in PostgreSQL and serves them as playlists and tracks.

Uses in the project:

  • Converts pixel colors into physical values with the GIBS tables and SVS color bars
  • Summarizes each frame: named features, a 24 × 48 grid and regions (oceans, continents)
  • Rate limiting of 60 requests per minute (SlowAPI)

Endpoints used by the front

  • GET/api/v1/playlists

    Home: list of playlists

  • GET/api/v1/playlists/{slug}

    Playlist page and its tracks

  • GET/api/v1/tracks/{slug}

    Player: every frame with its values

Built with

Technology stack

Product and service names belong to their owners. Earth Jukebox is a NASA Space Apps Challenge entry and is not endorsed by NASA.