Repolode
tess1o

tess1o/geopulse

OwnTracks, Overland 같은 앱의 GPS 데이터를 체류, 이동 경로, 분석 정보로 바꾸는 셀프 호스팅 위치 타임라인으로, Google Timeline의 대안입니다.

대체할 수 있는 제품:Google Timeline

스타
1,446
포크
64
열린 이슈
16
마지막 커밋
19시간 전

어떤 프로젝트인가요?

GeoPulse는 셀프 호스팅 위치 기록 플랫폼입니다. OwnTracks, Overland, GPSLogger, Home Assistant, Traccar, Dawarich, Colota 같은 소스에서 GPS 좌표를 받아 체류, 이동 경로, 데이터 공백을 검색할 수 있는 타임라인으로 변환하고, 각 이동 경로의 이동 수단도 분류합니다.

Immich의 사진, Memos의 메모, 날씨 정보를 타임라인에 추가할 수 있습니다. 거리 및 방문 분석, 여행 계획, 도시·국가별 요약, 연간 요약도 제공합니다. Valhalla를 통한 맵 매칭으로 원본 GPS 데이터는 그대로 유지하면서 노이즈가 있는 이동 경로를 도로에 맞출 수 있습니다.

친구별 공개 범위 설정, 공유 가능한 게스트 링크, OIDC/SSO 로그인, 암호화된 백업, GPX, GeoJSON, OwnTracks, CSV 내보내기를 지원합니다. Docker Compose, Helm, Unraid, Proxmox LXC 또는 수동 설치 방식으로 배포할 수 있으며, 개인 및 비상업적 용도의 무료 사용을 허용하는 BSL 1.1 라이선스를 적용합니다.

핵심 기능

  • 01GPS 좌표를 체류, 이동 경로, 데이터 공백으로 변환하고 이동 수단을 분류합니다.
  • 02OwnTracks, Overland, GPSLogger, Home Assistant, Traccar, Dawarich, Colota에서 실시간 위치 정보를 받습니다.
  • 03Immich 사진, Memos 메모, 날씨 정보를 위치 기록에 추가합니다.
  • 04Valhalla 맵 매칭을 사용해 이동 경로를 도로에 맞춥니다.
  • 05Google Timeline, GPX, GeoJSON, OwnTracks, CSV에서 데이터를 가져오고 표준 형식으로 내보냅니다.
  • 06MCP 서버와 OpenAI 호환 키를 사용하는 AI 채팅 옵션을 제공합니다.

활용 사례

  • 클라우드 서비스에 위치 기록을 저장하는 대신 내 이동 기록을 비공개로 보관합니다.
  • Immich 라이브러리의 사진과 함께 이동 경로와 체류 기록을 살펴봅니다.
  • 공개 범위를 세밀하게 설정해 가족이나 친구와 실시간 위치 및 기록을 공유합니다.
  • 기존 Google Timeline 내보내기 파일을 가져와 내 서버에서 살펴봅니다.

빠른 시작

  1. 1

    디렉터리를 만들고 구성 파일을 다운로드합니다

    mkdir geopulse && cd geopulse curl -L -o .env https://raw.githubusercontent.com/tess1o/GeoPulse/main/.env.example curl -L -o docker-compose.yml https://raw.githubusercontent.com/tess1o/GeoPulse/main/docker-compose.yml
  2. 2

    컨테이너를 시작합니다

    docker compose up -d
  3. 3

    localhost의 5555 포트에서 앱을 열고 프로덕션 환경에 맞게 .env 보안 설정을 확인합니다

사용 전 알아둘 점

  • BSL 1.1 라이선스가 적용되며, OSI 오픈소스 라이선스가 아닌 소스 공개 라이선스입니다.
  • 직접 호스팅하고 자체 위치 데이터를 유지 관리해야 합니다.
  • AI Chat과 같은 일부 연동 기능에는 자체 OpenAI 호환 API 키가 필요합니다.

토픽

자주 묻는 질문

geopulse은(는) 무엇인가요?
OwnTracks, Overland 같은 앱의 GPS 데이터를 체류, 이동 경로, 분석 정보로 바꾸는 셀프 호스팅 위치 타임라인으로, Google Timeline의 대안입니다. GeoPulse는 셀프 호스팅 위치 기록 플랫폼입니다. OwnTracks, Overland, GPSLogger, Home Assistant, Traccar, Dawarich, Colota 같은 소스에서 GPS 좌표를 받아 체류, 이동 경로, 데이터 공백을 검색할 수 있는 타임라인으로 변환하고, 각 이동 경로의 이동 수단도 분류합니다.
geopulse은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
geopulse은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
geopulse은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. geopulse의 마지막 커밋은 2026년 10월 19일입니다.
geopulse은(는) 어디에 사용할 수 있나요?
클라우드 서비스에 위치 기록을 저장하는 대신 내 이동 기록을 비공개로 보관합니다. Immich 라이브러리의 사진과 함께 이동 경로와 체류 기록을 살펴봅니다. 공개 범위를 세밀하게 설정해 가족이나 친구와 실시간 위치 및 기록을 공유합니다. 기존 Google Timeline 내보내기 파일을 가져와 내 서버에서 살펴봅니다.
geopulse는 어떻게 설치하나요?
디렉터리를 만들고 구성 파일을 다운로드합니다: mkdir geopulse && cd geopulse curl -L -o .env https://raw.githubusercontent.com/tess1o/GeoPulse/main/.env.example curl -L -o docker-compose.yml https://raw.githubusercontent.com/tess1o/GeoPulse/main/docker-compose.yml 컨테이너를 시작합니다: docker compose up -d localhost의 5555 포트에서 앱을 열고 프로덕션 환경에 맞게 .env 보안 설정을 확인합니다
geopulse은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tess1o/geopulse

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트