summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJaromil <jaromil@dyne.org>2008-10-19 22:26:27 (GMT)
committer Jaromil <jaromil@dyne.org>2008-10-19 22:26:27 (GMT)
commitcfbc1ab88d0fa64d93b335691c0aa9c3210c4f0d (patch)
tree92f4d5083bb7f8022f8b3226a614da075e09e991
parentda8d151763b9325f5218900458dd36cb57828135 (diff)
documentation updates for a new release
-rw-r--r--ChangeLog7
-rw-r--r--Makefile4
-rw-r--r--README51
-rw-r--r--TODO15
-rw-r--r--tbt.147
5 files changed, 80 insertions, 44 deletions
diff --git a/ChangeLog b/ChangeLog
index 0a61610..3c95855 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+TBT 0.8 - 20 Oct 2008 - caedes, jaromil
+ New Python-GTK graphical user interface
+ Timing mode now defaults to posix
+ TBT file format conversion
+ Fixed the 100% cpu usage on some distros
+ Documentation updates
+
TBT 0.7 - pallotron
New interactive website for TBT messaging (PHP)
diff --git a/Makefile b/Makefile
index 031cf86..73bc15e 100644
--- a/Makefile
+++ b/Makefile
@@ -14,10 +14,10 @@ LINKER = ld
# debugging flags:
-CXXFLAGS = -Wall -ggdb -pg -Islw -I. -I/usr/pkg/include -DHAVE_BSD
+# CXXFLAGS = -Wall -ggdb -pg -Islw -I. -I/usr/pkg/include -DHAVE_BSD
# optimized flags:
-# CXXFLAGS = -Wall -O2 -fomit-frame-pointer -ffast-math -I../slw -I. -I/usr/pkg/include -DHAVE_BSD
+CXXFLAGS = -Wall -O2 -fomit-frame-pointer -ffast-math -I../slw -I. -I/usr/pkg/include -DHAVE_BSD
# Darwin/OSX flags: uncomment all below and comment the rest
# CPPFLAGS = -pipe -Wall -ggdb -I../slw -I. -I/sw/include -L/sw/lib -DHAVE_BSD
diff --git a/README b/README
index c8e1cca..ffedcb9 100644
--- a/README
+++ b/README
@@ -5,7 +5,7 @@
888 888 888 888
o888o o888ooo888 o888o
- Time Based Text v0.7
+ Time Based Text v0.8
http://tbt.dyne.org
@@ -25,10 +25,9 @@ As this simple concept, our implementation is also kept very
minimalistic while we welcome programmers to embed it in communication
applications.
-The implementation is written in thread-safe POSIX C++ and can be
-ported to most platforms.
-
-
+The basic implementation is written in thread-safe POSIX C++ and can
+be ported to most platforms. It is also included a graphical
+implementation in python-GTK. Please refer to the manual.
@@ -58,6 +57,10 @@ requirements are:
- Educational purposes
- Multipurpose granular time based protocol
+TBT will be used in an on-site installation for art exhibition
+SPEAKING OUT LOUD - hosted by the Netherlands Media Art Institute
+in November 2008, Amsterdam - Montevideo - Time Based Arts
+http://transition.turbulence.org/blog/2008/10/07/speaking-out-loud-amsterdam/
::::: PROTOCOL
@@ -84,31 +87,33 @@ any application using some h4x0r keylogging technique on different OS.
:::: TODO
-In case of a multipurpose protocol for tagging time based events of
-variable size and type, we should introduce the use of a header.
-This might also help distinguishing among different key code maps.
-With 0.7 development reached a sufficiently advanced status, following
-some more debugging it will be tagged as 1.0 - so basically the change
-of the protocol will be an aim for the development of TBT 2.0 .
+In case of a multipurpose protocol for tagging time based events of
+variable size and type, we should introduce the use of a header. This
+might also help distinguishing among different key code maps. With
+0.7 development reached a sufficiently advanced status, following some
+more debugging it will be tagged as 1.0 - so basically the change of
+the protocol will be an aim for the development of TBT 2.0 .
::::: DISCLAIMER
-TBT is Copyleft 2006 - 2007 by Jaromil & Jodi
+TBT is Copyleft 2006 - 2008 by Jaromil & Jodi
+
artwork commissioned by the Impakt.nl festival
+
please refer to the included AUTHORS file for complete information.
-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 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.
+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.
+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.
diff --git a/TODO b/TODO
index a8efb7a..1b6090c 100644
--- a/TODO
+++ b/TODO
@@ -1,15 +1,13 @@
-as of 13 april 2007:
-
- header describing type and size of entries
-
-- grab from any graphical application as a X keylogger
-- integrate with more mail clients
-- playback control in console mode (rewind, fast forward etc.)
+- integrate with more mail clients
+
+v grab from any graphical application as a X keylogger?
-- conversion between binary, ascii and html formats
+x playback control (rewind, fast forward etc.)
+ (implemented in pygtk)
- daemon mode, timed pipe input/output through sockets
@@ -23,5 +21,6 @@ as of 13 april 2007:
send remarks and patches to http://dyne.org/hackers_contact.php
-or get in touch with coders via irc.freenode.net channel #dyne
+or get in touch with coders via IRC:
+irc.dyne.org port 9999 (SSL) #dyne
diff --git a/tbt.1 b/tbt.1
index d3da459..c39244f 100644
--- a/tbt.1
+++ b/tbt.1
@@ -62,13 +62,29 @@ playback tbt - option alias: playtext
mail composer - option alias: recmail
.B
.IP "-s \fI<format_name>\fR"
-save format in [ bin | ascii | html ]. Default is bin.. Default is bin.
+save format in [ bin | ascii | html ]. Default is bin.
-The binary mode will store a binary file you can play with the playtext command.
+The \fIbin\fR mode will store a binary file you can play with the
+playtext command.
-The html mode will produce a simple html page, in which your text will be played. For further information about the html mode please the the README.html file.
+The \fIhtml\fR mode will produce a simple html page, in which your
+text will be played. For further information about the html mode
+please the the README.html file.
+
+The \fIascii\fR mode produces pure ascii text file, one character per
+line, with the information about the key pressed, and the timestamp.
+
+.B
+.IP "-t \fI<timing mode>\fR"
+method used to calculate time: [ posix | rtc ]. Default is posix.
+
+So far a few methods are implemented, posix should be the most compatible,
+rtc works only with Linux kernel and requires suid authority.
+
+.B
+.IP "-x \fI<format_name>\fR"
+convert a binary .tbt file to another format [ bin | html | ascii] (see -s)
-The ascii mode produces pure ascii text file, one character per line, with the information about the key pressed, and the timestamp.
.SH EXAMPLES
@@ -101,28 +117,37 @@ Everyone is encouraged to test this software and report bugs!
Send remarks and patches to http://dyne.org/hackers_contact.php or get in touch with coders via irc.freenode.net channel #dyne
.SH AUTHORS
-Time Based Text software by Denis J. Rojo - jaromil.dyne.org
+Time Based Text software by Denis Roio - http://jaromil.dyne.org
.br
-Concept ideated with the contribution of Jodi - www.jodi.org
+Concept ideated with the contribution of Jodi - http://www.jodi.org
.br
PHP/Javascript code by Angelo Failla - pallotron freaknet.org
.br
-Webdesign by O.K. Parking - www.ok-parking.nl
+Webdesign by O.K. Parking - http://www.ok-parking.nl
+.br
+Python-GTK graphical interface by Pablo Martines - caedes sindominio.net
.br
More code and suggestions by Andrea Lo Pumo - alpt freaknet.org
.br
-Development supported by Impakt - www.impakt.nl
+Development supported by Impakt - http://www.impakt.nl
.br
Thanks to: Florian Cramer, Annet Dekker, Paul Hendriks
.SH COPYING
-This manual is Copyleft (c) 2007 Denis Rojo <\fIjaromil@dyne.org\fR>
+This manual is Copyleft (c) 2007-2008 Denis Rojo <\fIjaromil@dyne.org\fR>
-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.
+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.
.SH AVAILABILITY
-The most recent version of tbt sourcecode and up to date documentation is always available for download from \fIhttp://tbt.dyne.org\fR.
+
+The most recent version of tbt sourcecode and up to date documentation
+is always available for download from \fIhttp://tbt.dyne.org\fR.
.SH SEE ALSO