mcpField
S
social-spotify-card

social-spotify-card

github.com/nexu-ioDesign & UI9.3k40 installsUpdated 2w ago
Repository

About social-spotify-card

A template for turning a song, podcast, or personal introduction into a Spotify now-playing card. It supports video overlays and profile pages, using CSS gradients and text or geometric artwork instead of external cover images.

Key features

  1. 01Video overlay and compact widget sizes
  2. 02CSS gradient album-art placeholders
  3. 03Title, artist, and playback progress
  4. 04Playback controls and Spotify logo
  5. 05Optional waveform animation with reduced-motion support
  6. 06Single-file HTML

Use cases

  1. 01Show a song or podcast in a video overlay
  2. 02Add a now-playing-style card to a profile page
  3. 03Feature a title and subtitle in a creator hero

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nexu-io/html-anything --skill social-spotify-card

After installing, type/social-spotify-cardin Claude Code to confirm it loaded.

Bundled filesexample.htmlexample.md

Details

From the project README

【模板: Spotify Now-Playing 卡】 【意图】把一首歌、一段播客、或一段个人介绍渲染成 Spotify 正在播放卡, 适合 video overlay / 个人 about page / 创作者 hero。Inspired by hyperframes spotify-card。

【画布】两个尺寸:

  • 横版视频叠加: 1280×720, 卡片居中或左下角浮动。
  • 紧凑横条 widget: 600×200, 可嵌入到任何 hero。

【卡片结构】

  • 外框: 圆角 12-16px; bg 用专辑封面色提取的暗渐变 (e.g. linear-gradient(135deg, #1e3264 0%, #0d1f3d 100%)) 或 Spotify 经典 #121212; 边缘有 1px subtle border。
  • 左侧: 专辑封面 (CSS 渐变 + 大字 monogram 或抽象几何描绘, 不能外链图片), 圆角 6px, 60-200px 方形。
  • 右侧:
    • 顶部 NOW PLAYING (uppercase letterspace 0.14em, 11px, 绿色 #1DB954)。
    • 歌名 / 标题 (Inter / Spotify Circular, 22-28px, weight 700, 白色)。
    • 艺人 / 副标 (16px, weight 400, opacity 0.7)。
    • 进度条: 4px 高, 圆角, 灰色背景 + 白色 fill (width: 38%); 两端时间戳 1:24 / 3:42 (mono, 11px, 灰)。
    • 控制行: ⏮ ⏯ ⏭ icon (inline SVG, 24px, 白色 fill), shuffle / repeat icon 较小。
  • 右上角: Spotify logo (内联 SVG, 绿色 #1DB954 圆 + 三道白色波纹)。
  • 可选: 右下角小型音波动效 (3 个 bar @keyframes)。

【字体】

  • 主: Spotify Circular → fallback Inter / Inter Tight, weight 400 / 700。
  • 数字: 同主字体, 不用 mono 太多。

【设计细节】

  • Spotify 经典 dark mode: #121212 bg, #1DB954 accent, #b3b3b3 secondary text。
  • 若用户输入是文本/标题 → 把 "标题" 当歌名, "副标/作者" 当艺人, 估算"时长" 3:42 默认。
  • 若用户输入是音乐相关 → 直接对应。
  • 严禁外链图片; 封面用 CSS 渐变 + 文字 logo / 几何描绘。
  • 微动效: 音波动效用 @keyframes, 可被 prefers-reduced-motion 关闭。
  • 单文件 HTML。

Comments

Markdown supported