README.md

.... 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.3 - In loving memory of our brother BBK.

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

To compile the sourcecode it works as usual:

./configure; make; make install

what's needed to compile:

aalib - (libaa1-dev on Debian) 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.

running it:

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

---

DOCUMENTATION

to have a list of command line options:
./hasciicam -h
or once installed try:
man hasciicam

---

CREDITS

Hasciicam is written by Jaromil - http://jaromil.dyne.org

code, hacks and ideas have been contributed by: Jan Hubicka and the
aalibcrew, Gerd Knorr, Mathop, Augusto Nero, Boffh, Martin Guy, Pbm,
Megabug, Erich Berger, Guido Rapid Torres, Alessandro Preite
Martinez, Hks1, Thomas Pfau, Knorke, Blended, Dan Stowell

special thanks to:

# Lucia Zappacosta :: http://www.alviani-artspace.net
for curating the net:art exhibition of HasciiCam

# Giuliana Dieni :: http://vimeo.com/videopirate
for using HasciiCam in the best possible ways

# LOA hacklab milano :: http://loa.hacklab.it
for donating a pentium100mhz development box

# Hell Voyager
for donating an hauppage bttv brooktree card
(wich makes it possible to have releases :) )

# Alex + Rasty + Martinez
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!