Pular para o conteúdo
andarama

andarama me deixa andar por panoramas

Envie suas fotos 360, ligue umas às outras como quem desenha uma planta e publique um tour que se percorre de qualquer navegador, inclusive com óculos de realidade virtual.

código aberto (EUPL-1.2) · grátis no seu servidor · hospedado aqui a partir de US$ 2 por mês

Ande por um de verdade

Isto não é um vídeo: é um tour publicado com o Andarama. Arraste para olhar, clique nas setas para andar. Experimente o menu de projeções e o botão dos óculos.

fotografias esféricas do Wikimedia Commons (CC BY-SA) · as atribuições estão dentro do próprio tour

Um tour em quatro passos

  1. 1

    Envie as fotos

    De qualquer câmera 360 ou do celular. O importador lê um lote inteiro, ordena pela numeração da câmera, renomeia por padrão e fatia os panoramas no seu próprio navegador, até 32K, sem esperar por servidor nenhum.

  2. 2

    Ligue umas às outras

    Arraste uma cena sobre outra e pronto: já existe uma passagem, com volta. No grafo, cada seta é um hotspot de navegação: não há dado paralelo que possa se dessincronizar.

  3. 3

    Conte a história

    Textos, fotos, vídeos, áudio, PDF, modelos 3D, perguntas, formulários, plantas baixas, narração com áudio espacial e traduções. Dezessete tipos de hotspot, todos acionáveis também dentro dos óculos.

  4. 4

    Publique

    Um link, um iframe, um domínio próprio ou um ZIP que funciona em qualquer hospedagem. Em modo quiosque para uma TV, em SCORM para o Moodle, em PWA para ver sem conexão.

o editor

Edita-se olhando, não preenchendo

A pré-visualização é o visualizador de verdade em modo de edição: o que você vê é o que se publica. Clica-se na foto para colocar um hotspot, arrasta-se para movê-lo, desenha-se um polígono vértice a vértice.

A orientação com que se entra numa sala não é da sala, é do caminho: entrar na sala de estar pelo corredor e pela cozinha são duas chegadas diferentes, e cada uma guarda a sua vista. O painel “Como se chega aqui” reúne todas onde podem ser avaliadas: na cena de destino.

  • Desfazer e refazer sem limite, salvamento automático com aviso se algo não chegar ao servidor
  • Histórico de versões com diferenças por cena e hotspot, e restauração
  • Paleta de comandos, atalhos de teclado e painel de propriedades com abas
  • Presença e bloqueio suave por cena quando várias pessoas editam, comentários ancorados com threads
  • Traduções lado a lado com porcentagem de conclusão, XLIFF e CSV
O editor do Andarama com uma cena da catedral de Geisenheim, a lista de cenas à esquerda e o painel de chegadas à direita

o grafo

A planta do tour, desenhada

Uma tela com miniaturas, portas, marquise, minimapa e ordenação automática. Liga-se arrastando a partir da borda do nó, e a volta se cria de uma vez. Avisa das passagens sem destino, sem volta, sem posição e das cenas às quais não se chega.

No modo Autopilot, a mesma tela desenha os tours guiados: paradas com permanência, entrada pela passagem que une as duas cenas e giro em direção à saída antes de cruzar. É o que o quiosque e o botão de visita automática reproduzem.

O grafo do tour com as cenas agrupadas por áreas e as ligações desenhadas como setas

o painel e a biblioteca

Tudo à mão, como numa escrivaninha

Pastas, etiquetas, modelos, lixeira de trinta dias e busca. A capa de cada tour é o panorama da sua cena inicial. Duplicar, renomear, compartilhar com um colega com o papel dele.

A biblioteca mostra um little planet ao passar o mouse sobre qualquer panorama, calculado localmente sem pedir nada à rede, e o duplo clique abre a foto em 360 para conferi-la antes de usar. Uma mídia, uma seleção ou uma pasta inteira se arrastam para o grafo e viram cenas.

  • Envio direto multiparte e retomável, sem duplicados graças ao hash do conteúdo
  • Leitura de metadados GPano e EXIF com GPS, nivelamento e ajuste de nadir sem destruir o original
  • Valores padrão em cascata: instância, organização, usuário, modelo e tour
O painel de projetos do Andarama com as capas de quatro tours

Dezessete maneiras de tocar a foto

Cada hotspot tem posição, ícone, etiqueta, escala por distância e condições (idioma, variáveis, instante do vídeo). E todos aparecem nos óculos como pictogramas que se tocam com a mão.

o visualizador

Vidro escuro sobre a foto, e nada que a cubra

Multirresolução com fatiamento próprio até 32K, panoramas parciais, cubemaps, estéreo e planos gigapixel. Vídeo 360 mono e estéreo (MP4, WebM, HLS) com hotspots por instante. Áudio ambiente com fade, narração, música com atenuação e áudio espacial que gira com a cabeça.

  • Projeções little planet, olho de peixe, Panini e arquitetônica, com os hotspots no lugar
  • Bússola com norte real, planta baixa com radar multiandar e mapa sobre OpenStreetMap
  • Mouse, toque, teclado completo, controle e giroscópio com retículo de olhar
  • Temas claro e escuro, cor, tipografia e CSS próprio; telas de boas-vindas e de fim
  • Links profundos para cena, orientação e idioma; menu de cenas com busca
  • Cento e dezesseis kilobytes comprimidos com o motor de realidade virtual incluído
O visualizador do Andarama mostrando o interior de uma catedral, com a barra de controles à direita e a faixa de miniaturas embaixo

realidade virtual

Abre-se o endereço nos óculos e pronto

Com óculos

WebXR de verdade: as duas vistas se desenham ao mesmo tempo, as mãos com suas vinte e cinco articulações, a pinça de polegar e indicador, o toque direto nos painéis e os controles com raio. Mãos e controles convivem na mesma sessão.

Com papelão

Qualquer celular sem WebXR: tela dividida, orientação por giroscópio com permissão do iOS, seleção por olhar com anel de permanência e o botão físico dos óculos de papelão.

Sem as mãos

Com giroscópio aparece um retículo que abre o que se olha. Os painéis imersivos se desenham dentro da sessão: texto, imagem, galeria, vídeo com transporte, áudio com transcrição, quiz pontuável e comparador com divisor.

o que se exporta conserva a realidade virtual: o motor é autocontido e o pacote traz as condições de hospedagem

Para ensinar, para avaliar, para deixar registro

O que uma sala de aula pede já vem de série.

Quiz com nota

Perguntas espalhadas pelo tour, pontuação, mínimo para aprovar, embaralhamento, tentativas, relatório final e certificado PDF com o nome do aluno.

Caça ao tesouro

Objetos escondidos pelas cenas, progresso visível e variáveis de estado que abrem portas quando todos foram encontrados.

Moodle e companhia

LTI 1.3 Advantage: o tour se insere a partir do próprio Moodle, com seletor de conteúdo, e devolve a nota ao livro de notas. E SCORM 1.2 e 2004 para qualquer outro campus.

Visitas guiadas ao vivo

Uma sala com código: o guia move a cena e a vista de todos, aponta com o ponteiro, conversa no chat; cada participante pode se soltar e voltar a sincronizar.

Formulários

Inscrição, pesquisa ou contato dentro do próprio tour. As respostas ficam guardadas e se baixam em CSV, ou se reenviam a um webhook.

Analítica sem cookies

Visitas, funil de cenas, hotspots mais usados, tempo por cena e mapa de calor de para onde as pessoas olham. Sem rastrear ninguém: cumpre a LGPD e o RGPD de fábrica.

Para museus, arquivos, bibliotecas, monumentos e prefeituras há uma página própria: tour virtual navegável, visitas guiadas ao vivo para escolas, quiz, acessibilidade e exportação livre. Andarama para museus

Publicar, compartilhar, exportar

Um link

  • Público, não listado, com senha, só para a sua organização ou só nos seus domínios
  • Publicação programada e data de expiração
  • Domínio próprio por CNAME: o tour na raiz do seu site
  • Cartão social com a projeção real da cena, título e texto traduzíveis
  • Abre o tour normal ou o modo quiosque para uma TV de recepção
  • Código QR pronto para imprimir

Dentro de outro site

  • Um iframe ou o componente <anda-tour> com uma linha de script
  • API por postMessage: ir a uma cena, girar a vista, mudar de idioma, escutar eventos
  • Sitemap, robots e versão em texto simples pré-renderizada para os buscadores
  • Webhooks ao publicar e API REST documentada com OpenAPI, com tokens por escopo

Sem o Andarama por trás

  • ZIP estático autocontido: funciona em qualquer hospedagem, com caminhos relativos
  • HTML único para abrir de um pen drive
  • PWA com service worker para ver sem conexão
  • SCORM 1.2 e 2004 com relatório de conclusão e nota
  • Quiosque em loop, com liberação ao tocar e retorno sozinho
  • Exporta-se do navegador, com idiomas, resolução e downloads à escolha

A sua nuvem ou a de ninguém

Nenhum módulo do Andarama fala diretamente com a Cloudflare: tudo passa por uma camada de adaptadores. Por isso o self-host não é uma versão recortada, e sim a mesma aplicação.

Cloudflare, um comando

Workers, D1, R2, KV, Durable Objects e Analytics Engine, dentro da camada gratuita para usos pequenos e médios. pnpm deploy:cloudflare e em dez minutos há uma instância.

Desktop, um executável

Um único arquivo para macOS, Windows e Linux com o servidor, o Studio e o visualizador dentro. Duplo clique, o navegador abre e os dados ficam na sua pasta pessoal. Sem Docker, sem Node, sem conta de ninguém.

Docker, um arquivo

Node e SQLite numa única imagem, um volume e uma porta. docker compose up -d. Cópias de segurança com um script e o arquivo portátil .andarama.

Segurança de série

CSP com nonces, HSTS, sessões seguras, CSRF de token duplo, limites de requisições, Turnstile, sanitização de SVG, Markdown e CSS, auditoria e permissões verificadas no servidor em cada rota.

Contas e equipes

Organizações com papéis (administra, edita, colabora, lê), compartilhamento por projeto, convites, SSO institucional por OIDC com cadastro automático por domínio, verificação em duas etapas e painel de administração com cotas e uso.

Acessível e internacional

Teclado completo, foco visível, alvos de 44 pixels, anúncios de mudança de cena, texto alternativo obrigatório com sugestão por IA revisável, prefers-reduced-motion, legendas WebVTT e traduções por cena e por hotspot.

Código aberto

EUPL-1.2, TypeScript estrito em todo o monorepo, centenas de testes unitários e de ponta a ponta, integração contínua com auditoria de dependências. O formato tour.json garante que o exportado continuará abrindo. O código, as issues e os downloads estão em github.com/joseluissaorin/andarama.

em andarama.com as contas e os pagamentos ficam com a Clerk · os dados continuam no banco de dados do Andarama

Por que “andarama”?

Panorama foi inventado em 1791 para nomear “a vista de tudo”. Desde então o sufixo -rama serve para as maneiras de olhar: diorama, ciclorama, cinerama.

Nós só trocamos o verbo: um panorama, a gente olha; um andarama, a gente anda.

de “andar” + “-rama” · e sim, a criatura amarela também anda

Quanto custa

O Andarama é de código aberto: grátis se você instala por conta própria. Se preferir que a gente cuide dele, em andarama.com há seis planos. Todos têm projetos limitados e uma política de uso razoável.

Teste de 14 dias sem cartão ao criar a conta.

Na sua casa

0 €

para sempre

  • Um executável para macOS, Windows e Linux: duplo clique e pronto
  • Ou Docker no seu servidor, ou a camada gratuita da Cloudflare
  • Sem cotas de plano: tantos tours quantos couberem
  • O mesmo programa, sem funções recortadas
Instalar · Na sua casa

Andar

US$ 2

por mês

  • 1 tour
  • 5 GB de mídia
  • Todo o editor, a RV e a exportação
Começar · Andar

Aula

US$ 42

por ano por docente

  • Até 5 tours
  • 10 GB de mídia
  • Todo o editor, a RV e a exportação
  • Alunos ilimitados com código de turma
  • Quiz com nota, escape room e caça ao tesouro
  • Pensado para um docente e suas turmas
Começar · Aula

Paseo

US$ 20

por mês
ou US$ 200 por ano

  • Até 10 tours
  • 50 GB de mídia
  • Todo o editor, a RV e a exportação
Começar · Paseo

Excursión

US$ 500

por ano

  • Até 500 tours
  • 100 GB de mídia
  • Todo o editor, a RV e a exportação
  • Sem o selo “Feito com Andarama”
  • Domínio próprio para os seus tours
Começar · Excursión

Formación

US$ 99

por mês
ou US$ 990 por ano

  • Até 100 tours
  • 200 GB de mídia
  • Todo o editor, a RV e a exportação
  • SCORM e LTI para o seu campus
  • Marca branca e domínio próprio
  • Equipe com várias pessoas editando
  • Pagamento por fatura
Começar · Formación

De por vida

US$ 1000

uma única vez

  • Até 1000 tours
  • 200 GB de mídia
  • Todo o editor, a RV e a exportação
  • Sem selo e com domínio próprio
Levar para sempre · De por vida

o gateway cobra em dólares; o banco faz a conversão · impostos conforme o seu país · uso razoável: se o uso deixar de ser o de uma pessoa ou de uma equipe pequena, conversamos antes de cortar qualquer coisa

O que costumam perguntar

Onde está o código?

No GitHub, sob EUPL-1.2. Pode-se ler, instalar, modificar e contribuir. Os executáveis de desktop e as notas de cada versão saem nas releases do mesmo repositório.

Que câmera eu preciso?

Qualquer uma que tire uma foto equirretangular (Insta360, Ricoh Theta, GoPro Max, Kandao…) ou o celular com um app de panoramas. Também servem cubemaps, panoramas parciais e fotos planas gigapixel. O fatiamento é feito no seu navegador até 32K; acima disso, no servidor.

Os tours continuam funcionando se o Andarama desaparecer?

Sim. O ZIP exportado é estático e autocontido: HTML, o visualizador e os tiles. Sobe-se em qualquer hospedagem, abre-se de um pen drive com o HTML único e conserva a realidade virtual. E o formato tour.json está documentado e versionado.

Onde ficam os meus dados?

Se você instala por conta própria, no seu servidor ou na sua conta da Cloudflare. Em andarama.com, no banco de dados do Andarama; a Clerk guarda só a conta e a cobrança. A analítica dos visitantes não usa cookies nem guarda endereços IP.

Funciona com o Moodle?

Com LTI 1.3: registra-se o Andarama como ferramenta externa, escolhe-se o tour a partir do próprio Moodle e a nota do quiz volta ao livro de notas. Para outros campus, o pacote SCORM 1.2 ou 2004.

Posso trabalhar com mais gente no mesmo tour?

Sim. Organizações com papéis, compartilhamento por projeto, presença e bloqueio suave por cena para ninguém pisar no pé de ninguém, comentários ancorados na foto e histórico de versões para voltar atrás.

Que óculos servem?

Qualquer um com navegador WebXR (Meta Quest, Pico, Vision Pro com Safari, PC com headset). Abre-se o endereço do tour no navegador dos óculos e clica-se no botão de realidade virtual. Sem óculos, o modo papelão funciona em qualquer celular.

O que significa “uso razoável”?

Que os planos foram pensados para uma pessoa ou uma equipe pequena. Se o uso deixar de parecer isso, conversamos antes de cortar qualquer coisa. E se você precisa de algo sem cotas, a instalação própria é grátis e é o mesmo programa.