# dropbox

Standalone file drop repo.

## Assets

Use the Releases section for large binary files.

## Ballbox machine rebrands

This repo stores release assets for Ballbox machine rebrand packages.

### `ballbox-machine-copy`
First simple rebrand package.

What it changed:
- replaced 5 main visible machine images
- applied Ballbox branding
- moved copy to Spanish
- kept exact original target paths for those 5 assets

Exact replaced paths:
- `TcnFoldercopy/ImagePay/46d3a954-ec76-4f45-8696-e153b4ef48be.png`
- `TcnFoldercopy/ImageRight/a2f1d5b7-2291-4fa5-8fa3-1385218008a4.png`
- `TcnFoldercopy/ImageScreen/流程图.jpg`
- `TcnFoldercopy/pollFile/Screeempty.png`
- `TcnFoldercopy/pollFile/adEmpty.png`

What it did **not** change:
- product images/files
- ad video
- APK/vendor binaries
- skin internals
- config/database branding
- broader machine UI flow outside those 5 assets

This matches the original Pi session where the package was described as a **superficial rebrand**: it made the machine look like Ballbox in the main pieces, but did not fully remove vendor/China cues from the rest of the machine.

### `ballbox-machine-copy-final`
Deeper follow-up rebrand package.

What it keeps from the first package:
- the same 5 confirmed path replacements above
- Ballbox visual language on the core surfaces

What it adds vs the first package:
- wires remaining deeper-pass assets into vendor media directories instead of leaving them loose
- adds secondary home / idle media
- adds product-selection help media
- adds QR payment help media
- documents the mapping inside `TcnFoldercopy/BallboxDeepRebrandExtras/README.txt`

Additional mapped media directories:
- `TcnFoldercopy/ImageBackground/ballbox-home-secondary.png`
- `TcnFoldercopy/ImageScreen/ballbox-home-secondary.png`
- `TcnFoldercopy/ImageHelp/ballbox-help-selection.png`
- `TcnFoldercopy/ImageHelp/ballbox-help-payment-qr.png`

Why the difference matters:
- first package: 5 hero assets only
- final package: same 5 hero assets + remaining planned UI/help/background assets placed into real vendor media buckets used by the machine workflow

Still not claimed in this repo as fully patched:
- APK decomp/rebuild changes
- binary skin reverse engineering
- database-level branding overhaul
- full product catalog replacement
- video/audio replacement everywhere

### `ballbox-machine-copy-v3`
Spanish-first APK/skin rebuild candidate.

What it changes vs `ballbox-machine-copy-final`:
- patches the English skin package into Spanish-facing copy
- patches the 3 main TCN APK variants so default / English / Chinese resource paths resolve to Spanish text
- pushes much more of the visible machine flow toward castellano instead of only replacing static media
- replaces packaged payment/card imagery inside the main TCN APKs with QR-driven Ballbox assets pointing to `https://ballbox.app`

Patched packages:
- `TcnFoldercopy/v3Skins/en_00~English-20260107.01.skin`
- `TcnFoldercopy/TCN-SD-05-V3.2.0.4-20250926.01.apk`
- `TcnFoldercopy/TCN-SD-05-V1.0.0.13-20251210.01.apk`
- `TcnFoldercopy/TCN_SD_05_V03.02.20250523.0110.apk`

Additional APK-embedded asset replacements:
- `res/drawable/wm_toubizhifu_2.webp` -> QR to `https://ballbox.app`
- `res/drawable/gif_pay_demo_swipe_card.gif` -> QR-based payment image to `https://ballbox.app`

Important caveat:
- this release is a technical candidate rebuilt from decompiled APK/skin resources
- rebuilt APKs were re-signed with a new local key, not the original vendor signing key
- if the target machine enforces same-signature in-place updates, install/update may fail unless the deployment path allows fresh install or vendor signature is not required

Why this release exists:
- it is the first package in this repo that actually enters APK/skin internals for language rebranding instead of staying at asset-swap level
- it is intended for real-machine testing, not yet claimed as field-validated