GitPedia

Qtfm

Qt File Manager

From rodlie·Updated May 22, 2026·View on GitHub·

Qt File Manager for Linux, FreeBSD, NetBSD, OpenBSD and macOS. The project is written primarily in C++, distributed under the GNU General Public License v2.0 license, first published in 2018. Key topics include: bsdisks, ffmpeg, file-management, file-manager, files.

Latest release: 6.2.1QtFM 6.2.1
June 5, 2021View Changelog →

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

ActionShortcut
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

Contributors

Showing top 10 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from rodlie/qtfm via the GitHub API.Last fetched: 6/13/2026