Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/HO-COOH/FastCopy
A GUI wrappers for Windows' built-in robocopy. QQ讨论群：479734355
https://github.com/HO-COOH/FastCopy
cpp20 explorer system-utility windows windowsappsdk winui3
Last synced: 17 days ago
JSON representation
A GUI wrappers for Windows' built-in robocopy. QQ讨论群：479734355
- Host: GitHub
- URL: https://github.com/HO-COOH/FastCopy
- Owner: HO-COOH
- License: mit
- Created: 2023-01-15T15:00:48.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-02-03T16:08:38.000Z (5 months ago)
- Last Synced: 2024-04-28T03:36:50.694Z (2 months ago)
- Topics: cpp20, explorer, system-utility, windows, windowsappsdk, winui3
- Language: C++
- Homepage:
- Size: 7.06 MB
- Stars: 145
- Watchers: 3
- Forks: 16
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Lists
- WinUI-3-Apps-List - FastCopy
- fluent-design-app-list - Fast Copy
README
#  FastCopy
A GUI wrapper for Windows' built-in `robocopy` ~~and `xcopy`~~.
## Features
- Easy to use copy/paste/move/delete dialog, just like your good old explorer, but much faster🚀
- Support the new Windows 11 context menu, and the old windows context menu, with the fluent design icon adapted to Light/Dark theme
- Integration with Windows Notification Center: a notification toast will pop up when the copy is finished
- Speed graph
- Confirmation Dialog
- Integration with taskbar: a progress bar sync with the one inside the window
- Settings
- Multi-language support
+ English
+ 中文
## Installation (before publish to Microsoft Store)
1. Go to the [Release Page](https://github.com/HO-COOH/FastCopy/releases), download the zip file in the **Asset** section of the latest version
2. Unzip, double-click to open the certificate file ended in `.cert`, click `Install Certificate`. Choose `Local Machine` in the dialog, click `Next`
3. Choose `Place all certificates in the following store`, click `Browser`, and in the dialog choose `Trusted root certification authorities`
4. Then click `Next` and finally `Finish` to install the certificate.
5. Now you can double-click the `msix` to install the app.
6*. **In rare situations, you might need to restart `explorer.exe` to see `FastCopy` in the right-click context menu**
## Usage
1. Using file explorer, select some files/folders, as many as you want >> right click >> move to **FastCopy** >> select **Copy** or **Move**
2. Go to destination folder, right click at empty space >> move to **FastCopy** >> select **Paste**
## Development
### Project structure
```
FastCopy
FastCopy\ --- Main project
FastCopyShellExtension\ --- A dll project for registering the new Windows context menu
SpeedTest\ --- A speed test project for measuring various copying method under Windows
UnitTest\ --- Unit test for above projects
FastCopy.sln --- The solution file for all the projects
```
### Build pre-requisites
- Visual Studio 2019+, with C++20 support & Universal Windows development workload
- Windows App Sdk, with C++ template
- Additional dependencies per project:
+ FastCopy:
- spdlog
- boost-algorithm
+ SpeedTest:
- abseil
- ftxui
- cereal
[vcpkg](https://vcpkg.io/en/) is the recommended package manager to handle these dependencies.
You can install them with one command, and do no more.
```
vcpkg install boost-algorithm:x64-windows
vcpkg install spdlog:x64-windows
vcpkg install abseil:x64-windows
vcpkg install ftxui:x64-windows
vcpkg install cereal:x64-windows
```
Other component comes from my very own [WinUIEssentials](https://github.com/HO-COOH/WinUIEssentials), which will be installed automatically by Visual Studio nuget.
### Known issue
- App crash after the window closed (does not affect users, low priority)
### Recommendation
Please install the [Child Process Debugger](https://marketplace.visualstudio.com/items?itemName=vsdbgplat.MicrosoftChildProcessDebuggingPowerTool2022), so that the debugger would break at the copying process (after you launch the settings process).
That is, you run the program first (so it goes into settings), then copy-paste a file, then the debugger will break automatically.
Strongly recommended!
## Translation
For contribution to translation, there are 2 places to be translated:
- The main project, in `FastCopy/Strings//Resources.resw`
- The shell extension project, in `FastCopyShellExtension/CopyOperationNames.cpp CopyOperationNames::GetInstance()`
### Prototype
[Figma link, you may need to ask for permission.](https://www.figma.com/file/e5hUvDWKO8gZiKXruuNSvL/Xcopy?type=design&node-id=217-31199&t=cKY9TdBJXXi7QdFL-0)
### Behind the scene
#### Parsing `robocopy` output
1. New file line has the form of this
```
New File 485 CMakeLists.txt 20:58 -> 20:58
```
This can be matched with **staring with `New File` and containing 4 segments after split with `\t`**
```cpp
std::string_view{line}.starts_with("New File");
std::vector v = absl::StrSplit(s.data(), "\t", absl::SkipEmpty());
/*
New File
485
CMakeLists.txt
xx:xx -> xx:xx
*/
```
2. New folder line has the form of this
```
New Dir 2000 D:\computecpp-sdk\.git\refs\
```
This can be matched with **starting with `New Dir` and containing 2 segments after split with `\t`** (the spacing between `New Dir` and number are spaces, not `\t`)
```cpp
std::string_view{line}.starts_with("New Dir");
std::vector splitted = absl::StrSplit(absl::string_view{ line.data(), line.length() }, "\t", absl::SkipEmpty());
/*
New Dir 2000
D:\computecpp-sdk\.git\refs\
*/
std::pair count = absl::StrSplit(splitted[0], " ", absl::SkipEmpty());
/*
New Dir
2000
*/
```