Difference between revisions of "PCManFM"

From ArchWiki
Jump to: navigation, search
m ("Not authorized" errors when accessing/mounting USB drives: - only small correction in formating)
m (Newline)
(20 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 
[[Category:File managers]]
 
[[Category:File managers]]
 +
[[ar:PCManFM]]
 
[[cs:PCManFM]]
 
[[cs:PCManFM]]
 
[[fr:PCManFM]]
 
[[fr:PCManFM]]
Line 5: Line 6:
 
[[pl:PCManFM]]
 
[[pl:PCManFM]]
 
[[ru:PCManFM]]
 
[[ru:PCManFM]]
'''PCManFM''' is "an extremly fast, lightweight, yet feature-rich file manager with tabbed browsing". Source: [http://pcmanfm.sourceforge.net/ PCManFM on sourceforge]. PCManFM is the default file manager of the [[LXDE]] (Lightweight X11 Desktop Environment).
+
From the project [http://wiki.lxde.org/en/PCManFM home page]:
 +
: ''PCMan File Manager (PCManFM) is a file manager application developed by Hong Jen Yee from Taiwan which is meant to be a replacement for Nautilus, Konqueror and Thunar. Released under the GNU General Public License, PCManFM is free software. PCManFM is the standard file manager in [[LXDE]], which is also developed by the same author in conjunction with other developers.''
  
==Installation==
+
== Installation ==
Run the following command to install:
+
# pacman -S pcmanfm
+
  
You will also require [[gamin]] (a replacement for [[FAM]], which required a daemon) to pick up events such as file and directories changes:
+
{{Pkg|pcmanfm}} is available in the [[official repositories]].
  
# pacman -S gamin
+
You will also require [[gamin]] (a replacement for [[FAM]], which required a daemon) to pick up events such as file and directories changes.
 +
 
 +
Notable variants are:
 +
* {{AUR|pcmanfm-git}} - Development version.
 +
* {{AUR|pcmanfm-qt}} - New [[Qt]] implementation.
 +
* {{AUR|pcmanfm-qt-git}} - New Qt implementation, development version.
 +
 
 +
== Volume handling ==
 +
 
 +
PCManFM is able to mount and unmount devices, both manually and automatically. This feature is offered as an alternative to CLI tools such as {{Pkg|udevil}} and {{AUR|pmount}}.
 +
 
 +
=== Auto mounting USB external storage devices ===
 +
 
 +
To auto mount USB external storage devices only simply install {{Pkg|gvfs}}.
 +
 
 +
If they do not auto mount after installing, try rebooting your system and try again.
 +
 
 +
=== Mounting with udisks ===
  
==Volume handling==
 
PCManFM is able to mount and unmount devices, both manually and automatically. This feature is offered as an alternative to CLI tools such as [[pmount]]. There are various 'up-to-date' versions of PCManFM (see below), and different volume handling strategies can be chosen.
 
===Mounting with udisks===
 
 
The current release of PCManFM is able to handle volumes through udisks. If you want to use this feature, make sure the D-Bus daemon is installed and running. See the [[D-Bus]] page for details.
 
The current release of PCManFM is able to handle volumes through udisks. If you want to use this feature, make sure the D-Bus daemon is installed and running. See the [[D-Bus]] page for details.
  
===Trash support and automounting with gvfs===
+
=== NTFS read/write support ===
See [[GVFS]].
+
  
==Tips & troubleshooting==
+
Install {{Pkg|ntfs-3g}}. See [[NTFS-3G]] for more informations.
===No "Applications"===
+
# pacman -S gnome-menus
+
You can try this method: Delete all files in the $HOME/.cache/menus directory, and run PCManFM again.
+
  
PCManFM requires the environment variable "XDG_MENU_PREFIX" to be set. The value of the variable should match the beginning of a file present in the "/etc/xdg/menus/" directory. In case you have installed the "gnome-menus" package, you can set the value in your .xinitrc file with the line :
+
=== Trash support, browsing network shares, and automounting with gvfs ===
$ export XDG_MENU_PREFIX=gnome-
+
See these threads for more informations : [https://bbs.archlinux.org/viewtopic.php?pid=1110903], and especially this post from the Linux Mint Forums [http://forums.linuxmint.com/viewtopic.php?f=175&t=53986#p501920]
+
  
===No icons?===
+
To resolve the "Operation not supported" error when clicking on Trash Can, you must install {{Pkg|gvfs}}.
If you are using a window manager over a desktop environment and notice you have no icons for folders and files, install an icon theme:
+
# pacman -S tangerine-icon-theme
+
  
Then edit {{ic|~/.gtkrc-2.0}} '''or''' {{ic|/etc/gtk-2.0/gtkrc}} and add the following line:
+
To browse network shares:
gtk-icon-theme-name = "Tangerine"
+
# Install these packages: ''gvfs'' {{Pkg|gvfs-smb}} {{Pkg|gvfs-afp}}.
 +
# Start PCManFM only using the following command: {{ic|$ dbus-launch pcmanfm}}.
 +
# Type {{ic|smb://''server name''/''share name''}} to access Windows/CIFS/Samba file shares.
 +
# Type {{ic|afp://''server name''/''share name''}} to access AFP file shares.
  
===NTFS Read/Write Support===
+
== Tips ==
Install ntfs-3g (See [[NTFS-3G]]):
+
# pacman -S ntfs-3g
+
  
===gnome-open opens "Find" dialog instead of the directory===
+
=== One click for open folders and files ===
Remove or rename the file {{ic|/usr/share/applications/pcmanfm-find.desktop}}. If you're running pcmanfm-mod from AUR, remove or rename the file {{ic|/usr/share/applications/pcmanfm-mod-find.desktop}}.
+
  
===No "Previous/Next Folder" functionality with mouse buttons===
+
Open PCManFM in file explorer mode, and go to ''Edit > Preferences''
A method to fix this is with [[Xbindkeys]]:
+
and in ''General > Behavior'' and select ''Open files with a simple click''.
  
Install xbindkeys:
+
{{Note|This option works with {{ic|$ pcmanfm --desktop}} too}}
# pacman -S xbindkeys
+
Edit ~/.xbindkeysrc to contain the following:
+
# Sample .xbindkeysrc for a G9x mouse.
+
"/usr/bin/xvkbd -text '\[Alt_L]\[Left]'"
+
  b:8
+
"/usr/bin/xvkbd -text '\[Alt_L]\[Right]'"
+
  b:9
+
Actual button codes can be obtained with xev[http://www.archlinux.org/packages/extra/i686/xorg-xev/].
+
  
Add
+
== Troubleshooting ==
 +
 
 +
=== No "Applications" ===
 +
 
 +
First install {{Pkg|gnome-menus}}.
 +
You can try this method: Delete all files in the {{ic|$HOME/.cache/menus}} directory, and run PCManFM again.
 +
 
 +
PCManFM requires the environment variable ''XDG_MENU_PREFIX'' to be set. The value of the variable should match the beginning of a file present in the {{ic|/etc/xdg/menus/}} directory. In case you have installed the ''gnome-menus'' package, you can set the value in your {{ic|.xinitrc}} file with the line :
 +
export XDG_MENU_PREFIX=gnome-
 +
See these threads for more informations : [https://bbs.archlinux.org/viewtopic.php?pid=1110903], and especially this post from the Linux Mint forums [http://forums.linuxmint.com/viewtopic.php?f=175&t=53986#p501920]
 +
 
 +
=== No icons ===
 +
 
 +
If you are using a [[WM]] instead of a [[DE]] and you have no icons for folders and files, specify a GTK+ icon theme.
 +
 
 +
If you have e.g. {{Pkg|oxygen-icons}} installed, edit {{ic|~/.gtkrc-2.0}} '''or''' {{ic|/etc/gtk-2.0/gtkrc}} and add the following line:
 +
gtk-icon-theme-name = "oxygen"
 +
{{Note|All instances of PCManFM have to be restarted for changes to apply!}}
 +
 
 +
Else, use an different one (''gnome'', ''hicolor'', and ''locolor'' do not work). To list all installed icon themes:
 +
$ ls ~/.icons/ /usr/share/icons/
 +
 
 +
If none of them is suitable, install one. To list all installable icon packages:
 +
$ pacman -Ss icon-theme
 +
{{Tip|For an alternative GUI solution, install {{Pkg|lxappearance}} and apply an icon theme from there.}}
 +
 
 +
=== gnome-open opens "Find" dialog instead of the directory===
 +
 
 +
Remove or rename the file {{ic|/usr/share/applications/pcmanfm-find.desktop}}. If you're running {{Pkg|pcmanfm-mod}} from AUR, remove or rename the file {{ic|/usr/share/applications/pcmanfm-mod-find.desktop}}.
 +
 
 +
=== No "Previous/Next Folder" functionality with mouse buttons ===
 +
 
 +
A method to fix this is with [[Xbindkeys]].
 +
 
 +
Install {{Pkg|xbindkeys}} and edit {{ic|~/.xbindkeysrc}} to contain the following:
 +
{{bc|<nowiki>
 +
# Sample .xbindkeysrc for a G9x mouse.
 +
"/usr/bin/xvkbd -text '\[Alt_L]\[Left]'"
 +
b:8
 +
"/usr/bin/xvkbd -text '\[Alt_L]\[Right]'"
 +
b:9
 +
</nowiki>}}
 +
Actual button codes can be obtained with package {{Pkg|xorg-xev}}.
 +
 
 +
Add:
 
  xbindkeys &
 
  xbindkeys &
 
to your {{ic|~/.xinitrc}} to execute xbindkeys on log-in.
 
to your {{ic|~/.xinitrc}} to execute xbindkeys on log-in.
  
===--desktop parameter not working / crashing X-server===
+
=== One click for open folders and files ===
Make sure you have ownership and write permissions on {{ic|~/.config/pcmanfm}}
+
  
Setting the wallpaper either by using the --desktop-pref parameter or editing {{ic|~/.config/pcmanfm/default/pcmanfm.config}} solves the problem.
+
Open PCManFM in file explorer mode, go to ''Edit > Preferences > General > Behavior'' select ''Open files with a simple click''.
 +
{{Note|This option works with {{ic|pcmanfm --desktop}} too.}}
 +
 
 +
=== --desktop parameter not working or crashing X-server ===
 +
 
 +
Make sure you have ownership and write permissions on {{ic|~/.config/pcmanfm}}.
 +
 
 +
Setting the wallpaper either by using the {{ic|--desktop-pref}} parameter or editing {{ic|~/.config/pcmanfm/default/pcmanfm.config}} solves the problem.
 +
 
 +
=== Terminal emulator advanced configuration not saved ===
  
===Terminal emulator advanced configuration not saved===
 
 
Make sure you have rights on libfm configuration file:
 
Make sure you have rights on libfm configuration file:
  
  # chmod -R 755 ~/.config/libfm
+
  $ chmod -R 755 ~/.config/libfm
  # chmod 777 ~/.config/libfm/libfm.conf
+
  $ chmod 777 ~/.config/libfm/libfm.conf
 +
 
 +
=== Make PCManFM remember your preferred Sort Files settings ===
 +
 
 +
You can use ''View > Sort Files'' to change the order in which PCManFM lists the files, but PCManFM won't remember that the next time you start it. To make it remember, go to ''Edit > Preferences'' and close. That will write your current sort_type and sort_by values into {{ic|~/.config/pcmanfm/LXDE/pcmanfm.conf}}.
 +
 
 +
=== "Not authorized" errors when accessing/mounting USB drives ===
  
===Make PCManFM remember your preferred Sort Files settings===
+
In various window managers (when using with [[PolicyKit#Mounting_USB_drives|PolicyKit]]), you might receive a "not authorized" error when trying to access a USB drive.
You can use View | Sort Files to change the order in which PCManFM lists the files, but PCManFM won't remember that the next time you start it. To make it remember, go to Edit | Preferences and Close. That will write your current sort_type and sort_by values into ~/.config/pcmanfm/LXDE/pcmanfm.conf.
+
  
==="Not authorized" errors when accessing/mounting USB drives===
+
Edit or create {{ic|/etc/polkit-1/actions/org.freedesktop.udisks2.pkla}} to contain the following:
In various WM (in use with [[PolicyKit#Mounting_USB_drives|PolicyKit]]), You might receive an "Not authorized" errors when trying to access e.g. an USB drive.
+
{{bc|<nowiki>
 +
[Storage Permissions]
 +
Identity=unix-group:storage
 +
Action=org.freedesktop.udisks2.filesystem-mount;org.freedesktop.udisks2.modify-device
 +
ResultAny=yes
 +
ResultInactive=yes
 +
ResultActive=yes
 +
</nowiki>}}
  
If not existing, create (including the directory actions, which ain't existing by default in there) {{ic|/etc/polkit-1/actions/org.freedesktop.udisks2.pkla}} to contain the following:
+
{{Note|The directory {{ic|/etc/polkit-1/actions/}} does not exist by default.}}
[Storage Permissions]
+
Identity=unix-group:storage
+
Action=org.freedesktop.udisks2.filesystem-mount;org.freedesktop.udisks2.modify-device
+
ResultAny=yes
+
ResultInactive=yes
+
ResultActive=yes
+
  
==Available Versions==
+
== Known issues ==
There are several versions of PCManFM currently available:
+
  
===PCManFM2===
+
==== Custom folder icons in $HOME ====
This is the package in Arch's extra repository as "pcmanfm". The current git test version of it is available in the AUR as [https://aur.archlinux.org/packages.php?ID=33601 pcmanfm-git]. More information is available on the [http://forum.lxde.org/viewforum.php?f=22 LXDE Forum].
+
  
===PCManFM-Mod===
+
Currently it looks like PCmanFM doesn't support this:
PCManFM-Mod adds user-definable commands, other features, and bugfixes to the legacy version of the PCManFM file manager v0.5.2. This version builds and installs as "pcmanfm-mod" and will run independently of other versions of PCManFM you have installed on your system.  This legacy version is still desired by some due to more stability than the newer 0.9.x rewrite in progress, less Gnome dependencies, and the use of HAL rather than gnome-vfs.  PCManFM-Mod is available in the [https://aur.archlinux.org/packages.php?ID=34819 AUR as pcmanfm-mod] and as [https://aur.archlinux.org/packages.php?ID=39547 pcmanfm-mod-prov] (latter provides pcmanfm).  More information is available at [http://igurublog.wordpress.com/downloads/mod-pcmanfm/ IgnorantGuru's Blog].
+
  
===PCManFM_with_Search===
+
https://bbs.archlinux.org/viewtopic.php?pid=851397#p851397
Latest PCmanFM version with search dialog in the [[AUR]] as {{aur|pcmanfm_with_search}}.
+

Revision as of 12:39, 17 July 2013

From the project home page:

PCMan File Manager (PCManFM) is a file manager application developed by Hong Jen Yee from Taiwan which is meant to be a replacement for Nautilus, Konqueror and Thunar. Released under the GNU General Public License, PCManFM is free software. PCManFM is the standard file manager in LXDE, which is also developed by the same author in conjunction with other developers.

Installation

pcmanfm is available in the official repositories.

You will also require gamin (a replacement for FAM, which required a daemon) to pick up events such as file and directories changes.

Notable variants are:

Volume handling

PCManFM is able to mount and unmount devices, both manually and automatically. This feature is offered as an alternative to CLI tools such as udevil and pmountAUR.

Auto mounting USB external storage devices

To auto mount USB external storage devices only simply install gvfs.

If they do not auto mount after installing, try rebooting your system and try again.

Mounting with udisks

The current release of PCManFM is able to handle volumes through udisks. If you want to use this feature, make sure the D-Bus daemon is installed and running. See the D-Bus page for details.

NTFS read/write support

Install ntfs-3g. See NTFS-3G for more informations.

Trash support, browsing network shares, and automounting with gvfs

To resolve the "Operation not supported" error when clicking on Trash Can, you must install gvfs.

To browse network shares:

  1. Install these packages: gvfs gvfs-smb gvfs-afp.
  2. Start PCManFM only using the following command: $ dbus-launch pcmanfm.
  3. Type smb://server name/share name to access Windows/CIFS/Samba file shares.
  4. Type afp://server name/share name to access AFP file shares.

Tips

One click for open folders and files

Open PCManFM in file explorer mode, and go to Edit > Preferences and in General > Behavior and select Open files with a simple click.

Note: This option works with $ pcmanfm --desktop too

Troubleshooting

No "Applications"

First install gnome-menus. You can try this method: Delete all files in the $HOME/.cache/menus directory, and run PCManFM again.

PCManFM requires the environment variable XDG_MENU_PREFIX to be set. The value of the variable should match the beginning of a file present in the /etc/xdg/menus/ directory. In case you have installed the gnome-menus package, you can set the value in your .xinitrc file with the line :

export XDG_MENU_PREFIX=gnome-

See these threads for more informations : [1], and especially this post from the Linux Mint forums [2]

No icons

If you are using a WM instead of a DE and you have no icons for folders and files, specify a GTK+ icon theme.

If you have e.g. oxygen-icons installed, edit ~/.gtkrc-2.0 or /etc/gtk-2.0/gtkrc and add the following line:

gtk-icon-theme-name = "oxygen"
Note: All instances of PCManFM have to be restarted for changes to apply!

Else, use an different one (gnome, hicolor, and locolor do not work). To list all installed icon themes:

$ ls ~/.icons/ /usr/share/icons/

If none of them is suitable, install one. To list all installable icon packages:

$ pacman -Ss icon-theme
Tip: For an alternative GUI solution, install lxappearance and apply an icon theme from there.

gnome-open opens "Find" dialog instead of the directory

Remove or rename the file /usr/share/applications/pcmanfm-find.desktop. If you're running pcmanfm-mod from AUR, remove or rename the file /usr/share/applications/pcmanfm-mod-find.desktop.

No "Previous/Next Folder" functionality with mouse buttons

A method to fix this is with Xbindkeys.

Install xbindkeys and edit ~/.xbindkeysrc to contain the following:

# Sample .xbindkeysrc for a G9x mouse.
"/usr/bin/xvkbd -text '\[Alt_L]\[Left]'"
 b:8
"/usr/bin/xvkbd -text '\[Alt_L]\[Right]'"
 b:9

Actual button codes can be obtained with package xorg-xev.

Add:

xbindkeys &

to your ~/.xinitrc to execute xbindkeys on log-in.

One click for open folders and files

Open PCManFM in file explorer mode, go to Edit > Preferences > General > Behavior select Open files with a simple click.

Note: This option works with pcmanfm --desktop too.

--desktop parameter not working or crashing X-server

Make sure you have ownership and write permissions on ~/.config/pcmanfm.

Setting the wallpaper either by using the --desktop-pref parameter or editing ~/.config/pcmanfm/default/pcmanfm.config solves the problem.

Terminal emulator advanced configuration not saved

Make sure you have rights on libfm configuration file:

$ chmod -R 755 ~/.config/libfm
$ chmod 777 ~/.config/libfm/libfm.conf

Make PCManFM remember your preferred Sort Files settings

You can use View > Sort Files to change the order in which PCManFM lists the files, but PCManFM won't remember that the next time you start it. To make it remember, go to Edit > Preferences and close. That will write your current sort_type and sort_by values into ~/.config/pcmanfm/LXDE/pcmanfm.conf.

"Not authorized" errors when accessing/mounting USB drives

In various window managers (when using with PolicyKit), you might receive a "not authorized" error when trying to access a USB drive.

Edit or create /etc/polkit-1/actions/org.freedesktop.udisks2.pkla to contain the following:

[Storage Permissions]
Identity=unix-group:storage
Action=org.freedesktop.udisks2.filesystem-mount;org.freedesktop.udisks2.modify-device
ResultAny=yes
ResultInactive=yes
ResultActive=yes
Note: The directory /etc/polkit-1/actions/ does not exist by default.

Known issues

Custom folder icons in $HOME

Currently it looks like PCmanFM doesn't support this:

https://bbs.archlinux.org/viewtopic.php?pid=851397#p851397