DJI Metadata Embedder

비디오 메타데이터 삽입

SRT 파일에서 추출한 GPS 좌표, 고도, 카메라 설정 등의 텔레메트리를 MP4 파일에 삽입합니다. 재인코딩 없이 빠르게 처리되며, 전체 텔레메트리는 자막 트랙으로 보존되어 편집기에서 오버레이로 사용할 수 있습니다.

지도 생성

폴더 내 모든 비행 기록을 하나의 대화형 지도로 표시하는 flightmap, 사진을 지도에 표시하는 photomap, 사진과 비행 기록을 함께 표시하는 map 명령을 제공합니다. 3D 지도 보기, 카메라 시선 추적, 비행 재생 기능도 지원합니다.

텔레메트리 내보내기

GPX, CSV, GeoJSON, KML, CoT 형식으로 텔레메트리를 내보낼 수 있습니다. GPX는 Google Earth, CSV는 스프레드시트, GeoJSON/KML은 GIS 도구, CoT는 ATAK/TAK와 호환됩니다.

검증 및 개인정보 보호

파일의 메타데이터를 확인하는 check 명령과 태양 위치를 이용한 그림자 검증 verify-sun 명령을 제공합니다. 또한 --redact 옵션으로 GPS 좌표를 약 100m로 흐리게 하여 개인정보를 보호할 수 있습니다.

설치 및 시작

Windows에서는 GitHub 릴리스에서 설치 프로그램을 다운로드하거나, winget 명령으로 설치할 수 있습니다. macOS에서는 DMG 파일을 다운로드하여 앱을 설치하고, Homebrew로 FFmpeg와 ExifTool을 설치합니다. Linux에서는 패키지 매니저로 FFmpeg와 ExifTool을 설치한 후 pip로 설치합니다.

설치 후 dji-embed doctor로 환경을 확인하고, dji-embed flightmap /path/to/footage로 비행 지도를 생성할 수 있습니다.

활용 예시

• 드론 비행 영상을 촬영한 후, dji-embed embed로 GPS 메타데이터를 삽입하여 Windows 사진 앱 등에서 위치로 검색할 수 있습니다.
• 여러 비행 기록을 dji-embed flightmap으로 하나의 지도에 표시하여 비행 경로를 비교할 수 있습니다.
• 사진 폴더를 dji-embed photomap으로 지도에 표시하여 촬영 위치를 한눈에 볼 수 있습니다.
• GPX 파일을 내보내 Google Earth에서 비행 경로를 확인할 수 있습니다.

지원 환경 및 요구사항

Windows, macOS, Linux에서 사용할 수 있습니다. 데스크톱 앱은 Windows와 macOS를 지원하며, CLI는 모든 플랫폼에서 사용할 수 있습니다. Python 기반 CLI를 사용하려면 Python 3.10 이상과 FFmpeg가 필요하며, 일부 기능(사진 지도 등)은 ExifTool이 필요합니다. Windows 설치 프로그램에는 FFmpeg와 ExifTool이 포함되어 있어 추가 설치가 필요 없습니다.

라이선스 및 확인사항

이 도구는 MIT 라이선스로 배포됩니다. 지도는 인터넷에서 배경 타일을 로드하므로 렌더링에 네트워크 연결이 필요합니다. 지도 및 내보내기 파일은 비행 위치를 공개하므로 공유 시 --redact 옵션을 사용할 수 있습니다.