Steve-Mr/EmojiFace

Identify faces in an image and replace them with emojis.

FaceMoji 的功能

FaceMoji(亦稱為 EmojiFace)是一款小型 Android/Web 應用程式,偵測圖片中的人臉,並在每個臉部區域覆蓋表情符號(或套用模糊效果)。所有影像處理皆在本機進行——不會上傳至伺服器。

工作原理

  • 應用使用預先訓練的 YOLOv8‑face 模型(來自 derronqi/yolov8-face 專案)來定位影像中的人臉。
  • 一旦偵測到臉部矩形,應用會執行以下其中一項操作:
    • 在該區域繪製選定的表情符號,或
    • 套用多種模糊樣式之一(高斯模糊、像素化、半調類似效果)。
  • 使用者可手動新增、移動或刪除表情符號與模糊區域,並可匯入自訂的表情符號風格字型檔。

可執行的平台

平台 取得方式 說明
Web (PWA) 點擊 README 中的 Deploy with Vercel 按鈕,或依照 web/README.md 中的指示操作。該網站完全在瀏覽器中執行,不遠端儲存任何資料。 支援桌面與行動瀏覽器;可作為漸進式 Web 應用(PWA)安裝。
Android 從 GitHub 發布頁面下載最新版本(兩種 APK 風格):
default – 正常應用圖示(可在設定中隱藏)。
icon‑disabled – 圖示預設隱藏,專為「分享至應用」使用而設計。
兩個 APK 均已簽署,可手動安裝。隱藏圖示版本在僅透過 Android 分享功能啟動應用時非常實用。

主要功能

  1. 自動人臉偵測 → 預設表情符號覆蓋或模糊處理。
  2. 手動編輯 – 新增、移動或刪除表情符號 / 模糊區域。
  3. 多種模糊樣式 – 高斯模糊、像素化、自訂半調類似效果。
  4. 圖示隱藏模式 – 僅透過影像分享意圖啟動應用。
  5. 自訂表情符號字型 – 匯入自己的表情符號風格字型以變更覆蓋外觀。

限制與注意事項

  • 人臉偵測模型為 離線 且在裝置上執行,但不如雲端服務穩健——在某些影像中可能漏檢或誤檢人臉。
  • Web 版本由貢獻者(Jules / Vibe Coding)快速建構;程式碼品質與穩定性無法保證。
  • 應用以「原樣提供」,無任何保證

如何貢獻 / 自行建置

  • 倉儲包含一個 web 資料夾,其內部有獨立的 README 用於部署說明。
  • Android 原始碼可使用 Android Studio 編譯;兩種 APK 風格於 Gradle 設定中定義。
  • 人臉偵測模型來自外部 derronqi/yolov8-face 專案,因此更新模型只需替換應用使用的 .pt 檔案即可。

致謝

  • 表情符號圖示改編自 Freepik 上的 Carnival Masks Pack
  • 人臉偵測依賴於 derronqi/yolov8-face 提供的 YOLOv8‑face 模型。

TL;DR – FaceMoji 是一款以隱私為首要考量的 Android/Web 工具,使用裝置端的 YOLOv8 人臉偵測器將人臉替換為表情符號或模糊處理,支援可選的手動編輯與僅透過分享啟動的隱藏圖示模式。

相關

  • 專案
  • Dispatch
  • 專案
  • 專案
  • 專案