MFMR  -  My File Manager Re-Imagined
Overview
Disclaimers
General Notes
File and Directory View
Usage and Navigation
All Keyboard Shortcuts
Main Menu Bar:
 New
 Go
 UP / HOME OPT TCE TBIN CD
 HighLight
 Files
 View
 Sort
 Config
 Exit
 Help
Secondary Menu Bar
DIRECTORY TREE
MFMR BULK RENAME
MFMR BURN
MFMR CONFIGURE
MFMR EXTRACT ARCHIVE
MFMR FIND
MFMR MOUNT
Application Popup List
Command Output Popup
CREATE ARCHIVE Popup
Destination Directory Popup
EDIT ATTRIBUTES Popup
Right Click Popup Menu
STATISTICS Popup
Command Line Use
Known Issues
Changelog
Bug Fixes










Overview:

My File Manager Re-Imagined (MFMR) is based on Stefano Gatti's My File Manager
v0.4 (http://sg67.altervista.org/mfm), released in 2006 under the terms and
conditions of the GNU GPL (http://www.gnu.org/licenses/gpl-3.0.en.html). It
is a small, lightweight, fast and configurable file manager with minimal
dependencies (FLTK v1.1).

MFMR was adapted specifically for Tiny Core Linux and BusyBox. Original source
code was modified to change layout and appearance, improve functionality and
address bugs. This help file was rewritten to reflect these changes. Useful
updates will be uploaded to the repository. Hopefully you find this software
enjoyable and useful. Review disclaimers and known Issues before using.

MFMR is a non-traditional file manager that provides a simple, somewhat quirky
interface. Although a basic directory tree can be launched as a seperate window,
it does not feature a built-in tree or provide other popular layouts such as
multi-pane or tabs. It does, however, provide mechanisms to perform file
operations and additional actions:

  - Create, copy, move, remove files and directories
  - Create symbolic links
  - Move to trash and permanent delete
  - Open multiple windows, right-click drag and drop
  - Bookmark and select directory favorites
  - Utilize directory history for more efficient navigation
  - Mount/unmount partitions, temporary mount, check freespace
  - Burn data to CD/DVD (not presently functional)
  - Compress and extract files, numerous formats including *.deb files
  - Rename and bulk rename files, numerous rename parameters
  - Find files and directories, various filters, text file content search
  - Launch regular and root terminal
  - Configure view, sort and mouse scroll speed
  - Configure default editor, terminal, trash bin path, filetypes and colors

Executables utilized in this extension are listed below. All helper
executables can be launched from within an MRMR window:

mfmr            My File Manager Re-imagined
mfmburn         CD/DVD burn utility
mfmcfg          Configuration options
mfmfind         Find files
mfmhelp         Integrated help
mfmmount        Mount/unmount partitions
mfmrename       Bulk file rename
mfmzip          Extract files










Disclaimers:

MFMR is based on beta software. There are numerous known issues and probably
unknowns. This software comes with absolutely no guarantees. Perform regular
data backups and use at your own risk.

All helper executables were modified for MFMR but not unlinked from original
source code. Loading the mfm.tcz and mfmr.tcz extensions concurrently is,
therefore, not recommended. Both extensions also utilize the same
~/.mfm configuration directory, which should be renamed or removed
when switching between these extensions.

Always confirm the trash bin pathway and contents before emptying! The default
trash bin pathway is /tmp/trashbin, not persistent in default Tiny Core Linux.










General notes:

MFMR and helper GUIs were adapted for Tiny Core and BusyBox. See change log and 
bug fixes. Most menubar buttons, dropdown menus and keyboard shortcuts were
revised for efficient navigation and file management. See usage and navigation
and all keyboard shortcuts for more information.

Main menubar directory shortcuts are colored blue and menubar dropdowns that
provide double-click functionality are colored pink. Selected items are
highlighted yellow for easy visibility.

Dedicated menubar buttons for UP, /, HOME, OPT, TCE, BIN and CD along the main
menubar provide quick navigation with a single click or keystroke. All dropdown
menus and most selections have dedicated hotkeys (underlined on menubar or
identified in menubar dropdowns).

A secondary menu bar was added to provide quick access to: history dropdown
(navigate to previously visited directories), clear history, burn, edit,
extract, find, mount, trash, terminal and root terminal.

The Enter key is used to open any file with the default editor. This provides
an efficient method to open any text file regardless of extension
(eg. rc, dot, html, dep).

Left arrow key navigates up to parent directory and the right arrow enters
the selected directory or opens a selected file with the default action.

Up/down arrow, page up/down and home/end navigate within directories.

Creating a new file is as simple as pressing Alt-f, enter name.

Creating a new directory is similar, Alt-d, enter name.

Although customizable, sane first run sort, view and configuration options
include Tiny Core friendly default editor (editor), terminal (aterm) and trash
bin pathway (/tmp/trashbin). Easily recogized colors are used for executables
(red), directories (blue), mounted partitions (green) and unmounted (red).

MFMR relies on the Window Manager titlebar to display the current directory
pathway, which may require modification to improve visibility. Review your
Window Manager theme or consult the documentaton.










File and Directory View:

The main MFMR window appearance will change based on the sort, view and
configuration options utilized. By default directories are colored blue,
regular files black and executable files red.

Main window headers include Filename, Mode (permissions), Owner, Group,
Size and Date. Header widths can be clicked and dragged to resize.

Single left clicking a header title will re-sort the view based on the header
selected. Clicking the header again will inverse sort/toggle the directory.

Numerous options are available to show/hide file permissions, ownership, size
and date information. Filenames can be listed on the right side, directories
and dot files can be hidden, file and directory colors can be customized or
disabled, etc. See View and Options dropdowns and MFMR CONFIGURE.

The default size of the main MFMR window can be changed by corner dragging the
window to the desired size. This data is written to ~/.mfm/mfm-def.cfg (width_
window, height_window) when the window is closed. The window must be closed
and re-opened for the directory headers to properly resize.

To restore default settings, close all MFMR windows and helper GUIs and use a
terminal to remove the ~/.mfm directory or applicable configration file. A
new default configuration will be saved upon exiting the next program run.










Usage and Navigation:

Main MFMR window main menubar mouse navigation:

  Click UP, /, HOME, OPT, TCE, TBIN, CD: access other directories,
  CD opens Change directory popup

  Single-click pink menubar buttons: access dropdown menus

  Double-click pink menubar buttons for these actions (actions highlighted
  pink in dropdown menus for easy reference):

    New: open new MFMR window to home directory

    Go: reload directory, deselect items, return to top of directory

    HighLight: select all files and directories

    Files: open statistics popup of selected item(s), item(s) need to be selected

    Sort: toggle inverse sort

    View: open edit attributes popup for selected item, item needs to be selected

    Config: open MFMR Configure

    Exit: close current MFMR window

  Help!: this help guide


Seconday menubar mouse navigation:

  History dropdown: change to previously visited directory

  X: clear/reset history dropdown menu

  burn: open MFMR BURN, at least one file or directory needs to be selected

  edit: open selected file with default editor

  extract: open MFMR EXTRACT ARCHIVE

  find: open MFMR FIND

  mount: open MFMR MOUNT

  trash: move selected item(s) to trash

  $: open default terminal to current or a selected directory

  #: open root terminal to current or a selected directory


Other mouse navigation:

  Double left click directory (default color blue): open directory

  Middle click directory: open directory in a new window

  Right click anywhere or specific item(s): open right click popup menu

  Double left click executable (default color red): run executable

  Middle click executable: run executable and capture command output

  Middle click regular file: activate application popup list

  Double left click file: open with default action, specified in MFMR CONFIGURE

  Single left click: select one file or directory

  Single left click and drag up/down: select multiple items

  Single left click an item, hold Shift, select another item: selects contiguous

  Single left click an item, hold Ctrl, click other item(s): select multiple

  Single left click selected item while holding Ctrl: deselect item

  Right click and drag: copy, move or create link within same window directories,
  to another MFMR window or a DIRECTORY TREE, popup will confirm action

  Middle-click and drag: middle-click and drag a directory from the DIRECTORY
  TREE to an MFMR window to load the selected directory in the window

  Click and drag vertical scrollbar or middle-click along scrollbar: quickly
  scroll up/down directory


Main MFMR window keyboard navigation:

  Main menubar underlined hotkeys: activate buttons and dropdowns

  Left arrow: go up to parent directory

  Right arrow: open selected directory, open regular file with default action or
  run executable

  Enter: open selected file with default text editor, select dropdown menu item
  or select OK/specific action buttons in popups

  Spacebar: select item from dropdown menu

  Up/down arrow: scroll up/down folder/file list, select item, navigate dropdown

  Page up/down: move up/down folder/file list one page at a time

  Home/End: quickly move to the top/bottom of folder/file list

  d key then Alt 0-8: open change directory popup and access directory favorites

  Escape: close dropdown menus, cancel popups, close MFMR window


Mouse scroll wheel speed can be adjusted via Config -> scroll wheel speed.

Explore dropdown menus for additional keyboard shortcuts. Review all keyboard
shortcuts for a comprehensive list of shortcuts.










All Keyboard Shortcuts:

Main MFMR window menubar hotkeys:

  n: open New drop down menu

  g: open Go drop down menu

  /: open root directory

  h: change to /home/tc directory

  o: change to /opt directory

  t: change to TCE directory (/etc/sysconfig/tcedir)

  b: change to trash bin directory (default /tmp/trashbin)

  d: open change directory popup, select directory/bookmarked favorite

  l: open HighLight dropdown menu

  f: open Files dropdown menu

  v: open View dropdown menu

  s: open Sort dropdown menu

  c: open Config dropdown menu

  e: open Exit dropdown menu

  !: open this help guide


Additional keyboard shortcuts:

  Left arrow: go up to parent directory

  Right arrow: open selected directory, open regular file with default action or
  run executable

  Alt-right arrow: activate application popup list

  Enter: open selected file with default text editor, select dropdown menu item
  or select OK/specific action button in popup

  Up/down arrow: scroll up/down directory list, select item, navigate dropdown

  Page up/down: move up/down directory list one page at a time

  Home/End: quickly move to the top/bottom of a directory

  Tab: reload directory, deselect all items, go to top of directory

  Escape key: close MFMR window, helper GUIs, exit popups and dropdowns

  Delete: move seleced item(s) to trash bin (no prompt)

  Shift-Ctrl-Delete: open Empty trash bin popup

  Shift-Delete: open Delete item(s) popup

  Ctrl-b: open MFMR BURN, at least one file or directory must be selected

  Ctrl-c: toggle display colors

  Ctrl-d: toggle show directories

  Ctrl-e: open MFMR EXTRACT ARCHIVE

  Ctrl-f: open MFMR FIND

  Ctrl-h: toggle show hidden files

  Ctrl-l: toggle display localized dates view

  Ctrl-m: open MFMR MOUNT

  Ctrl-r: toggle file names on right side

  Ctrl-t: open DIRECTORY TREE

  Ctrl-w: open WILDCARD select popup

  Ctrl-1: select none

  Ctrl-2: select files only

  Ctrl-3: select all

  Alt-a: open EDIT ATTRIBUTES popup, file or directory must be selected

  Alt-c: open Copy files to/destination directory popup

  Alt-d: open New directory popup, create directory

  Alt-f: open New file popup, create file

  Alt-l: open Soft link files to/destination directory popup

  Alt-m: open Move files to/destination directory popup

  Alt-o: open Open with popup, enter application executable

  Alt-p: open right click popup menu

  Alt-r: open Rename popup if one item selected or MFMR BULK RENAME if
  multiple items selected

  Alt-s: open STATISTICS popup

  Alt-t: open default terminal to current or a selected directory

  Alt-z: open CREATE ARCHIVE popup, item must be selected

  Alt-x: close all MFMR windows










Main Menu Bar: New dropdown

New: double-click to open a new MFMR window to home directory

home: open a new MFMR window to home directory

tce: open a new MFMR window to TCE directory (etc/sysconfig/tcedir)

trash bin: open a new MFMR window to trash bin, default is /tmp/trashbin unless
changed in MFMR CONFIGURE

replicate: open a new MFMR window to the parent window's current directory

select directory: open Change directory popup to select another directory via
input line or favorites dropdown

  Change directory popup: use to add and manage directory favorites, /home/tc
  is a dedicated favorite and nine additional pathways can be specified,
  associated keyboard shortcuts are displayed

directory tree: open DIRECTORY TREE

mkdir: open New directory popup to create new directory

touch: open New file popup to create new file





Main Menu Bar: Go dropdown

Go: double-click to reload directory, deselect all items, go to top of directory

match last: change directory to match the last directory opened in MFMR history
  - if the last directory change was in the current window nothing will happen
    other than reloading the directory
  - if the last directory opened was in another MFMR window then match last
    will replicate that directory in the current window

reload: reload and go to top of directory, deselect all items





Main Menu Bar: UP / HOME OPT TCE TBIN CD

UP: change up to parent directory

/: change to root directory

HOME: change to home directory (/home/tc)

OPT: change to /opt directory

TCE: change to TCE directory (/etc/sysconfig/tcedir)

TBIN: change to trash bin directory, default /tmp/trashbin, see MFMR CONFIGURE

CD: open CHANGE DIRECTORY popup, select directory via input box or line, click
small directory pathway boxes to go to parent directories or use the favorites
dropdown

  Change directory popup: use to add and manage directory favorites, /home/tc
  is a dedicated favorite and nine additional pathways can be specified,
  see favorites dropdown, keyboard shortcuts are displayed

     Alt-0-8: select favorite/bookmarked directory

     Alt-a: add directory to favorites

     Alt-m: manage directory favorites





Main Menu Bar: HighLight dropdown

HighLight: double-click to select all files and directories

all: select all files and directories

files: select all files

none: deselect all files and directories

wildcard: open WILDCARD popup, use to select specific files or directories,
multiple wildcards (*) may be utilized





Main Menu Bar: Files dropdown

Files: double-click to open STATISTICS popup if item selected

copy to: open COPY FILES TO... destination directory popup

move to: open MOVE FILES TO... destination directory popup

soft link to: open SOFT LINK TO... destination directory popup

hard link to: open HARD LINK TO... destination directory popup

open with: open OPEN WITH... popup, enter executable to run selected file,
command line options can be specified, examples:
    sudo aterm -e vi
    sudo editor
    mupdf -r 150
    dillo -f

open popup menu: open right click popup menu

open with default action: open file with the default action for that file type
if specified in MFMR CONFIGURE

open with select action: activate application popup list if one or more
specific file type actions have been configured in MFMR CONFIGURE

attritubes: open EDIT ATTRIBUTES popup

statistics: open STATISTICS popup

compress: open CREATE ARCHIVE popup, item(s) must be selected

rename: open RENAME popup if only one item selected, open MFMR BULK RENAME if
multiple items selected

empty trash bin: open EMPTY TRASH BIN popup

delete forever: open DELETE ITEM(S) popup





Main Menu Bar: View dropdown

View: double-click to open EDIT ATTRIBUTES popup if item selected

all permissions: display user and group permissions

user permissions: display user permissions only

no permissions: do not display any permissions

owner and group: display owner and group

owner only: display owner only

no owner/group: do not display owner or group information

bytes: display size in bytes

kbytes: display size in kilobytes

compact: display size in B, KB, MB or GB depending on item size

no size: do not display size information

date and time: display date and time

date only: display date only

no date/time: do not display date or time information

colors: toggle show directory and file colors, specified in MFMR CONFIGURE

directories: toggle show directories

hidden files: toggle show hidden files

localized dates: toggle show dates in localized or ISO 8601 format

filenames on right: toggle file names on right side of window





Main Menu Bar: Sort dropdown

Sort: double-click to inverse sort file and directory list

by mode: sort alphabetically by mode (permissions)

by user: sort alphabetically by owner

by group: sort alphabetically by group

by size: sort by file size

by date: sort by date

by name: sort alphabetically by directory and file name

by extension: sort alphabetically by extension type

unsorted: no sort

case sensitive checkbox: case sensitive sort, capitalized items first

directories first checkbox: display directories before files

inverse sort checkbox: inverse sort file and directory list





Main Menu Bar: Config dropdown

Config: double-click to open MFMR CONFIGURE

verbose mode: toggle verbose output during move and copy operations,
preference auto-saved when toggled

overwrite mode: toggle file/directory overwrite during file operations
(use with caution), preference auto-saved when toggled

scroll wheel speed: open SCROLL VALUE popup to adjust mouse wheel scroll
speed, preference auto-saved when popup closed

save preferences: save View and Sort preferences, all preferences are
auto-saved to ~/.mfm/mfm-def.cfg when the MFMR window is closed

configure MFMR: open MFMR CONFIGURE





Main Menu Bar: Exit dropdown

Exit: double-click to close this MFMR window

-->: close this MFMR window

all: close all MFMR windows





Menu bar: Help! button

Help!: this help guide










Secondary Menu Bar:

history dropdown menu: select menu item to change to a previously visited
directory, maintains the most recent 16 visited directories, directories
automatically added to the history menu during navigation

X: clears all history dropdown menu entries including the current directory,
reload the current directory if desired to re-add it to the history menu

burn: open MFMR BURN, item(s) must be selected to open the GUI

edit: open selected file with default editor specified in MFMR CONFIGURE

extract: open MFMR EXTRACT ARCHIVE

find: open MFMR FIND

mount: open MFMR MOUNT

trash: move selected item(s) to trash bin pathway specified in MFMR CONFIGURE

$: open default terminal, specified in MFMR CONFIGURE, to the current
or a selected directory

#: open default terminal as root to the current directory or a
selected directory










DIRECTORY TREE:

The DIRECTORY TREE can be used to open and manage directories. It is
accessed by selecting  directory tree  from the New dropdown menu
or using the Ctrl-t keyboard shortcut.

Options: double-click to collapse and deselect all directories

Options dropdown: options include collapse all directories, open in terminal,
copy to, move to, soft link to, hard link to, delete to trash and delete
forever, terminal opens to selected directory pathway

Open: open a selected directory in a new MFMR window, can also middle-click
a selected directory or use the Enter key

Exit: exit DIRECTORY TREE, can also use the Escape key

Help!: this help guide

Right-click popup menu: right-click to select a directory, popup menu options
include open in browser, open in terminal, copy to, move to, soft link to, hard
link to, delete to trash and delete forever

Middle-click and drag: middle-click and drag a directory from the DIRECTORY
TREE to an MFMR window to load the selected directory in the window

Right-click and drag: copy, move or create link between DIRECTORY TREE
directories or an MFMR window

Delete key: open DELETING DIRECTORY popup










MFMR BULK RENAME:

MFMR BULK RENAME allows renaming multiple files at once. Is is accessed by
selecting more than one file or directory and then selecting  rename  from the
Files dropdown menu, right click popup menu or by using the Alt-r keyboard
shortcut.

The upper input line allows adding and editing parameters to change file or
directory names. The parameters can be utilized in various combinations
and should not be separated by spaces or commas.

The lower window displays the Old (current) name on the left side and New
(proposed) name on the right. New name file names are previewed in real
time as parameters are entered.

Add dropdown: add rename parameters in various combinations, before or after
the original file name as desired

  Fullname, $F(start,length), default $F(0,0): default shows original full
  name, change the (0,0) start and length numbers to determine which
  characters to exclude from the name

  Name, $N(start,length), default $N(0,0): similar to fullname above but
  does not include the extension type (eg. html)

  Extension, $E: display only the file extension excluding the dot (eg. html)

  Counter, $C(start,increment), default $C(1): default appends a number to the
  name, beginning with one and incrementing by one for each subsequent file or
  directory name, changing the start variable determines the count starting
  point and changing the increment number determines the count increment

  Insert, $I(position,text), default $I(,): add text to the name
  at the specified character position

  Overwrite, $O(position,text), default $O(,): similar to above but overwrite
  the specified character position rather than inserting text

  Delete, $D(position,chars), default $D(,): similar to above but delete
  the specified character position rather than inserting text

  Replace, $R(from text, to text), default $R(,): similar to above
  but replace the specified character position with text

Rename: create a copy of the files in renamed format to a newly created
sub-directory called mfmrenxxxxxx, although creating file copies is time
consuming and doubles drive space usage it preserves the original files/
file names that can later be deleted

Reset: reset the input box parameters and New name preview section

Exit: exit MFMR BULK RENAME

Help!: this help guide










MFMR BURN:

MFMR BURN is a simple GUI to burn CD/DVD data. Files or directories must be
selected in order to open MFMR BURN, which can be accessed by selecting  burn
from the secondary menu bar or by using the Ctrl-b keyboard shortcut. The burn
utility uses the burner device and mount point specified in MFMR CONFIGURE.

Note MFMR BURN is not presently functional, see known issues.

The output window initially lists the selected files, then displays messages
during the burn process. MFMR BURN automatically attempts to recognize the
inserted media type (CD vs DVD) at burn time.

Burn: burn data onto CD or DVD

Refresh List: refresh the selected items list and re-check media

CD or DVD: select either CD or DVD media to bypass the automated check routine

Erase Disc: overwrite existing disk content during the burn process

Verify Data: verify written data after the burn process

Exit: exit MFMR BURN

Help!: this help guide










MFMR CONFIGURE:

Use MFMR CONFIGURE to add and edit several configuration options.
It is accessed by double-clicking the Config menubar button
or by selecting  Config -> configure MFMR.

Save: create ~/.mfm/mfm.cfg if not present, save configuration changes

Exit: exit MFMR CONFIGURE

Help!: this help guide

editor: enter executable name of preferred editor (default is editor) or click
on the  editor  button to select, the default editor used when pressing  Enter 
to open a selected file, selecting  edit  from the secondary menu bar
or  open with text editor  from the right click popup menu

terminal: enter executable name of preferred terminal (default is aterm) or
click on the  terminal  button to select, this is the terminal used when
selecting  $  and  #  from the secondary menu bar or when using
the Alt-t keyboard shortcut

trash bin: enter trash bin pathway (default is /tmp/trashbin/, coded to be newly
created at every boot) or click on the  trash bin  button to change, manually
create trash bin directory if not present

color select buttons: click  executables, directories, mounted and unmounted
buttons to change their color, View -> colors must be checked for colors to
appear in MFMR windows, MFMR MOUNT displays mounted and unmounted color choices

file types section: customize run application and color for specific file types

  file extension: enter desired file extension (eg. html)

  color: click to select a custom color for the file type, a false executable
  name can be entered to simply associate a custom color with a specific file
  type, format examples:
    file extension: tcz
    executable: none
    color: pink

    file extension: html
    executable: dillo firefox
    color: green

  executable: enter the desired executable(s) for that file type (eg. firefox)

    - more than one space seperated executable can be entered, the executable
      entered first is the default action when selecting open with default
      action, format example:
        firefox editor

    - all executables will be listed when selecting open with select action
      from the Files dropdown  or right click popup menu or when middle-
      clicking the file

    - custom popup menu dialogue can be added, format example:
        "Open with Firefox" (firefox) "Open with editor" (editor)

    - custom runtime options can also be specified, format example:
        "Open with mupdf" (mupdf -r 150)

  add: click to create a new/empty entry in the file types section

  modify: click to enter custom file extension, executable and color data
  into the file types section, click Save to make changes permanent

  delete: click to remove selected custom file type from the file types section

burner device: enter the burner device to be utilized by MFMR BURN or click the
burner device  button to select (eg. navigate to /dev/sr0, select sr0)

mount point: enter the mount point to be utilized by MFMR BURN or click
the  mount point  button to select, based on /etc/fstab data
(eg. navigate to /mnt/sr0, select sr0)










MFMR EXTRACT ARCHIVE:

MFMR EXTRACT ARCHIVE lists and extracts the contents of archive files.
It is accessed by selecting  extract  from the secondary menu bar or
by using the Ctrl-e keyboard shortcut. To compress files,
see CREATE ARCHIVE Popup.

The output window displays file contents when selecting List Contents and
outputs progress messages during the extraction process.

Supported file formats: gz, tar, tar.gz, tar.xz, tar.bz2, tgz, zip and deb.

At present, only one-click extraction of .deb files containing a data.tar.gz
file is possible. If List Contents indicates the .deb file contains a newer
data.tar.xz format file, then close MFMR EXTRACT ARCHIVE and manually extract
the .deb file and data.tar.xz contents with these terminal commands:
    ar x *.deb
    tar Jxvf data.tar.xz

Open: select archive file to be listed and/or extracted, will default to a
specific file if it was already selected in the MFMR window before
launching MFMR EXTRACT ARCHIVE

List Contents: list contents of selected archive file

Extract: extract archive file to selected directory

Exit: exit MFMR EXTRACT ARCHIVE

Help!: this help guide










MFMR FIND:

MFMR FIND finds files by name or content (text files) and directories by name.
It can be accessed by selecting  find  from the secondary menu bar or by
using the Ctrl-f keyboard shortcut.

If launched from an MFMR window, the default search path is the current
directory. Various search parameters can be specified and some file
functions can be performed.

Path: open SELECT DIRECTORY popup to change search path

Search: perform search

Options dropdown:

  copy to: open COPY TO destination directory popup

  move to: open MOVE TO destination directory popup

  select all: select all search results

  delete forever: open DELETING ITEMS popup to delete selected item(s)

Open Directory: open selected directory in a new MFMR window

Open File: open selected file with default text editor, see MFMR CONFIGURE

Open With: open selected file with the executable entered in the  -->  input box,
one or more selected directories can also be opened in new MFMR windows by
entering the executable  mfmr  in the open with input box 

Exit: exit MFMR FIND

Help!: this help guide

search path: when MFMR FIND is launched from an MFMR window the default search
path is the current directory, can also manually enter the desired search
pathway or use the menubar Path button

--> input box: enter the executable name that will run/open a selected file
when the menubar Open With button is selected

name search - * ok: enter search term, * wildcards OK, clicking Search
without a search term will list the entire contents of the search path

case sensitive: check to perform a case sensitive name search

content search - no *, part word ok: enter a full or partial word
to search the contents of text files, do not use * wildcard

case sensitive: check to perform a case sensitive content search

line #: check to output the line number and data where the
content search term was found in the file

age: select from various file or directory creation ages (older/newer/
minutes/days), if a custom filter is selected then a number must
be entered into the adjacent box

size: select from various file sizes, if a custom filter is selected
then a number must be entered into the adjacent box

show: select from files and directories, files only or directories only

recursive search: check to recursively search sub-directories










MFMR MOUNT:

MFMR MOUNT allows mounting, unmounting and opening mounted partitions. It uses
information from /etc/fstab. The output window displays the device, mount point,
mount status and if mounted, partition freespace. Use MFMR CONFIGURE to
customize the color of mounted and unmounted partions.

It is accessed by selecting  mount  from the secondary menu bar or by
using the Ctrl-m keyboard shortcut.

Mount: click to mount selected partition

Mount/Open: click to mount the selected partition and open a new MFMR
window to the root directory of the mounted partition

Temp Mount/Open: temporarily mount and open the selected partition in a new
MFMR window, the partition will automatically unmount when the MFMR window is
closed

Unmount: click to unmount a selected partition

Refesh: update MFMR MOUNT status after closing temporary mounted partitions
or to recheck partition status and freespace

Exit: exit MFMR MOUNT

Help!: this help guide

right-click: toggle mount/unmount of selected partition

double left-click: temporarily mount and open a selected partition in a
new MFMR window










Application Popup List:

A popup list of all executables associated with a specific file type, specified
in MFMR CONFIGURE. Click to select the desired run application from the popup
list. The popup will only appear if at least one custom executable is
specified for that file type.

The popup list is activated by selecting  open with select action  from the
Files dropdown menu or right click popup menu. It can also be activated
by using the Alt-right arrow keyboard shortuct on a selected file
or simply middle-clicking a specific file.










Command Output Popup:

This outputs progress messages and errors in a popup window, similar to
running commands and executables from a terminal.

For file operations, such as copy and move, it is activated by selecting
Config -> verbose mode. As noted in the popup window, any output containing
either  cp: overwrite ?  or  mv: overwrite ?  indicates the item(s) already
exist. To overwrite this data, click OK to close the popup, select
Config -> overwrite mode  and repeat the copy or move operation.

For running executables, the popup window outputs relevant information during
runtime, such as program errors. The popup remains open after the application
is closed to review output. To activate this popup when running executables,
middle-click the executable or select  open with select action  from the
Files dropdown or right click popup menu. Note it only pops up when
selecting executables (default color red).

There are several known issues.

OK: to exit

Cancel: cancel the operation or close the application

Help!: this help guide










CREATE ARCHIVE Popup:

Compress selected files or directories into a single archive file. It is
activated by selecting  compress  from the right click popup menu or
Files dropdown or by using the Alt-z keyboard shortcut. At least one file
or directory must be selected for the CREATE ARCHIVE popup to appear.

Supported compression formats: gz, tar, tar.gz, tar.bz2 and tgz.

Enter the desired filename, including file extension, in the popup input line.

Alternatively the input line can be left blank, selecting OK will automatically
compress and create a *.tar.gz file. The filename will automatically be created
using the selected file name, if only one file was selected for compression,
or the directory name if multiple items are being compressed.

OK: create archive

Cancel: exit

There is a known issue regarding zip file creation.










Destination Directory Popup:

This popup appears when selecting copy to, move to, soft link to or hard link to
from the Files dropdown, right click popup menu or DIRECTORY TREE.

destination directory: specify destination directory in the input box

  - manually edit the input box pathway

  - click small rectangular directory break buttons to go to parent directories

  - select a directory from the active windows list

  - use Browse button to select directory

Browse: opens a Select directory popup then browse directory tree, manually
enter pathway, click small rectangular directory break buttons for parent
directories or select from the favorites dropdown

OK: perform file action

Cancel: exit

Help!: this help guide










EDIT ATTRIBUTES Popup:

Use to view or edit file and/or directory permissions, ownership and time/date
stamps. Can modify individual files and directories or make changes recursively.
The recursive checkbox must be selected beforehand if recursive changes are
desired.

The popup is accessible by selecting a file or directory and double-clicking
the View menubar button, selecting  attributes  from the Files dropdown or
Right Click Popup Menu or using the Alt-a keyboard shortcut.

Recursive: check 1st, real-time changes!: this checkbox must be selected
beforehand to make recursive changes into sub-directories

owner: change read, write and execute permissions for owner

group: change read, write and execute permissions for group

others: change read, write and execute permissions for others

set UID: set user ID for selected executable

set GID: set group ID for selected executable

sticky bit: set sticky bit for selected file or directory

owner: change owner for selected files or directories

group: change group for selected files or directories

date: display date stamp of selected item (update with Touch button)

time: display time stamp of selected item (update with Touch button)

Touch: update selected files and/or directories to current date and time

Exit: exit popup

Help!: this help guide










Right Click Popup Menu:

Right-click inside the MFMR window to open the menu, options:

up: go up to parent directory

terminal: open default terminal to current or selected directory

select all: select all directories and files

attributes: open EDIT ATTRIBUTES for selected item

statistics: open STATISTICS for selected item(s)

copy to: open Copy to popup

move to: open Move to popup

open with: open OPEN WITH popup, enter executable

open with default action: open selected item with default action,
as specified in MFMR CONFIGURE

open with select action: open applications popup list

open with text editor: open selected file with default text editor

mkdir: open NEW DIRECTORY popup, enter new directory name

touch: open NEW FILE popup, enter new file name

rename: open RENAME popup if single item selected, open
MFMR BULK RENAME if multiple items selected

compress: open CREATE ARCHIVE popup

delete to trash: move selected item(s) to trash bin, default /tmp/trashbin,
specified in MFMR CONFIGURE

delete forever: open DELETE ITEM(S) popup, permanently delete, bypass trash bin










STATISTICS Popup:

Use to view the number of files, number of directories and total size of
selected item(s). To activate select one or more files or directories then
double-click the Files menubar button, select  statistics  from the
right click popup menu or use the keyboard shortcut Alt-s.

OK: exit










Command Line Use:

Helper GUIs can be launched from the main MFMR window, although the
command line can also be utilized, usage examples:

Open MFMR window to user's home directory:

     mfmr


Open MFMR window to /tmp directory:

     mfmr /tmp


Mount partition sda2 (based on /etc/fstab) and open MFMR window to root
directory of partition sda2:

     mfmr -m=/mnt/sda2


Temporarily mount partition sda2 and open MFMR window to root directory of
partition sda2, automatically unmount partition when window closed:

     mfmr -t=/mnt/sda2


Open an MFMR window as root user to the /tmp directory:

     sudo mfmr /tmp


MFMR BURN:

     mfmburn /home/tc/Desktop/*
     * wildcard okay


MFMR CONFIGURE:

     mfmcfg


MFMR FIND:

     mfmfind /home/tc/Desktop/


MFMR MOUNT:

     mfmmount


MFMR BULK RENAME:

     mfmrename /home/tc/Desktop/*
     * wildcard okay


MFMR EXTRACT ARCHIVE:

     mfmzip

     mfmzip -x archived_file_name
     (extract to parent directory without prompt)


Access this help guide:

     less /usr/local/share/doc/mfm.html










Known Issues:

Numerous issues, some fixes pending.

MFMR window headers (Filename, Mode, Owner, Group, Size, Date) do not auto
resize when increasing window size.

  Workaround: Close all MFMR windows except one, resize as desired, exit and
  reopen MFMR window, headers will be resized.


Adjusting MFMR window width smaller than default (mfm-def.cfg window_width 750)
cuts off main and secondary menubars.

  Workaround: Avoid using a window width less than 750, use a higher desktop
  resolution if necessary.


Preferences for view, sort, verbose mode, overwrite mode and scroll wheel speed
do not update changes to other previously opened MFMR windows.

  Workaround: Close all MFMR windows except one, change and save
  preferences, then open additional windows.


Creating a new file (touch) with the same name as an existing file overwrites
the contents of the old file even when overwrite mode is disabled.

  Workaround: Exercise caution when creating new files.


Unable to move item to trash if same named item already exists in trash bin.

    Workarounds:
      - If acceptable select delete forever instead of delete to trash
      - Empty trash bin first or permanently delete same named trash bin item
      - Enable overwrite mode


Zip file contents can be listed and extracted but new zip files can not be
created. Standard Tiny Core does not create zip files, although the MFMR
source code provides zip file creation functionality.

  Workaround: Utilize an alternative archive format or test the
  zip-unzip.tcz extension with MFMR.


Right/left arrow navigation (up to parent, open selected directory) no longer
works if header widths (Filename, Mode, Owner, Group, Size, Date) are
stretched enough to create a horizontal scroll bar.

  Workaround: Do not stretch header widths greater than window width,
  alternatively increase default MFMR window size.


DIRECTORY TREE left/right arrow keys (up to parent, open selected directory) do
not work and the up/down arrow keys move two directories at a time.

  Workaround: Use mouse to navigate DIRECTORY TREE.


Command output window does not consistently popup when running executables. The
cancel button is not selectable during usage, preventing the ability to close
the window and application during runtime. Window contents do not redraw
while the application is running, resulting in no unreadable data until
the launched application is closed.

  Workaround: Launch executables from regular terminal to view program output.


MFMR BURN non-functional. To burn CDs, cdrecord and mkisofs from the TC 4
cdrtools.tcz extension likely required. To burn DVDs, growisofs likely
required, not presently in Tiny Core.

  Workaround: Use an alternative CD/DVD burn application as MFMR BURN was
  only designed to provide limited functionality anyway.


MFMR MOUNT unexpectantly closes when double left-click or single right-click
lower window freespace.

  Workaround: Reopen MFMR MOUNT.










Changelog:

August 2015:

  My File Manager (mfm.tcz) submitted to Tiny Core 6


September 2015:

  First My File Manager Re-imagined (mfmr) executable compile

  Added open root terminal function

  Added dedicated UP, /, HOME, TCE, TBIN, CD, $, # buttons to main menubar

  Revised graphics for more consistent appearance, changed color scheme

  Corrected GUI typos and clarified most output dialogues

  Reorganized dropdown and popup menus

  Added attributes to right-click popup menu

  Made View dropdown menu more compact by removing rarely used keyboard
  shortcuts to toggle display of permissions, owner, size and date

  Default window resized wider but shorter for improved layout

  Resized header column widths for improved readability

  Reformatted owner/group columns for improved readability

  All popups now open as hotspots/under cursor instead of 0, 0,
  tested in Fluxbox with init file entry:
  session.screen0.windowPlacement: UnderMousePlacement

  Customized keyboard shortcuts

  Incorporated sane first run sort, view, configuration defaults

  Create and utilize default /tmp/trashbin directory on startup

  Revised double-click functions of some menubar buttons and dropdowns

  Regular user can modify owner/group permissions, even to/from root

  Added show all/files/directories choicebox filter to MFMR FIND

  Added Open with function to MFMR FIND, any executable to open search result

  EXTRACT ARCHIVE now lists and extracts .gz file contents

  CREATE ARCHIVE popup now creates .gz files

  Improved EDIT ATTRIBUTES popup functionality

  New desktop icon


October 2015:

  Toggling verbose and overwrite mode checkboxes automatically creates
  mfm-def.cfg if not present and saves preference

  Exit and Exit all automatically creates mfm-def.cfg during first run and
  saves view, sort, verbose, overwrite and scroll wheel speed preferences

  Added basic History select Fl_Menu_Button to main browser window

  Added clear History button (X) function

  Added secondary menubar: History, X (clear), $ and # (regular, root terminal)

  Added TC friendly OPT button to main menubar

  Added Refresh button to MFMR MOUNT as closing temporary mounted windows
  or adding/removing files does not auto-refresh mount status and freespace

  Temp Mount/Open button in MFMR MOUNT now remounts a mounted partition as a
  temporary mount and opens a new browser window to the selected partition

  Creating soft and hard links always provides verbose output

  Help manual first revision

  Expanded secondary menubar: History, X (clear), burn, edit, extract, find,
  mount, trash, $ and # (regular, root terminal)

  EXTRACT ARCHIVE can now list and extract .tar.xz file contents

  EXTRACT ARCHIVE can now list the contents of .deb files and extract
  data.tar.gz contents directly into a destination directory
  (presently only data.tar.gz files, not data.tar.xz)


November 2015:

  MFMR CONFIGURE redesign, more compact and intuitive

  Color coded applicable dropdown menu items pink to reflect their
  associated pink main menubar double-click functionalities

  Destination directory added to History select dropdown menu when copy to,
  move to, soft link to and hard link to is utilized via right-click or
  Files dropdown menu (not needed for drag n drop as the target
  directory is already opened in another window anyway)

  New directory added to History select dropdown menu when mkdir is used to
  create a new directory via right-click or New dropdown

  Help manual second revision










Bug Fixes:

September 2015:

  Addressed some compiler warnings

  Fixed occasional hang on exit

  Fixed segmentation fault triggerd by dropdown menus

  Fixed segmentation fault when changing EDIT ATTRIBUTES owner/group

  Can re-open window even if FLTK editor documents left open from previous
  MFMR session (likely attributed to segmentation fault issues)

  Empty trash now removes dot files

  EXTRACT ARCHIVE can now extract and list zip file contents

  MFMR MOUNT can now properly mount/unmount partitions as regular user

  MFMR MOUNT now properly updates mount status when selecting Mount/Open

  Fixed MFMR FIND instability that crashed MFMR when opening search results

  Fixed drag and drop functionality between DIRECTORY TREE and MFMR windows


October 2015:

  Overwrite mode now works as expected during move and copy operations

  Fixed EDIT ATTRIBUTES sticky bit function

  MFMR MOUNT now updates mount status when selecting Temp Mount/Open

  Fixed MFMR MOUNT error when using the Mount/Open button to open an already
  mounted partition in a new MFMR window

  Setting overwrite mode to false now prevents renaming file to a same-named
  existing file to prevent overwrite

  Setting overwrite mode to false now prevents moving an item to the trash bin
  if a same named item already exists to prevent overwrite









************************************** END *************************************!