summaryrefslogtreecommitdiffstats
path: root/README
blob: 0ccbb518bb97540bd07b73fc49bdf84019609a2b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

.... 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

To compile the sourcecode it works as usual:

 ./configure; make; make install

on Debian and Ubuntu you have hasciicam packages ready to install
for the very latest version add the dyne.org apt repository:

 Debian:      deb http://apt.dyne.org/debian stable main

 Ubuntu:      deb http://apt.dyne.org/ubuntu stable main

what's needed to compile:

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.

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://rastasoft.org

code, hacks and ideas have been contributed by:
 jan hubicka and the aalibcrew, gerdknorr, mathop, augustonero, boffh,
 martin guy, pbm, megabug, rat, rapid, alessandro preite martinez, hks1,
 thomas pfau, knorke, blended, dan stowell

special thanks to:

# 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!