xenial (1) hasciicam.1.gz

Provided by: hasciicam_1.1.2-1ubuntu1_amd64 bug

NAME

       hasciicam - (h)ascii for the masses!

SYNOPSIS

       hasciicam  [  -hvq  ]  [ -m mode ] [ -d device ] [ -i input ] [ -o output ] [ -f :user%pass@host:/dir ] [
       rendering-options ]

DESCRIPTION

       hasciicam makes it possible to have live asciivideo on the web. It takes  video  from  a  capture  device
       (like  tv  cards  or quickcams) and renders it into ascii, formatting the output into an html page with a
       refresh tag or in a live ascii window or in a simple text file as well, giving the possiblity to  publish
       on the web a live asciivideo feed browsable without any need for browser's plugins.

       hasciicam  grabs frames using Video4Linux api, renders them into ascii using AA-lib engine and is capable
       of armoring them with auto-refreshing HTML code. It's being used also jpeglib for  optionally  refresh  a
       small jpeg image, so that it can work also as a simple webcam (or showing both, jpeg and asciivideo).

OPTIONS

       -h --help
              Display a help text and quit.

       -v --version
              Display version and quit.

       -q --quiet
              Be quiet and don't show hardware detection.

       -m --mode
              Selects the mode in wich hasciicam will run:
              live will use the console (or eventually open one under X display) to show full speed ascii video.
              html will write html formatted ascii video every refresh seconds into file aafile.
              text will write plain text ascii video every refresh seconds into file aafile.
              Default mode is live. Mode selection is XOR'ed.

       -d --device
              Use specified capture device. Default is /dev/video.

       -i --input
              Selects the device's input channel to be used for grabbing frames. Default is 1.

       -o --aafile
              Defines  the  file  where  to  save  rendered  ascii, overwrited every refresh seconds. Default is
              hasciicam.html when in html mode, hasciicam.txt when in text mode (useless when in live mode).

       -f --ftp
              Ftp pushes the selected output file  to  an  ftp  account  specified  within  an  expression  like
              :user%pass@dyne.org:/home/user/www.  If  the password is not specified (omit %pass) hasciicam asks
              for it on stdin (hidden while typing). If the directory is not specified it is assumed to  be  the
              first  ftp  directory  where  user logs in. Remote file is refreshed depending on refresh rate and
              connection bandwidth, a scolopendro temporary file is created to keep clients on  the  other  side
              refreshing smooth.

       -D --daemon
              Forks to background and runs in daemon mode.

RENDERING-OPTIONS

       -S --font-size
              Selects  a  font  size  from 1 to 4 used in html rendering. default is 1 (only useful when in html
              mode).

       -a --font-face
              Selects a font face to be used in html rendering, it should be  fixed  size  for  better  results.
              default is courier (only useful when in html mode).

       -r --refresh
              Specifies  the  refresh interval in seconds between each grabbed frame. Default is 2 (useless when
              in live mode).

       -b --aabright
              Specifies brightness level for the aa_render, from 0 to 100. Default is 60.

       -c --aacontrast
              Specifies contrast level for the aa_render, from 0 to 100. Default is 4.

       -g --aagamma
              Specifies gamma correction level for the aa_render, from 0 to 100. Default is 3.

       -I --invert
              Invert and render the resulting negative ascii.

       -B --background
              Specifies the background color to be used in the form of a hex RGB triplet  (without  the  leading
              #). Default is 000000 for black (only useful when in html mode).

       -F --foreground
              Specifies  the  foreground  color to be used in the form of a hex RGB triplet (without the leading
              #). Default is 00FF00 for green (only useful when in html mode).

EXAMPLES

       hasciicam -m html -o watchme.html
       puts your html formatted ascii into watchme.html - then just open it with your favourite browser.
       hasciicam -m text -o ~/.plan
       puts  your  ascii  into  your  local  .plan  (fingercam)  hasciicam  -m  html  -S  2  -o  index.html   -f
       :jaromil%sasuchen@dyne.org:korova
       generates  an  hascii  video with font size +1 and uploads the frames in ftp passive mode on the dyne.org
       server, with user jaromil password sasuchen, inside the korova directory

NOTES

       When using a usb webcam, a supported size needs to be specified. The minimum  or  maximum  detected  size
       should  work,  also  a  size  of  160x120  mostly gives good results, with unsupported sizes you will get
       unexpected results.

BUGS

       Report bugs to hasciicam@dyne.org. Please include a complete, self-contained example that will allow  the
       bug  to be reproduced, information about which version of hasciicam you are using, which operative system
       and the complete device detection output.

AUTHOR

       jaromil [aka Denis Roio] <jaromil@dyne.org>

COPYING

       Copyright (c) 2001-2006 Denis Roio <jaromil@dyne.org>
       Permission is granted to copy, distribute and/or modify this manual under  the  terms  of  the  GNU  Free
       Documentation  License,  Version  1.1  or  any  later  version published by the Free Software Foundation.
       Permission is granted to make and distribute verbatim copies of  this  manual  page  provided  the  above
       copyright notice and this permission notice are preserved on all copies.

AVAILABILITY

       The  most  recent  version  of  hasciicam sourcecode and up to date documentation is always available for
       download from http://ascii.dyne.org.

SEE ALSO

       info aalib