Version 0.7.x, May 2011
Command-line OptionsDirWin is a window that shows you the contents of one directory and lets you perform certain functions on those files. DirWin uses the FLTK user interface library, which makes it especially efficient on TinyCore Linux. The source code of DirWin is released under the GNU license. See http://www.gnu.org/licenses/ for more details.
CAUTION: Use carefully and at your own risk! DirWin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See http://www.gnu.org/licenses/ for more details. Please provide feedback on bugs, quirks, and improvement suggestions so it can be made better.
DirWin has no unique command-line options at this time. It does accept the
FLTK-standard command-line options to override application colors and so forth. You
many see a brief list of the these FLTK-standard options by passing an invalid
option such as --? on the command line.
You may pass an initial directory as an argument to Dirwin:
dirwin /path/to/my/intial/dir
DirWin will perform the command-line entered in the Cmd input field when you press enter or click the "Do Cmd" button. This field is automatically filled when you select a file with the first defined application association based on the file type. If DirWin cannot identify the file as a specific type, the first generic association is used as the command line. (See Managing Filetypes and Associations with Programs for more info on associating file types with applications. If you double-click a file in the list, the command-line is automatically executed. If you single-click on a file, you may edit the command line in the Cmd field before you press enter or click on "Do Cmd".
Jump to...Home: Ctrl+Shift+Home, Change to the user's home ($HOME) directory, normally /home/tc.
Jump to...Start Dir: Ctrl+Shift+S, Change back to the initial directory of this session of DirWin.
Jump to.../mnt: Ctrl+Shift+M, Change to /mnt directory.
Jump to.../opt: Ctrl+Shift+O, Change to /mnt directory.
Jump to.../tmp: Ctrl+Shift+T, Change to /tmp directory.
Jump to...TCE Dir: Ctrl+Shift+E, Change to TinyCore Extensions, TCE, directory.
Open terminal here: Alt+T, Open a terminal (fixed as "aterm" now) window with the current path set to the directory highlighted in the directory tree window.
Create directory: Ctrl+D key, Create a new subdirectory under the current directory, using the name entered in a prompt window.
Refresh: F5, Reloads the window with the current contents of the current directory.
About: F10, Displays "About" copyright, summary, and license info.
Help: F1, Displays this help file.
Quit: Ctrl+Q, Quit DirWin.
Rename: F2, Places a "mv" (move which also will rename the file) in the Cmd input field along with the name of the selected file. Type the new name after the existing name, then press the Enter key or click the 'Do Cmd' button to commit them.
Delete: Delete key, Delete selected item or items. If the "ConfirmDelete" configuration is set to 1 in the .dirwin.conf file, the user will be prompted to confirm the delete operation.
Copy: Ctrl+C, Make a note of the currently selected files for use with later commands.
Paste: Ctrl+P, If one or more files are already "copied" for pasting, the Paste command will put a copy into the current directory.
View Text: Ctrl+1, View the contents of the file as a text file in the exeuctable 'editor' in read-only mode. If the file is not a text format file, this command may not provide an intelligible display.
Edit Text: Ctrl+2, View the contents of the file as a text file in the exeuctable 'editor' in read-only mode.
(Additional associated programs for all files) Ctrl+n, where 'n' is 2, 3, ... Launch associated app as defined in the .dirwin.conf file.
(Additional associated programs for specific file type) Alt+n, where 'n' is 1, 2, ... Launch associated app as defined in the .dirwin.conf file, where the type is impled by the extension (end portion of the filename).
| F1 | Open this help document | |
| F2 | Rename current selected file | |
| F5 | Refresh window conetents | |
| F10 | Show "About DirWin" window | |
| Delete | Delete file(s) or directory | |
| Alt + T | Open a terminal window at the current directory | |
| Ctrl + C | "Copy." Well, really just remember the selected files for Paste later. | |
| Ctrl + V | "Paste." Well, really just duplicate files remembered from "Copy" | |
| Ctrl + Backspace | Go to parent directory (toward root) | |
| Ctrl + Shift + Home | Jump to $HOME directory | |
| Ctrl + Shift + S | Jump (back) to initial directory of this instance of DirWin | |
| Ctrl + Shift + M | Jump /mnt (file mounts) directory | |
| Ctrl + Shift + O | Jump /opt option configuration directory | |
| Ctrl + Shift + T | Jump /tmp temporary file directory | |
| Ctrl + Shift + E | Jump to Tiny Core Extensions (TCE) directory |
There are two main ways to move or copy files in DirWin:
DirWin has a simple way to define file types and programs that should be associated with each type. File types are distinguished by the final letters of the filename, which often contain an "extension" consisting of a period and a short word or abbreviation, such as .png for Portable Network Graphics image files, .cpp for C++ programming source code files, and .sh for shell script files. In the .dirwin.conf file, there are multple lines that define the file name extension to match, a friendly label for the file type that will appear next to the name in the directory contents view, a friendly label for the associated program command, and the specification of the command itself. For example, the following association definition for shell script files allows us to easily "Run" a selected file whose name ends in '.sh' as a shell script in an aterm window:
.sh,script,Run,aterm -e ./%s &Note that there are no spaces around the commas above, and that the '%s' will be replaced by the name of the currently selected item or items. Any association made with the wildcard "*" extension pattern will be available to files of all types. For example, the "View Text" and "Edit Text" associations are pre-defined with:
*,file,View Text,editor -R %s &The first association for a specific file type will be the first in the menu and will also be the association that is used when the user double-clicks the file, except for directories (which causes a change to that directory) and executables (which will launch them).
Here is a .DirWin.conf setting that is not exposed in the GUI:
| ConfirmDelete | Whether DirWin will request user to confirm all delete
operations (1 = yes: confirm delete operations, 0 = don't) |
To easily select multiple files, you may "sweep" over right-side file list using the normal left-click-and-drag gesture, but in the non-name columns. As in several other file managers, you may also shift-click to extend a selection range, or ctrl-click to toggle the selection of individual files.
DirWin will try to utilize the window managers's color scheme and display something legible for reasonable combinations of foreground and background colors. However, some combinations of colors will not be usable. DirWin will utilize the window manager's FLTK window style setting, which can currently be one of "none" (Windows 95 style), "gtk+", or "plastic" (Mac OS Aqua style).
Some filesystes for mountable media such as FAT32 USB memory sticks support upper and lower case letters in filenames in a limited way, so the underlying Linux file management commands used by DirWin may not allow you to successfully rename a file if the only difference is capitalization. For example, if you try to rename myfile to MyFile on a USB Stick, it will not work for certain filesystem format types. However, you may change the name in two steps: myfile --> myfile1, then myfile1 --> MyFile.
Post bug reports and suggestions to the Tiny Core Linux Forum
(http://tinycorelinux.com/forum/).
Michael A. Losh