# iPhone Framer
Generate App Store-compliant screenshots by adding iPhone frames and promotional text to your app screenshots.
## Installation
```bash
pip install iphone-framer
```
Or use with uvx (no installation required):
```bash
uvx iphone-framer screenshot.png -o output.png -t "Amazing App" -s "Experience the future"
```
## Usage
### Basic Usage
```bash
iphone-framer screenshot.png -o output.png -t "Revolutionary Design" -s "Experience the future" --device 6.9_inch
```
### Gradient Backgrounds
```bash
# Ocean blue gradient
iphone-framer screenshot.png -o output.png -t "Ocean App" --gradient ocean
# Sunset gradient with diagonal direction
iphone-framer screenshot.png -o output.png -t "Sunset Vibes" --gradient sunset --gradient-direction diagonal
```
### Available Options
- `--device`: Choose from `6.9_inch`, `6.5_inch`, `6.1_inch`, `5.5_inch`
- `--gradient`: Use preset gradients: `ocean, sunset, forest, purple, midnight, rose, emerald, autumn, arctic, cosmic`
- `--gradient-direction`: `vertical` or `diagonal`
- `--bg-color`: Custom RGB background color as "R,G,B"
## Features
- 📱 Multiple iPhone sizes (6.9", 6.5", 6.1", 5.5")
- 🎨 Beautiful gradient presets
- 🏝️ Dynamic Island for modern iPhones
- 📐 App Store compliant dimensions
- ✨ Promotional text with shadows
- 🔄 Cross-platform font support
## Device Sizes
- `6.9_inch`: iPhone 14 Pro Max, 15 Pro Max, 16 Pro Max (1290x2796)
- `6.5_inch`: iPhone 14 Plus, 13 Pro Max, 12 Pro Max (1284x2778)
- `6.1_inch`: iPhone 14 Pro, 13 Pro, 12 Pro (1170x2532)
- `5.5_inch`: iPhone 8 Plus, 7 Plus, 6s Plus (1242x2208)
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "iphone-framer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "app-store, frame, generator, iphone, screenshot",
"author": "David Cai",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/4a/78/cec9ef6a407d6e0f741bfe6955d8267444068f34633b65753427bd5879bf/iphone_framer-1.0.0.tar.gz",
"platform": null,
"description": "# iPhone Framer\n\nGenerate App Store-compliant screenshots by adding iPhone frames and promotional text to your app screenshots.\n\n## Installation\n\n```bash\npip install iphone-framer\n```\n\nOr use with uvx (no installation required):\n\n```bash\nuvx iphone-framer screenshot.png -o output.png -t \"Amazing App\" -s \"Experience the future\"\n```\n\n## Usage\n\n### Basic Usage\n\n```bash\niphone-framer screenshot.png -o output.png -t \"Revolutionary Design\" -s \"Experience the future\" --device 6.9_inch\n```\n\n### Gradient Backgrounds\n\n```bash\n# Ocean blue gradient\niphone-framer screenshot.png -o output.png -t \"Ocean App\" --gradient ocean\n\n# Sunset gradient with diagonal direction\niphone-framer screenshot.png -o output.png -t \"Sunset Vibes\" --gradient sunset --gradient-direction diagonal\n```\n\n### Available Options\n\n- `--device`: Choose from `6.9_inch`, `6.5_inch`, `6.1_inch`, `5.5_inch`\n- `--gradient`: Use preset gradients: `ocean, sunset, forest, purple, midnight, rose, emerald, autumn, arctic, cosmic`\n- `--gradient-direction`: `vertical` or `diagonal`\n- `--bg-color`: Custom RGB background color as \"R,G,B\"\n\n## Features\n\n- \ud83d\udcf1 Multiple iPhone sizes (6.9\", 6.5\", 6.1\", 5.5\")\n- \ud83c\udfa8 Beautiful gradient presets\n- \ud83c\udfdd\ufe0f Dynamic Island for modern iPhones\n- \ud83d\udcd0 App Store compliant dimensions\n- \u2728 Promotional text with shadows\n- \ud83d\udd04 Cross-platform font support\n\n## Device Sizes\n\n- `6.9_inch`: iPhone 14 Pro Max, 15 Pro Max, 16 Pro Max (1290x2796)\n- `6.5_inch`: iPhone 14 Plus, 13 Pro Max, 12 Pro Max (1284x2778)\n- `6.1_inch`: iPhone 14 Pro, 13 Pro, 12 Pro (1170x2532)\n- `5.5_inch`: iPhone 8 Plus, 7 Plus, 6s Plus (1242x2208)\n\n## License\n\nMIT",
"bugtrack_url": null,
"license": "MIT",
"summary": "iPhone Screenshot Frame Generator for App Store",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/dcai/iphone-framer",
"Repository": "https://github.com/dcai/iphone-framer"
},
"split_keywords": [
"app-store",
" frame",
" generator",
" iphone",
" screenshot"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4e77d1b30c7b343137e053d7910b96a58012b592a8c92f1bef36e593b82e2cfc",
"md5": "4acd634672ca692fd525ba71d234c384",
"sha256": "27707e83c9594791bc3de10554c208173a5928e8687fff9a56f4104533522e74"
},
"downloads": -1,
"filename": "iphone_framer-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4acd634672ca692fd525ba71d234c384",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7198,
"upload_time": "2025-07-25T11:38:38",
"upload_time_iso_8601": "2025-07-25T11:38:38.371644Z",
"url": "https://files.pythonhosted.org/packages/4e/77/d1b30c7b343137e053d7910b96a58012b592a8c92f1bef36e593b82e2cfc/iphone_framer-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4a78cec9ef6a407d6e0f741bfe6955d8267444068f34633b65753427bd5879bf",
"md5": "9e3c9ddd94d5a9e611431bcfdf2c76b6",
"sha256": "5f7b2dd0e998b278ba91dc23c9a7b89f4e0c650230c57f6905ff9fca59e27999"
},
"downloads": -1,
"filename": "iphone_framer-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "9e3c9ddd94d5a9e611431bcfdf2c76b6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4453911,
"upload_time": "2025-07-25T11:39:07",
"upload_time_iso_8601": "2025-07-25T11:39:07.420341Z",
"url": "https://files.pythonhosted.org/packages/4a/78/cec9ef6a407d6e0f741bfe6955d8267444068f34633b65753427bd5879bf/iphone_framer-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 11:39:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dcai",
"github_project": "iphone-framer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "iphone-framer"
}
JSON
