# 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
# With custom output filename
uvx iphone-framer screenshot.png -o output.png -t "Amazing App" -s "Experience the future"
# Auto-generate output filename
uvx iphone-framer screenshot.png -t "Amazing App" -s "Experience the future"
```
## Usage
### Basic Usage
```bash
# With custom output filename
iphone-framer screenshot.png -o output.png -t "Revolutionary Design" -s "Experience the future" --device 6.9_inch
# Auto-generate output filename (creates screenshot_appstore.png)
iphone-framer screenshot.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": null,
"author_email": "Dongsheng Cai <pypi-contact@tux.im>",
"download_url": "https://files.pythonhosted.org/packages/ff/76/ef9b8f7690b70e13dc85f5e256d0d031b371437f2e22258b3dc6ab7704bf/iphone_framer-1.4.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\n# With custom output filename\nuvx iphone-framer screenshot.png -o output.png -t \"Amazing App\" -s \"Experience the future\"\n\n# Auto-generate output filename\nuvx iphone-framer screenshot.png -t \"Amazing App\" -s \"Experience the future\"\n```\n\n## Usage\n\n### Basic Usage\n\n```bash\n# With custom output filename\niphone-framer screenshot.png -o output.png -t \"Revolutionary Design\" -s \"Experience the future\" --device 6.9_inch\n\n# Auto-generate output filename (creates screenshot_appstore.png)\niphone-framer screenshot.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.4.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": "8037c65843d41f0d26837cddc70dc3caab6cb87576e9f59313e6f81fa20bfe57",
"md5": "3c97fbd8077a805176a6db0c44392cc3",
"sha256": "77a18977569f460116c9f71f3f2d85292afe6d0d816319d9c790a81e2e573b9a"
},
"downloads": -1,
"filename": "iphone_framer-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c97fbd8077a805176a6db0c44392cc3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7513,
"upload_time": "2025-08-17T14:35:52",
"upload_time_iso_8601": "2025-08-17T14:35:52.339062Z",
"url": "https://files.pythonhosted.org/packages/80/37/c65843d41f0d26837cddc70dc3caab6cb87576e9f59313e6f81fa20bfe57/iphone_framer-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ff76ef9b8f7690b70e13dc85f5e256d0d031b371437f2e22258b3dc6ab7704bf",
"md5": "6da0f6f30b4946325bfeeb4a3e16b3bf",
"sha256": "df1757273b9eacd6a23d6d90a627868fa3a1d73e0ef4545cf4a52696702bb6a7"
},
"downloads": -1,
"filename": "iphone_framer-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "6da0f6f30b4946325bfeeb4a3e16b3bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 186339,
"upload_time": "2025-08-17T14:35:54",
"upload_time_iso_8601": "2025-08-17T14:35:54.048241Z",
"url": "https://files.pythonhosted.org/packages/ff/76/ef9b8f7690b70e13dc85f5e256d0d031b371437f2e22258b3dc6ab7704bf/iphone_framer-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 14:35:54",
"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
