green2blue 0.1.0__tar.gz

green2blue-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Cordwell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

green2blue-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: green2blue
+Version: 0.1.0
+Summary: Transfer SMS/MMS/RCS messages from Android to iPhone
+Author: green2blue contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/discordwell/green2blue
+Project-URL: Repository, https://github.com/discordwell/green2blue
+Project-URL: Issues, https://github.com/discordwell/green2blue/issues
+Project-URL: Changelog, https://github.com/discordwell/green2blue/releases
+Keywords: sms,mms,android,iphone,backup,migration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: System :: Archiving
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41.0
+Provides-Extra: device
+Requires-Dist: pymobiledevice3>=4.0; extra == "device"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# green2blue
+
+Move your texts from Android to iPhone. SMS, MMS, RCS, group chats, photos, videos — all of it.
+
+green2blue takes an export from the free [SMS Import/Export](https://github.com/tmo1/sms-ie) app and injects it into an iPhone backup. Restore the backup, and your messages show up in Messages like they were always there.
+
+## Quickstart
+
+### 1. Export from Android
+
+Install [SMS Import/Export](https://github.com/tmo1/sms-ie) on your Android phone. Export all messages as **NDJSON** with attachments. You'll get a ZIP file.
+
+### 2. Get the ZIP to your computer
+
+Email it, AirDrop it, USB it, cloud it — whatever works.
+
+### 3. Make an encrypted iPhone backup
+
+Connect your iPhone. Open **Finder** (macOS) or **iTunes** (Windows). Turn on **"Encrypt local backup"**, then click **"Back Up Now"**.
+
+> Encrypted backups are required — iOS won't restore messages from unencrypted ones.
+
+### 4. Install green2blue
+
+**Easiest — download a binary** from the [latest release](https://github.com/discordwell/green2blue/releases/latest). No Python needed.
+
+Or install with pip:
+```bash
+pip install green2blue
+```
+
+### 5. Run it
+
+```bash
+green2blue
+```
+
+The wizard walks you through everything. Or go direct:
+```bash
+green2blue inject export.zip
+```
+
+### 6. Restore the backup
+
+Back in Finder/iTunes, click **"Restore Backup"** and pick your backup. Done.
+
+---
+
+## Features
+
+**Review before import** — Let the Android owner browse and filter their export in-browser before you touch anything. Deselect conversations, search by contact or content, download a trimmed ZIP.
+
+```bash
+green2blue review export.zip
+```
+
+**Privacy-safe corpus** — Generate a representative sample ZIP with redacted text, anonymized contacts, and placeholder media. Safe to share for testing or bug reports.
+
+```bash
+green2blue corpus capture export.zip sample.zip
+```
+
+**Canonical archive** — Merge Android and iPhone message histories into a single SQLite archive. Deduplicates across sources, content-addresses attachments, and can re-export to either platform.
+
+```bash
+green2blue archive import-android export.zip archive.sqlite
+green2blue archive import-ios ~/path/to/backup archive.sqlite
+green2blue archive merge archive.sqlite
+```
+
+**iCloud sync protection** — iCloud Messages can wipe injected messages on sign-in. The `--disable-icloud-sync` flag prevents that.
+
+**Dry run** — See exactly what would be injected without modifying anything:
+```bash
+green2blue inject export.zip --dry-run
+```
+
+## Troubleshooting
+
+**"macOS can't verify this app"** — Right-click the file, click Open, then Open again. Or: `xattr -d com.apple.quarantine green2blue-macos-*`
+
+**"Windows Defender SmartScreen"** — Click "More info", then "Run anyway".
+
+**"No iPhone backups found"** — Create a backup first. Finder on macOS, iTunes on Windows.
+
+**"Wrong password"** — This is your *local backup password* from Finder/iTunes, not your Apple ID.
+
+**Messages disappear after restore** — iCloud Messages is wiping them. Re-run with `--disable-icloud-sync`, or don't sign into iCloud Messages right after restore.
+
+**Non-US phone numbers** — Use `--country GB` (or whatever). The wizard auto-detects this.
+
+## CLI Reference
+
+```
+green2blue                     Interactive wizard
+green2blue inject <zip>        Inject messages into a backup
+green2blue review <zip>        Browse/filter export in browser
+green2blue corpus capture      Privacy-safe sample generation
+green2blue archive <cmd>       Canonical archive operations
+green2blue list-backups        Show available iPhone backups
+green2blue inspect <zip>       Preview export contents
+green2blue verify <path>       Check backup integrity
+green2blue diagnose <path>     Show CloudKit sync state
+```
+
+Full CLI docs: [docs/CLI.md](docs/CLI.md)
+
+## Development
+
+```bash
+git clone https://github.com/discordwell/green2blue.git
+cd green2blue
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

green2blue-0.1.0/README.md

@@ -0,0 +1,119 @@
+# green2blue
+
+Move your texts from Android to iPhone. SMS, MMS, RCS, group chats, photos, videos — all of it.
+
+green2blue takes an export from the free [SMS Import/Export](https://github.com/tmo1/sms-ie) app and injects it into an iPhone backup. Restore the backup, and your messages show up in Messages like they were always there.
+
+## Quickstart
+
+### 1. Export from Android
+
+Install [SMS Import/Export](https://github.com/tmo1/sms-ie) on your Android phone. Export all messages as **NDJSON** with attachments. You'll get a ZIP file.
+
+### 2. Get the ZIP to your computer
+
+Email it, AirDrop it, USB it, cloud it — whatever works.
+
+### 3. Make an encrypted iPhone backup
+
+Connect your iPhone. Open **Finder** (macOS) or **iTunes** (Windows). Turn on **"Encrypt local backup"**, then click **"Back Up Now"**.
+
+> Encrypted backups are required — iOS won't restore messages from unencrypted ones.
+
+### 4. Install green2blue
+
+**Easiest — download a binary** from the [latest release](https://github.com/discordwell/green2blue/releases/latest). No Python needed.
+
+Or install with pip:
+```bash
+pip install green2blue
+```
+
+### 5. Run it
+
+```bash
+green2blue
+```
+
+The wizard walks you through everything. Or go direct:
+```bash
+green2blue inject export.zip
+```
+
+### 6. Restore the backup
+
+Back in Finder/iTunes, click **"Restore Backup"** and pick your backup. Done.
+
+---
+
+## Features
+
+**Review before import** — Let the Android owner browse and filter their export in-browser before you touch anything. Deselect conversations, search by contact or content, download a trimmed ZIP.
+
+```bash
+green2blue review export.zip
+```
+
+**Privacy-safe corpus** — Generate a representative sample ZIP with redacted text, anonymized contacts, and placeholder media. Safe to share for testing or bug reports.
+
+```bash
+green2blue corpus capture export.zip sample.zip
+```
+
+**Canonical archive** — Merge Android and iPhone message histories into a single SQLite archive. Deduplicates across sources, content-addresses attachments, and can re-export to either platform.
+
+```bash
+green2blue archive import-android export.zip archive.sqlite
+green2blue archive import-ios ~/path/to/backup archive.sqlite
+green2blue archive merge archive.sqlite
+```
+
+**iCloud sync protection** — iCloud Messages can wipe injected messages on sign-in. The `--disable-icloud-sync` flag prevents that.
+
+**Dry run** — See exactly what would be injected without modifying anything:
+```bash
+green2blue inject export.zip --dry-run
+```
+
+## Troubleshooting
+
+**"macOS can't verify this app"** — Right-click the file, click Open, then Open again. Or: `xattr -d com.apple.quarantine green2blue-macos-*`
+
+**"Windows Defender SmartScreen"** — Click "More info", then "Run anyway".
+
+**"No iPhone backups found"** — Create a backup first. Finder on macOS, iTunes on Windows.
+
+**"Wrong password"** — This is your *local backup password* from Finder/iTunes, not your Apple ID.
+
+**Messages disappear after restore** — iCloud Messages is wiping them. Re-run with `--disable-icloud-sync`, or don't sign into iCloud Messages right after restore.
+
+**Non-US phone numbers** — Use `--country GB` (or whatever). The wizard auto-detects this.
+
+## CLI Reference
+
+```
+green2blue                     Interactive wizard
+green2blue inject <zip>        Inject messages into a backup
+green2blue review <zip>        Browse/filter export in browser
+green2blue corpus capture      Privacy-safe sample generation
+green2blue archive <cmd>       Canonical archive operations
+green2blue list-backups        Show available iPhone backups
+green2blue inspect <zip>       Preview export contents
+green2blue verify <path>       Check backup integrity
+green2blue diagnose <path>     Show CloudKit sync state
+```
+
+Full CLI docs: [docs/CLI.md](docs/CLI.md)
+
+## Development
+
+```bash
+git clone https://github.com/discordwell/green2blue.git
+cd green2blue
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

green2blue-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "green2blue"
+version = "0.1.0"
+description = "Transfer SMS/MMS/RCS messages from Android to iPhone"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+keywords = ["sms", "mms", "android", "iphone", "backup", "migration"]
+dependencies = [
+    "cryptography>=41.0",
+]
+authors = [
+    { name = "green2blue contributors" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: System :: Archiving",
+]
+
+[project.urls]
+Homepage = "https://github.com/discordwell/green2blue"
+Repository = "https://github.com/discordwell/green2blue"
+Issues = "https://github.com/discordwell/green2blue/issues"
+Changelog = "https://github.com/discordwell/green2blue/releases"
+
+[project.optional-dependencies]
+device = ["pymobiledevice3>=4.0"]
+dev = [
+    "build>=1.2",
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.4",
+    "twine>=5.0",
+]
+
+[project.scripts]
+green2blue = "green2blue.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"green2blue.testing" = ["assets/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "SIM"]
+ignore = ["N801"]  # Allow iOS-prefixed class names (iOSHandle, iOSMessage, etc.)

green2blue-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

green2blue-0.1.0/src/green2blue/__init__.py

@@ -0,0 +1,3 @@
+"""green2blue — Transfer SMS/MMS/RCS messages from Android to iPhone."""
+
+__version__ = "0.1.0"

green2blue-0.1.0/src/green2blue/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running as `python -m green2blue`."""
+
+import sys
+
+from green2blue.cli import main
+
+sys.exit(main())

green2blue-0.1.0/src/green2blue/archive/__init__.py

@@ -0,0 +1,54 @@
+"""Canonical green2blue archive support.
+
+The canonical archive is the target-neutral storage format used for future
+merge and re-render workflows. The first implementation slice supports
+importing Android exports and iPhone backups into a SQLite-backed archive.
+"""
+
+from .android_import import AndroidArchiveImportResult, import_android_export
+from .db import ArchiveSummary, CanonicalArchive
+from .export_android import AndroidArchiveExportResult, export_merged_android_zip
+from .ios_import import IOSArchiveImportResult, import_ios_backup
+from .merge import ArchiveMergeResult, merge_archive
+from .render_verify import (
+    IOSRenderedTargetVerificationResult,
+    verify_ios_render_target,
+)
+from .report import ArchiveReport, build_archive_report
+from .stage import IOSStageResult, stage_ios_export
+from .verify import ArchiveVerificationResult, verify_archive
+from .workflow import (
+    IOSWorkflowInjectionResult,
+    IOSWorkflowPreparationResult,
+    IOSWorkflowStatus,
+    load_ios_workflow_status,
+    prepare_ios_workflow,
+    run_ios_workflow_injection,
+)
+
+__all__ = [
+    "AndroidArchiveExportResult",
+    "AndroidArchiveImportResult",
+    "ArchiveMergeResult",
+    "ArchiveReport",
+    "ArchiveSummary",
+    "ArchiveVerificationResult",
+    "CanonicalArchive",
+    "IOSStageResult",
+    "IOSArchiveImportResult",
+    "IOSRenderedTargetVerificationResult",
+    "IOSWorkflowInjectionResult",
+    "IOSWorkflowPreparationResult",
+    "IOSWorkflowStatus",
+    "build_archive_report",
+    "export_merged_android_zip",
+    "import_android_export",
+    "import_ios_backup",
+    "load_ios_workflow_status",
+    "merge_archive",
+    "prepare_ios_workflow",
+    "run_ios_workflow_injection",
+    "stage_ios_export",
+    "verify_ios_render_target",
+    "verify_archive",
+]