maxstridde/social_preview

This is a pair of shell scripts that convert any photo into a social preview image, the rectangle that appears when you share a link on social media or in chat apps. The target size is 1200 by 630 pixels, which is the standard for Open Graph images used by platforms like Twitter/X, LinkedIn, and Facebook. The only dependency is ImageMagick, a widely available image processing tool. The simpler script places the photo as the background, adds a dark gradient across the bottom half so text stays readable on any photo, and overlays two centered lines of text. The advanced script creates a more designed layout: the photo sits inside a framed box with rounded corners and a soft shadow, three colored accent shapes peek out from behind the frame, and a title block with a button sits next to the photo. The advanced layout automatically adjusts to whether the input photo is portrait or landscape. Both scripts are configured by editing a short block of plain variables at the top of the file. You change things like the title text, font file path, and accent colors there. The README includes a PROMPT.md file you can paste into an AI assistant to get a suggested color palette that matches your site. A batch script runs either style over an entire folder of images, which makes it easy to add to a build pipeline or CI workflow. Because the configuration is just simple key-value lines, an AI can modify the title and colors per post from a Markdown frontmatter block before calling the script, enabling a fully automated per-post preview pipeline. Once generated, you reference the image in your page's HTML head section using standard Open Graph and Twitter card meta tags. The license is MIT.