TwtView documentation – a command line twitter viewer from early 2007 I wrote.

TwtView                 Version 1.4
by Kenneth Udut – simplify3@aol.com
January 26td, 2007

1.4 UPDATE: Now you can see your private messages!
[and reply to them if you have TwitterSubmitter W32]

1.3 UPDATE: USING SED & UPDATED BATCH FILE FOR DETECTING/INTERPRETING
XML INSTEAD OF WITHIN THE BASIC PROGRAM.

NOW YOU CAN SEARCH FOR A PARTICULAR USERNAME!!!
JUST TYPE u twittername  where twittername a valid, public
Twitter screenname, and it will show you a text version of
their homepage, including their timeline!

README
TwtView runs under Windows 32-bit systems
which includes Win95, 98, NT, 2k,
XP, etc.

It’s a combination of programs and
scripts which work in tandem to
allow you to easily view the public
timeline and the timeline of you and
your friends on Twitter.com without
having to open a web browser.

****
**** NOTE: IN THIS VERSION OF TWTVIEW,
**** YOUR TWITTER USERNAME/PASSWORD –WILL– BE STORED
**** IN A TEXT FILE, ON YOUR HARD DRIVE WHICH MAY BE A
**** SECURITY RISK FOR YOU.  THIS PROGRAM WORKS, BUT IT
**** MAY HAVE SOME ROUGH EDGES THAT NEED SMOOTHING, AND
**** THIS IS ONE OF THEM.
****

Quick One-Time Setup instructions:
==================================

NOTE: IF YOU ALREADY HAVE TwitterSubmitter W32,
then you do not need to create C:\twtsub. It already exists.

ALSO: YOU *CAN* RUN TwitterSubmitter W32 at the same time as
Twtview, allowing you the ability to update your Twitter status
as well as see the results!

1) Create a new directory on the C: drive called “twtsub”
Go to command prompt.
Type the following commands:
C:
CD \
MD twtsub

2) If you have not yet unzipped the files within, do so now,
and save all of the files to C:\twtsub

NOTE: IF YOU ALREADY HAVE TwitterSubmitter W32 installed,
then it will ask if you wish to overwrite certain files.
This is OKAY.  TwtView and Twitter Submitter W32 use a number
of the same files, and they are identical and will remain so
for some time.

3) Edit the text files called
viewurl.txt
and
dirmess.txt
in your favorite text editor.
***** THESE ARE THE FILEs THAT CONTAIN YOUR USERNAME/PASSWORD.
***** HANDLE WITH CARE AND DO NOT DISTRIBUTE WITH YOUR PASSWORD.
4) Replace USERNAME with your Twitter username
5) Replace PASSWORD with your Twitter password
6) Save the text file (to C:\twtsub) and close it.

Setup is complete!

Now to use the program:

Run TWTVIEW.EXE

You’ll see something similar to the following [but in monospaced text]:
=================================================
TwitterView 1.4 by Kenneth Udut simplify3@aol.com
=================================================
pub                      last 100 public timeline
me                          my timeline & friends
1,5,10,15,20,25,30,50,75   last x public timeline
u twittername      view user’s timeline-if public
pm                     view your private messages
————————————————-
quit                                 exit program
————————————————-

Type: pub and hit Enter and within a few seconds, you will be able
to see the last 100 entries on the public timeline.

Type: me and hit Enter and within a few seconds, you will be able
to see the timeline of you and your friends.

Typing 1, 5, 10, 15, 20, 25, 30, 50 or 75 and pressing Enter
will show you the lastest # of entries on the public timeline.

NEW FOR 1.3: Typing u twittername where twittername is the
screenname of a public Twitter user, will show you their
homepage – similar to going to: http://twitter.com/twittername

NEW FOR 1.4: Typing pm allows you to see your private messages!
If you wish to reply, you can do so using Twitter Submitter W32
by typing D username message [example: D simplify3 hello ken!]

Integration of the two programs is coming soon.

TECHNICAL:
TwtView 1.4 depends on several programs working together.

Here’s the required files, and what they all do.

wget.exe
——–
“GNU Wget is a free software package for retrieving files using HTTP,
HTTPS and FTP, the most widely-used Internet protocols.
It is a non-interactive commandline tool, so it may easily be
called from scripts, cron jobs, terminals without Xsupport, etc.”

This version of WGET comes from: http://users.ugent.be/~bpuype/wget/

Official WGET Homepage: http://www.gnu.org/software/wget/wget.html

sed.exe
——-
Search & Replace utility, based upon unix utility of the same name.

noexist.txt
———–
this is displayed if the username does not exist.

viewurl.txt
———–
This is the potentially unsafer part of TwtView
It contains your name and password for the Twitter API.

The file contains a single line:

http://USERNAME:PASSWORD@twitter.com:80/statuses/friends_timeline.xml

Where you will be replacing USERNAME with your Twitter.com username,
and PASSWORD will be your password.

dirmess.txt
———–
This is another potentially unsafe part of Twtview.
It contains your name and password for the Twitter API.

pubview.txt
———–
Contains the URL to access the public timeline through the Twitter API.
It contains the single line:

http://twitter.com:80/statuses/public_timeline.xml

This file, unlike viewurl.txt, does NOT contain your username/password
information, as it is unnecessary in order to view the public timeline.

twtv_p.bat
———-
This batch file is called by TWTVIEW if you selected
pub, or one of the #’s

twtv_u.bat
———-
This batch file is called by TWTVIEW if you decided to
lookup a particular twitter user’s homepage/timeline.

twtv_d.bat
———-
This batch file is called by TWTVIEW if you decided to
take a look at your private messages.

d.txt
—–
Temporary Session Cookie file created each time you send to Twitter.

twtview.bas
———-
This is the JustBASIC/LibertyBASIC file that twtview.tkn is based on.

twtview.tkn
———-
This is the Tokenized JustBASIC/LibertyBASIC file.  It’s compiled
to run faster than it would be to run the .BAS file above.

unix2dos.exe
————
This converts the resulting XML file produced by the Twitter API
from its native Unix format into MS-DOS text format, which can
be more easily read by TwtView.

readme.txt
———-
You are here.

twtview.exe
———-
This is the Runtime Module for JustBASIC 1.01, the version of
the compiler I am currently using. Do not change this name, or
the program will not be able to find twtview.tkn.

vbas31w.sll
vgui31w.sll
voflr31w.sll
vthk31w.dll
vtk1631w.dll
vtk3231w.dll
vvm31w.dll
vvmt31w.dll
————-
Files are required for the Runtime Module of JustBASIC to work properly.

Let me know how the program is running (or not!) for you.

Feel free to contact me at twitter.com/simplify3
or at simplify3@aol.com.

Hope this works as well for you as it does for me!  Future updates
will be forthcoming that will address concerns as they crop up.

Kenneth Udut
simplify3@aol.com
Golden Gate Estates, Naples, FL USA
January 25, 2007

Leave a comment

Your email address will not be published. Required fields are marked *


seven + 7 =

Leave a Reply