Twitter Submitter W32 Version 1.4 by Kenneth Udut - simplify3@aol.com January 23rd, 2007 Twitter Submitter for Windows32 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 update your Twitter.com status without having to open a web browser. **** **** NOTE: IN THIS VERSION OF TWITTER SUBMITTER W32, **** 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: ===============------------------- 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 3) Edit the text file called "upurl.txt" in your favorite text editor. ***** THIS IS THE FILE THAT IS CONTAINS 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 TWTSUB.EXE. You'll see something similar to the following [but in monospaced text]: +-------------------+ msgs sent: 2 |TwitterSubmitterW32| |by Kenneth Udut 1.4| ? or ! send to: twitter.com/simplify3 |maximum: 147 chars.| |press ENTER to send| |...5...10...15...20|..25...30...35...4 What are you doing? -----> [STOP] +-------------------+------------------ Just start typing your message. You'll notice it will scroll to the right. This is normal - you have about 147 characters to work with. Once you press ENTER, your message will be submitted to your Twitter account, and you'll be ready to type another one. NOTE: It currently records just what you type. NOTE: Copy/Paste, although it appears to work, NOTE: it will not be sent to Twitter. NOTE: This is an issue for a future release. TECHNICAL: Twitter Submitter W32 1.4 depends on several programs working together. Here's the required filse, 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 status.txt ---------- This contains the text you are sending to your Twitter account. It is created and recreated everytime you send a message using Twitter Submitter W32. upurl.txt --------- This is the potentially unsafer part of Twitter Submitter It contains your name and password for the Twitter API. The file contains a single line: http://USERNAME:PASSWORD@twitter.com:80/statuses/update.xml Where you will be replacing USERNAME with your Twitter.com username, and PASSWORD will be your password. twtget.bat ---------- This batch file is called by TWTSUB after it has your message in hand. Here are its contents: @echo off c: cd \twtsub wget --keep-session-cookies --save-cookies c.txt --post-file=status.txt -i upurl.txt --quiet del update.xml The wget line does all of the magic. The reason for "del update.xml" is to keep things neat and tidy. update.xml is the file that gets sent back from the Twitter API. It contains the XML encoded message you sent to the Twitter API. In the future, Twitter Submitter may make use of this file and no longer delete it, but for now, it makes things simpler. c.txt ----- Temporary Session Cookie file created each time you send to Twitter. twtsub.bas ---------- This is the JustBASIC/LibertyBASIC file that twtsub.tkn is based on. twtsub.tkn ---------- This is the Tokenized JustBASIC/LibertyBASIC file. It's compiled to run faster than it would be to run the .BAS file above. readme.txt ---------- You are here. twtsub.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 twtsub.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. filelist.txt ------------ List of files required to run Twitter Submitter W32 1.4. 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 23, 2007