{"id":15020378,"url":"https://github.com/flixma/mockingbird","last_synced_at":"2025-10-25T19:30:48.836Z","repository":{"id":57442581,"uuid":"216066291","full_name":"FlixMa/Mockingbird","owner":"FlixMa","description":"Easily bulk embed your screenshots in Apple device mockups.","archived":false,"fork":false,"pushed_at":"2020-05-17T11:07:04.000Z","size":283,"stargazers_count":20,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-10T22:40:13.733Z","etag":null,"topics":["apple","bulk-operation","design-tools","ios","marketing","mockup-generator","multithreading","opencv","photoshop","python3","screenshots","xcode"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlixMa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-18T16:34:19.000Z","updated_at":"2024-07-25T20:03:47.000Z","dependencies_parsed_at":"2022-09-26T17:21:15.860Z","dependency_job_id":null,"html_url":"https://github.com/FlixMa/Mockingbird","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlixMa%2FMockingbird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlixMa%2FMockingbird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlixMa%2FMockingbird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlixMa%2FMockingbird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlixMa","download_url":"https://codeload.github.com/FlixMa/Mockingbird/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219865145,"owners_count":16555931,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","bulk-operation","design-tools","ios","marketing","mockup-generator","multithreading","opencv","photoshop","python3","screenshots","xcode"],"created_at":"2024-09-24T19:54:58.980Z","updated_at":"2025-10-25T19:30:48.461Z","avatar_url":"https://github.com/FlixMa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mockingbird\n\n## TL;DR - Key Features\n\n- Uses Photoshop documents\n- Supports Bulk-Edit\n- Supports single and multi-frame mockups\n- Supports transparency\n- Supports resizing (aspect fit)\n- Supports Multicore Systems\n\n\u003cimg src=\"https://github.com/FlixMa/Mockingbird/raw/master/assets/ipad129_iphone11.png\" width=\"100%\"\u003e\n\n## The Long Story\n\nThis tool helps you to embed your app screenshots inside Apples device mockups.\nBecause the script reads the original photoshop documents Apple provides within their marketing guidelines, there is no need to wait for updates of the library after new product releases.\nMulti-Frame Mockups, e.g. one containing iPad and iPhone, are supported.\n\n\n### Installation\n\nThe only prerequisite is Python 3.6 or higher. On macOS its comfy to install it via homebrew, i.e. `brew install python3`.\nTo install mockingbird, use `pip3 install mockingbird-psd`.\n\n\n### Instructions\n\nYour screenshots need to be organized into folders.\nEach folder represents one device and contains the screenshots for every feature you wish to showcase.\nThe folders are specified using the `--screenshots` parameter.\nConcerning the layers of the photoshop document, the folders should be given from background to foreground.\n\nYou might also want to have a look at the usage message `mockingbird --help`\n\n#### Single-Frame mockups:\n\n`mockingbird --frame ./iphone_11.psd --screenshots ./iphone11`\n\n\n#### Multi-Frame mockups:\n\n`mockingbird --frame ./ipad_iphone.psd --screenshots ./ipad129inch ./iphone11`\n\nThis command uses the dual-device psd file and combines it with the images from `./ipad129inch` in the background device and `./iphone11` in the foreground device.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflixma%2Fmockingbird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflixma%2Fmockingbird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflixma%2Fmockingbird/lists"}