This is a Manual Page of RapidCopy(FastCopy for Mac OS X). Please read carefully the following points.
Based on the great original FastCopy v2.11. manual.
RapidCopyPro and making it the common man. Please refer to the introduction for feature differences between the Pro version.
FastCopy is the Fastest Copy/Delete Software on Windows.
RapidCopy is portable version of FastCopy that runs Mac OS X.
Automatically selects different methods according to whether Source and DestDir are in the same or different HDD.
|Diff HDD||Reading and writing are processed respectively in parallel by separate threads.|
|Same HDD||Reading is processed until the big buffer fills. When the big buffer filled, writing is started and processed in bulk.
Because Reading/Writing are processed with no OS cache at all, other applications don't easily become slow.
Include/Exclude Filter (UNIX Wildcard style) can be specified.
GUI and some function constructed by Qt Framework
For the purpose of performance, Using a POSIX system call to replace the Win32API.
Add a number of features such as xxHash verify and copy result EMail sending.
RapidCopy for Linux
has been published on Github.
The RapidCopy There are two versions.
Please refer to the table below for feature differences.
(*1)RC_MultiLauncher.app supports multiple RapidCopy launching. Download is here
Usage is here
If you want to know the changes from FastCopy, Please refer to change list from FastCopyV2.11
Future this program we want to open source. but,,
I want you to pay the money for a while for development funds because I also salaryman. I'm sorry :)
Copyright 2004-2012 SHIROUZU Hiroaki All rights reserved.
Copyright 2015-2016 Kengo Sawatsu@L'espace Vision All rights reserved.
THIS SOFTWARE IS PROVIDED BY SHIROUZU Hiroaki and Kengo Sawatsu@L'espace Vision ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SHIROUZU Hiroaki OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Mac OS X 10.7.5(Lion) ～ Mac OS X 10.12.x(macOS Sierra) x64CPU,64bit kernel mode launching required.
|Install||Please refer to the AppStore manuals||Please D&D RapidCopyPro.app to Application folder.|
|Uninstall||Please delete RapidCopy(Pro).app in Application folder.||←|
|License||Agree Apple EULA||Please D&D RapidCopyPro.app to Application folder.|
If main window is minimized, it is stored in system tray.
Source / DestDir
Specified Source(s) / DestDir by D&D or FileDialog.
（In case of RapidCopy Pro, remember Source(s) and DestDir history）
If you want to add files/dirs to the Source field by using drag and drop, simply drop with pushing Command key.
You can also drag & drop to DestDir field.
You can not specify a symbolic link directly to the Source and DestDir.
(Please refer to the handling of symbolic links.)
Regarding different behavior whether the end of DestDir character is '/' or not.
Source is one directory and the end of DestDir character is NOT '/'
Copy source directory's contents to DestDir.
Copy source directory that including it self to DestDir.
|Diff (No Overwrite)
||Copy if the same filename doesn't exist in destination.|
||Copy if size or date is different, or if it doesn't exist (default)|
||Copy if source filesize is different.|
This mode requires "LTFS" checking.
||Copy if source date is newer or doesn't exist.|
|Copy (Overwrite all)
||Always copy/overwrite all.|
||Copy if size or date is different, or doesn't exist.
In addition, delete all destination files/directories that don't exist in source.|
||Don't run Copy. verify only.|
In verify mode, this process is following differences as an error.
Different size of date
File or folder exists in the Source, but is not present in DestDir
Unauthorized file of verification results
Verify mode or when "listing+v" run in RapidCopy Pro, verify against the symbolic link, regardless of the setting, and compares the file entity.
|Move (Overwrite all)
||Always copy/overwrite all and delete all copied source files. (It is able to change "Move (Overwrite all)" -> "Move (Size/date)" in settings dialog.)|
||Delete all files/dirs by force.|
Buttons & Options
||The copy operation is executed. While copy is executing, this button changes "Cancel..." button. |
||The files and directories list that will be copied and deleted are displayed.|
output reference is here
(Compare file pairs that will be skipped(except skipping by filter), if this button is pushed with pushing Command key(button label "listing" -> "listing+v"(*2)))
||Specify the size(MB) of the main buffer for Read/Write oprations. |
||Specify "Full Speed", "Auto Slow"(*1), "9"~"1", "Suspend".|
If you feel it is hogging resources, it is recommended to set to "Auto Slow" (If it detects mouse moving/active window changing (and fastcopy window isn't foreground), it is slowed down).
If "Full Speed" isn't selected, low process priority class is set.
(This setting is not saved by job manage)
||Don't interrupt even if errors occur by Read/Write/Delete, and keep processing as much as possible. |
(However, errors are displayed in the main window, and recorded in the error log.)
Verify written files data.|
By default, verify with MD5.
You can choose any of the hash algorithm in Settings->General Settings->I/O configuration.
... Action detail: Read(Src) -> MD5(Src) -> Write(Dst) -> Read(Dst) -> MD5(Dst) -> Compare MD5(Src/Dst)
(Of course, all actions are processed in parallel as much as possible)
||Display the estimated complete time. This means will cause RapidCopy to investigates source tree before starting.|
||RapidCopy window is always top-level.|
|Start at once
||Start at once without waiting for the finish of other RapidCopy instance(s) executing. (This button doesn't show when other RapidCopy isn't copying.)|
(*1)It is slowed if RapidCopy window isn't foreground and it is detected mouse moving, by waiting beetween I/O, changing process priority, and changing maximum I/O size.
(*2)"Listing+V" mode is backward compatibility feature of the Windows version users. We recommend the use of the verify mode in RapidCopy.
||Copy Access Control List.|
||Copy EA(Extended Attribute).|
Please be used if you want to keep the metadata of the file.
Ex:Finder color label data.
||Copy from/to Linear Tape File System(LTFS)|
EA,ACL,Speed Control is disable.
Diff copy that uses the date can not be selected under LTFS.
Replace LTFS Prohibit char to '_'.
Please refer to the BBS for LTFS support information.
|Wipe & Delete (prevent deleted files reviving)
||Rename filename and Overwrite random data before deleting. EA isn't overwritten. If NSA method is checked in setting dialog, Overwriting Random data process runs two times, and overwriting NULL data process runs once.|
Handling of Alias(by Finder)/Symbolic link(by "ln -s")
||By default,copy the symbolic link itself.|
In the case of RapidCopy Pro, you will be able to copy the target of a symbolic link of the entity in the config.
Default behavior is here.
Alias(make by Finder):Copy the alias itself regardless of the contents of the setting.(*1)
Symbolic link(ln -s):Copy symboliclink as link.(*2)
||Always move the alias and symbolic link itself.|
||Always remove the alias symbolic link itself.|
(*1):Please attach the EA always. It may not work properly if EA does not exist.
(*2):Will be the behavior of --recreate options equivalent of below is always active.
HardLink can be reproduced as much as possible, if specify "linkdest=1" in configuration file.
(In running, "TotalFiles:" format changes "number_of_files (number_of_dirs)" to "number_of_files / number_of_created_hardlinks (number_of_dirs)").
Please note that consumes 10MB about memory at the maximum per hard link entity 10 000 files. (Path length dependent).
If "linkdest" option is enabled,--recreate
is enabled tacitly.
File -> Open New Window(Only RapidCopy Pro)
Open In New Window.
ShortCut is Command+N.
File -> Save Bug Report(Only RapidCopy Pro)
generate Bug Report Data.
Generate file to "$HOME/Desktop/YYYYMMDD-HHMMSS.zip"
JobMng -> Manage Single Job(Only RapidCopy Pro)
Register/Restore parameters in main window as named job.
||Add/Modify prameters in main window(Source/DestDir, Operation mode, Buffer size, Nonstop/Verify/Estimate/ACL/AltStream/Wipe&Delete/Filter checkboxes, Filter strings, HDD mode) as named job.|
||Delete registered job.|
JobMng -> JobList Mode(RapidCopy Pro only)
Save a set of job as JobList and run JobList as copybatch.
Job order can be changed.
Load job list, save, and delete.
||Create/save the contents of the current job list.|
||Delete current job list.|
When deleting the job in the job list is all will be removed.
(If the job of the same name outside the deleted job list exists, it does not delete)
||If check off, a fatal error occurs in any of the job(ex:Src/Dst path invalid, memory allocate error), it does not start all subsequent job.|
Please check to think well the order dependent.
Adding a job to job list, delete, reorder,running etc..
Support D&D reorder.
||Add the contents of the current main window as a new job in the job list under the name of YYYYMMDD_HHMMSSZZZ.|
||Runs current job list. If job list is running,it will cancel button.|
||Cancel current job and cancel all later job.|
note:Can't cancel executed job(s).
|Double click job in joblist
||change the name of the selected job.|
|Up key while holding down the Option(Alt) key
||It will raise the execution order of the job.|
|Down key while holding down the Option(Alt) key
||It will reduce the execution order of the job.|
|Drag and Drop in Job order
||Delete job from the job list.|
|Delete all Job
||Delete all jobs from the job list.|
Notice for Joblist Mode
When the job list mode execution of the behavior of existing functions are changed as follows.
|Start at once
||Force run without waiting for the completion of execution of other RapidCopy Pro.|
||Cancel current job.(If next job exists,next job will start)|
||E-Mail,Execute Command,Play Sound, Runs at job list ends.|
||Detailed log:Generate YYYYMMDD-HHMMSS-[joblistname].log(csv)file in the job list ends.|
If a fatal error, such as at each job src / dst path fraud occurs, the error contents are output to the standard log.
||--auto_close:It does not automatically end if even one in a job in the job list error has occurred.|
--force_close:Forcibly quit after the end all of the job.
|Confirm before execute dialog
||"Confirm before execute" dialog is not displayed regardless of the setting.|
General settings. (change Default values, I/O parameters, and Copy Options, etc)
I/O Settings -> MAX I/O(MB)
Specifies the Read / Write size when reading and writing data.
In the case of ultra-high-speed network environment, such as 10G Ethernet you may want to speed if you specify a 4-8MB.
Except under 10G environment, we recommended default value(1MB).
I/O Settings -> Verify mode
Select verify algroithm. Default is MD5
If you want to save CPU resources can be used to lower the CPU utilization by using the xxHash.
|Verify Mode||hash key length
I/O Settings -> Enable Readahead
When RapidCopy is reading the data, Enable Readahead.
Default is "Write to Log" enabled.
Log output charset is UTF-8
|Number of history items Src/DestDir||need to restart(RapidCopyPro only)
|Write to Log(RapidCopy.log)||Write summary and error only.|
|Write EA(xattr) errors to Log||Write EA errors to Log.|
|Write ACL errors to Log||Write ACL erros to Log.|
|Write to detailed Log||Create the "Log/DATE".log file for each copy. If you check "verify", checksum add.|
|Write to detailed CSV||
Create the "Log/DATE".log file for each copy.|
csv output format is no BOM and charset is UTF-8
It can be converted to xls using the data import feature of OpenOffice or LibreOffice
(Can't read the UTF-8 in MS Office)
listup and detailed log format:
|+||Add file(including overwrite)
|Ends with "/"||Target is directory|
|Ends with "=>"||Target is HardLink|
|Ends with "->"||Target is Symbolic link|
Option -> Auto/Same/Diff HDD mode
Specify Auto/Same/Diff HDD mode
Command+ K shortcut toggles between disk modes (auto -> same -> diff ->...)
Option -> Swap Source<->DestDir
Swap Source for DestDir (for mutual update or etc).
Source/DestDir will be modified based on different behavior whether the end of DestDir character is '/' or not
. (For example, If Source is "/Volumes/TEST/AAA/BBB" and DestDir is "/Volumes/TEST/AAA/BBB", then Source becomes "/Volumes/CCC/BBB" and DestDir becomes "/Volumes/TEST/AAA/")
If Source has two or more files/directories, this menu item is disabled.
Command+Shift+S is shortcut of this function.
Option -> Post-Process
Set the action, such as sound settings and command execution or Email sending.
Also, user can add new Post-Process settings.
Sound play after running command. (reverse execution is the windows version)
Option -> Post-Process -> Execute Command(only RapidCopy Pro)
Execute commands in the background by handing it over to /usr/bin/sh
If you execute multi commands,You can separate by semicolon(";")
Option -> Post-Process -> Play Sound(RapidCopy has limit)
Play any sound at the end.
Support file format are (wav,aiff,mp3)
You can set any of the files in RapidCopy Pro.
RapidCopy only support default sound.
Option -> Post-Process -> E-Mail
E-mail send a copy result.
Transmission protocol only support SMTPS.
gmail account only confirmed the operation. Configuration examples please refer to the following.
Option -> Show Filter
Specify the enable / disable of various filters.
Note: It is always disabled in move mode.
Include/Exclude filter(wildcard) format.
||Copy only the files/directories that match up specified strings(UNIX Wildcard style).|
If you want to specify two or more strings, please use semicolon as separator.
If you want to specify directories, please add '\' to the end of directory name.
Note:If you specify a folder to Include/exclude filters, only the first matching folder is the copy target.
(even if there is more than one match folder you will copy only the first match folder)
(For example: *.txt; My Folder [0-9]\)
||Don't copy the files/directories that match up specified strings.|
||Don't copy the files that timestamp are older than specified date(format).|
This can be specified by not only absolute format ("20090322") but also by relative format (10days before ... "-10D").
||Don't copy files with timestamps newer than this specified date.|
||Don't copy the files with sizes that are smaller than specified size.|
High number can be abbreviated using K/M/G/T character (Kilo/Mega/Giga/Tera).
||Don't copy the files with sizes bigger than specified size.|
（Note:Wild card specification same as QtFramework QRegExp::WildcardUnix)
FromDate/ToDate filter format.
|*||Zero or more arbitrary characters
|?||One arbitrary character
|[abc]||One character in "abc"
|[^abc]||One character except "abc".
|[a-z]||One character in "abc...xyz"
|[0-9]||Any single character up to "0-9"
|\||Escape character (However, if '\' is the end of string character, it means a directory)
|Relative||Specify "+|- number W|D|h|m|s".
W|D|h|m|s means Weeks/Days/hours/minutes/seconds.
ex) "-12h" (This is case sensitive.)
Option -> TimerMode alpha function (RapidCopy Pro only)
Automatically running current main window settings.
To stop the timer mode, uncheck the "Timer Mode",or Cancel copy.
It will be enable by writing the "timermode=true" to the [main] section in the configuration file(RapidCopy.ini).
Notice:This function is alpha. There's two problems
It crashes in a continuous run of about 72 hours. (If the interval is set to 5 seconds)
A long period of time if you want to run consume memory (about 500MB the interval at 72 hours when set to 5 seconds)
Please use with the understanding the above-mentioned problems in advance.
|Interval||Set Interval time.
|Count||Set number of copy(0=infinite)
Notice for Timer Mode
Timer mode, please note the following points.
||If the file size of the copy source is changed during run in timer mode, and skip the copy of the file.
(Suppress that the waste copy the file being generated)
If you cancel a copy of the running in timer mode, timer mode is terminated.
||Send mail, command execution, sound playback will work every time of the automatic execution.|
||Outputs a large amount of log files by the automatic execution depending on the setting.
You should make sure of log settings.
||When you run TimerMode with JobList Mode,Automatically running JobList.
6. Command Line(only RapidCopy Pro)
A basic format is as follows.
RapidCopyPro [--options] [--to DestDir] Source1 Source2 …
1. Delimiter is blank character. Path name that contains a space character, escaped with a '\'
2. If you start from the terminal, the terminal side until the end by default GUI operation will be a wait state.
If you want to include in shell scripts, etc., please use the background execution and --auto_close and --force_close as necessary.
Supported options are as follows.
-h,--help … display help.
…Specify operation mode.
（By default, "dif" is used. If "del" is specified, then "--to" option isn't used.）
|Operation Mode||GUI display
|noe||Diff (No Overwrite)|
|siz||Diff (Size) (*1)|
(*1)require "--ltfs true"
... Close automatically after execution is finished with no errors.
... Close automatically and forcedly after execution is finished.
... Don't stored in the task tray.
... Estimate complete time.
... Don't start to execute.
... Don't confirm before deleting.
... Don't Show error dialog, Even if critical errors occurred.
(true|false) ... Show error dialog (and operation is interrupted), if an error occurred.
... Specify the size(MB) of the main buffer for Read/Write opration.
(true|false) … Write the operation/errors information to the standard logfile(RapidCopy.log).
... Specify the filename of standard logfile.
(true|false|filename) ... Write to the detail filelog(detail of copy/delete files). It is stored YYYYMMDD-hhmmss-N.log in RapidCopy/Log directory. If using verify mode, write digest data as additional data. (To specify filelogname, --filelog filename).
(true|false) ... Write to the detail filelog with csv format.Save destination and file name, please follow the instructions of --filelog.
If you specify a --filecsv you need to enable --filelog.
(true|false) ... Skip to create empty directories when /include or /exclude option is used.
... Specify the job that is already registered.
... Specify the joblist that is already registered.
(true|false) ... Start at once without waiting for the finish of other RapidCopy executing.
... SpecifyAuto/Same/Diff HDD mode
... Specify speed control level.
... Specify source files by textfile. User is able to describe 1 filename per line. (Attention:
If a lot of files are specified, it will take many times to display/refresh Source display area.)
... Specify include filter.(details
... Specify exclude filter.(details
... Specify oldest timestamp filter. (details
... Specify newest timestamp filter. (details
... Specify minimum size filter. (details
... Specify maximum size filter. (details
(true|false) ... Rename filename and wipe(overwrite Random data) before deleting.
(true|false) ... Copy ACL.
(true|false) ... Copy EA(Extended Attribute).
(true|false) ... Copy Symlink as link.details
... Verify written files data
|Verify Mode||GUI display
(true|false) ...Reproduce hardlink as much as possible. details
(true|false) ... Change updating behavior "overwrite the target" to "delete and recreate the target". (If --linkdest option is enabled, this option is enabled by default.) If you want always to enable, write [main] recreate=1 in RapidCopy.ini.
... Specify post-process action name
--ltfs (true|false) ... Enable LTFS mode.
--nodot (true|false) ... Skip "." start files or folders.
--xpos (xpos) ... Specifies window Xpos. Need to specify with --ypos.
--ypos (ypos) ... Specifies window Ypos. Need to specify with --xpos
Ex) Copy "/Volumes/srchdd" to "/Volumes/dsthdd" by "diff(Size/Date)" mode.
RapidCopyPro --cmd dif --to /Volumes/dsthdd/ /Volumes/srchdd
When --auto_close or --force_close or command argument error, return value to parent process.
Meaning of the return code is as follows.
|0(EX_OK)||no error(error files and error dirs are 0)|
|79||error(One or more errors has occurred) |
7. Change list from fastcopy v2.11
Change from the Windows version v2.11, adding, main specification list of deleted is as follows.
Improved operability of GUI such as ProgressBar.
Write completion time in detail file Log (verify valid at the time of verification completion time).
Add new verify algorithm
Add new operation mode.
Add new Post-Process function E-mail sending.
Support Linear Tape File System.
Assuming the evidence use of file corruption detection, changed the specification to record the details file Log in "list+v"
Delete or unsupported
Finder Extenstion is unsupport. (such as right-click menu)
Remove the ability to use the os cache.
Post-Process -> shutdown/standby is unsupport.
Copy behavior is different from the original FastCopy
In some modes, destination files that exist with the same filename in source directories, are overwritten forcedly without confirming.
In sync mode, destination files that don't exist with the same filename in source directories, are deleted forcedly without confirming.
In delete mode, target files and directories are deleted forcedly without confirming.
When an error interruption or cancellation during the execution of the copy that enable verification,
RapidCopy will skip the verification of the copied file.
In this case, it does not guarantee already integrity of the file.(*1)
If you want to guarantee the verification of the copied file, You should run RapidCopy at Verify mode.
(*1) FastCopy is also similar specifications. I'm going to improve this problem in conjunction with the original author.
Please do not sleep during the operation of the RapidCopy (Pro).
When sleep during data reading and writing may not be copied continuously.
When RapidCopy Pro beta version is two months from the date that has been given to the file name expires, you will not be able to boot.
If RapidCopy(Pro) has bugs, there is a possibility of serious problem.
Please use at your own risk. (See 2. License
)and the destination of the various log files is as follows.
RapidCopy output the file unconditionally regardless of the disk remaining capacity.
|detail file log and csv||$HOME/Library/Containers/com.LespaceVison.RapidCopy/|
Please note the remaining disk space.
Configuration file does not have compatibility in FastCopy.
10. Known bugs
Finder Extension support.
Enhance perfomance at Verify mode.
Improved specification at the time of copy interrupt.
Adding multiple files copy mode(refresh core copy engine).
Checksum only mode support (output the checksum in the Source specified).
Relative Path Filter support(compatible with FastCopyV3.xx)
RapidCopy,RapidCopy Pro common bug fixes.
fix:When opening the file, retry if the problem is a temporary error.
RapidCopy,RapidCopy Pro common bug fixes.
fix: When set Include/Exclude filter,RapidCopy(Pro) may crash.
some minor fix.
RapidCopy,RapidCopy Pro common bug fixes.
fix When delete a folder during the operation, "Nonstop" does not work.
Delete a meaningless toolbar
RapidCopy,RapidCopy Pro common enhances. and changes
change "Verify(Size/Date)" -> "Verify(Size)"
Crash occurs when Standard Log enable and repeat copy 700 over times.
fix memory leak.
Fix an exception(or ACL copy failure) when using many ACL entry with deep path.
some minor fixes.
RapidCopy,RapidCopy Pro common enhances. and changes
Add Preferences->I/O setting -> Readahead option
Write performance improvement to SMB/CIFS,HFS+,HFSX(support preallocate)
Support "do not update the update date" to Preferences->Copy/Move options
Support "LTFS Prohibit char" auto replacement in LTFS.
Change. Can't selected "diff copy" with date in LTFS.
Support new copy mode "Diff(Size)" and "Verify (Size)". (LTFS only)
Add "username","hostname","serial" to log and detail log.
Change some copying information.
Improvement minor error handling,securiy and others...
HP LTFS environment under "WriteFileProc:utimes()" output.
E-Mail function can't used in OS X 10.10.3 or later.
Copy speed is reduced when idle at OS X 10.9 or later.
When natural sleep,Writing to the disc does not continue.
When copying with move mode "CloseMultiFilesProc: close" output.
If Detect checksum error in dst file, force delete dst file.
Add new function to RapidCopy Pro
JobList Batch function.
Add csv formats log output.
RapidCopy Pro first release,Added function for Prover.
License register dialog.
Version up information and help->"Download new ver"
Add option "Preferences" ->"Misc"->"Enable notification on Desktop"
Prover bug fix
Job delete function is not working.
Job save is not working in "LTFS"
When used to "open a new window" during a copy run,
it becomes impossible to unmount the copy source / destination device until you close was started new window.
Copy at the end of which was used to "open a new window", RapidCopy Pro to no exception crash.
RapidCopy,RapidCopy Pro common fix
When you remove "Post-process" setting, correct the problem that duplicate entries are stored in the definition file.
When used to multiple running,Don't generate the detailed log file by timing.
Some minor fix.
Fixed local help file has not been updated.
improve the contents of the error message.
|1.0.3||Improves Extended Attributes(xattr) error handling.(2015/6/11)|
|1.0.2||AppStore English Explanation support.(2015/5/24)|
|1.0.0||FirstRelease for Test(2015/4/29)||