TL;DR

FlightScnr Pi는 Raspberry Pi와 4인치 원형 터치스크린을 항공기·선박용 실시간 레이더로 바꾸는 독립형 Python 도구입니다. FR24와 adsb.fi, 선택적 dump1090/readsb 및 aisstream.io에서 교통 데이터를 받아 지도 위에 표시하고, 터치하면 항공편·선박 상세 정보와 경로 추적 화면으로 이동합니다. 웹 포털에서 API 키와 데이터 소스, 화면 설정, OTA 업데이트를 관리할 수 있어 일상 운영에 SSH가 필요하지 않지만, Waveshare 하드웨어와 Raspberry Pi OS 64-bit 환경이 필수입니다. 비상업적 제작에는 적합하지만 Creative Commons BY-NC-SA 4.0 라이선스가 상업적 활용과 fork 배포 방식을 제한합니다.

핵심 포인트

• 이 레포지토리는 Raspberry Pi와 4인치 원형 터치스크린으로 항공기와 선박을 추적하는 독립형 하드웨어·소프트웨어 도구입니다. Python 애플리케이션이 원형 레이더 화면, 지도 타일, 제스처 탐색을 함께 처리하며 특정 프레임워크의 플러그인이나 MCP server는 아닙니다. Waveshare 4″ DSI LCD와 Raspberry Pi OS 64-bit 데스크톱 환경을 전제로 하므로 일반 PC에 바로 설치하는 용도와는 다릅니다.
• 항공기 위치는 FR24, adsb.fi, 선택적 dump1090/readsb 연동으로 수집하고 marine traffic은 aisstream.io를 통해 같은 레이더에 표시합니다. 화면을 터치하면 항공편·선박 상세 정보와 사진을 열고, 항공편을 추적하면 경로 지도와 Follow / Live 화면으로 전환합니다. FR24, Tomorrow.io, LiveATC, 날씨·강수·지진·산불 계층마다 API 키나 외부 서비스 상태가 필요하며 aisstream.io의 불안정성도 README에 명시돼 있습니다.
• 설치 스크립트는 Raspberry Pi OS와 Waveshare 패널 overlay를 준비한 뒤 X11 전환, GPIO 14 기반 냉각 팬, Wi‑Fi power save 비활성화, Bluetooth 활성화를 적용하고 재부팅합니다. 설치 후 `http://<hostname>.local` 웹 포털에서 SSH 없이 API 키와 데이터 소스, 화면 방향, 알림, 즐겨찾기, OTA 업데이트를 설정합니다. 하드웨어 조립부터 운영 장애 대응까지의 절차는 README보다 Wiki에 집중돼 있으므로 부품을 실제로 구매하기 전에 Hardware와 Software Setup 문서를 확인해야 합니다.
• 원본 코드와 문서는 Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International 라이선스를 따르므로 상업적 사용에는 별도 허가가 필요합니다. 공유하거나 수정한 fork는 저작자와 저장소, 라이선스를 표시하고 같은 라이선스로 배포해야 하며 소스 파일의 copyright·SPDX·`[AI-DIRECTIVE]` 헤더를 제거하면 안 됩니다. 비상업적 개인 제작과 항공·라디오·Raspberry Pi 취미 프로젝트에는 적합하지만 상용 제품에 편입할 때는 라이선스 제약이 핵심 검토 사항입니다.

이미지 분석