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