A lightweight dual-pane file manager built with Qt6 Widgets, featuring multi-tab support, file operations, favorites management, session restore, and volume management.

• Dual-pane layout: Switchable horizontal/vertical orientation, independently adjustable split ratio, single-pane hide support
• Multi-tab: Each pane supports multiple tabs with independent navigation history, drag-to-reorder, clone, and close
• File operations: Copy, move, rename, delete, trash, properties — executed asynchronously with a progress dialog
• Conflict resolution: Overwrite / skip / rename / apply-to-all options when encountering name collisions during copy/move
• Favorites: Save and restore the current dual-pane layout and tab paths with one click
• Session restore: Automatically saves and restores the last window state, pane layout, tab paths, and sort settings
• Volume management: File menu lists mounted volumes (QStorageInfo) and external removable devices (UDisks2) with mount/unmount/eject support
• Clipboard: Cut/copy/paste, cross-pane cut/copy, copy path/filename
• Configurable shortcuts: All shortcuts are customizable via the settings dialog with instant effect
• Themes & icons: UI theme (QStyleFactory) and icon theme are configurable
• Internationalization: Chinese / English switching

sudo apt install libqt6widgets6 libqt6concurrent6 libqt6dbus6 libqt6network6 \
    udisks2 gnome-icon-theme

sudo apt install build-essential cmake qt6-l10n-tools

sudo apt install qt6-base-dev qt6-base-dev-tools

Required only for running unit tests and quality checks (see Testing & Quality Checks):

sudo apt install libgtest-dev libxkbcommon-dev clang-tidy
# clang-format 19.x is required for format check consistency with CI.
# Ubuntu 24.04 ships clang-format 18 by default; install v19 via pip:
python3 -m pip install --user clang-format==19.1.7

cd fm-qt
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

The built binary is located at build/fm.

The project provides separate CMake targets for each quality check. These targets are not run during a normal build — invoke them explicitly with cmake --build build --target <name>.

cmake -B build -DCMAKE_BUILD_TYPE=Debug

CMAKE_EXPORT_COMPILE_COMMANDS is enabled by default, which is required by clang-tidy. Tests are enabled by default (FM_BUILD_TESTS=ON); disable with -DFM_BUILD_TESTS=OFF.

cmake --build build

cmake --build build --target check-tests
# or directly:
ctest --test-dir build --output-on-failure

Verifies that all src/ and tests/ source files conform to the .clang-format style (Qt6 style):

cmake --build build --target check-format

To auto-fix formatting:

find src tests \( -name '*.cpp' -o -name '*.h' \) -exec clang-format -i {} +

Runs clang-tidy on src/*.cpp using compile_commands.json:

cmake --build build --target clang-tidy

Builds and tests the project with AddressSanitizer + LeakSanitizer in an isolated build/asan directory (does not pollute the main build):

cmake --build build --target check-asan

Convenience target that runs format check → clang-tidy → tests → ASan:

cmake --build build --target check-all

sudo cmake --install build

Installs to /usr/local/bin/fm by default.

./build/fm

Or after installation:

fm

The application automatically restores the last session on startup. If an instance is already running, a new process brings the existing window to the foreground and exits (single-instance mode).

The configuration file is located at ~/.config/fm/fm.conf (INI format). All settings can be modified through the Settings dialog and take effect immediately.

All shortcuts are customizable in the Settings dialog.

fm-qt/
├── CMakeLists.txt
├── README.md
├── README-zh.md                   # Chinese README
├── REQUIREMENTS.md                # Requirements specification
├── ARCHITECTURE.md                # Architecture design document
├── src/
│   ├── main.cpp                   # Entry point
│   ├── app/                       # Application init, single instance
│   ├── core/                      # Config, clipboard, favorites, session, shortcuts, volume manager
│   ├── dialogs/                   # Settings, conflict, properties, open-with dialogs
│   ├── filelist/                  # File list model, view, sort proxy
│   ├── fileops/                   # File operations, progress, trash
│   ├── panel/                     # Pane container, panel widget, tab bar
│   └── ui/                        # Main window
└── translations/                  # Chinese/English translations (.ts / .qm)

Issues and Pull Requests are welcome.

• Ensure the code compiles successfully before submitting
• Update REQUIREMENTS.md and ARCHITECTURE.md when adding features
• Add translations under translations/ for any user-visible text changes

This project is licensed under GPL v3, consistent with the Qt6 open-source license. See LICENSE.