README.md 1.61 KB
Newer Older
Nicolas Fella's avatar
Nicolas Fella committed
1
# Summary
Nicolas Fella's avatar
Nicolas Fella committed
2
KTrip is a public transport assistant targeted towards mobile Linux and Android.
Nicolas Fella's avatar
Nicolas Fella committed
3

Nicolas Fella's avatar
Nicolas Fella committed
4
It allows to query journeys for a wide range of countries/public transport providers by leveraging [KPublicTransport](https://cgit.kde.org/kpublictransport.git/).
Nicolas Fella's avatar
Nicolas Fella committed
5

Nicolas Fella's avatar
Nicolas Fella committed
6
# Get it
Nicolas Fella's avatar
Nicolas Fella committed
7

Nicolas Fella's avatar
Nicolas Fella committed
8
Nightly [Android APKs](https://binary-factory.kde.org/view/Android/job/KTrip_android/) and [Windows installers](https://binary-factory.kde.org/view/Windows%2064-bit/job/KTrip_Nightly_win64/) can be found at KDE's binary factory.
Nicolas Fella's avatar
Nicolas Fella committed
9

Nicolas Fella's avatar
Nicolas Fella committed
10 11 12 13 14
Nightly Flatpak builds are available:

`flatpak remote-add --if-not-exists kdeapps --from https://distribute.kde.org/kdeapps.flatpakrepo`

`flatpak install kdeapps org.kde.ktrip`
Nicolas Fella's avatar
Nicolas Fella committed
15 16 17 18 19 20 21 22 23 24

# Building

KTrip depends on Qt 5 and a number of KDE Frameworks:
- KCoreAddons
- KI18n
- KConfig
- KItemModels
- Kirigami
- KPublicTransport
Nicolas Fella's avatar
Nicolas Fella committed
25
- kirigami-addons
Nicolas Fella's avatar
Nicolas Fella committed
26 27 28

## Linux

Tobias Fella's avatar
Tobias Fella committed
29
`git clone https://invent.kde.org/utilities/ktrip`
Nicolas Fella's avatar
Nicolas Fella committed
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54

`cd ktrip`

`mkdir build`

`cd build`

`cmake -DCMAKE_INSTALL_PREFIX=/usr ..`

`make`

`sudo make install`

This assumes that all dependencies are installed. If your distribution does not provide them you can use [kdesrc-build](https://kdesrc-build.kde.org/) to build all of them conveniently.

## Android

You can build KTrip for Android using KDE's [Docker-based build environment](https://community.kde.org/Android/Environment_via_Container).

## Windows

You can build KTrip on Windows using KDE's [Craft](https://community.kde.org/Craft).

## macOS and iOS

Nicolas Fella's avatar
Nicolas Fella committed
55
Running on macOS and iOS should be possible in theory, but is untested. Building on macOS should be possible using KDE's [Craft](https://community.kde.org/Craft). Patches are welcome.