STAR is a web interface that helps users align their device (and antenna) with a specified satellite using the device's motion sensors and real-time Two-Line Element (TLE) data. Designed for both beginners and advanced users, STAR simplifies satellite alignment for handheld antennas, particularly useful for HAM radio operators and satellite enthusiasts.
- Next.js 15.1.0
- React 18
- TypeScript
- Tailwind CSS
- N2YO API for satellite data retrieval
Before you begin, ensure you have the following:
- Node.js (v18+)
- Yarn or npm
- N2YO API Key (to fetch satellite TLE data)
-
Clone the repository:
git clone https://github.com/ConorEB/star cd star -
Install dependencies:
yarn install
Include your N2YO API key in the .env file in the project's root directory:
N2YO_API_KEY={INSERT_API_KEY}You can obtain an API key from N2YO (https://www.n2yo.com/login/register). Make sure to replace INSERT_API_KEY with your actual key.
Start the development server:
yarn devOnce running, open http://localhost:3000 in your browser to view the application.
This app only works on devices that supply motion data via the web API, which are typically only mobile devices. I reccomend using ngrok to establish a tunnel to a local device if you are running this on a computer.
This project is released under the MIT License. Refer to the LICENSE file for more information.