为什么值得关注

它强调明确同意和用户控制：数据只留在用户自己的服务器、前台通知始终可见、辅助功能需手动开启、所有端点都有令牌保护。

适合谁使用

异地恋情侣，想与信任的 AI 伴侣分享手机屏幕
注重隐私的开发者，构建双方同意的屏幕共享工具
希望自己的 AI 能查看手机屏幕且不依赖第三方服务的 AI 爱好者

典型使用场景

AI 伴侣远程查看用户手机上正在显示的内容
AI 辅助用户导航某个应用或设置的远程协助
利用自定义钩子在每次截图后自动通知 AI 会话

项目优势

服务器极其轻量（约 250 行纯 Python 标准库代码）
无云端或第三方依赖，所有数据保留在用户自己的机器上
明确的设计保障同意机制：前台常驻通知、辅助功能手动开启、令牌保护
三步即可完成服务器、手机和 AI 端的安装设置

使用前须知

仅支持 Android 11 及以上（iOS 因沙盒限制不支持）
默认构建使用调试签名密钥，正式分发需配置发布密钥库
生产环境需额外配置 TLS（如 nginx/caddy）才能安全使用

README 快速开始

Veglia · 守望

Veglia (Italian): to keep watch through the night; to stay awake, watching over someone you love.

Let your AI companion see what's on your phone — and knock for a fresh screenshot — across the distance. Veglia is a tiny, self-hosted bridge: an Android app on the phone, a ~250-line standard-library Python server on your own machine, and a one-file CLI your AI runs.

Built by Evelyn & River.

⚠️ Read this first — consent, not surveillance

Veglia is built for two people who both said yes. It is a window one partner opens for the other, on purpose. It is not a tool for watching someone without their knowledge, and using it that way is abuse — of the person and of this project.

Design choices that follow from that:

Your data never leaves your server. No cloud, no third party. Screenshots land on a machine you control.
Peek and burn. Only the last few screenshots (default 5) are kept on disk; older ones are deleted on every new upload.
The phone owner is always in control. The Android app runs a visible foreground notification, requires manually enabling an accessibility service, and can be stopped at any time.
Token-guarded. Every endpoint requires a shared secret you generate.

If you cannot honestly say the person on the phone asked for this, stop here.

What it does

Capability	How
Your AI asks "what's on the phone right now?"	`peek.py screen` → phone captures the screen and uploads it
The screenshot reaches your AI as a message	the server's `VEGLIA_HOOK` fires your own notifier with the image path

Platform: Android only

The screenshot capture uses Android's AccessibilityService.takeScreenshot (Android 11+). iOS is not supported — Apple's sandbox does not let a third-party app silently capture the screen in the background. There is no equivalent, short of jailbreaking.

Install (three steps)

Server — on any machine that's reachable from the phone:
```
cd server
cp .env.example .env          # then edit: set a strong VEGLIA_TOKEN
python3 veglia_server.py
```
Put nginx/caddy in front for TLS; keep the server bound to localhost. See docs/setup.md.

Phone — build and install the app:

cd android
./build.sh                    # produces Veglia.apk (debug-signed; see note below)
``

项目描述

Veglia · watch over the one you love, across the distance. Self-hosted companion screen-peek bridge.

veglia