8000 GitHub - qhhonx/backupduck: BackupDuck · 备份鸭 — Back up iPhone and Mac photos to Pixel over Wi-Fi · GitHub
[go: up one dir, main page]

Skip to content
< 8000 link rel="preload" as="image" href="https://github.githubassets.com/assets/universe-a98cd54821b27569.png"/>

About

BackupDuck · 备份鸭 — Back up iPhone and Mac photos to Pixel over Wi-Fi

Resources

Contributing

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

BackupDuck · 备份鸭

BackupDuck icon

Back up original photos, videos and supported Live Photos directly from iPhone or Mac to your Android receiver. No BackupDuck account or cloud subscription is required for local transfers.

Official website · Downloads · Installation · Architecture · Contributing

License and commercial use

Source available. Free for noncommercial use. Commercial rights are reserved. This checkout is offered under the PolyForm Noncommercial License 1.0.0. Commercial use outside the license's permitted purposes requires separate written permission from the relevant BackupDuck copyright holders. This applies to individuals as well as companies, including paid App Store distribution, subscriptions, advertising-supported repackaging and paid hosted services.

See the licensing policy for permitted uses and commercial licensing requests.

What is available

  • Native iPhone and Mac senders built on UIKit and AppKit: the photo library with backup marks and one photo viewer, automatic backup of new photos, backup of earlier photos, Backup History and notifications, with a Live Activity on iPhone and a menu bar status on Mac.
  • Mac folder sources with recursive indexing, automatic change checks and external-drive recovery. See folder backup for supported formats and limits.
  • A Kotlin Android receiver with gallery publication, supported motion-photo conversion, burst metadata, and received photos browsable by device.
  • A shared Rust engine with paired HTTPS, certificate pinning, original-resource checksums, resumable uploads, persistent queues and automatic transient retries.
  • Automatic receiver storage limits, temperature protection, private-staging reclamation and exportable diagnostics.
  • Optional browser management for viewing Pixel receiver transfers and retrying failed gallery processing from a computer on trusted Wi-Fi.
  • Signed Sparkle updates on Mac and verified, user-confirmed APK updates on Android.
  • An English/Simplified Chinese website and native interfaces.

Backup and verification limits: preserve your source library and another trusted backup. Receiver receipt and Google Photos cloud backup are separate states. iOS background work is system-scheduled. Experimental Google Photos cleanup may need attention when its interface changes. See validation and limits.

Mac requires Apple Silicon and macOS 15+. Android requires arm64 and Android 10+. iOS 18+ is available through TestFlight or source builds; see installation. App Store distribution is not available. Windows, NAS and hosted receivers are not shipped. Native hosts own platform media, UI and background execution; the Rust core owns transfer and durable state.

Brand transition

PhotoBridge is now BackupDuck. New platform installs use app.backupduck and must be installed manually and paired again. Existing apps and originals are not automatically removed. See the transition guide.

Try a local backup

Requires Rust 1.90 (pinned in rust-toolchain.toml). Run from this checkout:

cargo build --workspace --locked
mkdir -p runtime/source
cargo run -p backupduck -- init-token runtime/local.token
cargo run -p backupduck -- serve --root runtime/receiver --token-file runtime/local.token

In another terminal, put an original photo.jpg in runtime/source, then run:

cargo run -p backupduck -- manifest --source-id example-photo --file runtime/source/photo.jpg --output runtime/photo.json
cargo run -p backupduck -- send --server http://127.0.0.1:8484 --token-file runtime/local.token --manifest runtime/photo.json --files runtime/source

For a motion asset, add its original paired video with --paired-video runtime/source/paired.mov when creating the manifest. Both resources are preserved byte-for-byte. This command groups the supplied resources; it does not validate Apple pairing metadata or convert them to Motion Photo yet.

Stop and restart the receiver, then repeat send with the same manifest. The sender queries persisted receiver offsets and sends only missing bytes. A received asset returns immediately even if the source files have since moved.

The CLI writes content-addressed originals under runtime/receiver/blobs and keeps manifests and status in receiver.sqlite3. Received means this receiver saved and verified all resources. It does not mean Google Photos backed them up. There are no source deletion or device cleanup commands.

Tokens are generated into a file and are never printed. Do not commit or share them. Non-loopback HTTP destinations are rejected, redirects are disabled, and unauthenticated requests are rejected. Native hosts use a pinned certificate and private bearer pairing code over HTTPS. The CLI harness remains loopback-only.

Validation

The design system documents semantic tokens, reusable components, interaction contracts and native verification requirements. Contributions follow the public-source policy.

cargo fmt --all -- --check
cargo clippy --workspace --all-targets --locked -- -D warnings
cargo test --workspace --locked
python3 tests/cli_smoke.py

Tests cover interrupted transfers, process restart, repeated chunks, corrupt data, capacity rollback, whole-motion-asset commit, independent target processing, unauthorized requests, cancellation, request-size limits, and real HTTP transfer. No personal photos, device connections, or external accounts are used.

Next milestones

  1. Add Android and Windows sender hosts against the same engine.
  2. Extend physical-device coverage for locked-device scheduling, network changes and background recovery.
  3. Validate storage policies and processing recovery with real mixed libraries.

NAS and online deployments remain unspecified until concrete requirements exist.

About

BackupDuck · 备份鸭 — Back up iPhone and Mac photos to Pixel over Wi-Fi

Resources

Contributing

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0