Skip to content

Latest commit

 

History

History
159 lines (134 loc) · 5 KB

README.md

File metadata and controls

159 lines (134 loc) · 5 KB

QtFM

Qt File Manager for Linux, FreeBSD, NetBSD, OpenBSD and macOS.

  • XDG integration
  • Customizable interface
  • Powerful custom command system
  • Customizable key bindings
  • Drag & drop functionality
  • Tabs support
  • Removable storage support
  • System tray daemon (qtfm-tray(1))
    • Show available storage/optical devices in system tray
    • Auto mount (and open) storage/optical devices when added (not default)
    • Auto play CD/DVD (not default)
  • Extensive thumbnail support
    • Supports image formats through ImageMagick
    • Supports PDF and related documents
    • Supports video formats through FFmpeg
    • Supports embedded images in media files

Default shortcuts

Action Shortcut
New Window [ctrl+n]
Open Tab [ctrl+t]
Close Tab [ctrl+w]
Copy Action [ctrl+c]
Paste Action [ctrl+v]
Up Action [alt+up]
Back Action [backspace]
Toggle Show Hidden Files [ctrl+h]
Move to Trash [del]
Delete [shift+del]
Open Terminal [F1]
Quit/Close [ctrl+q]
Rename Action [F2]
Zoom Out [ctrl+-]
Zoom In [ctrl++]
Focus Path [ctrl+l]
Toggle Icon View [F3]
Toggle Detail View [F4]
Refresh View [F5]
Drag and Drop Move Modifier [shift]
Drag and Drop Copy Modifier [ctrl]
Drag and Drop Ask Action [alt]

All shortcuts can be modified.

Build

Download the latest release, then make sure you have the required dependencies.

  • Requires Qt 5.2+ (LTS recommended)
    • libQt5Widgets
    • libQt5Gui
    • libQt5Concurrent
    • libQt5DBus
    • libQt5Core
  • Requires hicolor-icon-theme
  • Requires adwaita-icon-theme or similar
  • Requires libinotify if using BSD/macOS
  • Recommended udisks/bsdisks at run-time
  • Recommended ImageMagick (Magick++) 6.9/7.x for improved thumbnail support
    • libMagick++
    • libMagickWand
    • libMagickCore
  • Recommended FFmpeg 3+ for video/audio thumbnails/coverart
    • libavdevice
    • libswscale
    • libavformat
    • libavcodec
    • libavutil

Download and extract:

tar xvf qtfm-6.x.y.tar.gz
cd qtfm-6.x.y

Or use git:

git clone https://github.com/rodlie/qtfm
cd qtfm

qmake

Build options:

  • CONFIG+=with_magick : This will enable ImageMagick support.
    • MAGICK_PC= : Custom Magick++ pkg-config .pc file.
    • CONFIG+=oldmagick : If you have ImageMagick older than 6.9 (Ubuntu).
  • CONFIG+=with_ffmpeg : This will enable FFmpeg support (NOTE! requires ImageMagick).
  • CONFIG+=no_tray : This will disable qtfm-tray (no_dbus will also disable this feature).
  • CONFIG+=no_dbus : This will disable D-Bus session and udisks features in (lib)QtFM, qtfm-tray will also not be built.
  • CONFIG+=with_includes : Install library includes and pkg-config
  • CONFIG+=sharedlib : Force shared library.
  • PREFIX= : Install prefix, where things are installed when running make install
  • DOCDIR= : Location for documentation (default is PREFIX/share/doc/qtfm-VERSION)
  • MANDIR= : Location for man pages (default is PREFIX/share/man)
  • XDGDIR= : Location of XDG (default is /etc/xdg or PREFIX/etc/xdg)
  • LIBDIR= : Library location (default is $PREFIX/lib$LIBSUFFIX), only used if shared library is enabled

Doing a normal build:

mkdir build && cd build
qmake ..
make

You can run the binary bin/qtfm or install to /usr/local:

sudo make install

cmake

Since version 6.3.0 building with CMake is supported.

Build options (added):

ENABLE_MAGICK "Enable support for ImageMagick" (default true)
ENABLE_FFMPEG "Enable support for FFmpeg v3" (default true)
ENABLE_DBUS "Enable support for D-Bus" (default true)
ENABLE_UDISKS "Enable support for udisks" (default true)
ENABLE_TRAY "Enable support for qtfm-tray" (default true)

Doing a normal build:

mkdir build && cd build
cmake ..
make

You can run the binary qtfm or install to /usr/local:

sudo make install

Packaging

qmake

qmake PREFIX=/usr CONFIG+=with_magick CONFIG+=with_ffmpeg ..
make -jX
make INSTALL_ROOT=<package> install

cmake

cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBDIR=lib64 ..
make -jX
make DESTDIR=<package> install