The Release numbers are actually dates yy.mm.dd.hr
Each release has a full Change log... accessed by Help->History
This is a quick summary as well as info on installing filerunner.
Complete update info is in the history file.
Fixed a couple of bugs. Expanded the Chmod command to also Chown and to use a new interactive window.
Mostly bug fixes. Improved the color editor to work better with slow systems.
The View window (as well as Q-Edit) now have a spell checker. Just use the
<3> mouse button in the window. This is not your ordinary spell checker. Do check out the spellingFilter in the "Edit Configuration" window.
For windows, we now support the *.lnk files (we try to do this in other systems
as well so that, if possible you can get to what they point at).
Updates no longer kill the selection (as if you knew:).
Button column is now scrollable with the mouse wheel.
Added and modified the key-board support code so that is is more useable.
Fixed other bugs - see the History file and/or the change log.
There is a new color editor, however, the big thing with this release is
the INSTALL file and the RPM and DEB files. This 'could' change how you
install filerunner, see below.
New features include configurable mouse buttons for the file panes including
pop up menus. Rewrite of the Run command, now a middle button. New command
'open', much like the windows open, but, of course, better.
Major new feature this release: ftp like (via adb) connection to andriod devices
Info below covers installation, etc. What you need to down load is:
The *.exe file is self contained and will run on most windows platforms.
Please see the notes below on Requirements to use Secure Ftp.
If you want it to run faster and or to be able to modify the code:
First you need to down load a current version of Tcl/Tk. The
ActiveState Active Tcl version has a nice windows help interface.
Second, you will need the tar.gz file which contains all the sources
and such build files as you might need.
Third, you will need a development environment that has, at least,
tar, gunzip, and some sort of an editor (I prefer Emacs).
For what its worth, it is best to run wish from a CMD window and NOT
from the cygwin window.
To us SFTP on windows, please see the requirements section below.
For other platforms:
There are several ways you can install filerunner:
First: In all cases you will need a current version of Tcl/Tk.
This should be easily obtained from your distro provider. You can
tell if these packages are installed by typing 'tk' at a command prompt:
If a little window pops up you have the required Tcl/Tk code.
Next: If your system uses RPM packages, download the *.noarch.rpm file.
If your system used DEB packages, download the *.deb file.
If your system uses neither of these distribution package formats
or you want to install in a location other than what the above
package files use, you will need to download the *.tar.gz file.
If you have downloaded a package file, your package handler can be
used to install the package and you are done.
Targz: To install the *.tar.gz file, cd to a directory where you would like
to put filerunner. If you are not going to do any work on the code,
this could be a temp directory. Otherwise, choose a directory you
would like to use to do the work. Then 'un-tar' the file, e.g.:
tar xfBp <down loaded fr-*.tar.gz file>
If you don't want to install any parts of filerunner (i.e. you just
want to run from this directory you need do no more. You might want
to put a link to <directory>/filerunner/fr in a directory in your
PATH (for example ~/bin). In any case filerunner will run just fine
from any directory.
Icons & desktop issues:
There is an INSTALL file in <directory>/filerunner/Makefiles
(called INSTALL, imagine that!) that you can run to install filerunner
most anywhere on your system. The INSTALL script behaves differently
depending on if the runner has root access or not.
Before you run INSTALL as root run 'INSTALL -help' to get a list
of options and how you may provide them (commandline or env).
The INSTALL file attempts to install the various bits and pieces of
filerunner to the proper directories, however, your distro may have
other conventions. You may introduce these conventions to INSTALL
when you run INSTALL or even after it is running (if Tk is installed
there is a gui interface to help here). (Tk is not required, but
is used if INSTALL is run in a user environment or the gui is
requested on the command line.)
A request: If your distro puts things in different directories could
you send me a note describing this to me (email address at end of
A simple way to do this is to just send a copy of the
'uninstall' file that INSTALL puts in the CODE directory.
INSTALL sets up filerunner icons and a desktop file. This allows
filerunner to be easily found in the system menus and allows you
to easily set it up as your default handler for inode events
(such as plugging in a memory stick or camera memory).
Note that the INSTALL file allows you to install just the icons
and desktop files, leaving the code in place. This is a useful
way to install if you are going to work on the code.
In addition INSTALL manages keeping filerunner appraised of the
location of its 'doc' files and of a system wide configure file.
System wide config file:
The RPM, DEB and root INSTALL code sets up a system wide configure
file for filerunner. The default location of this file is:
/usr/share/config/filerunnerrc if a root (or RPM/DEB) install and
~/.local/share/config/filerunnerrc if a user install
This file is created if it does not exist, but is not touched if it
does, thus it survives updates.
Other things you might want:
To use the Secure FTP feature you will need to have both Expect and sftp
on your system. Expect is available here:
sftp should be in one of the vendor packages for your system. On
Fedora 16 it is in the openssh-clients rpm.
The fr-*.tar.gz file is the complete source including several tools
and scripts to build all the release files.
The RPM source file is just this file packaged as an RPM.
And, if you want to modify the code, a decent editor is helpful (again,
I prefer Emacs).
This file is also available as the 'Installation' file under the help menu.
(C) 2010 Tom Turkey
(C) 1996-1999 Henrik Harmsen
FileRunner is a file manager for Unix. It is simple and efficient
and has a built-in FTP client.
It also does a reasonable (and improving) job on Windows systems.
* Simple and powerful interface.
* History and Hotlist (bookmarks).
* Recursive directory menu of entire file system tree (not supported in windows).
* Browse FTP and SFTP directories as easy as normal directories.
* FTP & SFTP capabilities:
- Copy: FTP files/directories upload/download (recursive).
- FTP/SFTP Delete (recursive), FTP/SFTP Makedir, FTP/SFTP Rename.
- FTP/SFTP chmod (if server supports it)
- Supports FTP through proxy.
- FTP resume download function.
- Rule based configuration of FTP/SFTP site logins (password/user/proxy).
- Asynchronous file transfer.
- Cached directory listings.
* Asynchronous file operations.
* Built-in command shell windows. Synchronized with file panels.
These have history, aliases and file name completion.
* Extendable by adding your own command buttons.
* Very configurable.
* User defined file pattern / actions. (*.jpg -> launch image viewer etc.)
* Distributed under the GNU General Public License.
* A standard Unix platform or Windows NT or later.
* Tcl/Tk 8.5.7 or later.
FileRunner does not require rebuilding the wish binary. It is pure Tcl/Tk and
uses some helper programs as available on the host. These functions are
configured by default and the user as needed.
Requirement to use the Secure Ftp (SFTP) option.
For non-windows platforms:
You must have the Expect tcl package and
sftp installed on your system. Expect is available here:
sftp should be in your standard distro. In Fedora 16 it is in the
For windows platforms:
At this time we only support SFTP on windows if you set up
the ssh password exchange to use an un protected private key
(i.e. no passphrase) and have your public key already on the host.
We do not support the supplying the password or passphrase through
the windows .exe file because, without the Expect package,
which is not in the code we use to build the .exe file, filerunner
can not pass either the password or the passphrase to the
This restriction is modified in that you may use a passphrase
if you install tcl/tk and use the filerunner.tar.gz file to
run filerunner. In this case you will also need to make sure
the Expect package is available. At this point in time the
Expect site recommends ActiveState for this package. Still,
for reasons I have not been able to understand, even this
package will not properly pass the password that you would
need if you did not set up a public/private key with the host.
Regardless of if you use the .exe file for windows or you use
the tar.gz file on windows, you will need an sftp server. We
have only tested the PSFTP.EXE program from the PUTTY package
which you may download from here:
You need to make sure your PATH enviornment variable contains
the path to SFTP.EXE.
FileRunner has been verified to work on:
- Windows XP or later
Past versions have worked on (but the current version is not tested on):
- SunOS 4.x
- Solaris 2.x
- Irix 5.x
- UnixWare 2.x
- Dec Alpha OSF (Digital Unix)
- SCO OpenServer
Installation is fairly simple.
Under windows, if you use the fr.exe file, you just need to put the file in a
convenient location (usually you will want the path to it in your PATH
environment variable). You can, if you like, put a shortcut on your desktop
(or where ever).
If you want to use SFTP please see the requirements section above.
This description is what to do if you are not using one of the package
files (*.rpm or *.deb) or if you want to edit or modify filerunner in
The main thing to note here is that you unpack directly to where the
stuff is to be installed. You may also do an INSTALL (see above) at this
The packaged distribution is set up to both run and allow development
(the only real difference being the tools in the "Makefiles"
The first step is to get the archive unpacked.
$ cd /usr/local/lib
$ gzip -cd fr.tar.gz | tar xf -
$ cd filerunner
You don't have to install in /usr/local/lib, you can install anywhere,
just make sure the link in step 3 is correct.
Filerunner is all Tcl/Tk. There is no longer any C or other language
content. The make file included with the package is used only if you
modify the "FontControl" file and builds the "FontControl.tcl" file by
striping bits of Tcl/Tk that, otherwise, allow FontControl to run as
an independent program (for those who want to use it elsewhere).
3. Making a soft link
The final stage of installation is to soft-link the fr script to where
you want installed in your path. If you want it in /usr/local/bin, and
you unpacked the FileRunner archive under /usr/local/lib, you do the
$ ln -s /usr/local/lib/filerunner/fr /usr/local/bin/fr
It's important you make this a soft link and not just copy it. If you
don't, FileRunner will not find the rest of itself and will not start
up. It uses the link to find the necessary stuff it needs.
4. If you installed as root
If you have installed FileRunner as root you probably have erroneous
owner/group id's of the installed files. Do the following (as root):
# chown -R root filerunner
# chgrp -R root filerunner
# chmod -R go-w filerunner
To fix permissions and ownership of the files.
5. Check the requirements...
See the requiremnets section above to make sure you have right support software.
WHERE TO GET FILERUNNER
Use this site:
WHERE TO GET TCL/TK
Please see the web page at
See the FAQ-file in the installation. Please also see chapter 13 in
the online guide.
Please see the file KnownBugs.txt.
E-MAIL LIST WITH ANNOUNCEMENTS
You can signup at at the filerunner sourceforge site to get on the
FileRunner announcement mailing list.
FILERUNNER IS OPEN SOURCE SOFTWARE
FileRunner is Open Source software and is distributed under the GNU
General Public License. If you like it, send me a cool postcard so I
can fill the front of my fridge :-) See the end of the User's Guide
for my address.
FileRunner is Copyright (C) 1996-1999 Henrik Harmsen.
FileRunner is Copyright (C) 2010-2013 Tom Turkey.
Henrik Harmsen (the orgional author seems to have disappeared)
We are also on Facebook. Just look for 'filerunner'.
For more contact info see online guide.