Command-line interface

The command-line is the Linux default user interface. It is used to maintain the operating system. Therefore also cherryEPG is using this way of performing jobs.

The command-line tool for maintenance is cherryTool. By various parameters and switches you can define the behavior of the tool. You can always run cherryTool -hto get a short command-line switch overview.

cherryTool - ver. 1.71 Copyright 2021 Bojan Ramsak                  
Usage:
     cherryTool [options] -[gdiprwx zero or multiple channel_id]           
                                                                
Options:
     -v         use verbose output mode

     -h         show this help
     -V         show version and configuration info
     -R         systemcheck and report
     -N         systemcheck and notify to log
     -S         show detailed database statistics
     -I chunk   inspect chunk and generate mosaic.png
     -Z msg     send ERROR record to log for testing

     -L scheme  initialize EPG database and load scheme
     -l scheme  load scheme into existing database (do not remove existing services and events)
                every imported scheme is copied to archive
     -f         show last(newest) scheme in archive
     -F         list scheme in archive
     -e file    export scheme to file
     -H host    set host as target when converting xls to scheme (used to select sheet)
     -c xls     convert xls scheme file to yaml scheme

     -C         list content of carousel
     -u file    add/upload .gz file to carousel
     -p chunk   play TS chunk
     -s chunk   stop playing TS chunk
     -y         clear carousel - EIT only {eit_???.cts}
     -Y         clear carousel - ALL

     -G target  grab&ingest by target: all, daily, hourly, weekly
     -M         make all output EIT chunks
     -B         build all output EIT chunks (forced make)
     -g id      grab service schedule data
     -d id      delete all files for service (not directory itself)
     -i id      ingest (parse) files for channels from ingest directory
     -a id      parse files for channels from ingest directory and just return result DON'T INGEST
     -r id      reset by deleting *.md5.parsed files
     -w id      wipe/remove service definition and data
     -x id      export events for service in XMLTV format to file {service_id.xml}

     -T         reset all tables in database to empty state (drop+init)
     -t         delete section and version table (force at next build)
     -D         delete ingest
     -P         delete all output rules

     -o         delete all .ets from carousel
     -O         cleanup database (events, logs)

     -W         run the web server

Description:
    "cherryTool" is a command-line interface to cherryEpg.pm, which it uses
    to perform all the work of grabbing, ingesting and building Epg.

    cherryEpg will look for a configuration file before reading its command
    line parameters. The default location is "$USER_HOME/config.yml".