An online app to view your X-Plane flight
Airspaces is a web and desktop companion app to X-Plane, a flight simulator. It provides an online map where you can track your plane flying, along with your friends, or the whole world of X-Plane simmers!
⚠️ Airspaces is no longer maintained. Il will keep working as long as it costs minimal effort to me. Technical support is mostly not provided anymore. ⚠️
If you have a bug report, a feature request, or just any question, you can either create an issue on Github.
Thanks for your interest! Here are a few ways to help me improve Airspaces:
Unless you are a developer interested in contributing to Airspaces, you probably should have clicked one of the above links.
Airspaces (excluding the desktop app) is composed of a React.JS frontend and a Node.JS backend. Both use Typescript.
Here is how to get set up:
Clone the repo: git clone [email protected]:foucdeg/airspaces.git
Then in a terminal, install frontend dependencies and run the frontend:
cd frontend && yarn && yarn start
In another terminal, do the same for the server.
cd server && yarn && yarn start
The server is now running on port 9000 and will be listening for X-Plane UDP packets on port 49003. The frontend is now running on port 3000 and should have opened a window in your browser.
Optionnally, in a third terminal, you can run a fake plane signal sending its data to your server:
cd server && yarn fake
You are free to use the Dockerfile to build a Docker image of the server:
docker build -f ./docker/api/Dockerfile . -t foucdeg/airspaces:api
You won't be able to push an image named foucdeg/airspaces:api
to Docker Hub, because, well, that's my name. Just use your Docker Hub username instead and you'll have a working Docker image of Airspaces with your changes!
This repository also includes the source code for the main website, https://airspaces.app. It is a Github Pages website, Github automatically builds it.
I run it locally using the following command:
docker run \
-t --rm \
-v "$PWD":/usr/src/app \
-e JEKYLL_GITHUB_TOKEN=$JEKYLL_GITHUB_TOKEN \
-p "4000:4000" starefossen/github-pages
$JEKYLL_GITHUB_TOKEN
is a Github access token to allow the local container to fetch the data from Github that builds the website.