https://github.com/dbrgn/flugbuech
Web based flight log for paragliding pilots.
https://github.com/dbrgn/flugbuech
flightlog gleitschirm paragliding
Last synced: 4 months ago
JSON representation
Web based flight log for paragliding pilots.
- Host: GitHub
- URL: https://github.com/dbrgn/flugbuech
- Owner: dbrgn
- License: agpl-3.0
- Created: 2018-08-29T00:05:31.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-12-27T17:34:55.000Z (4 months ago)
- Last Synced: 2025-01-12T10:42:15.302Z (4 months ago)
- Topics: flightlog, gleitschirm, paragliding
- Language: Rust
- Homepage: https://flugbuech.bargen.dev/
- Size: 10.9 MB
- Stars: 29
- Watchers: 5
- Forks: 1
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-flying - Flugbuech - Web based flight log for paragliding pilots. (Logbook / Other)
README
# Flugbuech
[](https://github.com/dbrgn/flugbuech/actions/workflows/backend.yml)
[](https://github.com/dbrgn/flugbuech/actions/workflows/frontend.yml)
[](https://hub.docker.com/r/dbrgn/flugbuech/)
Personal flight log for paragliding pilots. Written with
[Rust](https://www.rust-lang.org/) / [Rocket](https://rocket.rs/) in
the backend and Bulma CSS / SvelteKit in the frontend.
This software is mostly aimed at pilots that track their flights using a GPS
tracker which generates IGC files, but it can also be used without an IGC file
for every flight.
The IGC file is stored together with the flight data. Every flight can be
linked to an [XContest](https://www.xcontest.org/) upload.
A free hosted version of the flight book can be found at
[flugbuech.bargen.dev](https://flugbuech.bargen.dev/). Registration is open!
If you have any question, you can contact me at
[[email protected]](mailto:[email protected]).
## Status
### What works
- [x] User registration / login / authentication
- [x] Adding flights manually to the database
- [x] Simple submission of of flights by uploading IGC file (all
relevant flight data like launch time/location, landing time/location,
duration, distance, etc can be extracted from that file)
- [x] Manage locations
- [x] Show stats about the past flights
### What's not yet implemented
- [ ] Password recovery
- [ ] Map with all your flights
- [ ] Make it easier to self-host
- [ ] Import launch / landing locations from a public database
- [ ] Direct upload to XContest
## Setup
Requirements:
- Rust stable (see `rust-toolchain` file)
- PostgreSQL + PostGIS
- For building the frontend components: nodejs / npm
- For production environments: A reverse proxy like Nginx
Install `diesel_cli`:
cargo install -f diesel_cli --no-default-features --features postgres
Start PostGIS database:
docker run -d --name flugbuech-pg \
-e POSTGRES_DB=flugbuech \
-e POSTGRES_USER=flugbuech \
-e POSTGRES_PASSWORD=flugbuech-dev-password \
-p 127.0.0.1:5432:5432 \
docker.io/postgis/postgis:15-3.4-alpine
Prepare database and run migrations:
diesel setup
(Note: You can also apply migrations by starting with the `--migrate` flag)
Install frontend dependencies:
(cd frontend && npm install)
You're set up! To start the development API server:
cargo run
And to run the development frontend server in a second terminal window:
cd frontend && npm run dev
Then go to to view the local application.
## Creating test users
Head to and sign up regularly.
## Testing
First, set up a test database:
docker exec flugbuech-pg createdb -U flugbuech flugbuech_test
Run backend tests:
cargo test
To run frontend tests:
cd frontend
npm run test
## Resetting Password
To reset a password directly in the database:
UPDATE users
SET password = crypt('newpassword', gen_salt('bf', 10))
WHERE username = 'user';
## Deployment
If you want to deploy this software using Docker, please take a look at the
provided `docker-compose.yml` file. It can serve as an example on how to host
Flugbuech. The image is also available [on Docker
Hub](https://hub.docker.com/r/dbrgn/flugbuech/), images are re-built at least
weekly.
Note that while the default server is able to serve static files, it's probably
a good idea to put an Nginx instance in front of the `/static` volume inside
the Docker container.
**IMPORTANT**: Make sure to change the `ROCKET_SECRET_KEY` variable when
configuring your deployment!
## License
Licensed under the AGPL version 3 or later. See `LICENSE.md` file.
Copyright (C) 2019–2024 Danilo Bargen
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
## Credits
- Background photo by [eberhard grossgasteiger on Unsplash](https://unsplash.com/photos/15KSFB1n0FU)