Fietsboek

Website — Documentation — Repository (Mirror)

Fietsboek is a self-hostable sharing site for GPX track recordings with social features. The goal is to have an application like MyTourbook that runs as a web-service and allows sharing and discovering of new tracks.

Note that Fietsboek is early in development and a hobby project, as such many features are still lacking.

Installation

Setup instructions are in the documentation (mirror).

Development

Start redis:

docker run --rm -p 6379:6379 redis
Setup the environment:

virtualenv .venv .venv/bin/pip install poetry .venv/bin/poetry install
Adjust development.ini to your needs. Explanations of the configuration options are in the documentation.
Initialize the database:

.venv/bin/fietsupdate update -c development.ini .venv/bin/alembic -c development.ini upgrade head
Serve the code:

.venv/bin/pserve development.ini --reload
Hack away!

The documentation also contains information for developers. In particular, the rendered docstrings can be found there: https://docs.fietsboek.org/developer/module/fietsboek.html.

Issues

Issues are tracked in the Gitlab repository. You can also report them via email to fietsboek@kingdread.de.

License

Fietsboek, the GPX web sharing project
Copyright (C) 2022 Daniel Schadt

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 <https://www.gnu.org/licenses/>.