Biblioteca de rede embarcada em C, distribuída em dois arquivos, com pilha TCP/IP, TLS 1.3, HTTP, WebSocket, MQTT e atualizações OTA de firmware para microcontroladores.
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
Instale a imagem Docker pelo Docker Hub
docker pull owntracks/recorder - 2
Inicie o Recorder inscrito no tópico OwnTracks
./ot-recorder 'owntracks/#' - 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
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
Linha do tempo de localização auto-hospedada que transforma dados de GPS de apps como OwnTracks e Overland em permanências, viagens e análises — uma alternativa ao Google Timeline.
Servidor backend em Python/Java/Vue para dispositivos de voz xiaozhi-esp32 com ESP32, compatível com MQTT+UDP, WebSocket, MCP, reconhecimento de voz e base de conhecimento.
Biblioteca de rede C/C++ multiplataforma com event loop e suporte a clientes e servidores TCP/UDP, SSL, HTTP, WebSocket, MQTT e Redis.
Um cliente HTTP ergonômico para Rust, com APIs assíncronas e bloqueantes, JSON, multipart, proxies, cookies e TLS com rustls.
Backend de banco de dados JSON em tempo real que usa Operational Transformation para edição colaborativa multiusuário e sincronização ao vivo.