
.... The Dyne.org Foundation presents RASTASOFT's

```
88  88    db    .dP"Y8  dP""b8 88 88  dP""b8    db    8b    d8 
88  88   dPYb   `Ybo." dP   `" 88 88 dP   `"   dPYb   88b  d88 
888888  dP__Yb  o.`Y8b Yb      88 88 Yb       dP__Yb  88YbdP88 
88  88 dP""""Yb 8bodP'  YboodP 88 88  YboodP dP""""Yb 88 YY 88 

                [ (h)ascii for the masses! ]

                                                 version 1.1.1
```

[![software by Dyne.org](https://www.dyne.org/wp-content/uploads/2015/12/software_by_dyne.png)](http://www.dyne.org)

Hasciicam makes it possible to have live ascii video on the web. It
captures video from a tv card 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
anybody that has a bttv card. a linux box and a cheap modem line to
show a live asciivideo feed that can be browsable without any need for
plugin, java etc.

```
||==================================||==|===|=================================================|===========
==========================================================================================================
||===================================<|awww%==============================================================
|=================================<wg#ZUVSXQX|============================================================
|||=================|=|||=========9HHBBBWWWQX=============================================================
|||=======||||||||||||||||||||||||)XXXXXZ#WQ#>|||||||||===================================================
||||=====||||||||||i||iiiii|||||||ioXXXXX#WQ#c||||||||||||||||||========::::::=:::::=====|||||||||||||||||
||||=|===| YES this is a ii||i||ii|vXXXXX#mWWcii||||||||||||||||==:::::::::::::::::::::::=:=++||||||||||||
|||||====||    ........     iiiiiiivXXXXXXmWQoi|iii|||||||||||==::::::--.:::.:.--.-.....---:::=+||||||||||
|||||===|||| (H)ASCII SPLIFF iiiiiiiXXXXXX#WQXiiiii|||||||||=:::--::-...:::::::-............--::=|||||||||
||||===||||||ii --------------> iiiinXXXXX#mQmiiiiiii|i|||==:::::........-::::................:::==|||||||
||||===|||||iiiiiiiiiiiiiiiiiiiiiiiivXXXXX##Wmciiiiiii|||=:::-...........::.:..................:::=|||||||
|||====|||||iiiiiiiiiiiiiiiiiiiiiiiilXXXXXZmWWziiiiiii||=::--........:::.:::;=;;:...............:::=||||||
|||====|||i|iiiiiiiiiiiiiiiiiiiiiiiiinXXXXX#WQoiiiiii|==::...........::==|%vnooans|=;. .........-::==|||||
|||====||ii|iiiiiiiiiiiiiiiiiiiiiiiiinXXXXZ#WQXiiiii||=::::........:=|ivnXXXm##mmXXons|_. ........:::=||i|
|||===|||ii|iiiiiiiiiiiiiiiiiiiiiiiivvXXXXX#mQmi|||||==::..... ...=|vnXXXX#####m##XXXoov= ........:::=||ii
||||==|||iiiiiiiiiiiiiiivnvvvvi||iiiiInXXXX#mWWVYY1*|=::::.......:=ino21*1*YX#WmmmmZXZXXo|..... ...:::=|||
|||==|||iiiiiiiiiiiiiiivvovvvviiiiiivlnXXXX#mWWziii|=::-........:=iilivvvsiivX#m#ZXl|||l1s:.     ..:::====
||===||iii|iiiiiiiiiiiivnovnnniivvvvvvuXXXXZ#WQovvii==:.........:|iivlvnXXovivXXXe||saa%ii=.. . ....::::==
||===<|iiiiiiiiiiiiiiivvoonoonivvvvoooXXXXX##WQmXXXX==::........:<vvni|=||ivoooXXqv*!!11ii;.........::::=:
||==|||ii|iiiiiiiiiiiilnonnooovvvvnvvvnXXXXX#mQ#XXXn=:::........=ivoXXwauwqXoooXmWZnv|==<l=...-......-::::
||==|ii|||iiiiiiiiiiiivoonnoonvvvnonlii3XXXXZ#QB1ll>::.-:......:<vnXX#m##XX?*++!YS*iXmwXXoc ..........::::
||==|iiiiiiiiiiiiivlilvoooXo:=vvvXXos||)XXXX#mWW>===::......:::=|vvvnXe1nX1||+======XZ##XXn:.........::::-
|===|iiiiiiiiiiiiivvllvSo}Y!:={}vXXXsi|%XXXX#mWQz||||=:.....:::|inovvi|*}+=::=:=:::=+*nI3nv=.........::::=
||==iiiiiiiiiiiiiiivivvXX%+====<ndmX1|>imXXXZ#WQQkivQg;....::::<i3X1|==::==%ii}||=;:::+|ilv:........::====
|==||iiiiiiiiiiivlvlllvX2::====<n###ci=vQ#XXX#WQQm%+==::....:===|ivv=iuuav1SUUH$B#S=:::=|vv:........::=|==
=-=|i|iiiiiiiiiiiiiiiiivvsiiiiivvYTYsiivV&XXX##QW&vi=;::.....-.:=<iIsvXXXovInSSYSnvvvn%=|%>:......:::=====
-..+||iiiiiiiiiivowwonvvlvvviilvvvvvvvnXmmXXXZXmmwoova>:........::=+l1v#Zo}=:::::=+<nXXi|>::......::==|iii
   .~<iiiiiuwmQQQQQQQQQQQQQQQQQQQQQQmgmmQQmqqmmWQEYmmgw/;:::....::::==++**+===:::::{XX1i=:.......::=======
   ...-iiwmQQQQQQQQQQQQQQQQWWWWWWWQQQQWWQQmmmmmWWkvQQQQ@=~::-:...::-:::--:::::::::::+=+:.......::======::-
 .....:iqWQQQQQQQQQQQWW##Wmm######mmmQQQQQQQmovnX2vQQQQQg7(:....:.-.....::.::.--.::::::......:::==||=::   
   ..;vXX##WW###W##########XXXXXX#WWWQQQQQQQWmnnXS3QQQQQkmaa;:..==::...::-..-......-::.....::.:;==|==:   .
  ..:aonnXX##XXXXXXXXXXXXXXXXooXX#############vnXqmQQQQQWqoo%=;=ii|=;;................-....::==||||====-:.
...<Xonvvnn222nnXooooonvvvnonvv1oXXXXXXXXXXXXXv1XZBBWmmmmWmm}>=%nnvii||==;::.......::.......:::..........:
..)Xo1vllii|illIiillIIIllillliilIvIlIv1n11111llvXXXXXXXX$WWmc|vnooonnvvii||||||====||;.:::::::........:.::
..)vnli||====|==========++++|||||||||||||ivi||ivXXvnXXXXdWQQWzoXXXXXXoonvvvviiii||iii=|vs;:::::.........:.
..=vli||||====:::;=ivvsi|==;;:=========|ivnXX##mWWQQQQmmmQQQQQXXXXXXXXXXXoonnvvvvvvi|=<nXZa;:::-..........
..:vnvv%||=:==|vvnXXXmXXqXoovs%iiii|iiiivnXX##mmWQQQQQQQQQQQQQQQQmmXX##XXXXXXoonnvvvi|:IXmm#a;:::.........
..:oXXXonvvnnooXoXXX########ZXXXXXXoooooXXX####mWQQQQQQQQQQQQQQQQQQQmmm#XXXqXXXXnnvvvvi=XWWm#h%-::........
::vXXXXXooooXXXXXXXZ#m############m##mmmmmmmmm#mmWQQQQQQQQWQQQQQQQQQQQQm#mm##mXXooXovvvsmQQWmmm#6,:-......
sd#ZXXXXXXXXXXXXXXXXXXXXX#####XXX###############m#mWWWWWm#WQQQQQQQQQQQQQmmmmmmmmmmmqmgD9QQQQWW#????"-....:
####XXXXoXXonooononnXXon2XXXXXXXm####XXXXXXXXXXX##Z########WQQQQQQQQQQQWWWQQQQQmQQQQQP::=?VVT'-... ....:::
ZXSXXonnvnv1vvvvlliilivvvnooXXXXXXXXXXXXXXXXXooXXXXXXZ###X#####mWWWWWW##QQQQQQQQQQQQP:::::.-............--
nnonnvvvIllliiliiiiiilvvnnnnnn1nn11I11v1n111II1nqmmmmmmmmQQQQQmQmmZXXXXqQQQQQQQQQQQC:::::-.......:........
nnnvvvli||||||||||+iaaawwwwygwwwwwwwwwwwymmmWWQQQQQQQQQQQQQQQQQQQQQmuymQQQQQQQQQQQt=:::-.........-........
```

# INSTALLATION

On Debian and Ubuntu you have hasciicam packages ready to install

```
sudo apt-get install hasciicam
```

On RedHat and derivatives a package may be available too.

# USAGE

This software is operated from a terminal... and invites you to enjoy
the aesthetics of it `:^)`

To have a brief list of command line options, use:
```
hasciicam -h
```
To see the manual:
```
man hasciicam
```

# BUILD FROM SOURCE

If you want to compile hasciicam from its source code, you will need
`aalib`: that's the great lib that makes possible ascii rendering if
your distribution does'nt includes it, you can fetch it from the
hasciicam webpage.

To compile the sourcecode:
```sh
 autoreconf -i && ./configure && make
```
and to install it, you can use 
```
 make install
```
Running it:

people reported success with several pci and usb devices, refer to
video4linux documentation for further informations

# CREDITS

Hasciicam is designed, written and maintained by jaromil - http://rastasoft.org

People who contributed to the hasciicam project:
- jan hubicka and the aalib crew - the asci rendering library
- gerd knorr - grab was inspired by his webcam sourcecode
- mathop aka josto - help on css with style
- august black - hacks for iomegabuz
- boffh - hacks for usb cams
- martin guy - karma to avoid buffer overflows
- rat - text dump
- pbm & megabug - watching ascii horizons
- rapid - security and bugfixes
- alessandro preite martinez - sgi irix support (0.9)
- thomas pfau - ftp library
- blended - wider webcam support
- dan stowell - v4l2 api support

Special thanks to:

- LOA hacklab milano for donating a pentium100mhz development box
- hell voyager for donating an hauppage bttv brooktree card which made it possible to have releases :) )
- acme + rasty + martinez for very good vibez!
- servus.at, maddler.net, flyinglinux.net, autistici.org high quality bandwidth lets people get slashdotted!
- FREAKNET medialab catania :: http://freaknet.org for knowledge, place, sun and connectivity under the vulcano!
	
# LICENSE


This source code is free software; you can redistribute it and/or
modify it under the terms of the GNU Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This source code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  Please refer to
the GNU Public License for more details.

You should have received a copy of the GNU Public License along with
this source code; if not, write to: Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
