FSGuide commander of the web
about ^ donate ^ screenshots ^ history ^ forum ^ download ^ fsguide at sourceforge.net ^ author

FSGuide is a Norton Commander-clone for the web, which might be useful when you do not have shell access to your server, but want to perform various file operations. As a hosting provider, you can even give this tool to your hosting users, so they can access and modify their files through FSGuide - or you can use it yourself as a system administration tool.

Note: Due to the limitations of running scripts in server environment, you can reach only those files of the filesystem that are available to the web user (www-data or wwwrun used by Apache). In general, it's much more than just the files and directories under document root!

FSGuide features:

• user authentication (you can disable user authentication to use FSGuide without logging in)
• details of user access are configurable in a simple .ini file
• deeply customizable through its configuration file and the user.ini file, loads of peruser settings
• access control finetuning through access control lists in user ini file
• you can implement your own authentication module (eg. rdbms-based)
• two-panel display (supports sorting)
• directory bookmarks
• selecting files using checkboxes You can even "cross-copy" files between the two panels: after selecting files in both panels, just click the copy or move button - this way all the selected files are copied/moved to the other panel. If you click on the delete button, all the selected files in both panels are deleted.
• advanced file selection dialog (select files by regular expression, extension, extension group, permission, filesize, time)
• advanced mass renaming tool (add/remove characters, case conversion, regular expression rename)
• copying, moving, deleting files and directories even recursively
• renaming files or directories (only the first selected file)
• creating directories
• the file operations use no external commands (it helps multiplatform use)
• a one-line navigator on both panels. Clicking on parts of the navigator results in opening that subdirectory in the panel.
• downloading files (and optional bandwidth control mechanism)
• opening and displaying files:
  • built-in detection for different filetypes (DOC, PDF, text, PHP, binary, etc.) by extension or contents
  • displaying files depending on the result of the detection:
    • files having .php and .inc extension are displayed using source highlight
    • images files recognized by PHP are displayed as images: this helps a lot while organizing image files on a remote server (eg. if you use Windows).
    • If there are no other special characters than #09 (tab), #10 (CR), #12 (page break), #13 (LF), the file is displayed as a simple textfile. The file is divided into 10000 characters long pages (you can use the "more" or "less" links to switch between pages)
    • If there are other special characters in the file, or characters undefined in the ISO-8859-2 codepage, then the file is treated as a binary file. In this case the control characters, and ISO-8859-2's undefined characters (0x7f- 0x9f) are replaced with a dot (to avoid browsers displaying contents erroneously and to conform the HTML standard).
• file uploader:
  • configurable number of files to upload at once
  • you can configure any application to run after upload
  • you can check to drop the original file when the application finishes
• file editor:
  • plain text editor
  • binary editor
• works under both Windows and Linux
• does not depend on third-party libraries or extensions and needs no RDBMS
• produces well-formatted, valid HTML 4.01 Transitional pages
• uses PHP's error messages to report errors of file operations (since the default messages contain all the important information about the errors). This will change in the future.

FSGuide is licensed under the GPL license, it means that it's free and will be free for you. However, if you would like to support the author and the development of FSGuide, feel free to send a donation.

Donations are accepted using the Kagi service: https://order.kagi.com/?6FADP

The base amount is $5, but if you would like to donate more, "order" multiple copies of the "FSGuide donation" product. Major credit cards accepted (Visa, MasterCard, Discover, Americal Express, and more). If you experience any problem with sending donation, please let me know.

^ the opening two-panel view	^ renaming files
^ displaying textfiles	^ PHP (or HTML) files are source highlighted
^ editing binary files	^ file uploader allows running unzip/untar or other applications
^ handy filelist	^ advanced select dialog
^ advanced file compare/select dialog

v0.7  // released on 2005-04-25
    + added Italian translation, thanks to Marco Ponti!
    + rename form now handles multiple files
    + added dialog to rename form - such powerful rename tool has
      never been before in a web-based file manager!
        - remove given characters from filename
        - remove N characters (from beginning/end/given position of filename)
        - add string (to beginning/end/given position of filename)
        - regular expression replace
    + added (fake) statusbar (left top corner, under "bottom" link).
      shows up when you click on select all/none/invert selection
      on hundreds (thousands) of files in a directory.
      also used for rename form (placed after the form legend).
    + added edit link for php viewer
    + i18n done/fixed for 
      - sort arrows, 
      - create/last access time (appears as tooltip 
        when mouse cursor is over panel timestamps)
      - select/unselect dialog extension group select 
        (reported by Marco Ponti)
    * fixed bug 919535: save_textfile() function saved extra \ characters 
      for files containing ' when magic_quotes_gpc was on

v0.6  // released on 2004-11-28
    * array_multisort bug fixed,
      https://sourceforge.net/forum/forum.php?thread_id=1119844&forum_id=265340
    + added Spanish translation, thanks to Andres Barreto!
    + advanced file compare dialog
    * JavaScript confirmation before deleting files
    + donations accepted through Kagi

v0.5  // released on 2004-03-09
    (tons of important changes, maybe it should be more than 0.5 :)

    + download option with configurable bandwidth-control
      (browser-quirks identifier class was included from 
       the Horde framework)
    + user authentication and per-user settings through user.ini
      it's even possible to create your own user authentication module
      (eg. rdbms-based) by replacing user.ini.php with your own
    + session-based user authentication
    + you can still use FSGuide without login/password, in which case
      the [default] settings of user.ini will be used
    + per-user settings:
       - bookmarks= (shortcuts to frequently used directories)
       - start= (start directories)
       - dirN= (access control rules to define rights)
       - password= (user password)
       - and other settings from config.inc.php
    + you can override default settings in user.ini
    * reorganized directory structure
    * the Windows driveletter-shortcuts are removed. you can simulate
      nearly the same effect by using the bookmarks
    * the '.' (current directory) filename can be configured to be shown or
      not (now disabled by default)
    * fixed bug: couldn't access directories having ' or & in its name
      (reported by Ercolino, thanks for further suggestions too!)
    * navigatorline() reviewed (variable name changes only)

v0.42 // released on 2004-02-17
    * workaround for a kinda annoying bug of MSIE: it does not support 
      multiple submit <BUTTON>s sharing a common "name" and
      having different "value" attributes (anyways, it works fine under 
      also Opera, Mozilla) (reported by Ercolino)

v0.41 // released on 2004-02-10
    * large filelist resulted an Apache error due to large amount of
      GET data (now using POST method for the main form and the 
      REQUEST array everywhere in the code) (reported by Ronalds)
    * small HTML and image fixes
    + added rating, please do rate if you use and like it 

v0.4 // released on 2004-01-14
    + added 'check all', 'check none', 'invert selection' and 
      an advanced select dialog 
    + added file selector dialog (by filetype, extension, regexp, filesize)
    + filelist function added
    + language tool added - it helps translators to find missing 
      defines in language files (see includes/langtool.php).
    + added customized free icon sets from: 
        - Ben of hooboo.com (iconsets/ben),  
        - Barbara Kaemper's 'Landscapes' (iconsets/bk) 
        - Andi Peredri's 'QIcons 0.1' (iconsets/quicons), 
        - and the GNOME icon set 'Noia' (iconsets/noia)
    + added French language file (created by Ben Bois)
    + added German language file (created by Christopher Kramer)
    * <INPUT TYPE=BUTTON> was replaced with <BUTTON> to
      avoid problems with national characters in button names -
      now FSGuide needs HTML4 compliant browsers
    * fixed rename bug (reported by both Marton Elek and Christopher Kramer)
    - the 'check all' checkbox was missing in the root directory since
      it was positioned for the dot directory. Now it's eliminated by the
      new selection controls.
    * changed <? to <?php everywhere so settings of php.ini won't affect 
      fsguide
    * verified against HTML standard using W3C's validator

v0.3 // released on 2003-11-18

    + added html highlighter to viewer
    + added custom error handler
    + added file uploads with unzip option. 
      + detects if php.ini 'file_uploads' setting makes it possible
      + shows maximum upload filesize (php.ini setting) before upload
      + configurable number of upload controls
      + any command can be configured to run after upload 
        (unzip, mogrify, etc.)
    + javascript used for making the gui convenient (global invert checkbox)
    + text editor now saves the file
    + binary editor now saves the file
    + save_binaryfile() validates input values before updating the file
    * binary editor bugfix (last line did not appear)

v0.2 // released on 2003-04-04

    + added HISTORY, README, TODO files
    + localization support (English, Hungarian language files included)
    + skeleton for text and binary editing (does not store yet)
    + configuration file
    + support $default variable containing default values
      will be configurable later
    + filetype icons (taken from Apache) 
    + panel content sorting 
    + opening current directory 
    + drive selector under Windows
    + you can configure which drive letters to scan 
    + CSS layout
    * panel rendering rewritten to support sorting
    * replaced short variable- and functionnames 
    * viewer: now easy to add new filetypes
    * viewer: separate filetype determination and file viewer parts
    * viewer: file viewer parts are placed in an include file
    + viewer: added Content-type headers for PDF, RTF, PS,  
              M$ Word, M$ Excel, MP3
    * filename cut when too long (configurable), TITLE contains full name
    * colorized permission letters

v0.1 // released on 2003-03-10

  basic version, a contribution to the 5k php compo of the
  Hungarian PHP Conference, 2003 (www.phpconf.hu)
  the source was unreadable for others than me (had to fit in 5120 bytes) 

  basic features:
  - two panel interface (filename, size, date, rights)
  - recursive copy, move, delete
  - mkdir
  - rename
  - navigator bar
  - checkboxes
  - view binary files, textfiles with a pager
  - view images (recognized by PHP) as images 
  - view PHP files as source highlighted
  - HTML 4.01 Transitional (validated successfully at w3.org)
  - supports both Windows and *NIX (tested under Windows and Linux)

Looking for a professional form generator for PHP?
Visit phpformclass.com to download a free copy of clonefish,
the best configuration-based PHP form generator and validator class for automatic form processing!