sudo apt-get update (needed on retropie/raspi, seems....)
sudo apt-get install python3 python3-pip libxml2-dev libxslt-dev
sudo pip3 install requests Image bs4 lxml python-slugify
(lxml takes some minutes to build on raspi)

def run_direct_url(u, args):
  """
  perform query with the given direct url
  :param u: the game url
  :param args: arguments from cmdline
  :return: dictionary { name, publisher, developer, genre, releasedate, desc, png_img_buffer } (each except 'name' may be empty)
  """

def run(args):
  """
  perform query with the given game title
  :param args: arguments from cmdline
  :throws vscraper_utils.GameNotFoundException when a game is not found
  :throws vscraper_utils.MultipleChoicesException when multiple choices are found. ex.choices() returns [{ name, publisher, year, url, system}] (each except 'name' may be empty)
  :return: dictionary { name, publisher, developer, genre, releasedate, desc, png_img_buffer } (each except 'name' may be empty)
  """

def name():
  """
  the plugin name
  :return: string (i.e. 'lemon64')
  """

def url():
  """
  the plugin url name
  :return: string (i.e. 'http:https://www.lemon64.com')
  """

def systems():
  """
  the related system/s (descriptive)
  :return: string (i.e. 'Commodore 64')
  """

def engine_help():
  """
  help on engine specific '--engine_params' and such
  :return: string
  """

-------
WARNING
-------
be careful to use multi-query mode (when 'path' refers to an entire folder):
it may take long and/or cause your ip to be banned for hammering
(even though i added random sleep() of few seconds between queries)!

sudo su -
cd /opt
git clone https://github.com/valerino/es-vscraper

pi@retropie:/opt/es-vscraper $ ./es-vscraper.py --help
usage: Build gamelist.xml for EmulationStation by querying online databases

       [-h] [--list_engines] [--engine [ENGINE]]
       [--engine_params [ENGINE_PARAMS]] [--path [PATH]]
       [--sleep_no_hammer [SLEEP_NO_HAMMER]] [--strip_start [STRIP_START]]
       [--folder_overwrite] [--to_search [TO_SEARCH]]
       [--gamelist_path [GAMELIST_PATH]] [--img_path [IMG_PATH]]
       [--img_index [IMG_INDEX]] [--img_thumbnail] [--append [APPEND]]
       [--append_auto APPEND_AUTO] [--unattended] [--delete [DELETE]]
       [--debug]

optional arguments:
  -h, --help            show this help message and exit
  --list_engines        list the available engines (and their options, if any)
  --engine [ENGINE]     the engine to use (use --list_engines to check
                        available engines)
  --engine_params [ENGINE_PARAMS]
                        custom engine parameters, name=value[,name=value,...],
                        default None
  --path [PATH]         path to the file to be scraped, or to a folder with
                        (correctly named) files to be scraped
  --sleep_no_hammer [SLEEP_NO_HAMMER]
                        sleep random seconds (1-n) between each scraped
                        entries when path refers to a folder. Default is 15
  --strip_start [STRIP_START]
                        strip characters (until end) starting from the given
                        ones, before using 'path' as search key (i.e. --path
                        "./caesar the cat (eng)" --strip_start "(" searches
                        for "caesar the cat")
  --folder_overwrite    if path refers to a folder, existing entries in
                        gamelist.xml are overwritten. Default is to skip
                        existing entries
  --to_search [TO_SEARCH]
                        the game to search for (full or sub-string), case
                        insensitive, enclosed in "" if containing spaces.
                        Default is the filename part of path without
                        extension. Ignored if path refers to a folder
  --gamelist_path [GAMELIST_PATH]
                        path to gamelist.xml (default path/gamelist.xml, will
                        be created if not found or appended to)
  --img_path [IMG_PATH]
                        path to the folder where to store images (default
                        path/images)
  --img_index [IMG_INDEX]
                        download image at 0-based index among available images
                        (default 0=first found, -1 tries to download boxart if
                        found or fallbacks to first image found)
  --img_thumbnail       download image thumbnail, if possible
  --append [APPEND]     append this string (enclosed in "" if containing
                        spaces) to the game name in the gamelist.xml file
  --append_auto APPEND_AUTO
                        automatically generate n entries starting from the
                        given one (i.e. --append_auto 2 --path=./game1.d64
                        generates "game (disk 1)" pointing to ./game1.d64 and
                        "game (disk 2)" pointing to ./game2.d64)
  --unattended          Automatically choose the first found entry in case of
                        multiple entries found (default False, asks on
                        multiple choices)
  --delete [DELETE]     delete all the entries whose path matches this regex
                        from the gamelist.xml (needs --gamelist_path, anything else is ignored))
  --debug               Print scraping result on the console

/opt/es-vscraper/es-vscraper.py --engine lemon-c64 --to_search "caesar the cat" --path "/home/pi/RetroPie/roms/c64/caesar.prg"

/opt/es-vscraper/es-vscraper.py --engine lemon-c64 --path "/home/pi/RetroPie/roms/c64/caesar\ the\ cat.prg"

/opt/es-vscraper/es-vscraper.py --engine lemon-c64 --path /home/pi/RetroPie/roms/c64