Repolode
owntracks

owntracks/recorder

Servidor leve que armazena e disponibiliza dados de localização publicados pelos apps móveis OwnTracks via MQTT ou HTTP, sem banco de dados externo.

Estrelas
1,222
Forks
147
Issues abertas
12
Último commit
há 11 dias

O que é?

O OwnTracks Recorder assina um broker MQTT ou aceita requisições HTTP POST com mensagens JSON do OwnTracks e grava os dados de localização em arquivos simples no disco. Ele disponibiliza esses dados por meio de uma API REST integrada e de um servidor WebSocket, que alimenta um mapa ao vivo atualizado conforme novas posições chegam.

A ferramenta de linha de comando ocat lê os dados armazenados diretamente e os imprime em JSON, GeoJSON, CSV, GPX, XML e outros formatos, com filtros por usuário, dispositivo e intervalo de tempo. O geocoding reverso pode associar endereços e códigos de país aos pontos, usando provedores como OpenCage ou Google, ou um serviço revgeod local.

O programa é escrito em C e foi projetado para rodar em hardware de baixo custo. É distribuído como pacotes Debian, imagem Docker e código-fonte que pode ser compilado com make, e pode ser estendido com hooks Lua.

Recursos principais

  • 01Recebe dados de localização por assinaturas MQTT ou HTTP POST
  • 02Armazena dados em arquivos simples, sem banco de dados externo
  • 03API REST integrada e mapa ao vivo via WebSocket
  • 04A ferramenta de linha de comando ocat exporta JSON, GeoJSON, CSV, GPX e XML
  • 05Geocoding reverso com OpenCage, Google ou revgeod
  • 06Hooks Lua para personalizar o comportamento

Casos de uso

  • Manter um histórico privado de localização dos seus próprios dispositivos OwnTracks em um servidor doméstico
  • Acompanhar os celulares de familiares em um mapa local sem enviar dados a um serviço de terceiros
  • Executar em um dispositivo de baixo consumo, como um Raspberry Pi
  • Exportar o histórico de localização para GPX ou CSV para análise

Início rápido

  1. 1

    Instale a imagem Docker pelo Docker Hub

    docker pull owntracks/recorder
  2. 2

    Inicie o Recorder inscrito no tópico OwnTracks

    ./ot-recorder 'owntracks/#'
  3. 3

    Abra a interface web em um navegador usando o endereço padrão

Antes de usar

  • Os pacotes são oferecidos apenas para um conjunto limitado de distribuições Linux; em outras plataformas, é necessário compilar a partir do código-fonte.
  • É necessário usar um broker MQTT, como o Mosquitto, a menos que você use o modo HTTP.
  • Os recursos de mapas precisam das suas próprias chaves de API de mapas.
  • A licença não está claramente especificada nos metadados.

Em coleções

Tópicos

#location-tracking#mqtt#owntracks#geolocation#self-hosted#websocket#geojson#http#jpdup#json

Perguntas frequentes

O que é recorder?
Servidor leve que armazena e disponibiliza dados de localização publicados pelos apps móveis OwnTracks via MQTT ou HTTP, sem banco de dados externo. O OwnTracks Recorder assina um broker MQTT ou aceita requisições HTTP POST com mensagens JSON do OwnTracks e grava os dados de localização em arquivos simples no disco. Ele disponibiliza esses dados por meio de uma API REST integrada e de um servidor WebSocket, que alimenta um mapa ao vivo atualizado conforme novas posições chegam.
recorder é gratuito? Qual é a licença?
recorder é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
recorder ainda é mantido?
Manutenção ativa. O último commit de recorder foi em 27 de out. de 2026.
Para que posso usar recorder?
Manter um histórico privado de localização dos seus próprios dispositivos OwnTracks em um servidor doméstico Acompanhar os celulares de familiares em um mapa local sem enviar dados a um serviço de terceiros Executar em um dispositivo de baixo consumo, como um Raspberry Pi Exportar o histórico de localização para GPX ou CSV para análise
Como instalar recorder?
Instale a imagem Docker pelo Docker Hub: docker pull owntracks/recorder Inicie o Recorder inscrito no tópico OwnTracks: ./ot-recorder 'owntracks/#' Abra a interface web em um navegador usando o endereço padrão
Onde consigo recorder?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/owntracks/recorder

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados