search

DwarfTelescopeUsers / dwarfii-stellarium-goto

App to connect Dwarf II with Stellarium
15 stars 9 forks source link

readme

Dwarf II Stellarium Goto

This website connects to the Dwarf II telescope to Stellarium via the Dwarf II API and Stellarium remote control plugin. Once Dwarf II and Stellarium are connected, you can select an object in Stellarium, and then tell Dwarf II to go to that object.

screenshot of Stellarium and app –

Setup for coders

If you are interested in seeing how the code works or contributing to the project, then follow these steps.

This app is built with Next.js, Typescript, and Bootstrap css. This app uses eslint and Prettier to lint and format the code.

  1. Clone this repo.

  2. Install libraries.

npm install
  1. Start server.
npm run dev

Setup for non-coders

If you just want to get the site up and running on your machine, then follow these steps.

  1. Download the file DwarfStellariumGoto.tar.gz.

  2. Unzip the file. A DwarfStellariumGoto directory will be created. The website is a static html site (html, javascript, and css), so it should work on any OS that can run a browser and a web server.

  3. Start a server inside the DwarfStellariumGoto directory. I recommend using Python's webserver, but you can use any webserver you want.

cd DwarfStellariumGoto
python -m http.server
  1. Visit the site in a browser. If you use the Python's server, visit localhost:8000

Details

Stellarium remote control plugin starts a webserver that allows people to access Stellarium desktop app through a web browser. When people select an object in Stellarium, they can access information about that object through http://<localhost or IP>:<port>/api/main/status.

This app connects to /api/main/status, and parses the returned data to get the object name, right acension and declination. The app then sends a goto command to the DWARF II with RA, declination, latitude, and longitude data via Dwarf II API.