README for PCManFM-Mod v1.2.4
(A modified version of the legacy PCMan File Manager v0.5.2)
For updates and instructions visit:
http://igurublog.wordpress.com/downloads/mod-pcmanfm/
FINAL RELEASE NOTICE:
Except for possible bugfixes, v1.2.4 is the last planned release of
pcmanfm-mod. All further development of this fork will take place in the
SpaceFM project: http://spacefm.sourceforge.net/
CONTENTS:
DESCRIPTION
INSTALLATION
BUILD INSTRUCTIONS
MANUAL UN-INSTALL INSTRUCTIONS
BUILD DEBIAN PACKAGING INSTRUCTIONS
INCLUDED FILES
USAGE NOTES
KNOWN ISSUES
MODIFICATIONS
CHANGELOG FOR PCMANFM-MOD
DESCRIPTION:
PCManFM-Mod is a minor fork of the legacy version of PCManFM 0.5.2, which
uses HAL for mounting (optional) and has minimal Gnome dependencies
(compared with the newer PCManFM version 0.9 which uses gnome-vfs). This
modified legacy version adds user-definable commands and other features and
also includes a number of bugfixes as fully detailed in the MODIFICATIONS
section below.
PCManFM-Mod installs as /usr/bin/pcmanfm-mod and uses
~/.config/pcmanfm-mod/ as its config folder, thus making it run
independently of other versions of pcmanfm.
INSTALLATION:
For Debian and Ubuntu, deb files and a PPA package repository are available
at http://igurublog.wordpress.com/downloads/mod-pcmanfm/
For Arch Linux, AUR packages are available- pcmanfm-mod or pcmanfm-mod-prov
For other distros or for custom build options, follow the BUILD
INSTRUCTIONS below.
BUILD INSTRUCTIONS:
1) Install required build dependencies.
On Debian/Ubuntu:
apt-get install build-essential debhelper autotools-dev dbus \
desktop-file-utils fam libc6 libcairo2 libdbus-1-3 libfam0 \
libglib2.0-0 libgtk2.0-0 libpango1.0-0 libstartup-notification0 \
libx11-6 shared-mime-info intltool pkg-config libfam-dev \
libgtk2.0-dev libglib2.0-dev fakeroot libstartup-notification0-dev \
libdbus-1-dev \
hal libhal-dev libhal-storage-dev libdbus-glib-1-dev libhal-storage1 \
libhal1, libdbus-glib-1-2
Also Recommended: ktsuss gksu gnome-icon-theme
On Arch Linux:
pacman -S base base-devel desktop-file-utils gamin gtk2 hal \
shared-mime-info startup-notification intltool gettext
Also Recommended: gksu gnome-icon-theme
NOTE: gamin can be used instead of fam.
Other Linux distributions will have similar named libraries. configure
will report anything missing when you run it as shown below.
2) Extract tarball and enter directory. The following commands will build
and install as "/usr/bin/pcmanfm-mod":
./configure --prefix=/usr
make
sudo make install
sudo install -c -m 755 pcmanfm-opener /usr/bin
sudo update-mime-database /usr/share/mime > /dev/null
sudo update-desktop-database -q
NOTE: If configure reports missing dependencies, install them and run
configure again before proceeding to make.
NOTE: If hal support is not needed (pcmanfm-mod won't be able to mount and
unmount volumes), add --disable-hal to the configure command above.
NOTE: The su program used by pcmanfm-mod will be ktsuss, gksudo, gksu, or
kdesu. Optional: To set your preference (in this example to gksudo) add
--with-preferable-sudo=gksudo to the configure command above.
3) LXDE USERS ONLY
If you want LXDE to use pcmanfm-mod for desktop management, you can
remove pcmanfm and:
sudo ln -s /usr/bin/pcmanfm-mod /usr/bin/pcmanfm
Or see the /etc/xdg/lxsession/ and ~/.config/lxsession/ config files to
control pcmanfm(-mod) startup and desktop management.
For additional information consult the README-LEGACY and INSTALL files.
MANUAL UN-INSTALL INSTRUCTIONS:
1) As root:
rm /usr/bin/pcmanfm-mod
rm /usr/bin/pcmanfm-opener
rm -r /usr/share/pcmanfm-mod
rm /usr/share/pixmaps/pcmanfm-mod.png
rm /usr/share/pixmaps/pcmanfm-mod-root.png
rm /usr/share/mime/packages/libmimetype.xml
rm /usr/share/locale/*/LC_MESSAGES/pcmanfm-mod.mo
rm /usr/share/applications/pcmanfm-mod*.desktop
rm /usr/share/applications/pcmanfm-user*.desktop
update-mime-database /usr/share/mime > /dev/null
update-desktop-database -q
2) Optional: To remove pcmanfm-mod user configurations:
rm -r /home/*/.config/pcmanfm-mod
OR
rm -r $XDG_CONFIG_HOME/pcmanfm-mod # run for each user
DEBIAN PACKAGING INSTRUCTIONS:
To build a deb file of pcmanfm-mod:
1) Install build dependencies (see BUILD INSTRUCTIONS above).
2) Extract tarball and enter directory.
3) IF hal support is NOT desired:
cp debian/control-nohal debian/control
cp debian/rules-nohal debian/rules
4) Build package:
dpkg-buildpackage
The package files will appear in the parent directory.
INCLUDED FILES:
README this file
README-LEGACY Original README from PCManFM 0.5.2
0.5.2 source and make files modified source files of PCManFM 0.5.2
(search for "//MOD" to see changes)
pcmanfm-opener a script to open all files passed to it
data/pcmanfm-mod*.desktop desktop files for the PCManFM-Mod program
data/pcmanfm-user-f*.desktop desktop files for user commands
data/pcmanfm-mod.png program icon
data/pcmanfm-mod-root.png program icon when run as root
debian/ debian packaging control files
USAGE NOTES:
*** Custom Commands ***
/usr/bin/pcmanfm-opener is an example script to open all files passed
to it - by default this is assigned to F4. Functions F6-F9 also run
the same command until you customize them. The default pcmanfm-opener
script mostly uses xdg-open to open files - modify this script to use
your favorite apps. USE BY THE ROOT USER IS DISABLED BY DEFAULT (edit
the script to adjust this).
To change the name and command for User Command F6, copy the file
/usr/share/applications/pcmanfm-user-f6.desktop to
~/.local/share/applications/ Edit this file and add your desired command
to "Exec=" (do not use %F or %U, just the command name). This can be a
custom script or an application. Edit "Name=" to the command name as you
want it to appear on the right-click menu. Use underscore for shortcut
keys (for example, "User Co_mmand"). "Icon=" may be added if desired.
Other commands are modified with the same method - there is one desktop
file for each. Don't change the filenames of these .desktop
files or they won't work.
*** Config File ***
PCManFM-Mod recognizes additional settings in the [General] section of the
"main" config file:
home_folder=FOLDER Changes your default home folder (for the Go|Home
and toolbar commands)
no_execute=1 Makes double-clicking on an executable NOT run it
no_confirm=1 Causes no confirmation dialog when deleting files
(use this with caution as there is no trash can)
For example, with all PCManFM-Mod windows and daemons closed, edit the
file ~/.config/pcmanfm-mod/main (or main.lxde if using LXDE):
[General]
...
home_folder=/media
no_execute=1
no_confirm=1
*** Hide Files ***
To hide a folder's files from view in PCManFM-Mod, create a text file in
the folder named '.hidden' List files to be hidden in this file, one per
line (file name only, not the path). For example, to hide a file:
echo "hidethisexample.txt" >> .hidden
This can be done automatically using the File|Hide File menu option. To
unhide a file, edit .hidden and remove the entry. After changes are made,
select View|Refresh.
KNOWN ISSUES:
* The Run In Terminal mod command may not work with all terminals (choose
your terminal in Edit|Preferences|Advanced). The terminal must accept
the -e argument unquoted. These terminals are known to work: roxterm,
aterm, konsole, xterm, Eterm, lxterminal*, gnome-terminal*.
* Note that when using lxterminal and gnome-terminal, you cannot use
single quotation marks (') in the command.
MODIFICATIONS:
PCManFM-Mod is identical to legacy PCManFM v0.5.2 except for the
following changes:
* Adds five user-definable commands to the right-click and Tools
menus (keys F4, F6-F9). The menu item names, icons, and
commands are derived from .desktop files. When run, all
selected files are passed to the command. (see NOTES below)
* An example opener script is included as the default F4
user command, which opens all selected files. (see NOTES below)
* A "Run Command..." (Ctrl-R) has been added to the Tools and
right-click menus. This allows the user to run an
arbitrary command line, include %F to insert all selected
files into the command, and optionally run the command
in a terminal to see the output.
* Files can now be dragged and dropped into the Directory Tree
side pane
* A selection history has been added to remember selected files in
prior folders
* The Copy/Move dialog, widened and cleaned up, now shows file
count, transfer size, current and average speeds, time remaining
* A "Paste as Link" (Ctrl-Shift-V) command has been added to the
Edit and right-click menus to paste links to files on the
clipboard
* A "Paste as Target" (Alt-Shift-V) command has been added to the
Edit and right-click menus to paste the targets of links on the
clipboard
* A "Copy as Text" (Ctrl-Shift-C) command has been added to the
Edit and right-click menus to copy quoted filenames to the
clipboard for pasting into a terminal
* A "Copy Name" (Alt-Shift-C) command has been added to the
Edit and right-click menus to copy filenames to the
clipboard (without path)
* When a single file is selected, the filename is displayed in the status
bar (for long filenames). If a symlink is selected, its target and
target's size are displayed in the status bar
* Compress and Extract now support tar.xz
* Sticky bit is displayed in the Permissions field
* IEC binary units now display as KB/MB/GB/TB instead of KiB/MiB/GiB/TiB,
and IEC binary units are now the default (may be changed in Preferences)
* Support added for Nautilus-style .hidden file to hide files, and added
File|Hide File menu option
* The Paste items on the content menu are now disabled if the clipboard
does not contain a pastable file list
* The Paste and Create items now appear on the context menu even if the
cursor is over a file
* Configuration is stored in $XDG_CONFIG_HOME/pcmanfm-mod/
* The default home folder can be set in the main config file
(see USAGE NOTES above)
* "no_execute" can be set in the main config file to prevent
launching of executables by clicking (see USAGE NOTES above)
* "no_confirm" can be set in the main config file to delete files without
a confirmation dialog (see USAGE NOTES above)
* ktsuss is now a supported su program, and is the default (can be changed)
* A different program icon (taken from Tango) is used, and a red
folder program icon is used when in super user mode
* The Go|Home key is changed from Alt-Home to Escape
* The Open Terminal key is changed from F4 to Ctrl-S
* Tools|Open Terminal now opens only current folder instead of selected
* The default button on the delete dialog is changed to Yes
* When enter is pressed in the Rename/Overwrite dialog, rename is
assumed
* Ctrl-F is assigned to Create New Folder instead of search
(pressing any normal key still initiates a search), and Ctrl-Shift-F has
been added for Create New File
* The F5 Refresh function has been improved
* .desktop files display their actual filenames rather than name,
except in the user's Desktop folder
* File list is given focus when a dir is entered or a new tab added
* When a new file/folder is created in Detailed view mode, it is given focus
* Middle-clicking on a tab will close it
* Copying and pasting a single folder into its own parent now
asks for a new name rather than attempting to copy the folder into
itself. Pasting a folder into a selected folder no longer works.
* Link creation (Paste or drag methods) can now generate
overwrite/rename query instead of "File Exists" error
* Accepts --desktop-pref, --profile, and --desktop for compatibility
with PCManFM 0.9
* Bugfix: A serious bug which caused the target of a link to be
overwritten rather than the link itself has been corrected
* Bugfix: A bug which caused the target names of copied links to be
mangled been corrected
* Bugfix: A bug which caused a link's target's file permissions to change
when the link was copied has been corrected
* Bugfix: Right-clicking on a dangling sym-link now displays menu
* Bugfix: Find Files now displays all results
* Bugfix: Find Files 'Search in Sub Directories' now obeyed
* Bugfix: Invalid cross-device link error fixed
* Bugfix: Context menu write permissions are now based on directory
write permission instead of one selected file; symlinks not
erroneously followed for write permission to symlinks
* Bugfix: A bug which prevented opening multiple folders on the
pcmanfm command line has been corrected
* Bugfix: Fixed error message on create new folder cancel
* Bugfix: Default save folder for the Compress function is corrected
* Bugfix: Links to broken links may now be created
* Bugfix: Fixed POTFILES.in to correct error on make check
* Bugfix: Fixed syntax errors in ca.po to prevent make error
* Bug Workaround: A bug in GTK 2.20 which prevents double-clicking
should not affect pcmanfm-mod 0.9.6 and later
See http://bugzilla.gnome.org/show_bug.cgi?id=612802
CHANGELOG FOR PCMANFM-MOD:
1.2.4 (final):
fixed find files bug (size greater than 1 not honored)
fixed Copy As Text not handling filenames containing apostrophes
remove virtual My Documents icon from desktop
rename libmimetype.xml to pcmanfm-mod-mime.xml to prevent collisions
1.2.3:
fixed POTFILES.in to correct error on make check
added debian packaging control files
1.2.2:
corrected keyboard nav problem (cursor not set when restoring previous
selection) in Icon and Compact List view modes
1.2.1:
added selection history (pkt-file-browser)
corrected dir tree side pane scroll problem from gtk change (ptk-dir-tree)
added File|Hide File to update .hidden (vfs-dir)
new tab opens in custom home folder if configured (main-window)
added Ctrl-Shift-F key shortcut for create new file
status bar now shows selected file name
removed config file su_cmd= option introduced in 1.1.2
made ktsuss default su command
Tools|Open Terminal now opens only current folder instead of selected
0.5.2 bugfix: copy link changed link target permissions (vfs-file-task)
1.2.0:
copy/move progress dialog count, size, speed
added .hidden support
fixed find files bug not displaying all results
fixed find files recursive bug
fixed invalid cross-device link error
improved View|Refresh function - update model twice
adjustments to status bar
1.1.3:
workaround for root user roxterm dbus error
added --desktop, --profile, and --desktop-pref for compat with 0.9
1.1.2:
no_execute will now execute if Execute is selected from the context menu
no_confirm added
DSO patch for Fedora applied
su_cmd added
ktsuss now supported
progress dialog simplified
IEC binary units now show KB/MB/GB/TB; SI show kB/MB/GB/TB
IEC binary units now default
1.1.1:
copy/move/delete progress dialog widened to 700
added Copy Name (Alt-Shift-C) to Edit and context menus
Paste and Create now always shown in context menu
Paste items in context menu now insensitive if invalid clipboard
1.1.0:
makefiles changed to build and install as "pcmanfm-mod"
AUR package updated - installs as pcmanfm-mod, provides pcmanfm
uses $XDG_CONFIG_HOME/pcmanfm-mod/ as config folder - imports from
pcmanfm if missing
Compress and Extract functions now support tar.xz
Default save folder of Compress function now working folder (bugfix)
program icons (normal and root user) changed
refresh function improved
middle-click on tab now closes it
Create new file/folder in detailed list view now focuses new file
(same behavior as icon view)
File list given focus after create new file/folder (all views)
1.0.4:
corrected compress/extract appearance in context menu
1.0.3:
fixed error on drag to link in directory tree
1.0.2:
added drag and drop to directory tree
added Copy as Text (Ctrl-Shift-C) to Edit and context menus
added Paste as Link and Paste as Target to context menu
icons for user commands now displayed in context menu
changed Run Command %U to %F (%U still works)
home_folder used on home activate
source tarball now bzip2
1.0.1:
added "Edit|Paste as Target" (Alt-Shift-V) to paste targets
fixed overwrite of link target
context menu write permissions derive from current directory
permissions instead of one selected file; no longer derived
from resolved symlink target
links to broken links may now be created
link creation can now generate overwrite/rename query instead
of "File Exists" error
terminated buffer on link copy to prevent mangled target names
AUR PKGBUILD now prefers gamin over fam
1.0.0:
permissions now show sticky bit
added keyboard shortcut Ctrl-S for Open Terminal
unassigned user commands not shown in menus
Refresh function now reloads even if busy
0.9.6:
removed use of exo_noop_false to workaround GTK 2.20 bug
.desktop files in Desktop folder now display app name
removed confusing error message from installmod script
corrected "// MOD" to "//MOD" in ptk-file-browser.c
added version number to About dialog
0.9.5:
changed Tools menu "Open Terminal" to "Open _Terminal"
added special Run In Terminal for lxterminal and gnome-terminal
(these require -e argument quoted)
0.9.4:
removed diagnostic error pop-up in bookmark function
added "Edit|Paste as Link" (Ctrl-Shift-V) to paste links
added link target and target size in status bar
added home_folder in main config file for Go|Home
added no_execute in main config file to stop execution
changed program icon for root user mode to folder-saved-search
0.9.3:
removed diagnostic premature return that prevented right-click
'open with' menu from displaying (ptk-file-menu.c)
0.9.2:
modified About dialog to indicate it is a modified version
.desktop files display their actual filenames instead of name
focus in file list after change directory and new tab
Go|Home now Escape key instead of Alt-Home
right-click on dangling symlink now displays popup menu
copy/paste folder prompts for new name; no paste to selected
rewrote str_replace used by Run Command without static buffer
Run and Run In Terminal now have alt shortcut keys R & T
Run In Terminal now terminates with open bash shell
restored Open In Terminal to Tools and right-click menus
installmod script now won't overwrite existing .desktop files
or /usr/bin/pcmanfm-opener
0.9.1:
fixed syntax errors in ca.po to prevent make error
changed default button on delete dialog to Yes
fixed error message on create new folder cancel
improved F5 Refresh function
added user commands and Run Command to right-click menu
reorganized Tools menu
fixed multiple instance -t opening of tabs
added enter callback signal on rename/overwrite dialog
Changed crtl-f to Create New Folder
added uninstall instructions to README
changed opener script - old script will not work correctly
added desktop files for user commands and pcmanfm-mod
0.9.0:
added user commands to Tools menu, keys F4, F6-F9
fixed bug when opening multiple folders on command line
See also: README-LEGACY
Download Latest Version
pcmanfm-mod-1.2.3.tar.xz (663.2 kB)
