Skip to content

humblepenguinn/thmbly

Repository files navigation

thmbly

Quickly generate thumbnails for social media from the command line

Create custom thumbnail images for YouTube, Instagram, and TikTok with text, emojis, and custom styling. Perfect for content creators who need quick, professional-looking thumbnails.

Usage

You can run it without installing in interactive mode

npx thmbly create filename --interactive

Or pass the CLI options

npx thmbly create filename \
  --type youtube \
  --title "My Awesome Video" \
  --subtitle "Some subtitle for the video" \
  --emoji rocket \
  --background "#1d1e22"

Or alternatively install it globally.

Installation

npm install -g thmbly
# or
yarn global add thmbly
# or
pnpm add -g thmbly

Interactive Mode (Recommended)

thmbly create my-thumbnail -i

This opens an interactive setup where you can:

  • Choose thumbnail type (YouTube, Instagram, TikTok)
  • Select background and font colors
  • Pick an emoji from a searchable list
  • Enter title and subtitle text
  • Choose from available system fonts

Command Line Mode

thmbly create my-thumbnail -y youtube -t "My Awesome Video" -e rocket --background "#1d1e22"

Available Options

thmbly create <name> [options]

Options:
  -y, --type <type>              Thumbnail type (youtube, instagram, tiktok, custom)
  --custom-dimensions <dimensions> Use custom dimensions (width x height)
  -t, --title <text>             Main title text
  -s, --subtitle <text>          Optional subtitle text
  -e, --emoji <name>             Emoji name (e.g. smile, heart, rocket)
  -i, --interactive              Open interactive setup
  -o, --output-dir <path>        Output directory
  --font <font>                  Font family name
  --bold-title                   Make title bold
  --title-font-color <color>     Title font color (hex)
  --subtitle-font-color <color>  Subtitle font color (hex)
  --background <color>           Background color (hex)
  --svg                          export as SVG instead of PNG (great for editing)
  -h, --help                     Show help

Examples

YouTube Thumbnail

thmbly create youtube-video -y youtube -t "How to Code" -e computer --background "#ff6b6b"

Instagram Post

thmbly create insta-post -y instagram -t "New Feature" -s "Check it out!" -e sparkles -i

TikTok Video

thmbly create tiktok-video -y tiktok -t "Quick Tip" -e lightbulb --bold-title

Custom Dimensions

thmbly create custom-banner --custom-dimensions 1920x1080 -t "Custom Banner" -s "Perfect for presentations" -e star --background "#2c3e50" --title-font-color "#ecf0f1"

Thumbnail Types

Platform Dimensions Use Case
YouTube 1280x720 Video thumbnails
Instagram 1080x1080 Square posts
TikTok 1080x1920 Vertical videos
Custom Any size Custom banners, presentations, etc.

License

MIT © Humble Penguin

About

Quickly generate thumbnails for social media from the command line

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •