Your API file in only 6 steps

  1. Call up http://freifunk.net/api-generator/ 
  2. Fill in the information about your community in the form and press "OK - generate...". Mandatory fields are marked with an asterisk. The more information you enter, the better. 
  3. Your results will be displayed on the right hand side. If information is missing or fields are incorrectly filled, you will see it marked under the text box. Fill in or correct the information and generate the API file again.
  4. Save the content of the text box to a text file on your computer or press the download button. This puts a file with an encrypted file name in the default download directory of your browser. Unfortunately we cannot change that for technical reasons. 
  5. Upload the file created under point 4. to the Internet on to your Web space, in your content management system or our freifunk wiki. You will need a link to that file.
  6. The link must be added to the API directory. If you trust yourself, create a pull request, or you can send the link via contact form. If you chose the later, select "question about the API" as subject.

Please note: If you want to update, download or edit your API file, you can choose to do so after the entering the API directory, in the drop-down menu on the top right. The file must however be resaved or downloaded and uploaded to the Web server again.  

Please also use the possibilities to update information such as the number of nodes or services automatically and regularly. Gluon developers have written an examplary script, and there is a solution for OLSR-based networks on Github

You can find background information on the API in the blog and on freifunk.net.  

The most recent changes are summarized here.

Translation by Karin Kuschel.

In 6 Schritten zum API-File

  1. Ruf http://freifunk.net/api-generator/ auf
  2. Trag die Informationen zu deiner Community in das Formular ein und drücke auf "OK - generate...". Pflichtfelder sind mit einem Stern gekennzeichnet. Je mehr Informationen eingetragen werden, umso besser.
  3. Auf der rechten Seite werden dir die Ergebnisse angezeigt. Falls Informationen fehlen oder Felder falsch befüllt sind, steht es dort unter dem Textfeld. Ergänze oder berichtige die Informationen und generiere das API-File erneut
  4. Speicher die Inhalte des Textfeldes in einer Textdatei auf deinem Rechner oder drücke auf den Download-Button. Diese legt eine Datei mit kryptischem Dateinamen im Standarddownloadverzeichnis deines Browsers ab. Aus technischen Gründen lässt sich das leider nicht ändern.
  5. Lade die unter 4. erstellte Datei hoch ins Internet auf einen Webspace, in euer Content Managementsystem oder in das Freifunk-Wiki. Als Ergebnis benötigst du einen Link zu der Datei, der aus dem Internet erreichbar ist
  6. Der Link muss noch in das API-Directory eingetragen werden. Wenn du es dir selbst zutraust erstelle einen Pull-Request, ansonsten schickst du den Link über das Kontaktformular an uns und wählst als Betreff 'Frage zur API'
Hinweis: Wenn du dein API-File aktualisieren willst, kannst du es nach dem Eintrag ins API-Directory im Auswahlmenü oben rechts auswählen, laden und bearbeiten. Danach muss die Datei allerdings erneut gespeichert oder heruntergeladen und auf den Webserver hochgeladen werden.
 
Nutz bitte auch die Möglichkeiten, Informationen wie die Anzahl der Knoten oder Dienste automatisch und regelmäßig zu aktualisieren. Die Gluon-Entwickler haben ein Beispiel dafür ein Script geschrieben und für OLSR-basierte Netzwerke gibt es eine Lösung bei Github.

Hintergründe zur API findest du im Blog und auf freifunk.net.

Die letzten Änderungen sind hier zusammengefasst.

Neues aus der API-Werkstatt

Nach einige Zeit hat es mal wieder einen Versionssprung bei der Freifunk-API gegeben: Unsere Freifunk-API steht ab sofort in Version 0.3.0 bereit. Bestehende API-Dateien sollten schnell aktualisiert werden, da sich einige nicht rückwärtskompatible Änderungen ergeben haben.

Neuerungen und Änderungen der Spezifikation

    • Services hinzugefügt, netz-interne Dienste können hier angegeben werden. Später soll aus diesen Daten eine freifunk-weite Serviceübersicht entstehen
    • Timeline hinzugefügt, hier können Communities wichtige Meilensteine ihrer Geschichte eintragen (z.B. Gründung, Neugründung, wichtige Ereignisse wie Vereingründung oder Rekordstände bei Nutzern/Routern). Mit diesen Daten können schöne Zeitstrahlen erstellt werden
    • TLD hinzugefügt, damit Communities die von ihnen genutzten Top Level Domains (.ffhh, ffl, ...) benennen können. Die Informationen können genutzt werden, um die DNS-Konfiguration über die eigene Community hinaus nutzen zu können
    • Kalender-Sektion entfernt, durch Feed vom Typ ics ersetzt. Eine eigene Kalenderspezifikation erwies sich als zu komplex. Mit ics-Files kann man leicht übergreifende Kalender erstellen 
  • Country als Feld aufgenommen
  • Pattern zur Validierung von Eingaben für diese Felder eingeführt: urls, irc, twitter, email, facebook, ip-Adressen
  • Zeitstempel von Unix-Timestamp auf ISO8601-Format umgestellt
  • Netzwerke in CIDR-Notation
  • API Generator validiert

Änderungen am Generator

  • Die Eingabefelder wurden umsortiert. Pflichtfelder verstecken sich nicht mehr hinter eingeklappten Elementen
  • Der Generator kann API-Dateien validieren. Entweder wählt man seine Datei aus dem Auswahlfeld über dem Textfeld oder man kopiert den Inhalt einer Datei in das Textfeld
  • Bei der Validierung werden die Daten direkt in die Formularfelder kopiert, so dass sie danach gleich bearbeitet werden können
  • Gültigkeit von API-Dateien zeigt der Generator farblich an
  • Das Ergebnis der Validation zeigt die problematischen Felder an, man muss sie nicht mehr erraten
  • Zeitpunkt der letzten Änderung und API-Version setzt der Generator automatisch beim der Erstellung, wenn die Eingaben gültig sind

Weitere Änderungen

  • die zusammengefassten API-Dateien legen wir mit jeder Erzegung gesondert ab, um später die Entwicklungsgeschichte verfolgen zu können (Anzahl Communities, Anzahl Router, ...)
  • Es gibt mehrere Ansätze, z.B. die Anzahl der Knotennummern in den API-Files automatisch aktualisieren zu lassen. Solche Scripte und Anleitungen sammeln wir im Github-Repository common.api.freifunk.net 

Die gesamte Änderungsgeschichte ist Github-Repository aufzufinden. Fehler, neue Anforderungen oder Anregungen meldet ihr bitte auch im Github unter "issues".

Freifunk Google Summer of Code 2014

We are excited that Freifunk has been accepted as a Google Summer of Code Mentor organization again in 2014.

We are now looking for interesting student projects. Participating community networks and projects have already put up a list of ideas on the wiki.

Students can apply for example for projects developing packages for OpenWrt (the basis of the freifunk firmware) extending its functionality or other useful network tools such as management server tools, graphic interfaces for existing tools, map extensions, p2p tools that take routing into consideration, implementing wlan sleeping modes, routing protocols and more.

The deadline for student applications is 21 March: 19:00 UTC. We recommend to start your application now. You also need to add an enrolement form into the system.

 

Freifunk Google Summer of Code Timeline

21 March:

19:00 UTC

Student application deadline.

Interim Period:

Mentoring organizations review and rank student proposals; where necessary, mentoring organizations may request further proposal detail from the student applicant.

7 April:

Mentoring organizations should have requested slots via their profile in Melange by this point.

9 April:

Slot allocations published to mentoring organizations

Interim Period:

Slot allocation trades happen amongst organizations. Mentoring organizations review and rank student proposals; where necessary, mentoring organizations may request further proposal detail from the student applicant.

15 April:

First round of de-duplication checks happens; organizations work together to try to resolve as many duplicates as possible.

18 April:


  1. All mentors must be signed up and all student proposals matched with a mentor - 07:00 UTC

  2. Student acceptance choice deadline.

  3. IRC meeting to resolve any outstanding duplicate accepted students - 19:00 UTC #gsoc (organizations must send a delegate to represent them in this meeting regardless of if they are in a duplicate situation before the meeting.)

21 April:

19:00 UTC

Accepted student proposals announced on the Google Summer of Code 2014 site.

Community Bonding Period:

Students get to know mentors, read documentation, get up to speed to begin working on their projects.

19 May:


  1. Students begin coding for their Google Summer of Code projects;

  2. Google begins issuing initial student payments provided tax forms are on file and students are in good standing with their communities.

Work Period:

Mentors give students a helping hand and guidance on their projects.

23 June:

19:00 UTC

Mentors and students can begin submitting mid-term evaluations.

27 June:

19:00 UTC


  1. Mid-term evaluations deadline;

  2. Google begins issuing mid-term student payments provided passing student survey is on file.

Work Period:

Mentors give students a helping hand and guidance on their projects.

11 August:

Suggested 'pencils down' date. Take a week to scrub code, write tests, improve documentation, etc.

18 August:

19:00 UTC

Firm 'pencils down' date. Mentors, students and organization administrators can begin submitting final evaluations to Google.

22 August:

19:00 UTC


  1. Final evaluation deadline

  2. Google begins issuing student and mentoring organization payments provided forms and evaluations are on file.

22 August: 20:00 UTC

Students can begin submitting required code samples to Google

25 August:

Final results of Google Summer of Code 2014 announced

Links

* GSoC Page: https://www.google-melange.com/gsoc/org2/google/gsoc2014/freifunk

* Idea Page: http://wiki.freifunk.net/Ideas

Zweites Release für Freifunk-Bielefeld

Es hat etwas länger gedauert als gedacht, aber endlich haben wir es geschafft, die zweite Version unserer Firmware fertig zu stellen. Sie baut auf batman-adv (2013.4.0), fastd (10) und wie üblich auf OpenWRT (Attitude Adjustment) auf. Zusätzlich haben wir dank Spenden jetzt einen zweiten Gateway in Betrieb nehmen können. :-)

Dazu gibt es eine offizielle Ankündigung mit einer Liste der Neuerungen, und natürlich einen neuen Satz von Firmware-Images zum Herunterladen.

Wer also in Bielefeld oder Umgebung wohnt kann gerne einen Router aufstellen. Wir helfen dabei auch gerne und laden dazu jeden Dienstag Abend in den Hackerspace Bielefeld ein.

 

ffmap FF-Bielefeld

Unser Netz besteht z.Z. aus etwa 30 Knoten und 2 Servern.

ffb wifi scanner

Der kleine Wifi-Scanner in der Weboberfläche.

Freifunk als Weihnachtsgeschenk - Leverkusener Christkindchenmarkt bekommt freies WLAN

Die Initiative Freifunk Leverkusen freut sich, dass der diesjährige Christkindchenmarkt in der Wiesdorfer City mit Freifunk ausgestattet wird.  Um den Besuchern über WLAN einen kostenlosen Zugang zum Internet bieten zu können, werden etwa zwanzig Hotspots aufgestellt und mehrere hundert Meter Kabel verlegt. Möglich wurde dies durch eine enge Zusammenarbeit mit Felix Kaechele, dem Sohn des Veranstalters Axel Kaechele.

"Es bestehen zwar noch einige logistische Herausforderungen, aber wir sind zuversichtlich, dass das Projekt Erfolg haben wird", glaubt Oliver Ding von Freifunk Leverkusen. Damit wird der Weihnachtsmarkt zwischen Rathaus-Galerie, Luminaden und Marktplatz deutlich attraktiver. Die Veranstalter des Christkindchenmarkts sprechen in einer eigenen Pressemitteilung von "Geselligkeit 2.0".

Freifunk ist ein internationales Projekt, um ein freies WLAN-Netz zu schaffen, das frei von Registrierung, Erfassung von persönlichen Informationen oder zeitlicher Limitierung ist. Ziel der Leverkusener Freifunk-Gemeinschaft ist es, langfristig ein stadtweites Datennetz mit WLAN-Geräten aufzuspannen, die über das Freifunk-Netz Zugang zum Internet bereitstellen. Freifunk Leverkusen ist eine Initiative, an der jeder teilnehmen kann.

Links
* http://wiki.freifunk.net/Freifunk_Leverkusen
* https://www.facebook.com/pages/Freifunk-Leverkusen/545997212099259

[via Oliver Ding]

Review freifunk.net zum Webteam Hackday

Am vergangenen Wochenende traf sich das Webteam in der c-base in Berlin, um unsere gemeinsam genutzten Webdienste voranzubringen und fit für die Zukunft zu machen.

Gemeinsam haben wir Tickets abgearbeitet (und sogar mehr geschlossen als neue geöffnet) und ein paar größere und viele kleine Fehler in unserem Webauftritt behoben.

Monic und Christian haben begonnen, ein Wordpress-Theme für die Freifunk-Communities zu schaffen, die es als Startpunkt für einen eigenen Webauftritt verwenden können. Außerdem wollen wir das Design vom Wiki und dem Blog unserer Website anpassen und eine globale Navigation einbauen.

Daniel und Andi haben im Backendbereich einige Komponenten aktualisiert, z.B. das Wiki auf die neueste Version gebracht und die verwendeten php-Versionen modernisiert. Dienste wie den API-Collector haben wir konsolidiert und die eher aus Zeitmangel entstandene Verteilung auf verschiedene Systeme aufgehoben. Gleichzeitig wurde ein neuer Artikel zur neuen Struktur der API fertig.

Einen neuen Downloadbereich wird es in Zukunft auch geben. Hierfür schufen wir die Grundlagen am Wochenende, Monic stiftete dafür Speicherplatz im Internet, der noch seiner Einrichtung harrt.

Weit oben auf der Agenda steht nun, das Wiki aufzuräumen, alte Artikel zu modernisieren oder völlig unbrauchbare Fragmente zu entsorgen. Diese Aufgabe geht uns alle an! André aus Hamburg hat schon begonnen, den Artikel zum Intercity-VPN umzuschreiben und Ballast daraus zu entfernen.

Eine weitere Idee, die wir mittelfristig umsetzen wollen ist die Schaffung eines kollaborativen Kalenders, den alle Communities nutzen können. So entsteht ein weitreichender Überblick über Freifunkevents in ganz Deutschland (und vielleicht über unsere Grenzen hinaus).

Freifunk Franken auf Radio Bayern 2, Lokale Netze und Internet ohne Zensur und Überwachung

Johannes Meyer und Michael Fohrn haben Freifunk in Franken bei Radio Bayern 2 präsentiert.

"ja, wir haben 100 mal darauf hingewiesen dass wir nicht nur Internet machen und das man auch im Freifunk Internet nicht komplett annonym ist (gleiche Cookies, Mailserver usw)."

Geschnitten klingt das beim BR dann so:

Auszug Bayern2 Report:

Unabhängiges und kostenloses Bürgernetz

Immer mehr Menschen schließen sich zusammen und bauen digitale Datennetzwerke auf. Der Internetzugang ist dabei kostenlos und von einem Anbieter unabhängig. Das Ziel: eine freie Infrastruktur. Die wichtigsten Fakten zu Freifunk.

Die Idee hinter Freifunk ist, die freie Kommunikation der Teilnehmer im Netz ohne auf zentrale Anbieter zurückgreifen zu müssen. Das Netz wird nicht von einer Firma oder einem Provider betrieben, sondern von engagierten Bürgern – also den Nutzern – selbst.

Kostenloses Internet

Das Computer-Funknetz entsteht, indem sich beliebig viele WLAN-Router untereinander verbinden. Freifunk ist vergleichbar mit Computer-Netzwerken, die früher über Kabel verbunden wurden, nun geschieht das über Funk. Sobald ein Computer einen Internet-Zugang hat, können alle anderen Nutzer ebenfalls auf das Internet zugreifen – und das völlig kostenlos. Über das Gemeinschaftsnetz können aber auch Daten ausgetauscht werden, wie zum Beispiel Texte, Bilder, Musik oder Filme.

Nutzer bleiben anonym

Die Freifunker agieren anonym im Netz, da die Daten, etwa E-Mails, besuchte Internetseiten oder Suchanfragen aller Nutzer anonymisiert werden, ehe sie gemeinsam ins Internet gehen. Nach Angaben der Betreiber wäre der einzelne Nutzer durch die Daten-Bündelung und Anonymisierung kaum noch auszumachen. Dies funktioniert allerdings nur, wenn sich viele Bürger aktiv an dem Netz beteiligen, und ihren Internetzugang mit anderen teilen.

"Man schafft Menschen einen Internetzugang ohne Vorratsdatenspeicherung, mit weniger Überwachbarkeit. Das ist Internet ohne Zensur und Überwachung." Michael Fohrn, Freifunker

Vorteil für ländliche Regionen

Im Ausland zum Beispiel in Spanien und Österreich ist Freifunk weit verbreitet. Die größten Freifunk-Netzwerke in Deutschland wurden in Berlin und Hamburg aufgebaut. In Franken ist das Freifunk-Netz noch relativ klein, laut den Betreibern aber stark am Wachsen.

Freifunk könnte auch eine Lösung für die schlechte Internet-Versorgung im ländlichen Raum bieten. Für kommerzielle Betreiber ist es oft unrentabel, einen schnellen Internet-Zugang in kleinen Dörfern anzubieten. Schließen sich genügend Menschen zu einem Freifunk-Netz zusammen, könnten genügend kostenlose WLAN-Hotspots entstehen und damit das schnelle Internet auch in dünn besiedelte Regionen gelangen, so die Betreiber.

"Im Großraum Nürnberg bestehen schon über 130 Zugangspunkte, die von 20 bis 30 Freifunkern betreut werden."

Johannes Meyer, Freifunker

Das benutzen des Freifunk-Netzes ist einfach: Der Computer oder das Handy sucht nach verfügbaren WLAN-Netzwerken. Sobald "franken.freifunk.de" angezeigt wird, kann sich jeder kostenlos ins Internet einloggen. Wer sich aktiv an dem Netzwerk beteiligen und es ausbauen möchte, benötigt lediglich einen Router. Mehr Informationen bietet die Homepage Freifunk Franken.

Links:

Freifunk Franken http://freifunk-franken.de

Radiomitschnitt: https://soundcloud.com/depubliziert/freifunk-franken-in-bayern2

Onlineseite: http://www.br.de/radio/bayern2/sendungen/regionalzeit-franken/freifunk-internet-buergernetz-100.html

Audio: 
Syndicate content