XCD
Jump to navigation
Jump to search
http://matbal.drivehq.com/ old website http://mitglied.lycos.de/matbal/ is now offline
Here is an english readme, translated from the german xcd.html:
XCD - eXtended Change Directory for Total Commander http://matbal.drivehq.com/ (tested with Total Commander 6.03a) Installation: Copy xcd.exe to a directory in the 'PATH' (e.g. C:\WINDOWS\ or C:\WINDOWS\system32\). Starting the program: XCD is invoked via Total Commander's command line. Simply type XCD and the "target_directory". (target_directory is the name of the directory you want to change into.) xcd <target_directory> In the appearing dialog all (or similar) directories of the same name are listed with complete path (or similar ones if no directories of the exact name were found). Now select the directory and click [OK] or press Return. Note: XCD uses the file "treeinfo.wc" for finding the target_directory. By default Total Commander puts that file to the root directory on each local drive. If this file is missing or is no longer current, XCD might not function correctly. Treeinfo.wc can be updated with Total Commander or with xcd. Update treeinfo.wc using Total Commander: Run the "CD Tree" command (Alt+F10) to open the Directory Tree dialog box, then press F2 to re-scan the tree. Update treeinfo.wc using xcd: Enter on TC command line | Effect -------------------------------------------------------------------------- xcd /tree or xcd /treeinfo | Treeinfo.wc will be updated on all local drives -------------------------------------------------------------------------- xcd /fg | Treeinfo.wc will beupdated only on the indicated | drives F: and G: -------------------------------------------------------------------------- Change directory: In the following table, <target_directory> is the name of the directory to be changed into. The parameter before <target_directory> indicates the initial position of the search in the directory tree. The standard behavior of XCD when called without parameters before <target_directory> can be specified in the configuration dialog (function key [F12] or context menu in the XCD window). The initial position of the search is always indicated in the status line if the search is limited to a drive or a directory. Enter on TC command line | Effect -------------------------------------------------------------------------- xcd <target_directory> | Search for target_directory in all | possible paths. Total Commander changes to | the directory you select from the results. -------------------------------------------------------------------------- xcd | Brings up the last search results. -------------------------------------------------------------------------- xcd \ <target_directory> | Search for target_directory only on the | current drive. ("\" stands for root of the | current drive) -------------------------------------------------------------------------- xcd . <target_directory> | Search for target_directory in the current | directory and below. ("." stands for the | current path) -------------------------------------------------------------------------- xcd C: <target_directory> | Search for target_directory only on drive C: -------------------------------------------------------------------------- * XCD supports wildcards for target_directory ("*" or "?") e.g. "xcd win*" * target_directory can also contain multiple directories e.g. "xcd winamp\plugins" "xcd e: winamp\plug*" (to the WinAmpPlugin directory) * the search function is error tolerant, e.g. "xcd windos" finds among other things c:\windows The input line below the list of search results always shows the last search word entered. A new search can be started by entering a new search word. Operation of the dialog box: Keyboard | Mouse | Effect -------------------------------------------------------------------------- up/down | click on path in list | Select directory in results | | list. -------------------------------------------------------------------------- Ctrl+up/down | double-click on path in list | (*) Select directory in | | results list and change | | directory in Total Commander | | panel immediately. -------------------------------------------------------------------------- RETURN | click [OK] | (*) Change directory and | | close xcd. -------------------------------------------------------------------------- space/Ctrl | click [Übernehmen] (Apply) | (*) Change directory without | | closing xcd. -------------------------------------------------------------------------- ESC | click [Abbruch] (Abort) | Close xcd. -------------------------------------------------------------------------- plus/minus | click [<-] or [->] | Change tolerance threshold. | | Lists directories matching | | target_directory less than | | exactly. -------------------------------------------------------------------------- Alt+down | click arrow on input line | Opens search history (drop | | down menu). -------------------------------------------------------------------------- (*) With SHIFT key pressed at the same time (or right mouse button) the behavior differs as follows: Change directory to the parent of the selected directory instead of changing into the selected directory. This can be specified as the default behavior in the configuration dialog. Keyboard Instructions The following keys allow you to temporarily change the search options within the open window. The search results are immediately updated. The search options used when XCD starts can be changed in the configuration dialog [F12]. Keyboard | Effect -------------------------------------------------------------------------- number pad [*] | the search word is extended automatically with | *-Wildcards. (on/off) -------------------------------------------------------------------------- number pad [/] | only search the current drive (on/off) -------------------------------------------------------------------------- number pad [0] | error tolerance deactivated (on/off) -------------------------------------------------------------------------- A | Allow directory search on all drives -------------------------------------------------------------------------- C to Z | Limit directory search to the selected drive -------------------------------------------------------------------------- Function keys used in XCD. -------------------------------------------------------------------------- Function key [F1] | Help (not yet done) -------------------------------------------------------------------------- Function key [F2] | Update treeinfo -------------------------------------------------------------------------- Function key [F3] | Set selected directory as new starting directory for | the next search. (*) -------------------------------------------------------------------------- Function key [F4] | Undo the effect of [F3] (*) -------------------------------------------------------------------------- Function key [F5] | Show directory history -------------------------------------------------------------------------- Function key [F12]| Configuration dialog with program settings is opened. -------------------------------------------------------------------------- (Right-click in the XCD dialog box to open a menu of these function keys.) (*) As long as no new search word is entered, all subdirectories of the starting directory are shown. Thus [F3] can show all the subdirectories of a directory and [F4] returns. XCD Over A Network XCD can also find directories over a network. The tree structure of directories shared in the network must already been scanned. If existing directories are not found, "treeinfo.net" is not up to date. Enter on TC command line | Effect -------------------------------------------------------------------------- xcd /net or xcd \\ | Read in the directory structure of | the network shares -------------------------------------------------------------------------- xcd \\ <target_directory> | Changes to a directory in the xcd /net <target_directory> | network -------------------------------------------------------------------------- xcd \\<computer> <target_directory> | Changes to a directory on a certain | network computer -------------------------------------------------------------------------- xcd . <target_directory> | Changes straight into a sublist | of the active directory (as with | local drives) -------------------------------------------------------------------------- ========================================================================== Configuration Dialog Box Pressing F12 in the main window launches the configuration dialog box. options Search Options note: The first three options can be changed also temporarily in the main dialog. * Automatically extend search word with *-wildcards This option causes the search word to behave as if it's surrounded, front & back, with * wildcard characters. This causes directories to be found that contain the search word. * Search only in the current drive Only finds directories on the same drive from which XCD was called. * No error tolerance permitted Normally XCD matches directories that deviate slightly from the search word if no exact matches were found. Thus, even with typing errors, the desired directory can be found. This behavior can be turned off here. * Save settings when XCD terminates This option refers to the main window of XCD and the first three options. If this option is set, the first three options retain their settings with the next call of XCD. Directory change option * Only select Target Directory: Instead of changing into the selected directory, change to the parent of the selected directory. The cursor remains on the directory. (Restriction: This function only works with directories with read authorization.) * Single match changes to the directory immediately: If only one matching directory is found, change to it immediately without showing the result window. Window option * Program window always on top: The XCD main window always remains in the foreground, even if it is not the active window. History settings: * Maximum number of search words (Maximale Anzahl der Suchbegriffe) * Maximum number of directories (Maximale Anzahl der Verzeichnisse) The number of entries refers only to the number stored when terminating XCD. As long as XCD is opened, all entries are accepted. * Delete (Löschen): Deletes both histories. Settings for the Treeinfo.wc: Personal Treeinfos * Alternate location for personal Treeinfos (Alternativer Speicherort für persönliche Treeinfos): Specifies an alternate location for the Treeinfo files if the root directory should not be written or if one wants to work with customized Treeinfos. If a Treeinfo is not found, a reference window appears. * Use additional global Treeinfos, if no personal Treeinfos were found (Globale Treeinfo verwenden, wenn persönliche fehlt): If this option is active and the personal Treeinfo is not found, then the global Treeinfo is used. If both Treeinfos are missing, the reference window appears. Exclusion of directories and drives: * Exception list for directories to omit from the treeinfo (Ausnahmeliste): The entries specified in this list are abort conditions when reading the Treeinfo.wc. The entries are evaluated in RegExp syntax. Examples: ----------------------------------------------------------------------- Entry meaning ----------------------------------------------------------------------- temp Exclude directories which contain "temp" \\temp Exclude directories which begin with "temp" temp$ Exclude directories which end with "temp" \\temp$ Exclude directories which are called "temp" exactly \\temp\\ Exclude subdirectories after "temp" ----------------------------------------------------------------------- * Maximum directory depth Specifies the maximum number of subdirectories that can be read into the treeinfo files. Directories which lie more deeply are not included in treeinfo. If here nothing (or 0) is entered, then this function is deactivated. * Drives excluded by XCD Lists drive letters that XCD should ignore. Simply list the drive letters to be excluded one behind the other. This setting affects both reading the treeinfo and the directory search. * Treeinfo.wc update button This button re-scans the directory structure and updates the treeinfo.wc file. The settings of the main dialog are used, so if the search is limited to a specific drive, only the treeinfo file for that drive is updated. Explanations concerning the error tolerance With active tolerance: When searching for matching directories, XCD allows deviation from the search word for each directory. That means: How many characters must be exchanged/added/omitted for the search word to agree. The directories with the smallest deviation are then listed. With the tolerance keys the tolerance threshold can be further increased (up to max. 50%). Directories that differ by more than half are not considered. To disable error tolerance, simply set the threshold to 0. Thus only exact matches are found (with higher search speed). Explanation concerning the exception list (in the Treeinfo options) The directories listed here are abort conditions when reading the directory structure. All directories must be entered as "regular expressions" (RegExp) therefore the double backslashes in the list. All directories on a drive are read successively and compared with the list entries and matching directories are skipped. When reading the directory structure, each directory path is in this form: x:\dir1\dir2 (notice no backslash at the end.) The entry: \\dir2$ matches the path ($ stands for line end) the entry: \\dir2\\ doesn't match the path (It does match this path: x:\dir1\dir2\dir3) that means: \\directory\\ = directory will be read into the Treeinfo, but its subdirectories are omitted. \\directory$ = directory and its subdirectories are omitted. Further examples D:.*\.bak$ = on drive D: no directories that end with ".BAK"
Back to Shell Extensions and AddOns