note the password is stored in a weak encrytion. it is stored all backwords except for the first and last characters (eg "password" becomes "prowssad").
Install Instructions for TclSigX v0.1
"""""""""""""""""""""""""""""""""""""
1. Before you continue, you will need the following things:
* A SigX account
* Access to the internet (without port 80 or the SigX server blocked)
* A recent version of Tcl install (with http features complied)
* A cron deamon running
* Optional - TclXML installed (for Kopete Web Presense XML file and Exterme Overclocking Folding@Home stats
parsing)
If you dont have Tcl installed, you can install it through your distrobution's package manager. For APT based
distrobutions, you can do:
breadcrust@saji ~ $ su
Password:
root@saji breadcrust # apt-get update
root@saji breadcrust # apt-get install tcl
Emerge:
root@saji breadcrust # emerge tcl
Or if you prefer, you can use a GUI or CLI tool (Aptitude, Synaptic, YaST Package Manager, etc). If you dont
want to, or cant install Tcl from your distrobution's package manager, you can download ActiveState's ActiveTcl
from
http://www.activestate.com/products/activetcl. ActiveTcl includes Tcl, Tk as well as heaps of other Tcl
packages(/libraries) and demos, so if you want to use lots of other Tcl programs or program in Tcl, it is
recommended as a good replacement for your distrobution's Tcl installation.
2. Extract the TclSigX archieve to somewhere you can run TclSigX from. ~/tclsigx (/home/user/tclsigx), /opt/tclsigx or /usr/local/tclsigx is recommended.
breadcrust@saji randomdirectory $ cd ~
breadcrust@saji ~ $ tar jxf path/to/archieve/tclsigx-0.1.2.tar.bz2
3. Edit config.tcl in the extracted directory with a text editor, eg:
breadcrust@saji ~ $ nano tclsigx/config.tcl
or
breadcrust@saji ~ $ kwrite tclsigx/config.tcl
or
breadcrust@saji ~ $ vi tclsigx/config.tcl
or
breadcrust@saji ~ $ emacs tclsigx/config.tcl
etc...
Edit the variabes in config.tcl for your SigX account, e.g.:
# Account Settings
set ::settings::account::username "username" ;# Your user name
set ::settings::account::password "prowsaad" ;# Your password (encrtd)
# Your username on this machine TclSigX is being run on. Only required for listening to
# in amaroK and computer username data items
set ::settings::account::computerUsername "nobody"
would be changed to something like this for myself:
# Account Settings
set ::settings::account::username "breadcrust" ;# Your user name
set ::settings::account::password "nnillettog" ;# Your password (encrtd)
# Your username on this machine TclSigX is being run on. Only required for listening to
# in amaroK and computer username data items
set ::settings::account::computerUsername "breadcrust"
Note that the password variable uses a simple encrytion method, which is your password spelt backwords,
except for the first and last letters. E.g., in the above example, my password is "nottelling"
, which
becomes "nnillettog". This encrytion should not be relied on to keep your SigX password secret, if you want
more reliable password protection, make sure the file permissions are set so other users can not read
config.tcl.
A quick read through config.tcl is recommended.
These settings should be changed to change what text is displayed in your SigX image:
set ::settings::output::lines 5
and
set ::settings::output::line(0) { ... }
to
set ::settings::output::line(7) { ... }
For more infomation on how to do this, read the comments in the config file. Note that some of the data items
available require you to enter valid details in the data type's configuration variables.
4. Test your TclSigX configuration without sending data to SigX server:
breadcrust@saji ~ $ tclsigx/tclsigx.tcl --stdout
it is working if it displays something like this:
Welcome to TclSigX!
This program is licensed under the GNU GPL v2
Loading Settings (done), Code - v0.1.2 (done)
Creating Output: listeningToAmarok, tclSigXInfo, hardwareCpu, hardwareMemory, mood, hardwareAcpi, (done)
Outputting to stdout
----------------------------------------------------------------------------------
(client/SigX) TclSigX v0.1.2 Beta (development)
(music/amaroK/Stopped) - ()
(acpi/power) connected to ac
(memory/physical) 66% of 515mb used
(memory/swap) 1% of 1052mb used
(cpu/modelAndSpeed) Mobile Intel Pentium 4 - M CPU 1.80GHz @ 1.8Ghz/3.5 Kilabogomips
(devel/dataText/0)
(devel/dataText/1)
I feel: productive
----------------------------------------------------------------------------------
Finished! ^_^
if there is an error while reading config.tcl, eg
Welcome to TclSigX!
This program is licensed under the GNU GPL v2
Loading Settings missing close-brace
while executing
"set ::settings::output::line(3) {Resolution: @xServerScreenRes0
set ::settings::output::line(4) {@opSysDistrobution}
set ::settings::output::line(5) {..."
(file "./config.tcl" line 271)
invoked from within
"source [file join $::scriptDir $file]"
(procedure "include" line 2)
invoked from within
"include config.tcl"
(file "./tclsigx.tcl" line 82)
than you have supplied incorrect syntax in config.tcl. Check that all the quotes and backets have a matching
closing quote/bracket, and each variable is on only one line.
If there is a code error (like above) in another file, it either means there is a bug in TclSigX or you have not
entered valid settings for a data type in config.tcl. Most likely the latter.
If you get a non-code error, than TclSigX should tell you the problem.
If TclSigX is crashing (from a code error) or there is some other problem and you cannot manage to get it
working, dont be afaird to ask for help
:
SigX Forums -
http://forum.yuriy.net/phpbb
Sourceforge Project Page -
http://www.sourceforge.net/projects/tclsigx
Author Email -
breadcrust@users.sourceforge.net
Author Jabber -
breadcrust@jabber.org
5. Test sending data to SigX server:
breadcrust@saji ~ $ tclsigx/tclsigx.tcl
TclSigX should not crash if it didn't crash during the above test. Otherwise if there are any other problems
(like not being able to contact the SigX server), TclSigX will explain whats going on. If all goes well,
TclSigX will output something like this:
Welcome to TclSigX!
This program is licensed under the GNU GPL v2
Loading Settings (done), Code - v0.1.2 (done)
Creating Output: listeningToAmarok, tclSigXInfo, hardwareCpu, hardwareMemory, mood, hardwareAcpi, (done)
Sending signature to SigX server... Finished! ^_^
6. Schedule TclSigX to run every 1 to 5 minutes in cron...
There are some graphical programs such as KCron that can make this easier for cron n00bs that would rather not
touch a crontab file. Just set it to run TclSigX every 1 to 5 minutes for every hour, every day, every month,
every year... you get the idea.
Otherwise, edit your crontab file:
breadcrust@saji ~ $ nano crontab
or
breadcrust@saji ~ $ kwrite crontab
or
breadcrust@saji ~ $ vi crontab
or
breadcrust@saji ~ $ emacs crontab
etc...
If you dont already have a crontab, just save as a new file. Append something like the following at the end of
your crontab:
*/2 * * * * /home/breadcrust/tclsigx/tclsigx.tcl
Save and exit from your editor, then run the crontab command:
breadcrust@saji ~ $ crontab crontab
7. Spread the word and give feedback! ^_^
If you have friends that use SigX on Linux/POSIX and are still stuck using the old Perl script, tell them about
TclSigX! Feedback from users would also be great to help improve TclSigX. Feel free to express your opinion on
the SigX forums, project page (suggestions tracker), or email (details are as above at the end of step 6).
8. Umm... there is no step 8, you're done!
Login
FAQ
Search
