Back

index_files/FLAG.GIF

How to Download tclkit.exe's,
and Run TCL, and .kit files, by Using tclkit.exe

FOR WINDOWS ONLY

Under construction! Lots have been done, more to do.


Intro












Firefox
Sea-
monkey
  Hi!  Here's where I will try to explain, under Windows, by using the Browser, I do use under Windows (namely Firefox)

  Firefox (or SeaMonkey, which is another version of Firefox, with which I'm editing this page, which also happens to be a browser also) is my favorite browser under Windows, period. The only thing I use Internet Explorer for is to keep my version of Windows up to date.  The rest of the time that I'm using a browser, it's mostly Firefox (and some SeaMonkey).
  So I hope if you're using Internet Explorer, you'll be able to extrapolate them to how to download a file under Internet Explorer.



tclkit


  That would be if you wanted to try running it using "tclkit-8.5.9-win32.upx.exe OnceinaLifetime.tcl".

  By attempting to get tclkit-8.5.9-win32.upx.exe working with OnceinaLifetime.tcl, that may or may NOT work.  Why would it do that?

  Well that's a good question.  Tclkit has only a limited amount of things inside of it, to reduce it's size, which is around 1.3M.  It does have some, but only a few of those (in zipped form) that are released with the full blown version of ActiveState's 26G full download, which does install all of them.  So, what you are comparing is a lightweight version to run most TCL and TCLkits, with a full blown install of TCL.  That's why it may NOT work.

  From here in the tcl'ers wiki:
"Tclkit" is the name of a package that combines the standard Tcl/Tk binary with a virtual filesystem containing all the script files. The result is a single stand-alone executable, which acts as hassle-free runtime for Starkits, or you can use it like any other Tcl/Tk system. It embeds all the startup scripts and support libraries in the executable, and loads Tk optionally so it can be used as either tclsh or wish. On Windows this dual use is not possible, there is a separate tclkitsh to run a command-line tclsh only system. On Macintosh (prior to MacOS X), there is only a GUI-based wish version.
TclKit specifically refers to such an executable which will contain a tcl, Metakit, zlib, tclvfs, and incr Tcl (and optionally Tk). There are over a dozen platform builds ready to use, including many Unix systems, Windows, and Macintosh. Similar binaries may be produced containing other sets of extensions but these should use an alternative name. For example, a version that avoids Metakit and instead uses a library that avoids C++ and also removes incr Tcl is called TclKit-Lite. Another project produces a binary called dqkit."

  So why it might not work for your program OnceinaLifetime.tcl, is if your .tcl file, used some of the great packages, in tcllib, they wouldn't be present, in tclkit.exe! What you should do is take a look at the top of the .tcl file, in OnceinaLifetime.tcl, and make sure it doesn't have lots of 'package require somepackname' commands in it. So, if you aren't using any of those packages in tcllib, then it should work fine. Or your can just try it, and you'll find out if it is missing packages.

  But those packages, would be present, as folders (with the same package name), in a properly formatted .kit file.

  However. tclkit, for a particular operating system, will work with almost any starkit (that is well written, which may have many, many files, in zipped form, within only one file).  Starkit's are discused over here (on my site's page), and here in the tcl'ers wiki.



  So let's get started on downloading a tclkit, where are they stored?

  Good question.  They are currently stored on Google, for storage purposes.  So where you should go in your browser is to obtain the fairly newest version of tclkit, namely http://code.google.com/p/tclkit.

  If you go there it should look like this:

picture of tclkit_downloads.png

What you should do is click on the the "Downloads" link, and if you do, you'll see this screen:

picture of tclkit_pick8.5.9_01.png

  If you've got to this page then have a closer look at it.  The one in red is the good one, it's called tclkit-8.5.9-win32.upx.exe.  The one above it is a lot smaller!

  What makes it better than the other version, which is smaller?

  Good question.  The other version is only what's called a "Shell" version.  That means it does contain all of the TCL language in it, that's good, but what it is missing, is what is called TK, which lets you display screens that were written in TCL.

  So now you know that tclkitsh-8.5.9-win32.upx.exe is just the "Shell" version (i.e. NO TK).  If you compare the sizes you'll see the differences in sizes (they are also in a red box).  So what you do want is the larger one.

  So if you click on the red box (where you see the little hand in Firefox), you'll see this screen:
picture for tclkit_pick8.5.9_02.png

  This means, "Do you really want to download this?".  No actually it is offering you a "SHA1 Checksum", which is not needed much. You can click on the link "What's this?" if you want to know more about this. Anyway, to continue with the download of tclkit-8.5.9-win32.upx.exe ....

So you do, so click it with your mouse.  This is where it will diverge a little with my use of the browser I like, which is FireFox.  If you do so, you will see it like this:

picture of tclkit_pick8.5.8_03.png

What you should do is click on the "Save file" button.  If you do, you should see this:

picture of tclkit_pick8.5.9_04.png

If you click on the "Save" button, then the download would have already begun.

  Firefox's windows do look a lot like "Windows Explorer" windows, but they are produced by Firefox.  You should look at the screen some more, and look at the items outlined in green.

  What I did, was create a new Directory, by using the "New Folder" button, named it "new6", and have already downloaded a .kit file to it, namely "ased3.0b16.kit" to it.
  Do you want to ask, "I thought you said 'You did download a kit file to it'"?.  I did, and also downloaded an old "ased3.0b16.exe" to it also.  If you look at the screen above, you might notice the "Binary File (*.exe)" right below the lowest green box.  That's why it can only see the "*.exe" type files in the "new6" directory.

  What I want you to do, for a good reason, to be seen later on, is to also download tclkitsh-8.5.8-win32.upx.exe.  They both behave a little different, which I'll show you lot later.

  So lets try downloading tclkit-8.5.8-win32.upx.exe also.  What you want to do is scroll down the the screen a little bit, by clicking on the arrow in the lower left hand corner, like this, until you see tclkit-8.5.8-win32.upx.exe (which is 1.3 MB):

picture of tclkit_scroll_down.png

Once you've scrolled it down far enough, release the button on your mouse.  Reposition your mouse cursor on top of that file named
tclkit-8.5.8-win32.upx.exe, and click on it.  If you do this then you will see a screen like this:

picture of tclkit_pick8.5.9_01.png

  So if you click on the red box (where you see the little hand in Firefox), you'll see this screen:

picture of tclkit_pick8.5.8_02.png

So you do want this one, so click it with your mouse.  This is where it will diverge a little with my use of the browser I like, which is FireFox.  If you do so, you will see it like this:

picture of tclkit_pick8.5.8_03.png

and if you click on the screen above's button, you will see a screen like this:

picture of tclkit_pick8.5.8_04.png

  If you click on the "Save" button, then the download would have already begun.

  Ok. So what we just did is download to tclkit's (namely tclkit-8.5.9-win32.upx.exe which is newer, and tclkit-8.5.8-win32.upx.exe ).

  Once their downloads are complete, in case you're running on a slower connection, keep on reading.




So how can I run tclkit-8.5.9-win32.upx.exe to make sure it works?

  Good question.  If you already have a ".kit" file to test it on, you can skip ahead to try it.  However, you may wind up, back here, trying to get your tclkit running, in the first place.

  What you should do is click on your "Start" menu for Windows.  In my case, it is on the lower left hand corner, and it looks like this:

picture of win_start.png

   It is highlighted in red.  So if you click it you should see this screen:

picture of win_run_01.png

  If you click on the "Run..." button, which is highlighted in red, you should see this screen:

picture of win_run_browse_01.png

  What you should do is click on your "Browse..." button, which is highlighted in red, you should see this screen (which is broken into two parts to make it easy to see both):

picture of win_run_browse_02a.png

and this part2 of the screen:

picture of win_run_browse_02b.png

  What you should do, in part1 of the screen, is to select the choice on the list "tclkit-8.5.9-win32.upx.exe".  If you do so, you should notice the "File name:" item changes to "tclkit-8.5.9-win32.upx.exe", which is highlighted in green.
  If it did, then you should click on the "Open" button, in part2 of the screen, which is highlighted in red.

  If you do that, you should see this screen (if the download was successful):

picture of win_run_04.png

  If you did see this screen, then YES!  It did work properly.

  It would be a lot better to leave this screen open.  It does not require much memory.

  If you came back here, after downloading ml125h.kit, to re-open tclkit-8.5.9-win32.upx.exe's screen, you can go back to the proper spot here.


  What you can do with it now, if you have something you want to test your tclkit-8.5.9-win32.upx.exe upon follows.

  If you don't have something you want to test, why not download mlv125h.kit (or ezsdxv97b.kit)and try opening it with the tclkit-8.5.9-win32.upx.exe, which is why we recommended that you leave that screen open.

  You can do this by opening my home page in another tab, by clicking on your "File" menu and selecting "New Tab" and then entering in the URL adddress: http://www.geocities.ws/thezipguy/indexmain.html. If you do that, you should see a screen like this:

picture of ml_download_01.png

  What you should do is click on your "FreePDF" link, which is highlighted in red, you should see this screen:

picture of ml_download_02.png

  What you should do is click on the "mlv125h.kit" link (where you see the little hand in Firefox), which is highlighted in red, you should see this screen:

picture of ml_download_03.png

  What you should do is click on the "Ok" button, which is highlighted in red, you should see this screen:

picture of ml_download_04.png

 
  What you should do click on your "Save" button, which is highlighted in red. If you do this you've started downloading "mlv125h.kit".

  Once the download is done, you can go back to the tclkit-8.5.9-win32.upx.exe's screen (if you haven't closed it yet).  If you have closed  tclkit-8.5.9-win32.upx.exe's screen, you can re-open it with these instructions.

  Once you have your tclkit-8.5.9-win32.upx.exe screen open, then you can click on the "File" menu and select the "Source..." item.  It should look like this:

picture of tclkit_run_ml_01.png

  What you probably have to do is select the choice "All Files" from the "Files of type" field, on the next screen.

  It does tend to start with the choice "Tcl Scripts (*.tcl)" in the "Files of type" field.  Not sure if this should be changed.

  What you should do select the item "ml125h.kit" from the list, and click on your "Open" button, which is highlighted in red.

picture of tclkit_run_ml_02.png


  If you do that then you should see the screen below.

picture of tclkit_run_ml_03.png

  If you did it, then it did work.




  Well, how do I create an Icon for running tclkit-8.5.9-win32.upx.exe (under Windows)?

  Good question.  What you should do is right-click anywhere on your screen, and select the "New" option from the menu, which is highlighted in yellow, and pick the "Shortcut" item from the menu.  It would look like this:

picture of make_new_shortcut_01.png

  What you should see is the screen below.  What you should do is click on your "Browse..." button, which is highlighted in red.

picture of make_new_shortcut_02.png

  If you do so, you will see this screen below. 

picture of make_new_shortcut_03.png

  What you should do select the item "tclkit-8.5.9-win32.upx.exe" from the list, and click on your "Ok" button, which are both highlighted in red.  If you do so, you will be back on the screen before, with it filled in like this:

picture of make_new_shortcut_04.png

  What you should do is hit the "Next" button, which is highlighted in red.  If you do so, you will see the next screen
filled in with "tclkit-8.5.9-win32.upx.exe's" like this:

picture of make_new_shortcut_05.png

  What you should do us shorten the name (which is "tclkit-8.5.9-win32.upx.exe's") to "tclkit-8.5.9", and click on your "Finish" button, which are both highlighted in red.  If you do so, you will be back to your desktop, with the shiny new Icon like this:

picture of make_new_shortcut_06.png


So, can I make a copy of that Icon?

  Good question.  Yes you can.  What you should do is right-click on that icon on your screen, and select the "Copy" option from the menu, which is highlighted in red.  It would look like this:

picture of copy_new_shortcut_01.png

  Now, what you should do is move just below that Icon, right-click in the open screen, and select "Paste Shorcut" from the menu, which is highlighted in red.  It would look like this:

picture of copy_new_shortcut_02.png

  What you should see is the new Icon you just created, which is named "tclkit-8.5.9 (2)".  It is highlighted in red, in the screen below.
 
picture of copy_new_shortcut_03.png



Can I customize that newly created Icon to use tclkit and a program (ml125h.kit)?

  Good question.  Yes you can.  What you should do is right-click on that icon on your screen, and select the "Properties" option from the menu, which is highlighted in red.  It would look like this:

picture of copy_new_shortcut_04.png

  What that will do, is open up a special window for you, which is a tabbed notebook style window.  You will be on the second tab on that window, which will be the "Shortcut" tab.   It will look like this:

picture of copy_new_shortcut_05.png

  What you should do is add at the end of the "Target:" line, which begins with "tclkit-8.5.9-win32.upx.exe",
" ml125h.kit".  Make sure you include the leading space in there.  It should be filled out as above, which is highlighted in red.
  Then, what you should do, instead of clicking the "OK" button, is click on the "General" tab, at the top of the window,
to switch tabs, which is highlighted in red.  If you do that, you should see the "General" tab screen, which is shown below:

picture of copy_new_shortcut_06.png

  Then, what you should do is to rename the Icon from "tclkit-8.5.9 (2)" to "ML 1.25 Beta", which is highlighted above in red.
If you've done that, then you should click on the "OK" button, which is highlighted above in red.  If you do so, you will be back to your desktop  like this:

picture of copy_new_shortcut_07.png

  with a freshly renamed Icon.  Which is a modified copy of the Icon above, named "ML 1.25h Beta".



Can I test the updated (and customized) copy of the Icon?

  That's easy.  What you should do, is merely double click on the icon, named "ML 1.25h Beta", which is highlighted in yellow above.  If you do that, you should see this screen:

picture of test_new_shortcut_01.png

  Which must be getting kind of familiar right now.  You should click on the "Run" button above, which is highlighted in red above.
If you do that you should see this screen:

picture of test_new_shortcut_02.png 

which means that it did run "tclkit-8.5.9-win32.upx.exe ml125h.kit" to get "ML v1.25h" running.  This is great!

  If you have another kit file, like "ezsdxv97b.kit", it would be easy to get another icon for that.

  What you'd have to do is make another copy of the "tclkit-8.5.9" icon, and customize the newly created icon, namely "tclkit-8.5.9 (2)", to run 
ezsdxv97b.kit.  Then you'd have to test the freshly created icon, to make sure it works.



 So let's say your are left looking at this nice screen, which displays the ML Editor:

picture of test_new_shortcut_02.png
 
  What you could do with ML is:
  • go get some tcl code
  • copy it from somewhere
  • paste it into the ML editor
  • save it under a new name
  • and try running it
  Most of what follows, assumes that you want to try this.



  I would suggest that you do this, by getting something out of it, namely a good card game called "Once in a Lifetime" (which I call "Rainbow").

  You can do this by going to http://wiki.tcl.tk/11193 (by right clicking on it, and request "Open in a New Tab"), and you would see the screen below:

picture of oial_tcl_01.png

  So what you might ask is "Where is the tcl code I want"?

  Well the answer is, it's further down!  So you could click on the "Down Arrow", which is highlighted in red above.  
 
  If you do so, you will see the next screen like this:

picture of oial_tcl_02.png

  So what you want to do is to highlight all the tcl code, in preparation for the "Copy" command.  You can do this by left-clicking, and do NOT release the left button, and move your mouse down toward the bottom of the screen.  This is documented by the screen above, which is highlighted in red above.  
 
  If you do so, you will see, the screen scrolling, highlighting all the tcl code, until the bottom of the screen. It will look like this:

picture of oial_tcl_03.png

  Once you have done this, properly, i.e. not highlighting the text on the bottom of the screen, take your time and be careful.
 
  If you fail the first time, don't worry go back to top, three screens above and follow the directions closel
 
  Once you have all of the tcl code nicely highlighted, what you should do is right-click your mouse, and you should see a pop-up menu, very similar to the one above.  Then, you should position the mouse over the "Copy" choice, and click once upon it, which is highlighted in red above.

  If you do this then you've copied all the tcl text into your clipboard.  Then you can minimize your browser and click on the ML application (or you can hit Alt-Tab and just switch to the ML application).  You may have to click on the ML application to get it the focus on the main window.

  In any case, what you should do next is click on the "Paste" icon in the toolbar, which is highlighted in red below, like the screen below,

picture of oial_tcl_04.png

  If you do this then you should see something like the screen below:

picture of oial_tcl_05.png

  If you do see this screen, then yeah, you have managed to copy all of the tcl code from your web browser into the ML editor.

  Notice the screen above says "Modified" in red on the bottom of the screen, above.  What the ML editor is trying to tell you (or warn you) is that you
have not yet saved it.

  So, what you want to do now is to save it, but under what name?  The answer is right in the tcl code.  So what you should do is click on the scroll up arrow, .  If you do that and hold it down (for a while), you will see all the code scroll by.

  Eventually, you'll arrive at the top of the file, which should look like this:

picture of oial_tcl_06.png

  So what you should do now, is copy the name, which is within the tcl code, in a comment on the first line.

  What you should do now is hold down the right-click button, while expanding you selection, as is highlighted above (which is accentuated by a green box), to get ready to copy that name.  Now you know, you should call it "OnceInALifetime.tcl".  It is better to copy that name, than to memorize that (unless you want to name it something else), because it may be hard to remember for later.

  So what you should do next, is select the "Copy" icon, from the toolbar, which is highlighted in red above, which will copy that into your clipboard, for later usage.

  Then you should click on the disk icon, from the toolbar, which is not highlighted in red above, which, if you do, will present a different "Save File" dialog which is part of the tcl dialogs.  It does depend on which version of tclkit you are running.  You should know this dialog which has been around since Windows XP.  The newer dialog, which you've gotten used to, either liking or disliking it, will cause further discussion of that issue, later.  will copy that into your clipboard, for later usage.


picture of oial_tcl_08.png



picture of oial_tcl_09.png


picture of copy_new_shortcut_08.png


picture of oial_tcl_10.png


picture of oial_tcl_11.png



picture of oial_tcl_12.png




picture of oial_tcl_13.png



picture of oial_tcl_14.png



picture of oial_tcl_15.png



picture of oial_tcl_16.png



picture of oial_tcl_17.png



  Good question.  What you should do is right-click anywhere on your screen, and select the "Copy" item from the menu, which is highlighted in red.

  What you should do select the item "ml125h.kit" and click on your "Open" button, which is highlighted in red.

  What you should do us shorten the name (which is "tclkit-8.5.9-win32.upx.exe's") to "tclkit-8.5.9", and click on your "Finish" button, which are both highlighted in red.

  If you do so, you will be back on the screen before, with it filled in like this:

  If you do so, you will see the next screen like this:

  (where you see the little hand in Firefox)




  Well, what we should first get is to get a good .tcl file to test tclkit-8.5.9-win32.upx.exe upon.

  We can download a file from a web page which is a good game.  This will also show you how to do this in a general way, from  the "Tclers Wiki!", which is huge, and is at http://wiki.tcl.tk.

  So, what you can do is go to this link http://wiki.tcl.tk/11193.  What we want to do is download, the tcl code, which is on your screen, into your favorite editor and save it as OnceInALifetime.tcl. Then, afterwards we can try running OnceInALifetime.tcl on Windows by using tclkit-8.5.9-win32.upx.exe to just run a "tcl" file.





* Sigh....  Lot's more work to do on this page.... *














Created Screenshots (and renamed them) with the help of IrfanView  


Quickly create screenshots of a window and easily annotate or highlight parts of the screenshot
greenshot_logo.gif

 
and edited heavily, in a very nice freeware WYSIWYG editor, called Seamonkey
written by Firefox.

Brought to you Courtesy of The ZipGuy
These pages, and their contents, are Copyright 2000-2014 BMRWare. All rights reserved