tvos-assets

MIT2 Images → 39 FilesXcode Ready

Generate complete tvOS Images.xcassets bundles from an icon and a background image. Parallax app icons, Top Shelf images, and splash screen assets - ready for Xcode.

npmGitHub

How It Works

icon.png

1024 × 1024

bg.png

2320 × 720

#F39C12

color

$ npx tvos-assets --icon icon.png --background bg.png --color "#F39C12"

39 files generated

==================

Icon: icon.png

Background: bg.png

Color: #F39C12

Dark Color: #0A0800 (auto)

Output: ~/Desktop

Radius: 0px

[1/9] Creating xcassets directory...

[2/9] Generating App Icon (400x240, @1x + @2x)...

[3/9] Generating App Icon - App Store (1280x768, @1x)...

[4/9] Generating Top Shelf Image (1920x720, @1x + @2x)...

[5/9] Generating Top Shelf Image Wide (2320x720, @1x + @2x)...

[6/9] Generating Splash Screen Logo...

[7/9] Generating Splash Screen Background colorset...

[8/9] Generating icon.png (1024x1024)...

[9/9] Creating zip archive...

Done!

Files: 39 files (20 Contents.json + 18 PNGs + icon.png)

Output: ~/Desktop/tvos-assets-20260201-141523.zip

Preview

tvos-assets sample assets seen in the Apple TV simulators

What It Generates

App Icon — Home Screen6 files

front@1x.png

400 × 240

front@2x.png

800 × 480

middle@1x.png

400 × 240

middle@2x.png

800 × 480

back@1x.png

400 × 240

back@2x.png

800 × 480

App Icon — App Store3 files

front@1x.png

1280 × 768

middle@1x.png

1280 × 768

back.png

1280 × 768

Top Shelf4 files

top@1x.png

1920 × 720

top@2x.png

3840 × 1440

wide@1x.png

2320 × 720

wide@2x.png

4640 × 1440

Splash Screen Logo5 files

200-icon@1x.png

200 × 200

200-icon@2x.png

400 × 400

200-icon@3x.png

600 × 600

200-icon-tv@1x.png

200 × 200

200-icon-tv@2x.png

400 × 400

Standalone1 file

icon.png

1024 × 1024

CLI Options

Flag	Description	Default
--icon <path>	Path to icon PNG (transparent background)	required
--background <path>	Path to background PNG	required
--color <hex>	Background color hex (e.g. "#B43939")	required
--dark-color <hex>	Dark mode background color hex	auto-darkened
--output <path>	Output directory for the zip file	~/Desktop
--icon-border-radius <px>	Border radius for icon corners	0
--config <path>	Path to config JSON file	—

--icon <path>

Path to icon PNG (transparent background)

Required

--background <path>

Path to background PNG

Required

--color <hex>

Background color hex (e.g. "#B43939")

Required

--dark-color <hex>

Dark mode background color hex

Default: auto-darkened

--output <path>

Output directory for the zip file

Default: ~/Desktop

--icon-border-radius <px>

Border radius for icon corners

Default: 0

--config <path>

Path to config JSON file