Skip to content

nataliehogg/hoverscope

Repository files navigation

🔭 hoverscope

Hover over telescope and satellite names on arXiv to see key specifications instantly.

Hoverscope is a browser extension that detects mentions of telescopes, satellites, astronomical instruments, simulations, semi-analytic models, and sampling codes in arXiv papers and displays detailed information when you hover over them.

demo

Features

  • Instant Information: Hover over names to see specifications instantly
  • 🔄 Auto-updating: Database updates automatically from GitHub
  • 🌓 Dark Mode: Adapts to your system preferences
  • 📚 Comprehensive: Covers major space/ground telescopes and instruments, contemporary and historical simulations, Semi-Analytic Models (SAMs), and Bayesian sampling codes
  • 🌍 Multilingual: Tooltip labels available in English, German, Spanish, French, Italian, and Mandarin. Please note that these are machine translations; pull requests to correct errors are welcome.
  • 🎯 arXiv Optimised: Works seamlessly on paper titles, abstracts and arXiv's html view

Information Displayed

For each telescope/satellite, Hoverscope shows:

  • Type (Space telescope, radio interferometer, etc.)
  • Launch Date (or operational dates)
  • Wavelength Coverage (UV, visible, infrared, radio, etc.)
  • Survey Area (for survey instruments)
  • Location (orbit, ground location)
  • Status (Operational, decommissioned, in development)
  • Brief Description

For each simulation Hoverscope shows:

  • Type (Cosmological simulation, Suite, Zoom re-simulation, etc.)
  • Volume (box size)
  • Mass Resolution
  • Included Physics (e.g. dark matter only, hydrodynamics, feedback models)
  • Sub-grid Model (the name of the sub-grid model used, if applicable)
  • Code Used (e.g. SWIFT, GADGET, AREPO, RAMSES
  • Brief Description

For each Semi-Analytic Model (SAM) Hoverscope shows:

  • Included Physics (e.g. cooling, star formation, feedback models)
  • Dark Matter Simulation Used (e.g. Millennium, Bolshoi)
  • Mass Resolution (of the underlying dark matter simulation)
  • Merger Tree Code (e.g. Consistent Trees, DTrees)
  • Brief Description

For each sampling code Hoverscope shows:

  • Type (e.g. MCMC, Nested Sampling)
  • Method (the specific algorithm)
  • Language (implementation language)
  • Parallelisable (MPI/multiprocessing support)
  • Brief Description

Installation

From Browser Stores (Simplest)

Manual Installation (For Development)

Since Chrome and Firefox require different manifest configurations, you'll need to copy the appropriate manifest file first.

Prerequisites

Clone or download this repository:

git clone https://github.com/nataliehogg/hoverscope.git
cd hoverscope

Installing in Chrome

  1. Copy the Chrome manifest:
    cp manifest.chrome.json manifest.json
  2. Open Chrome and go to chrome://extensions/
  3. Enable "Developer mode" (toggle in top-right)
  4. Click "Load unpacked"
  5. Select the hoverscope folder
  6. Done! Visit arXiv and hover over telescope names

Installing in Firefox

  1. Copy the Firefox manifest:
    cp manifest.firefox.json manifest.json
  2. Open Firefox and go to about:debugging#/runtime/this-firefox
  3. Click "Load Temporary Add-on"
  4. Navigate to the hoverscope folder and select manifest.json
  5. Done! (Note: temporary add-ons are removed when Firefox restarts)

For permanent Firefox installation, the extension needs to be signed by Mozilla or you need to use Firefox Developer Edition with xpinstall.signatures.required set to false.

Updates

When a new release of the code is published on Github, that release will also be made available on the webstores. This is not automatic, and there may be a short delay (~hours) between the release on Github and the update propagating to the webstores, as the updates have to be reviewed each time. This means that the most up-to-date stable version of hoverscope will always be the one available from the main branch of this repository. Note that you will have to reload the extension in your browser after pulling from the repository to ensure updates propagate to your live version.

Usage

Just browse arXiv normally! Hoverscope automatically detects telescope and satellite names in paper titles, abstracts and HTML view.

When you hover over a recognised name (like "JWST", "Hubble", "ALMA"), a tooltip appears with detailed information.

Current Database

Hoverscope currently recognises 30+ telescopes and instruments, including:

Space Telescopes:

  • James Webb Space Telescope (JWST)
  • Hubble Space Telescope (HST)
  • Chandra X-ray Observatory
  • Spitzer Space Telescope
  • Kepler
  • TESS
  • Gaia
  • Euclid
  • Nancy Grace Roman Space Telescope
  • And more...

Ground-Based:

  • ALMA
  • VLA (Very Large Array)
  • SKA (Square Kilometre Array)
  • SDSS (Sloan Digital Sky Survey)
  • Vera Rubin Observatory (LSST)

Instruments:

  • JWST instruments (MIRI, NIRSpec, NIRCam)
  • And more...

Simulations:

  • EAGLE
  • IllustrisTNG
  • COLIBRE
  • FLAMINGO
  • Simba
  • Thesan
  • And more...

Semi-Analytic Models (SAMs):

  • L-GALAXIES
  • GALFORM
  • SCSAM
  • And more...

Sampling Codes:

  • emcee
  • MultiNest
  • PolyChord
  • dynesty
  • UltraNest
  • And more...

The extension automatically checks for database updates daily. The database is stored as a JSON file that can be easily updated.

Contributing

Want to add more telescopes or improve the extension? Contributions welcome!

  1. Fork the repository
  2. (For a telescope) Add telescope data to telescope.json following this format:
{
  "telescope_id": {
    "name": "Official Name",
    "aliases": ["Alternative Name 1", "Acronym"],
    "type": "Space Telescope",
    "launch_date": "Month Day, Year",
    "wavelengths": "UV to near-infrared (100-2500 nm)",
    "survey_area": "5000 sq deg",
    "location": "L2 Lagrange Point",
    "status": "Operational",
    "description": "Brief description of the mission"
  }
}
  1. Test locally
  2. Submit a pull request

Technical Details

  • Manifest Version: 3 (latest Chrome extension standard)
  • Framework: Vanilla JavaScript (no dependencies)
  • Storage: Chrome Storage API with automatic syncing
  • Update Mechanism: Daily automatic checks via background service worker

Privacy

Hoverscope:

  • ✅ Does not collect any user data
  • ✅ Does not track browsing history
  • ✅ Minimal permissions (storage only)
  • ✅ All data processing happens locally in your browser

A full privacy statement can be found at PRIVACY.md.

License

MIT License - feel free to use, modify, and distribute!

Credits

Telescope data compiled from NASA, ESA, and observatory official sources.


Made with ❤️ (and claude) for the astronomy community

About

Browser extension providing hovering tooltip information about telescopes, simulations, and sampling methods.

Topics

Resources

License

Stars

Watchers

Forks

Contributors