Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/VioletGiraffe/file-commander

Cross-platform Total Commander-like orthodox file manager for Windows, Mac and Linux
https://github.com/VioletGiraffe/file-commander

c-plus-plus cpp file-browser file-manager linux macos multi-threading qt windows

Last synced: about 1 month ago
JSON representation

Cross-platform Total Commander-like orthodox file manager for Windows, Mac and Linux

Lists

README

        

# FILE COMMANDER

Cross-platform Total Commander-like orthodox (dual-panel) file manager for Windows, Mac, Linux and FreeBSD with support for plugins. The goal of the project is to provide consistent user experience across all the major desktop systems.

[![CI](https://github.com/VioletGiraffe/file-commander/actions/workflows/CI.yml/badge.svg)](https://github.com/VioletGiraffe/file-commander/actions/workflows/CI.yml)

[![CodeFactor](https://www.codefactor.io/repository/github/violetgiraffe/file-commander/badge/master)](https://www.codefactor.io/repository/github/violetgiraffe/file-commander/overview/master)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/190add40753b46edbaa1327068263263)](https://www.codacy.com/gh/VioletGiraffe/file-commander/dashboard?utm_source=github.com&utm_medium=referral&utm_content=VioletGiraffe/file-commander&utm_campaign=Badge_Grade)

![Windows screenshot](/../gh-pages/screenshots/Windows/screenshot.png?raw=true)

### Download for Windows

*Get the latest release*
Windows Vista and later systems are supported (x32 and x64). Windows XP is not supported.

### Known Issues
For the list of known issues, refer to the project issues on Github, sort by the "bug" label. Or just use this link.

### Reporting an issue
Create an issue on the project's page on Github.

### Contributing

***Cloning the repository***

The main git repository has submodules, so you need to execute the `update_repository` script (available as .bat for Windows and .sh for Linux / Mac) after cloning file-commander to clone the nested repositories. Subsequently, you can use the same `update_repository` script at any time to pull incoming changes to the main repo, as well as to all the subrepos, thus updating everything to the latest revision.

***Building***

* A compiler with C++20 support is required.
* Qt 5.12 or newer required (currently tested with 5.15.2 and 6.2.2).
* Windows: you can build using either Qt Creator or Visual Studio for IDE. Visual Studio 2022 or newer is required - v143 toolset or newer. Run `qmake -tp vc -r` to generate the solution for Visual Studio. I have not tried building with MinGW, but it should work as long as you enable C++20 support.
* Linux: `cd` to directory with project, run `qmake -r` to generate Makefile and build via `make -j`.
* Mac OS X: You can use either Qt Creator (simply open the project in it) or Xcode (run `qmake -r -spec macx-xcode` and open the Xcode project that has been generated). Or you can build from command line with `qmake -r` followed by `make -j`.

See the Github workflow .yml file for reference on building the project.