• C
  • o
  • w
  • s
  • p
  • e
  • a
  • k
  •     
  • M
  • a
  • n
  • u
  • a
  • l
  • By Sourav Goswami
    March 30, 2020

    NAME

       cowspeak - Display an animal with a random quote or your own text.
    

    SYNOPSIS

       cowspeak, the program displays an animal with a random quote or your own text.
    

    OPTIONS

      --art/-a
                   Display a tutorial on adding your own art.
    
       --blink/-b
                   Blink the texts (not supported in all terminals yet).
    
       --borderh=<ch>/-brh=<ch>
                   Horizontal border character.
    
       --borderv=<ch>/-brv=<ch>
                   Vertical border character.
    
       --bubble=<text>/-bbl=<text>
                   Specify the character of speech balloons.
    
       --documentation/-d
                   Display the whole documentation including this help.
    
       --download/-dl
                   Download missing files and database from Github.
    
       --file=<path>/-f=<path>
                   Specify the ASCII file path to display your own ASCII art.
    
       --fill=<char>/-fc=<char>
                   Fill the white space with a specific character.
    
       --force-update/-fu
                   Update cowspeak forcefully even if no updates available.
    
       --help/-h
                   Display this help.
    
       --invert/-inv
                   Invert everything text! Read from right to left in English!!
    
       --manual/-m
                   Display a manual. Same as documentation.
    
       --net=<url>/-n=<url>
                   Read data from a website (in curl format).
    
       --no-art/-na
                   Don't display the animal.
    
       --no-colour/-nc
                   Don't colourize the output.
    
       --no-text/-nt
                   Don't show any text, and only show the animal.
    
       --read=<file>/-r=<file>
                   Read a file.
    
       --reverse/-rev
                   Cowspeak reads upside down!
    
       --rotate-colour/-rc
                   Rotate the output colours in each line.
    
       --show-arts/-sa
                   Show all available installed arts in the default directory.
    
       --text=<text>/-t=<text>
                   Display a custom text.
    
       --version/-v
                   Display the current version of cowspeak.
    
       --update/-u
                   Update cowspeak if possible.
    
       --welcome/-w
                   Show a welcome screen and some OS details.
    

    EXAMPLES

          No argument:
                           Show a random existing character with a random fortune and colours.
    
          Specify the horizontal border character
                      (the following example will draw the border with * character):
    
                           cowspeak --borderh='*'
    
                           cowspeak -brh='*'
    
                      Note that if you specify more than a character, the animal will select any one at its
       own will.
    
          Specify the horizontal border character
                      (the following example will draw the border with * character):
    
                           cowspeak --borderv='*'
    
                           cowspeak -brv='*'
    
                      Note that if you specify more than a character, the animal will select any one at its
       own will.
    
          Specify the speech bubbles character
                      (the following example will draw the border with * character):
    
                           cowspeak --bubble='*'
    
                           cowspeak -bbl='*'
    
                      Note  that  if  you  specify  more  than one character, the animal will use the whole
       string.
    
          For custom text:
                           cowspeak --text='text' or -t='text'
    
          To display your own ASCII art:
                           cowspeak --file='path/file.art'
    
          To display your own art with your text:
                           cowspeak --file=directory/file.art --text='your text'
    
          To read a file from the storage:
                           cowspeak --read='path/file.extension' or -r='path/file.extension'
    
          Pipe another program's output to cowspeak (also accepts arguments):
                           echo hello | cowspeak
    
                           echo hello | cowspeak --argument -short_argument
    
          To read from the internet in curl format:
                           cowspeak --net=http://www.example.net
    
                           cowspeak --net=http://www.example.net --argument -short_argument
    
          Cowspeak can show you a welcome screen and provide some OS details.
          It's helpful if you connect to multiple terminals on multiple machines.
          To get the welcome screen, run:
                           cowsepak --welcome or cowspeak -w
    
          [NOTE: If you pass an invalid argument, Cowspeak will likely ignore it without any warning.]