Skip to content

spaceapi-community/my-hackerspace

 
 

Repository files navigation



My Hackerspace

Build status

This is an Android app with the following features:

  • Show the opening status of hacker- and makerspaces using the SpaceAPI
  • Show information about the space (contact, location, sensors, ...)
  • Status widget, multiple widgets supported

The app was originally developed in 2012 by @rorist from FIXME Lausanne. In 2021, the app was transferred to the SpaceAPI community repositories and is now mainly being developed by members of Coredump. You can join our Matrix chat at #spaceapi:matrix.coredump.ch.

Get it on F-Droid Get it on Google Play

How it works

The app will get the list of hackspaces from https://directory.spaceapi.io. You can then choose the space by its name from a list. When the space is chosen, the associated data is retrieved from the space's SpaceAPI endpoint (which is registered in the SpaceAPI directory). If you would like to add your space to the directory, have a look at the SpaceAPI website.

The Widget

The image for the widget is specified in the SpaceAPI endpoint JSON. Have a look at the schema documentation to make your widget more pretty!

  1. open.icon - if present, the widget chooses the specific open/closed images
  2. logo - the widget chooses the logo of the hackspace to display

How to Compile

First, get the sources.

git clone --recursive https://github.com/spaceapi-community/my-hackerspace.git
cd my-hackerspace

Android Studio

With Android Studio, simply open the project directory and you should be set.

Command Line

You can build the project using Gradle.

The following examples use the gradle wrapper script which will automatically download gradle to your local directory. If you want to use your own system-wide installation instead, simply replace ./gradlew commands with gradle.

First, copy local.properties.example to local.properties and adjust the path to your Android SDK installation.

To build a debug APK:

./gradlew assembleDebug

You will find your APK file in the app/build/outputs/apk/ directory.

You can also build and directly install the file to your connected smartphone:

./gradlew assembleDebug installDebug

To see other tasks that gradle offers, run

./gradlew tasks