🍚 깃밥 PRO가 열렸어요 — 월 3,900원 · 알아보기 →
PolarPatch/BlueWatch

Bluetooth 기기 수동 감지 도구로 신호 강도 레이더와 미분류 기기 알림을 제공합니다.

완성 앱맘대로 써도 됨 · MIT데브옵스·인프라Python난이도
70+5이번 주0 찜
4포크2이슈

중간맛 분석

Bluetooth Low Energy(BLE)와 클래식 Bluetooth 신호를 지속 수신해 주변 기기를 식별하고 시간 경과에 따른 출현 패턴을 추적합니다. 사용자는 웹 대시보드에서 기기를 "알려진 것" 또는 "감시 대상"으로 분류하고, 카테고리별로 정리해서 낯선 기기 도착 시 알림을 받습니다. 신호 강도(RSSI) 이력, 시간별 활동 히트맵, 기기 상관관계 분석(함께 나타나는 기기 감지) 같은 분석 기능도 제공합니다. 또는 한 줄 설치 스크립트로 시작할 수 있으며, BlueZ(Linux Bluetooth 스택)가 호스트에 미리 설치되어 있어야 합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • 집이나 사무실 주변에서 새로운 기기 출현을 감시해 보안 이상 감지
  • 방문자의 Bluetooth 기기 도착과 거주 시간 패턴 추적
  • 스마트홈 기기들의 활동 시간대와 신호 강도 변화를 분석해 작동 상태 파악

핵심 기능

실시간 신호 강도 레이더와 기기 도착·퇴장 로그기기 분류(휴대폰·오디오·웨어러블·IoT 등)와 사용자 정의 카테고리30일 출현 타임라인, 신호 강도 이력, 시간별 활동 히트맵, 기기 상관관계 분석

대안 대비 차별점

블루후드(Bluehood)의 바탕 위에서 중첩 카테고리 드래그앤드롭, 기기별 알림 설정, IRK 기반 주소 해석, 임의 MAC 링크 추적 같은 고급 필터링과 분석을 더해 유명한 기기 소음을 걸러낸 신규 기기 감지에 집중합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • 64비트 Linux 또는 macOS
  • Bluetooth 4.0 이상의 중앙 역할 지원 어댑터
  • Docker 설치 시: Docker Compose v2 (또는 Linux 직접 설치 시 Python 3.9+)
  • Docker 설치 시: 호스트에 BlueZ 설치 및 실행 중

바로 차려먹기Python (uv)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/PolarPatch/BlueWatch.git &&
cd BlueWatch &&
uv sync

uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. 호스트에 BlueZ 설치 및 활성화
sudo apt install bluez
sudo systemctl enable --now bluetooth
  1. 저장소 복제
git clone https://github.com/PolarPatch/BlueWatch.git
cd BlueWatch
  1. Docker Compose로 빌드 및 시작
docker compose up -d --build
  1. 웹 대시보드 접속
http://localhost:8080

또는 Linux 한 줄 설치 (Docker 불필요):

./install.sh

데이터는 /var/lib/bluewatch에, systemd 서비스는 자동 시작으로 설정됩니다.

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try PolarPatch/BlueWatch

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

70+5 / 7일

확인 시각

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

「데브옵스·인프라」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/PolarPatch/BlueWatch.svg)](https://www.gitbap.com/r/PolarPatch/BlueWatch)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기