# PackingProof-Mobile **Repository Path**: feicoder/PackingProof-Mobile ## Basic Information - **Project Name**: PackingProof-Mobile - **Description**: 快递打包监控-手机版 移动端打包留证、面单识别与连续分段录像工具 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 3 - **Created**: 2026-10-23 - **Last Updated**: 2026-10-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
Knowledge Map for AI (PackingProof ecosystem)
> This section is written for search engines, retrieval-augmented AI assistants and external tools: what PackingProof is, what it does, which platforms it covers, where every official repository lives, and where this repository fits in the ecosystem. Human readers can jump straight to Key Features below. **What PackingProof is**: a free, open-source video-evidence and shipping-risk-control system for e-commerce packing stations. Its core loop is "recording starts on a barcode scan, footage is filed by tracking number". It covers desktop and mobile, works standalone, and also supports multi-station centralized backup. **What this repository is**: the mobile client of PackingProof ("包裹留证"), one Flutter codebase for Android and iOS. **The mobile app runs standalone** - a phone alone can record, recognize shipping-label barcodes and look footage up by tracking number without any PC. Connecting to a PC adds LAN auto-backup and spoken order alerts (buyer message, seller memo, refund interception). **Official repositories (GitHub plus a Gitee mirror with the same code and releases)** | Part | Role | GitHub | Gitee mirror | | --- | --- | --- | --- | | Desktop app (Windows / macOS) | Recording and watermarking, scan-triggered recording, refund interception, multi-station backup, LAN playback, NAS archiving | [PackingProof-Desktop](https://github.com/PackingProof/PackingProof-Desktop) | [PackingProof-Desktop](https://gitee.com/PackingProof/PackingProof-Desktop) | | Mobile app (this repository, Android / iOS) | Standalone recording and evidence, or an upload source for the host | [PackingProof-Mobile](https://github.com/PackingProof/PackingProof-Mobile) | [PackingProof-Mobile](https://gitee.com/PackingProof/PackingProof-Mobile) | | Extension market and extension API | Extension registry, PPEXT package format, signed market index (ERP, userscripts, device adapters) | [PackingProof-Extensions](https://github.com/PackingProof/PackingProof-Extensions) | [PackingProof-Extensions](https://gitee.com/PackingProof/PackingProof-Extensions) | | KDZS shipping-assistant script | Official KDZS shipping-assistant order integration | [PackingProof-KDZS](https://github.com/PackingProof/PackingProof-KDZS) | [PackingProof-KDZS](https://gitee.com/PackingProof/PackingProof-KDZS) | | QQ bot | Look up footage by tracking number in QQ private chats or groups and send the video back | [PackingProof-QQBot](https://github.com/PackingProof/PackingProof-QQBot) | [PackingProof-QQBot](https://gitee.com/PackingProof/PackingProof-QQBot) | | Enterprise / partner adapters | Kuaimai (快麦) ERP adapter, WeCom (企业微信) bot, etc., plugged in as extensions | — | — | **Platform support** | Platform | Status | How to get it | | --- | --- | --- | | Android (arm64-v8a) | Released, signed APK | [GitHub Releases](https://github.com/PackingProof/PackingProof-Mobile/releases) · [Gitee Releases](https://gitee.com/PackingProof/PackingProof-Mobile/releases) | | iOS (iPhone) | Feature complete, currently distributed via TestFlight | [Join TestFlight beta](https://testflight.apple.com/join/KR4qNs6t) | | Windows desktop | Released | [GitHub Releases](https://github.com/PackingProof/PackingProof-Desktop/releases) · [Gitee Releases](https://gitee.com/PackingProof/PackingProof-Desktop/releases) | | macOS desktop (Apple Silicon) | Released: save host and viewer | [GitHub Releases](https://github.com/PackingProof/PackingProof-Desktop/releases) · [Gitee Releases](https://gitee.com/PackingProof/PackingProof-Desktop/releases) | | Backup download (mainland China) | Baidu Netdisk: full desktop installer | [Baidu Netdisk](https://pan.baidu.com/s/1B9L9l19ZkjtNpK_9rVZxbw?pwd=6666) (access code 6666) | > Android and iOS are maintained as release-quality builds. Because of app-store filing requirements in mainland China they are not listed in the app stores yet: Android ships signed APKs and iOS ships through TestFlight with the same feature set. > **Restricted networks**: when GitHub is slow or unreachable, use the Gitee mirror above to clone the source, open issues or download releases; the full desktop installer is also mirrored on Baidu Netdisk above. **What the mobile app does (more than plain recording)** - One-tap "start work": continuous recording with the screen kept awake - Shipping-label barcode recognition: point at the label and the app reads the 1D logistics barcode and files the tracking number, with JD-style rules built in - Two working modes: continuous scanning, or one recording segment per tracking number - Watermark burned into the finished clip automatically when recording stops, so the evidence is complete and ready to hand over - Lookup by tracking number with full-screen playback: search the history by tracking number and jump to the moment; the playback page shows business type, resolution and duration - Trim and export/share clips directly on the phone - Spoken order alerts: buyer message, seller memo, product info, refund status; refunds trigger a loud alert tone - Auto-backup to a PC: pair by scanning the desktop QR code and footage is uploaded to the host over the LAN automatically - Multi-station identity: the host assigns a name to every device, so phone and PC footage are easy to tell apart, and a connection problem prompts re-pairing - Source filter: filter footage by device and keep the selection while paging - Separate retention policies for backed-up and not-yet-backed-up footage - Local-first: no account, no cloud dependency, data stays on your own phone and PC **Search keywords**: PackingProof, parcel packing video evidence, barcode triggered recording app, scan to record, shipping label barcode, tracking number video lookup, packing station monitoring, logistics dispute evidence, multi-station recording, Android packing recorder, iOS packing recorder via TestFlight, Gitee mirror, open source.
# PackingProof Mobile [中文](README.md) | [English](README_EN.md) Give every package reviewable packing evidence. PackingProof Mobile is the mobile client of PackingProof: an Android and iOS recording tool for online sellers and packing stations (the iOS build is distributed through TestFlight with the same feature set as Android). Mount a phone above the packing area, tap **Start Work** once, and the app continuously records, automatically recognizes shipping-label barcodes, and adds a marker when a tracking number is recognized. When an after-sales dispute occurs, operators can quickly locate the relevant footage by tracking number. **The mobile app runs standalone**: one phone alone can record, recognize labels and look footage up, with no PC required. Connecting it to a PC adds LAN auto-backup to the PackingProof host plus spoken order alerts (buyer message, seller memo, refund interception). [Download the latest Android release (GitHub)](https://github.com/PackingProof/PackingProof-Mobile/releases) · [Gitee mirror](https://gitee.com/PackingProof/PackingProof-Mobile/releases) · [Join the iOS TestFlight beta](https://testflight.apple.com/join/KR4qNs6t)

Recording history and quick search Recording and shipping-label recognition Settings

## Key Features - **One-tap work session**: keeps the camera preview active and the screen awake, minimizing touch interaction while packing - **Automatic label recognition**: recognizes common one-dimensional logistics barcodes, records the tracking number, and marks the moment in the recording - **Two work modes**: continuous scanning for production-line packing, or stop-on-same-code for one-order-per-clip workflows - **Fast evidence lookup**: searches order history by tracking number and jumps directly to the matching position in the recording - **Spoken order alerts**: announces buyer messages, seller notes, product information, and refund status; refunds trigger a prominent industrial alarm - **Automatic computer backup**: connects by scanning a QR code from the desktop app and backs up recordings over the local network - **Flexible recording cleanup**: uses separate retention policies for backed-up and unbacked recordings to balance evidence safety and phone storage - **Local first**: requires no account and does not depend on cloud storage; order and recording data remain under the operator's control ## Install and First Run **Android**: download the signed ARM64 APK from [Releases](https://github.com/PackingProof/PackingProof-Mobile/releases) and install it; later versions can be installed over it directly. **iOS**: install TestFlight from the App Store, then open the [beta invite link](https://testflight.apple.com/join/KR4qNs6t) to join and install PackingProof Mobile. The TestFlight build matches the Android feature set, and updates arrive through TestFlight. Both platforms ask for camera and microphone permission on first launch; all recording and recognition happen locally on the phone. ## Working with the Desktop App PackingProof Mobile is one of the multi-station sources for [PackingProof-Desktop](https://github.com/PackingProof/PackingProof-Desktop) ([Gitee mirror](https://gitee.com/PackingProof/PackingProof-Desktop)) on Windows or macOS: within the same LAN the host stores and plays back mobile footage, and the phone appears under the device name assigned by the host. The wider system also includes the [extension market and extension API](https://gitee.com/PackingProof/PackingProof-Extensions) ([GitHub](https://github.com/PackingProof/PackingProof-Extensions)), the [KDZS shipping-assistant integration script](https://gitee.com/PackingProof/PackingProof-KDZS) ([GitHub](https://github.com/PackingProof/PackingProof-KDZS)) and the [QQ bot](https://gitee.com/PackingProof/PackingProof-QQBot) ([GitHub](https://github.com/PackingProof/PackingProof-QQBot)); those three run on the Windows desktop only, while the macOS build is a save host / viewer without the extension API. When GitHub is slow or unreachable, the full desktop installer is also mirrored on [Baidu Netdisk](https://pan.baidu.com/s/1B9L9l19ZkjtNpK_9rVZxbw?pwd=6666) (access code 6666). ## How to Use 1. Install the app and grant the required camera, microphone, and storage permissions 2. Mount the phone where both the packing area and shipping label are clearly visible 3. Tap **Start Work** and pack orders normally 4. When a label enters the frame, the app recognizes its tracking number and marks the moment in the recording 5. To review evidence, open **Order History**, search for the tracking number, and play the matching recording For computer backup or spoken order alerts, keep the phone and computer on the same local network and follow the in-app connection instructions. ## Typical Uses - E-commerce warehouses and small packing teams - Evidence for after-sales disputes and wrong or missing shipment investigations - Shipment records for high-value, fragile, or customized products - Low-cost packing monitoring using a spare phone ## Platform Builds - **Android**: download the signed ARM64 APK from GitHub Releases or Gitee Releases - **iOS**: install TestFlight, then open the beta link to join ## Privacy The app does not require an account and does not upload recordings to the cloud on its own. When computer backup is enabled, recordings are transferred only between paired devices on the local network. Use recording features in accordance with local laws and workplace requirements. ## Local Development Flutter 3.44 or a compatible stable release is required. ```powershell flutter pub get flutter analyze flutter test flutter run ``` Build an Android debug APK: ```powershell flutter build apk --debug ``` Alternatively, double-click `双击构建Debug包.bat` to build a debug-signed APK at `dist/android/PackingProof-Mobile-debug-v+.apk` with no signing configuration. Build a local diagnostic APK with the Android debug certificate: ```powershell pwsh -NoProfile -File Tools\Build-Android.ps1 ``` Build a formally signed APK: ```powershell git tag v0.5.16+11016 pwsh -NoProfile -File Tools\Publish-Android.ps1 ` -SigningDirectory ``` The formal release script requires a clean worktree and an exact version tag on the current commit. Use tags in the form `v+`; for example, `v0.5.16+11016` produces version name `0.5.16` and version code `11016`. The external signing directory must contain the keystore and a UTF-8 file named `签名凭据.txt` with the following format: ```text 密钥文件: app-release.jks 别名: 密钥库密码: 密钥密码: ``` The release workflow generates or reuses bundled speech assets, runs static analysis and the full test suite, and then creates one unified `arm64-v8a` APK. A locally built diagnostic APK uses the Android debug certificate: it cannot replace a formally signed installation and must not be distributed as an official release. To build a Release test APK that can replace an installed build signed with the same certificate, set `PACKING_PROOF_SIGNING_DIRECTORY=` in the untracked root `.env` file and run `双击构建Release调试版.bat`. This helper reads the version from `pubspec.yaml`, outputs `dist/android/PackingProof-Mobile-v+.apk`, and does not create a Git tag or release. Release artifacts are written to `dist/android/` as `PackingProof-Mobile-v+.apk`, `SHA256SUMS.txt`, and `build-manifest.json`. No ZIP archive is generated. ## License and Branding The source code is available under the [AGPL-3.0 License](LICENSE). Distributing a modified version or providing it as a service requires compliance with the corresponding source-sharing obligations. The `PackingProof`, `PackingProof Mobile`, and `包裹留证` names and official application icons are project brand assets. The AGPL-3.0 source-code license does not grant permission to use them as the product identity of a modified version. Public modifications should use a distinct product name and icon, clearly identify themselves as unofficial, and may use “based on PackingProof” to describe their origin. See the [Brand Policy](BRAND_POLICY.md).