A CLI tool to add realistic device frames (phones, tablets, computers) around screenshots from images, URLs, or live websites.
deviceframe is a command-line tool that adds realistic device frames around screenshots from images, URLs, or live websites. It solves the problem of creating polished, presentation-ready mockups for mobile, web, and progressive apps without manual design work. The tool supports a wide range of devices including phones, tablets, computers, and watches.
Developers, designers, and marketers who need to create professional-looking device mockups for app showcases, documentation, or marketing materials.
Developers choose deviceframe for its ease of use, support for multiple input sources, and extensive device library. Its CLI interface allows for both interactive and automated workflows, making it versatile for both one-off tasks and integration into build processes.
:iphone: Put device frames around your mobile/web/progressive app screenshots.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Accepts local files, globs, website URLs, and image URLs in any combination, as demonstrated in the usage examples for flexible screenshot handling.
Prompts users with searchable multi-select from over 52 devices, making it easy to choose frames without memorizing commands.
Non-interactive mode with --frame flags allows scripting and CI/CD integration, shown in the README for batch processing.
Captures websites with correct aspect ratio and pixel density for selected devices, useful for responsive testing mockups.
Downloads and caches frame images locally using env-paths, improving performance on repeated use as noted in the README.
The tool is in active development with a 'Coming Soon' section for mobile apps, so users may encounter bugs or incomplete features.
With only 52 unique devices, it may not cover niche or newer models, requiring reliance on the predefined set from the CDN.
Frame images are downloaded from a CDN, which could fail if the service is unavailable, introducing a point of failure.
Lacks a graphical user interface, which might be a barrier for designers or users preferring drag-and-drop workflows.