/businfo-android

Android application providing bus schedules of French networks

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Businfo is a free Android application whose goal is to provide an easy way to get bus schedules of french bus networks.

Features

  • Easy to use
  • Works anytime, anywhere: all schedules are available instantly with no Internet connection required (off-line mode)
  • Bookmark favorite bus stations
  • Share schedules
  • Search information by voice using the voice recognition feature of Android devices (if supported).
  • Available in French, English and Spanish

Supported Bus Networks

Businfo is available on the Google Play Store and Aptoide market place.

Currently supported bus networks are:

  • HĂ©rault Transport (34, France)
  • Thau Agglo (34, France)

Contribute

Quick Installation With Docker

The easiest way to compile the android application is to use the provided Docker image gotsunami/businfo-android:

$ docker pull gotsunami/businfo-android
$ mkdir /tmp/apk
$ docker run --rm -ti -v /tmp/apk:/home/businfo/businfo-android/bin businfo debug

That's it! You'll get the /tmp/apk/Businfo-debug.apk ready to be uploaded to your emulator/device.

Manual Installation

If you can't use Docker or prefer a source installation, please checkout those repositories first:

$ git clone https://github.com/gotsunami/businfo-sample-lines.git
$ git clone https://github.com/gotsunami/businfo-tools.git

The businfo-sample-lines repository has some lines definitions (not real schedules) so that sample data can be used while building the Android application. The businfo-tools repository holds tools dealing with (cleaning, compiling) the bus schedules defined in businfo-sample-lines, making chunks of data that will be merged with the Android app's ressources.

Requirements

The following software is required to build the line schedules and the Android application:

  • The Android SDK
  • Go
  • Python 2.7
  • git
  • sqlite3
  • openjdk-7-jdk (also works with Java 1.6)
  • ant
  • make
  • ia32 libs if you're running a 64-bit system

Final Setup

Create a local.properties file at the root of the project with the following entries:

sdk.dir=/path/to/android/sdk
tools.dir=/path/to/businfo-tools

Create a gmaps.properties file at the root of project with:

gmaps.key.debug=your_gmaps_debug_key
gmaps.key.release=your_gmaps_release_key

Build the project with ant debug install.

License

This is free software released under the GPL (see LICENSE).