Content-type: text/html Manpage of tbt

tbt

Section: User Commands (1)
Updated: April 13, 2007
Index Return to Main Contents

 

NAME

tbt - Time Based Text

 

SYNOPSIS

tbt [options] [file]

 

DESCRIPTION

tbt - Time Based Text

To vehicle more human-input information in written text.

Record performance time of written text and vehicle it as additional information: saving and reproducing every single action during the composition of a text let us vehicle emphasis in written communication.

As this simple concept, our implementation is also kept very minimalistic while we welcome programmers to embed it in communication applications, as in emails, blogs, visual poetry, slides and what not.

Beware this software is hacky, u need to love text. A manual page is provided and commandline formulas to be casted in a terminal.

This software is written in thread-safe POSIX C++ and can be ported to most platforms, it provides a real-time recorder for serial timed data, recording 64bit tuples key/msec with low-latency. Included are programs providing a text console interface for the user to experiment with keyboard.

A Web application written in PHP/MySQL and Ajax could be used to publish TBT written into the world wide web.

 

PROTOCOL

In the .tbt format, text is saved with a timestamp for each letter:
   _________ ___________ 
  |  u-int  |   u-int   |
  |  64bit  |   64bit   |    m-seconds = 1/1000 of a second
   --------- -----------
  |  char   | m-seconds |    char = ASCII or higher bit char code
   --------- -----------
  |    Total: 128bit    |
   ---------------------

However export to different formats is planned including generation of web-ready code in HTML and Javascript, a daemon to provide timed input thru a socket on the network (TCP/IP) and what not.

Input is captured from the console, but can be extended to intercept any application using some h4x0r keylogging technique on different OS.

 

COMMANDS

The main functionalities are exclusive (use one or the other):

-r
Record a Time Based Text
-p
Playback a Time Based Text
-x <format_name>
convert TBT file to format [ bin | html | ascii ]

The bin 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. The distributed script file tbt-typewriter.js should be present in the same directory of the html file. For further information about the html mode please the the README.html file.

The ascii mode produces pure ascii text file, one character per line, with the information about the key pressed, and the timestamp.

-h
Display a help text and quit
-v
Display version and quit

 

OPTIONS

The following switches are optional:

-D <number>
Set verbosity level, the default value is 1
-c
Use the S-Lang console interface
-m
mail composer - option alias: recmail
-s <format_name>
save format in [ bin | ascii | html ]. Default is bin (see -x command)

-t <timing mode>
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.

 

EXAMPLES

Howto record a tbt in binary format

$ tbt -c -r mytext.tbt

Howto play a tbt binary file

$ tbt -c -p mytext.tbt

Howto record a tbt in ascii mode

$ tbt -c -r -s ascii mytext.txt

Howto record a tbt in html mode

$ tbt -c -r -s html mytext.html

 

NOTES

The first integration provided for TBT is with Mutt http://www.mutt.org the Mail User Agent popular among text console users. For further information please read the README.mutt file.

 

BUGS

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

 

AUTHORS

Time Based Text software by Denis Roio - http://jaromil.dyne.org
Concept ideated with the contribution of Jodi - http://www.jodi.org
PHP/Javascript code by Angelo Failla - pallotron freaknet.org
Webdesign by O.K. Parking - http://www.ok-parking.nl
Python-GTK GUI by Pablo Martines - caedes sindominio.net
More code and suggestions by Andrea Lo Pumo - alpt freaknet.org
Development supported by Impakt - http://www.impakt.nl
Thanks to: Florian Cramer, Annet Dekker, Paul Hendriks

 

COPYING

This manual is Copyleft (c) 2007-2008 Denis Rojo <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 tbt sourcecode and up to date documentation is always available for download from http://tbt.dyne.org.

 

SEE ALSO

* README.mutt * README.html


 

Index

NAME
SYNOPSIS
DESCRIPTION
PROTOCOL
COMMANDS
OPTIONS
EXAMPLES
NOTES
BUGS
AUTHORS
COPYING
AVAILABILITY
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 20:36:20 GMT, November 04, 2008