Skip to content

blockfeed/twilight-boxart-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 

Repository files navigation

TWiLightMenu++ Boxart CLI

A python-based command-line tool to automatically download and resize boxart images for TWiLightMenu++.

๐Ÿ“ฆ Features

  • Scans a directory of games and detects supported systems
  • Calculates SHA1 checksums and looks up official names using No-Intro DAT files
  • Downloads matching boxart images from the Libretro Thumbnails Repository
  • Automatically resizes images to 128x115 PNGs for use with TWiLightMenu++
  • Supports optional game renaming to match No-Intro names (experimental โ€” see warning below)
  • Logs missing boxart matches to errors.txt

โš ๏ธ Warning About Renaming

The --rename option is not yet fully tested and may require manual adjustment of associated .sav or .dsv save files. Please make backups of your games and saves before using it.

๐Ÿ› ๏ธ Usage

python twilight_boxart_cli.py --rom-dir /media/user/SDCARD/games --sdcard-dir /media/user/SDCARD --rename --errors
  • --rom-dir: Path to your games directory (can include subfolders by console)
  • --sdcard-dir: Root of your SD card (used to place boxart and download DATs)
  • --rename: Rename games to match official No-Intro names (optional and experimental)
  • --errors: Save a list of missing boxart matches to errors.txt

๐Ÿ“ Output

  • Boxart images go into: _nds/TWiLightMenu/boxart/ on the SD card
  • DAT files are saved to: no-intro/ on the SD card

๐Ÿ’ฌ License

GNU GPL v3

About

A python-based command-line tool to automatically download and resize boxart images for TWiLightMenu++

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages