summaryrefslogtreecommitdiff
path: root/Infrastruktur/Virtuell/SpaceAPI.mdwn
blob: e296c75ba03e54d287ebe8dc715b31063163b183 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Die Space API ist ein Projekt um ein vereinheitlichtes Statussyntax für alle Hackerspaces bereitzustellen. Zurzeit haben wir nur die Grundlegenden Funktionen (Tuerstatus und Kontaktdaten) implementiert. In Zukunft kann man darüber aber auch sicher Veranstaltungen ankündigen.

## Wie funktioniert es

Wir haben Sensoren an der Eingangstür, mit denen wir herausfinden können, ob die Türflügel geschlossen oder offen sind, und ob das Schloss geöffnet oder verschlossen ist. Diese Informationen werden zusammen mit den Informationen die über den [[Hausbus]] vorhanden sind auf [[Argonaut|Server/Argonaut]] in einer [[JSON|http://en.wikipedia.org/wiki/JSON]]-Datei abgelegt.
Auf dem Webserver [[oberon|Server/Oberon]] läuft alle zwei Minuten ein Skript, welches den aktuellen Türstatus aus der Hausbus-JSON-Datei auf Taifun ausliest, und in die SpaceAPI-JSON-Datei einfügt.

## Status abrufen (Software)

Es gibt es Reihe von Softwareschnittstellen für die SpaceAPI, diese existieren sowohl als Browserplugin, als auch als Applikation für Mobilgeräte.

### Firefox

Für den Firefox gibt es das Hacker's Openspace Plugin, welches durch einen roten oder grünen Kreis in der Statusleiste den Status des ausgewählten Spaces darstellt. Mit einem hellen Theme kann es direkt im Firefox installiert werden. Wer ein dunkles Theme benutzt sollte auf die gepatchte Version zurückgreifen, da sonst sämtliche Menüschriftarten unlesbar werden können.

* [[Hacker's OpenSpace (Firefox Plugin)|https://addons.mozilla.org/de/firefox/addon/hackers-openspace/]]
* [[Hacker's OpenSpace (mit Darktheme-Fix) bei github|https://github.com/stayawake/OpenSpace]]

Die gepachte Variante kann man einfach installieren, indem man das create_xpi-Skript im Git-Repository ausführt, und die xpi-Datei dann im Firefox installiert.

### Android

Für das Androidbetriebssystem gibt es eine Reihe von Applikationen, die die SpaceAPI auslesen und anzeigen können. My Hackerspace tut dies schnell und minimalistisch. Space Directory ist ein wenig netter anzusehen, läuft aber gefühlt langsamer und hakeliger. Das Hackerspace Widget zeigt auf dem Homescreen einen roten oder grünen Kreis an, je nach Status des eingestellten Spaces.

* [[Space Directory|https://play.google.com/store/apps/details?id=ws.narro.the.in.spacedirectory]]
* [[My Hackerspace|https://play.google.com/store/apps/details?id=ch.fixme.status]]
* [[Hackerspace Widget|https://play.google.com/store/apps/details?id=de.ring0.hackspace]]

## Links

* [[SpaceAPI Spezifikation|https://hackerspaces.nl/spaceapi/]]
* [[Liste der teilnehmenden Spaces|http://chasmcity.sonologic.nl/spacestatusdirectory.php]]
* [[SpaceAPI JSON Datei|http://sublab.org/sublab_status.json]]
* [[Hausbus JSON Datei|http://taifun.local.sublab.org/subcan.json]]
* [[SpaceAPI Script|http://git.sublab.org/website/tree/scripts/sub_api.py]]
* [[SpaceAPI Template|http://git.sublab.org/website/tree/template/template.spaceapi.json]]
* [[Global Hackerspace Wall|http://hackerspaces.me/wall]]