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: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/VioletGiraffe/file-commander
• Owner: VioletGiraffe
• License: apache-2.0
• Created: 2014-04-22T19:11:27.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2024-09-17T14:34:24.000Z (4 months ago)
• Last Synced: 2024-09-17T17:42:31.214Z (4 months ago)
• Topics: c-plus-plus, cpp, file-browser, file-manager, linux, macos, multi-threading, qt, windows
• Language: C++
• Homepage:
• Size: 8.01 MB
• Stars: 375
• Watchers: 25
• Forks: 56
• Open Issues: 117
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

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, x64 only (but older releases supported x86). 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.

* Build with Qt 6.4 or newer.

* Windows: you can build using either Qt Creator or Visual Studio for IDE. Visual Studio 2022 or later 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`. Make sure it's qmake from Qt 6 installation and not Qt5 (usually `qmake6 -r` works to ensure that).

* 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.