--point-in-time is used in conjunction with
--restore to download a directory in the state it was at a particular point in time. The general syntax is:
SpiderOakONE --restore /DIRECTORY/TO/RESTORE --point-in-time YYYY-MM-DD/hh:mm
The --restore option is followed by the directory to download. The --point-in-time option is followed by the date and time desired, in the format indicated above. By default the directory is downloaded to SpiderOak's download location, not to its original location. This is to avoid the possibility of overwriting wanted files and to allow the user to control the process.
If you wish, you may combine --point-in-time with one or more of the following additional options:
--output /TARGET/LOCATIONspecifies where to download the directory to. If not specified, it will be downloaded to the default download directory.
--device Nspecifies the device number (not name) to download the directory from. If not specified, the directory will be downloaded from the current device.
--verbosewill specify the files being downloaded.
--simulatewill report what files would be downloaded, but will not actually download anything. By its nature this command is verbose, so there is no need to specify verbose when --simulate is used.
Prior to using --point-in-time, you may find it helpful to use --tree-changelog to see what restore points are available. Note however that point in time restoration is not retroactive and can only restore points backed up since the installation of a SpiderOak version that supports this feature (version 6.1.2 or later). For example, if you upgraded on February 1, 2016 to a version that supports point in time restoration, then you will not be able to restore to points prior to that date even if --tree-changelog reports prior changes.
If you plan to use --device, you may find it helpful to first use --userinfo to obtain a list of your devices and their numbers.
This will download everything uploaded to SpiderOak ONE from the current device's Photos directory in their Documents folder, saving those files to a TempPhotos directory under their user name. It will also give a verbose list of all files which are being downloaded.
cmd /c "C:\Program Files\SpiderOakONE\SpiderOakONE.exe" --restore "C:\Users\Username\Documents\Photos" --point-in-time 2016-05-01/12:03 --output "C:\Users\Username\TempPhotos\" --verbose
This will report what files would be downloaded if you tried to download the Taxes2015 from device 4's Documents folder. This won't actually download any files.
/Applications/SpiderOakONE.app/Contents/MacOS/SpiderOakONE --device=4 --restore /Users/username/Documents/Taxes2015 --point-in-time 2016-05-01/12:03 --simulate
This will download /home/user/Documents/Thesis from May 1 at 12:03pm, from the current device, saving it to SpiderOak ONE's default download directory.
SpiderOakONE --restore /home/user/Documents/Thesis --point-in-time 2016-05-01/12:03