Avvia l'app sul tuo computer in un paio di minuti, perfetto per una sola persona o per un team sulla stessa rete. Non c'è nulla da installare e nessun file da modificare: Map Blueprint è un unico programma che scarichi e apri con un doppio clic, come qualsiasi altra app.
Map BlueprintMapBlueprint dentro i tuoi Documenti). All'interno troverai un programma per ogni tipo di computer, usa quello adatto al tuo (Windows, Mac o Linux) e ignora gli altri. Vuoi che compagni in altri luoghi vi accedano via internet? Usa invece la guida all'hosting cloud.
Fai doppio clic su MapBlueprint.exe. Si apre una piccola finestra console nera, è il server che fa il suo lavoro, quindi lasciala aperta. Il browser apre poi l'app automaticamente.
La prima volta, Windows potrebbe mostrare un riquadro blu "Windows ha protetto il PC" perché l'app non proviene da un editore famoso. Clicca su Ulteriori informazioni → Esegui comunque. È normale per le piccole app indie ed è sicuro, l'app semplicemente non ha la firma del codice, tutto qui.
Al primissimo avvio vedrai una rapida schermata di Setup. Scegli una password che il tuo team userà per accedere (o lasciala vuota se è un computer privato che usi solo tu) e clicca su Salva, la configurazione è tutta qui.
Arriverai al tuo pannello Mappe. Crea una mappa e condividine il link con i compagni sulla tua rete. Per arrestare l'app più tardi, chiudi la finestra console; per riavviarla, fai doppio clic sul programma.
MapBlueprint-mac funziona su ogni Mac, sia Apple Silicon (M1/M2/M3/M4) sia i Mac Intel più vecchi. Su Apple Silicon, macOS potrebbe proporti di installare Rosetta la prima volta, clicca su Installa (è un componente Apple a un clic che permette all'app di funzionare).
macOS blocca le app che non provengono dal suo App Store la prima volta che ne apri una. Per superare questo passaggio una volta sola: clic destro (o tieni premuto Control e clicca) sul programma → Apri → Apri di nuovo nella finestra di dialogo. Dopo questa prima volta potrai semplicemente aprirlo con un doppio clic come qualsiasi app.
Ti trovi a tuo agio con il Terminale (l'app dei comandi testuali del Mac)? Puoi fare la stessa cosa eseguendo le tre righe qui sotto dalla cartella che contiene il programma. La prima rimuove il flag "scaricato da internet", la seconda contrassegna il file come eseguibile e la terza lo avvia:
xattr -d com.apple.quarantine ./MapBlueprint-mac
chmod +x ./MapBlueprint-mac
./MapBlueprint-macIl browser apre la schermata di Setup del primo avvio. Scegli una password (o lasciala vuota) e salva, stai mappando. Un file di impostazioni (config.json) e le tue mappe vengono creati proprio accanto al programma.
Apri un terminale nella cartella che contiene il programma. Il primo comando contrassegna il file come eseguibile; il secondo lo avvia. Il browser apre poi la schermata di Setup.
chmod +x ./map-blueprint-linux
./map-blueprint-linuxVuoi un server Linux sempre attivo che i compagni da remoto possano raggiungere? Segui invece la guida all'hosting cloud.
Apri l'app, vai alla pagina Mappe e clicca su Impostazioni. Da lì puoi cambiare il nome, i colori, il logo, la password, la porta e la dimensione del team, nessun file da modificare. Le modifiche all'aspetto compaiono al prossimo aggiornamento; le modifiche a password e porta hanno effetto dopo aver riavviato il programma.
data/, proprio accanto al programma.data/ in un luogo sicuro..json dal pannello, comodo per spostare mappe tra computer.data/ e config.json insieme a esso.Per permettere ai compagni sulla stessa rete Wi-Fi o d'ufficio di aprire le tue mappe, devi prima dire all'app di accettare connessioni da altri computer, di default ascolta solo il tuo. Apri Impostazioni, imposta l'indirizzo di bind su 0.0.0.0 (in parole semplici: "accetta connessioni da qualsiasi computer sulla mia rete") e riavvia il programma. I compagni ti raggiungono poi su http://YOUR-COMPUTER-IP:8080.
Per trovare l'indirizzo IP locale del tuo computer (un numero come 192.168.1.42), esegui uno di questi in un terminale:
ipconfig, cerca la riga "Indirizzo IPv4".ipconfig getifaddr en0hostname -IVuoi che persone fuori dalla tua rete raggiungano l'app mentre gira ancora sul tuo computer? Un tunnel è un piccolo aiutante che dà alla tua app un indirizzo web pubblico https://…, senza modifiche al router, crittografato e gratuito. Il più semplice è un Cloudflare Tunnel.
cloudflaredcloudflared è lo strumento di tunnel gratuito di Cloudflare. Lo installi una volta sola:
winget install --id Cloudflare.cloudflared (oppure scarica cloudflared.exe dalla pagina dei download di Cloudflare).brew install cloudflared (richiede Homebrew).cloudflared dalla loro pagina delle release.Avvia l'app come al solito e lasciala aperta, è in ascolto su http://localhost:8080 (localhost significa semplicemente "questo computer"). Puoi lasciare l'indirizzo di bind sul valore predefinito; il tunnel raggiunge l'app proprio qui sulla tua macchina.
Apri una nuova finestra di terminale o PowerShell (lascia l'app in esecuzione nella sua finestra) ed esegui:
cloudflared tunnel --url http://localhost:8080Dopo un istante stampa un indirizzo pubblico come https://random-words.trycloudflare.com. Condividi quel link, i compagni lo aprono da ovunque, accedono con la tua password e modificano dal vivo insieme a te. Tieni aperte entrambe le finestre (l'app e il tunnel); chiudere la finestra del tunnel interrompe la condivisione.
Questo tunnel rapido non richiede alcun account Cloudflare, ma l'indirizzo cambia ogni volta che lo riavvii. Per un indirizzo permanente sul tuo dominio, crea un account Cloudflare gratuito e configura un tunnel con nome, la guida all'hosting cloud mostra la stessa configurazione di cloudflared, e funziona allo stesso modo puntando al tuo PC locale. Per un'istanza sempre attiva, anche quando il tuo computer è spento, eseguila su un piccolo server cloud.