Skip to content

Sir-Photch/KvaesitsoPlugin-PublicTransport

Repository files navigation

Public transport plugin for Kvaesitso

This plugin enables querying your local public transport providers for stops and departures near you, while using your favorite launcher app Kvaesitso. It is a thin wrapper around schildbach/public-transport-enabler and integrates its providers into Kvaesitso's location search.

Usage

Get it on GitHub

Download the .apk from the release page of this repository and enable it in the plugin settings. Then, go to the settings of the plugin (gears on the top right) when you have opened the settings of the plugin. Now, select the providers you want to get search results for. Note that if you activate multiple providers whose regions overlap, you might get duplicate results. Then, go back to your homescreen and start searching! (Make sure you have location search enabled in your filterbar and Kvaesitso has location permissions.)

Get it on F-Droid

You may as well get the .apk from MM2-0's F-Droid repository. Instructions on how to add it to your client can be found in the README of Kvaesitso.

Video demo:

Expand
plugin-usage.webm

Translation

You can translate this plugin using Weblate.

Übersetzungsstatus

Providers

Currently, all providers of schildbach/public-transport-enabler that do not require an API key are accessible through this plugin. Generally, if you miss one for your area, check schildbach/public-transport-enabler whether or not it is available there, and if it is, whether or not it requires an API key. As of right now, there is no support for providers that require an API key.

Roadmap

This is a list of things that are TODO:

  • Indicate that setup is required when no provider is selected (v1.1)
  • Add support for Providers that require an API key
  • Add icons to location attribution
  • Redesign settings screen (sometime)

License

This plugin is licensed under the GNU General Public License v3:

Kvaesitso Public Transport Plugin
Copyright (C) 2024  Sir-Photch and contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU 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 General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.