Difference between revisions of "SpaceFM"

From ArchWiki
Jump to navigation Jump to search
m (no more plus in gtk)
 
(36 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
[[Category:File managers]]
 
[[Category:File managers]]
 +
[[ja:SpaceFM]]
 +
[[ru:SpaceFM]]
 
{{Related articles start}}
 
{{Related articles start}}
{{Related|Display manager}}
 
 
{{Related|File manager functionality}}
 
{{Related|File manager functionality}}
 +
{{Related|PCManFM}}
 
{{Related|Window manager}}
 
{{Related|Window manager}}
 
{{Related articles end}}
 
{{Related articles end}}
  
Forked from [[PCManFM]], SpaceFM is a lightweight, highly configurable, desktop-indpendent multi-panel tabbed file and desktop manager. It features a built-in virtual file system, a [[udev]] or [[HAL]]-based device manager, a customisable menu system, and [[Bash]] integration. More information can be found at the [http://ignorantguru.github.io/spacefm/ official SpaceFM website].
+
[https://ignorantguru.github.io/spacefm/ SpaceFM] (a fork of PCManFMis a lightweight, highly configurable, desktop-independent multi-panel tabbed file and desktop manager. It features a built-in virtual file system, a [[udev]]-based device manager, a customisable menu system, and [[Bash]] integration.
  
 
== Installation ==
 
== Installation ==
{{pkg|spacefm}} is available from the [[official repositories]].
 
  
== File searches ==
+
[[Install]] the {{AUR|spacefm}} package.
SpaceFM provides a built-in file search feature similar to {{pkg|catfish}}, which can be utilised with the following command:
 
  
$ spacefm -f
+
Or you can use {{AUR|spacefm-gtk2}} package if you need a GTK 2 version.
  
== Desktop management ==
+
== Usage ==
The command to allow SpaceFM to set wallpapers and enable the use of desktop icons is:
 
  
spacefm --desktop
+
See the [https://ignorantguru.github.io/spacefm/spacefm-manual-en.html User's Manual].
  
The native desktop menu of the window manager will be replaced with that provided by SpaceFM. However, it can easily be restored from the SpaceFM menu itself by selecting {{ic|Desktop preferences}} and then enabling the {{ic|Right click shows WM menu}} option in the {{ic|Desktop}} tab.
+
=== File searches ===
  
=== Desktop preferences ===
+
SpaceFM provides a built-in file search feature similar to {{pkg|catfish}}:
If using the native desktop menu provided by a window manager, enter the following command to set or amend desktop preferences at any time:
 
  
  $ spacefm --desktop-pref
+
  $ spacefm -f
  
It is worthwhile to consider adding this command to a keybind and/or the native desktop menu for easy access.
+
=== Desktop management ===
  
=== Creating new icons ===
+
SpaceFM includes a lightweight desktop manager. [https://ignorantguru.github.io/spacefm/spacefm-manual-en.html#invocation-desktopmanager]. It replaces the desktop menu, adds desktop icons, and sets the wallpaper.  
User content such as text files, documents, images and so forth can be dragged and dropped directly onto the desktop. To create shortcuts for applications it will be necessary to copy their {{ic|.desktop}} files to the {{ic|~/Desktop}} directory itself. Do not drag and drop the files there as they will be moved completely. The syntax of the command to do so is:
 
  
cp /usr/share/applications/<name of application>.desktop ~/Desktop
+
To restore the native window manager menu, open {{ic|Desktop preferences}}
  
For example - where installed - to create a desktop shortcut for {{pkg|lxterminal}}, the following command would be used:
+
$ spacefm --desktop-pref
  
cp /usr/share/applications/lxterminal.desktop ~/Desktop
+
and enable the {{ic|Right click shows WM menu}} option in the {{ic|Desktop}} tab. Consider adding the above command to a keybind and/or the native desktop menu for easy access.
  
For those who used the [[Xdg user directories]] program to create their {{ic|$HOME}} directories no further configuration will be required.
+
To run SpaceFM as a [[daemon]] without it managing the desktop [https://ignorantguru.github.io/spacefm/spacefm-manual-en.html#invocation-daemonmode], use:
  
== Daemon mode ==
+
$ spacefm -d
The session or autostart command to run SpaceFM as a [[daemon]] / background process (i.e. to automount removable media such as CD/DVDs and USB flash-drives) is:
 
  
spacefm -d
+
How SpaceFM may be autostarted as a daemon process or to manage the desktop for a standalone [[window manager]] will depend on the window manager itself. Should a window manager not provide an autostart file, edit [[xinitrc]] or [[xprofile]].
  
== Autostarting ==
+
=== Mounting remote hosts ===
How SpaceFM may be autostarted as a [[daemon]] process or to manage the desktop for a standalone [[window manager]] will depend on the window manager itself. For example, to enable management of the desktop for [[Openbox]], the following command would be added to the {{ic|~/.config/openbox/autostart}} file:
 
  
spacefm --desktop &
+
SpaceFM supports mounting remote hosts via [[udisks#Mount_helpers|udevil]]. To add a remote host, add the access URL into the URL bar. A terminal window should pop up showing the mounting process which is useful for error tracing.
  
Review the relevant wiki article and/or official home page for a particular installed or intended window manager. Should a window manager not provide an autostart file, SpaceFM may be alternatively autostarted by editing one or both of the following files:
+
An overview of the supported remote hosts is available in the [https://ignorantguru.github.io/udevil/udevil--help.html udevil help]. For example to mount a remote FTP server:
 
 
* [[xinitrc]]: When using the [[SLiM]] [[display manager]] or [[Startx]] command
 
* [[xprofile]]: When using a display manager such as [[LXDM]] or [[LightDM]]
 
 
 
== Additional features and functionality ==
 
Less experienced users should be aware that a file manager alone - especially when installed in a standalone [[Window manager]] such as [[Openbox]] - will not provide the features and functionality users of full desktop environments such as [[Xfce]] and [[KDE]] will be accustomed to. Review the [[file manager functionality]] article for further information.
 
 
 
=== Mounting remote hosts ===
 
SpaceFM supports mounting remote hosts via [[File_manager_functionality#udevil.2Fdevmon|udevil]]. In order to add a remote host add the access URL into the URL bar. A terminal window should pop up showing the mounting process which is useful for error tracing. An overview of the supported remote hosts can be found in the [http://ignorantguru.github.io/udevil/udevil--help.html udevil help]. For example to mount a remote FTP server one would enter:
 
  
  ftp://user:pass@sys.domain/share
+
  <nowiki>ftp://user:pass@sys.domain/share</nowiki>
  
== Tips & Tricks ==
+
== Tips and tricks ==
  
 
=== Open archive in app instead of extracting ===
 
=== Open archive in app instead of extracting ===
Line 77: Line 63:
 
  File Is Dir equals true
 
  File Is Dir equals true
 
  File Is Text equals true
 
  File Is Text equals true
 +
 +
== Troubleshooting ==
 +
 +
=== Columns are not resizeable ===
 +
 +
This should only happen on the first start of SpaceFM (GTK 2 version). [https://github.com/IgnorantGuru/spacefm/issues/382]
 +
 +
=== Segmentation faults ===
 +
 +
If SpaceFM crashes with errors such as:
 +
 +
localhost kernel: [245086.687050] spacefm[30684]: segfault at 3e8000003e8 ip 00007fc95c586866 sp 00007fffb1dc9cc0 error 4 in libgtk-x11-2.0.so.0.2400.24[7fc95c446000+435000]
 +
 +
SpaceFM uses many different GUI elements, and is thus suspectible to a malfunctioning theme (especially in GTK 3). Try a different theme such as Raleigh (default theme). To do so for SpaceFM only, in GTK 2:
 +
 +
GTK2_RC_FILES=/usr/share/themes/Raleigh/gtk-2.0/gtkrc spacefm
 +
 +
See [https://ignorantguru.github.io/spacefm/spacefm-manual-en.html#invocation-gtkthemes] for details.

Latest revision as of 06:16, 16 August 2019

SpaceFM (a fork of PCManFM) is a lightweight, highly configurable, desktop-independent multi-panel tabbed file and desktop manager. It features a built-in virtual file system, a udev-based device manager, a customisable menu system, and Bash integration.

Installation

Install the spacefmAUR package.

Or you can use spacefm-gtk2AUR package if you need a GTK 2 version.

Usage

See the User's Manual.

File searches

SpaceFM provides a built-in file search feature similar to catfish:

$ spacefm -f

Desktop management

SpaceFM includes a lightweight desktop manager. [1]. It replaces the desktop menu, adds desktop icons, and sets the wallpaper.

To restore the native window manager menu, open Desktop preferences

$ spacefm --desktop-pref

and enable the Right click shows WM menu option in the Desktop tab. Consider adding the above command to a keybind and/or the native desktop menu for easy access.

To run SpaceFM as a daemon without it managing the desktop [2], use:

$ spacefm -d

How SpaceFM may be autostarted as a daemon process or to manage the desktop for a standalone window manager will depend on the window manager itself. Should a window manager not provide an autostart file, edit xinitrc or xprofile.

Mounting remote hosts

SpaceFM supports mounting remote hosts via udevil. To add a remote host, add the access URL into the URL bar. A terminal window should pop up showing the mounting process which is useful for error tracing.

An overview of the supported remote hosts is available in the udevil help. For example to mount a remote FTP server:

ftp://user:pass@sys.domain/share

Tips and tricks

Open archive in app instead of extracting

By default, SpaceFM is configured to extract an archive when double clicking on it. If you instead want to open it with your default archive manager such as file-roller, then select an archive, right-click for context menu, and then: Open / Archive default / Open With App

Show custom context menu command only on files/folders

If you have a custom context menu command that should be only shown on selection of files or folders, then add the following rules to Menu Item Properties -> Context:

MIME Type equals true
File Is Dir equals true
File Is Text equals true

Troubleshooting

Columns are not resizeable

This should only happen on the first start of SpaceFM (GTK 2 version). [3]

Segmentation faults

If SpaceFM crashes with errors such as:

localhost kernel: [245086.687050] spacefm[30684]: segfault at 3e8000003e8 ip 00007fc95c586866 sp 00007fffb1dc9cc0 error 4 in libgtk-x11-2.0.so.0.2400.24[7fc95c446000+435000]

SpaceFM uses many different GUI elements, and is thus suspectible to a malfunctioning theme (especially in GTK 3). Try a different theme such as Raleigh (default theme). To do so for SpaceFM only, in GTK 2:

GTK2_RC_FILES=/usr/share/themes/Raleigh/gtk-2.0/gtkrc spacefm

See [4] for details.