Map Blueprint

Map Blueprint auf deinem eigenen Computer betreiben

Bring die App in nur ein paar Minuten auf deinem eigenen Computer zum Laufen, perfekt für eine Person oder ein Team im selben Netzwerk. Es gibt nichts zu installieren und keine Dateien zu bearbeiten: Map Blueprint ist ein einziges Programm, das du herunterlädst und per Doppelklick startest, wie jede andere App.

Bevor du loslegst: entpacke die heruntergeladene Datei irgendwo, wo du willst (zum Beispiel in einen neuen Ordner MapBlueprint in deinen Dokumenten). Darin findest du je ein Programm für jede Art von Computer, nimm das, das zu deinem passt (Windows, Mac oder Linux), und ignoriere den Rest. Möchtest du, dass Teamkollegen an anderen Orten übers Internet darauf zugreifen? Nutze stattdessen die Cloud-Hosting-Anleitung.
Was passiert eigentlich, wenn du es startest? Zwei Dinge starten gemeinsam: ein kleines Hintergrundprogramm (der Server), das deine Karten speichert und Verbindungen ermöglicht, und dein Webbrowser, der sich mit der App öffnet. Solange der Server läuft, funktioniert die App. Schließt du ihn, stoppt die App, deine gespeicherten Karten bleiben sicher auf deiner Festplatte.

Windows

1. App starten

Doppelklicke auf MapBlueprint.exe. Ein kleines schwarzes Konsolenfenster öffnet sich, das ist der Server bei der Arbeit, lass es also einfach offen. Dein Browser öffnet sich dann automatisch mit der App.

Beim ersten Mal zeigt Windows möglicherweise ein blaues Fenster "Der Computer wurde durch Windows geschützt", weil die App nicht von einem namhaften Herausgeber stammt. Klicke auf Weitere Informationen → Trotzdem ausführen. Das ist bei kleinen Indie-Apps normal und sicher, die App ist lediglich nicht code-signiert, mehr nicht.

2. Passwort festlegen

Beim allerersten Start siehst du einen kurzen Setup-Bildschirm. Wähle ein Passwort, mit dem sich dein Team anmeldet (oder lass es leer, wenn dies ein privater Computer ist, den nur du nutzt) und klicke auf Speichern, das ist die ganze Einrichtung.

3. Mit dem Kartieren beginnen

Du landest auf deiner Karten-Übersicht. Erstelle eine Karte und teile ihren Link mit Teamkollegen in deinem Netzwerk. Um die App später zu stoppen, schließe das Konsolenfenster; um sie wieder zu starten, doppelklicke auf das Programm.

Mac

MapBlueprint-mac läuft auf jedem Mac, sowohl auf Apple Silicon (M1/M2/M3/M4) als auch auf älteren Intel-Macs. Auf Apple Silicon bietet macOS beim ersten Mal möglicherweise an, Rosetta zu installieren, klicke auf Installieren (es ist eine Apple-Komponente mit nur einem Klick, die die App lauffähig macht).

1. Beim ersten Mal öffnen

macOS blockiert Apps, die nicht aus seinem App Store kommen, beim ersten Öffnen. Um dies einmalig zu umgehen: Rechtsklick (oder Control gedrückt halten und klicken) auf das Programm → Öffnen → im Dialog erneut Öffnen. Danach kannst du es wie jede App einfach per Doppelklick starten.

Fühlst du dich mit dem Terminal wohl (Macs textbasierte Befehls-App)? Du kannst dasselbe erreichen, indem du die drei Zeilen unten aus dem Ordner ausführst, der das Programm enthält. Die erste entfernt die Markierung "aus dem Internet heruntergeladen", die zweite markiert die Datei als ausführbar, und die dritte startet sie:

xattr -d com.apple.quarantine ./MapBlueprint-mac
chmod +x ./MapBlueprint-mac
./MapBlueprint-mac

2. Passwort festlegen und mit dem Kartieren beginnen

Dein Browser öffnet sich mit dem Setup-Bildschirm beim ersten Start. Wähle ein Passwort (oder lass es leer) und speichere, schon kannst du kartieren. Eine Einstellungsdatei (config.json) und deine Karten werden direkt neben dem Programm angelegt.

Linux-Desktop

Öffne ein Terminal in dem Ordner, der das Programm enthält. Der erste Befehl markiert die Datei als ausführbar; der zweite startet sie. Dein Browser öffnet sich dann mit dem Setup-Bildschirm.

chmod +x ./map-blueprint-linux
./map-blueprint-linux

Möchtest du einen dauerhaft laufenden Linux-Server, den entfernte Teamkollegen erreichen können? Folge stattdessen der Cloud-Hosting-Anleitung.

Einstellungen jederzeit ändern

Öffne die App, gehe auf deine Karten-Seite und klicke auf Einstellungen. Von dort aus kannst du Name, Farben, Logo, Passwort, Port und Teamgröße ändern, keine Dateien zu bearbeiten. Optische Änderungen erscheinen beim nächsten Neuladen; Passwort- und Port-Änderungen werden wirksam, nachdem du das Programm neu startest.

Wenn du das Passwort leer lässt, läuft eine offene Instanz ganz ohne Anmeldung. Tu das nur in einem privaten Netzwerk, dem du vertraust und das du kontrollierst.

Deine Daten und Sicherungen

Im lokalen Netzwerk teilen

Damit Teamkollegen im selben WLAN oder Büronetzwerk deine Karten öffnen können, sagst du der App zuerst, dass sie Verbindungen von anderen Computern annehmen soll, standardmäßig hört sie nur auf deinen eigenen. Öffne die Einstellungen, setze die Bind-Adresse auf 0.0.0.0 (auf Deutsch: "Verbindungen von jedem Computer in meinem Netzwerk annehmen") und starte das Programm neu. Teamkollegen erreichen dich dann unter http://YOUR-COMPUTER-IP:8080.

Um die lokale IP-Adresse deines Computers herauszufinden (eine Zahl wie 192.168.1.42), führe einen dieser Befehle in einem Terminal aus:

Lege zuerst in den Einstellungen ein Passwort fest, sonst kann jeder im Netzwerk mit dem Link deine Karten öffnen.

Entfernte Teamkollegen hereinlassen, ein kostenloser Tunnel

Möchtest du, dass Leute außerhalb deines Netzwerks die App erreichen, während sie weiterhin auf deinem eigenen Computer läuft? Ein Tunnel ist ein kleines Hilfsprogramm, das deiner App eine öffentliche https://…-Webadresse gibt, ohne Router-Änderungen, verschlüsselt und kostenlos. Am einfachsten geht das mit einem Cloudflare Tunnel.

Lege zuerst ein Passwort fest. Öffne die Einstellungen und wähle ein starkes Passwort, bevor du den Tunnel öffnest, sobald er aktiv ist, kann jeder mit dem Link die App erreichen.

1. cloudflared installieren

cloudflared ist Cloudflares kostenloses Tunnel-Tool. Du installierst es einmalig:

2. Map Blueprint starten

Starte die App wie gewohnt und lass sie offen, sie lauscht auf http://localhost:8080 (localhost bedeutet einfach "dieser Computer"). Du kannst die Bind-Adresse auf ihrem Standardwert belassen; der Tunnel erreicht die App genau hier auf deinem Rechner.

3. Den Tunnel öffnen

Öffne ein neues Terminal- oder PowerShell-Fenster (lass die App in ihrem eigenen Fenster laufen) und führe aus:

cloudflared tunnel --url http://localhost:8080

Nach einem Moment gibt es eine öffentliche Adresse wie https://random-words.trycloudflare.com aus. Teile diesen Link, Teamkollegen öffnen ihn von überall, melden sich mit deinem Passwort an und bearbeiten live mit dir. Lass beide Fenster offen (die App und den Tunnel); das Schließen des Tunnel-Fensters beendet das Teilen.

Dieser schnelle Tunnel braucht kein Cloudflare-Konto, aber die Adresse ändert sich bei jedem Neustart. Für eine dauerhafte Adresse auf deiner eigenen Domain erstelle ein kostenloses Cloudflare-Konto und richte einen benannten Tunnel ein, die Cloud-Hosting-Anleitung zeigt dasselbe cloudflared-Setup, und es funktioniert genauso, wenn es auf deinen lokalen PC zeigt. Für eine Instanz, die immer läuft, auch wenn dein Computer aus ist, betreibe sie auf einem kleinen Cloud-Server.