Cloneapp Manual
Cloneapp Manual
BELIM
DOCUMENTATION CLONEAPP
4.3 Editor Path ................................................................................................................................. 12
4.3.1 Internal Editor ..................................................................................................................... 12
4.4 7z Compression......................................................................................................................... 13
4.5 Clone Modes ............................................................................................................................. 13
4.5.1 Clone Mode: Clone Apps in same or separate folder: .................................................. 13
4.5.2 Confirmation Mode: Display or Hide Clone conflicts.................................................... 13
4.6 Theme Mode ............................................................................................................................. 14
4.7 Configuration files .................................................................................................................... 14
5. Advanced Usage ............................................................................................................................. 15
5.1 Including Custom Items to the Backup process ................................................................... 15
5.2 Log operations .......................................................................................................................... 15
5.3 Command-line parameters...................................................................................................... 16
5.4 Backup Plug-ins and work with certain Apps ....................................................................... 17
6. Troubleshooting .............................................................................................................................. 17
7. Documentation Info ....................................................................................................................... 17
PLEASE NOTE that the information in this Documentation always refer to the
most recent Version of CloneApp, which can be downloaded here
BELIM
DOCUMENTATION CLONEAPP
1. Introducing CloneApp
1.1 What is CloneApp?
CloneApp is a small, fully portable utility for computers running
Microsoft Windows that is designed to easy backup and restore
Application settings and Windows configurations that are stored in
Windows directories, profile folders and Registry.
Since CloneApp is fully portable and has a very low memory usage, there are no minimum
memory or hard drive requirements. It is not bonded on 3rd-Party Libraries or has other
Dependencies and it does not write anything to the Registry.
CloneApp will run on any PC running Microsoft Windows 7, Windows 8, Windows 8.1,
Windows Server 2008-2012, Windows 10 (all editions, including 64-bit)
BELIM
DOCUMENTATION CLONEAPP
If you enjoy CloneApp please introduce it your beloved and more number of people, write
about CloneApp on your Blog and help me grow CloneApp.
Note: CloneApp contains NO spyware or adware.
2. Using CloneApp
2.1 The User Interface
The User Interface (UI) is separated into four tabs. The Main tab is captioned with the Name
Clone. This is also the first tab you will see, when starting CloneApp.
The Clone tab includes three areas. On the left hand you have the Supported Apps/Plugins list (What exactly Plug-ins are can be read in the chapter CloneApp Rules), which is listing all
supported Applications in CloneApp. Next to the Apps list, also a Installed list is available.
This one is listing all Installed Applications on your running System (Read more about this
feature in the chapter Advanced Usage)
On the right hand, you have the Description fields, which display some Information about
the selected Plug-in like Name of the Plug-in, Information what the Plug-in script does and
the Author of the Plug-in.
Next to the Description field, you will also see a Button captioned with the Name What is
being backed up? When clicking on this Button, CloneApp will analyze the Files, Folders and
Registry Keys for their existence belonging to the Applications and Windows features you
have selected. This may take some time.
Note: The What is being backed up? feature is ONLY for Preview purposes. No files are backed up
during the Process.
Next to the What is being backed up? Button you will see an Edit Button, which can be used
to open the Plug-in file itself for showing the Script behind the selected Plug-in. The Plug-in
file is opened by default with Windows Notepad (Read more about this feature in the chapter
Beneath the What is being backed up? Button you will also discover a small summary of
the Plug-in Script, which counts the Number of backed up Files, Folders, Registry Keys and
optional Commands of the selected Plug-in.
The Bottom of the Main UI is showing the Status-, Log window. This window logs all actions
during the Backup and Restoration process. (Read more about this feature in the chapter
Advanced Usage > Logging)
CloneApp Settings)
BELIM
DOCUMENTATION CLONEAPP
Read more in the chapter CloneApp Settings > Clone Modes and how to handle Dialog
boxes and Error Messages in CloneApp.
CloneApp will log every action taken in the Status window.
Dialogs may be displayed by default to you during the process, for instance, when a file
cannot be copied, because when an application is still running during the process or when
folders cannot be copied because the main folders do not exist since the application is not
installed. In the last case, CloneApp will ask you whether the folders should be created. This
could also happen, when an Environment Variable does not exist and CloneApp does not
know where to copy and/or restore the Files.
BELIM
DOCUMENTATION CLONEAPP
2.2.4 How can I Restore a Backup to another Computer?
Just copy the CloneApp program folder including the CloneApp Plug-ins and of course the
Backup folder including the cloneapp2.ini to the Machine you want to restore the
Configuration.
CloneApp writes the Path where the files has been backed up (Clone Path) also to the
clonapp2.ini
The Username on the target Machine you want to restore the Configuration could maybe be
another as on the Source Machine where the Backup has been made. In this case CloneApp
could maybe return the Error message Restoration Settings could not be loaded. Clone Path
has been reseted to Default. Please try again. In the second attempt the Clone Path in
cloneapp2.ini will be prepared and reseted to the default Clone Path registered in the
Options tab.
To check for updates go to the Get Started tab, click the Check for updates link next to the
Name label CloneApp. The Version label beneath will tell you if you have the latest version, or
will pop-up a download Message box if a newer Version is available.
BELIM
DOCUMENTATION CLONEAPP
3. CloneApp Rules
CloneApp is based on an .INI Engine to determine which Applications and Windows
configuration files to Backup and/or Restore and how to do that. .INI files are simple
text files with plain text, so you can edit them with Notepad. CloneApp brings by
default already pre-configured Plug-ins for dozen popular Applications. To extend
CloneApps functionality you can create your own Plug-ins.
The File entries must start at 1 and proceed sequentially upwards File1 (File2, File3 etc.)
followed by the equality sign (=)
Then the Command has to be added e.g. RunFile followed by the Path to the
File/Folder/Registry Keys or Command.
BELIM
DOCUMENTATION CLONEAPP
Variable
Place
%ALLUSERSPROFILE%
%APPDATA%
%LOCALAPPDATA%
%PROGRAMDATA%
%PROGRAMFILES%
C:\ProgramData
C:\Users\{username}\AppData\Roaming
C:\Users\{username}\AppData\Local
C:\ProgramData
C:\Program Files
%PROGRAMFILES(X86)%
%ProgramW6432%
%PUBLIC%
%SystemDrive%
%SystemRoot%
%USERPROFILE%
%WINDIR%
C:\Users\Public
C:
C:\Windows
C:\Users\{username}
C:\Windows
The "$" (dollar sign) defines Custom/Internal Variables of CloneApp based on Windows
API.
Variable
Place
$AppClonePath$
$Date$
$Documents$
$AppData$
$LocalAppData$
$ProgramFiles$ (only 32-bit version)
$FirefoxProfile$
You can also define Custom Variables in a CloneApp Plug-in file e.g.
[Variables]
MyDocuments=%UserProfile%\Documents
The Execution process of Custom Variables is also done in the [Files] section.
BELIM
DOCUMENTATION CLONEAPP
[Files]
File1=BackupFile|%MyDocuments%\config.ini
The command used is BackupFile, which exports the File config.ini to the Clone Path
defined under the Options tab in CloneApp. (Read more about this feature in the chapter
CloneApp Settings). It supports also Filetypes/Wildcards, here *.* In the second example File2
it would export all Files in the Configuration folder. You can also specify the Wildcard e.g.
File3 *.ini to export ONLY .INI-Files.
Note: The x64-bit Variant of the BackupFile Command, has to be used when working with x64-bit
Environment Variables e.g. %ProgramW6432%.
Info: This command supports the Attributes write-only and hidden.
To eliminate redundancies, when backing up an Application which has different locations but
same folder name, this command splits the absolute path of each backed up folder e.g.
Windows Themes
%LocalAppData%\Microsoft\Windows\Themes
The created Output folder Windows Themes creates five other Subfolders beginning with
%LocalAppData% \ Microsoft \ Windows \ Themes \ Themes
File2=BackupFolder|%AppData%\Example App\Configuration|OutputFolderNew
BELIM
DOCUMENTATION CLONEAPP
Here the same, where instead of %LocalAppData%, the folder %AppData% will be created.
%AppData% \ Microsoft \ Windows \ Themes \ Themes
Note: The x64-bit Variant of the BackupFolder Command, has to be used when working with x64-bit
Environment Variables e.g. %ProgramW6432%.
Info: This command supports the Attributes write-only and hidden.
This Command creates also for each part of the Registry Key a separate subfolder to
eliminate redundancies when backing up Registry Keys with identical Filenames e.g.
7-Zip
HKEY_CURRENT_USER\SOFTWARE\7-Zip
The created Output folder 7-Zip creates three other Subfolders beginning with
HKEY_CURRENT_USER \ Software \ 7-Zip
Here the same, where instead of HKEY_CURRENT_USER the folder HKEY_LOCAL_MACHINE will be
created.
HKEY_LOCAL_MACHINE \ Software \ 7-Zip
This Command supports also the creation of Custom Output folders
File1=BackupRegKey|HKEY_CURRENT_USER\Software\ExampleApp|HKEY_CURRENT_CustomFolder
This Command executes the command-line netsh advfirewall and exports the Windows Firewall
Settings to the Backup directory of CloneApp.
10
BELIM
DOCUMENTATION CLONEAPP
The RunCommand supports the internal Variable $AppClonePath$. If enabled, it uses the
default Clone Path directory of CloneApp.
3.3.7 Detect
Detect
File1=Detect|HKEY_CURRENT_USER\Software\Microsoft\Office\14.0\Word
OR (ONLY one Detect Command is allowed)
File2=Detect|%AppData%\Microsoft\Word
By default the Detection routine checks every deposited File, Folder and Registry Key in a
Plug-in file for their existence. Optional you can use the Detect Command, which is been
preferred if added, and check only the File, Folder and Registry Key existence in this
Command.
The Command used is ExternalPlug, which executes NirSoft ProduKey and exports the
Product keys in a Text File. As destination path, the internal $AppClonePath$ Variable is
used.
11
BELIM
DOCUMENTATION CLONEAPP
4. CloneApp Settings
In the Options tab, you will find some customizing settings for CloneApp to let it
work the way you need it to.
As you see, the Clone Path supports also the Variable %Date%, in the Format YYYY-MM-DD.
Variable/Dynamic
Editor
Path
e.g.
CloneApp brings also a small and fast built-in Plug-in Editor, which is enabled by default.
To make sure that it is enabled, please check for the Variable $AppEditor$ entered in the
Editor path. The internal AppEditor allows you to easily edit available Plug-in files and also to
save new Plug-in files based on your editing.
12
BELIM
DOCUMENTATION CLONEAPP
4.4 7z Compression
7-Zip is an effective compression program. The 7z.exe program is used to compress, extract
and update files through the command line. It provides superior compression. It is opensource. This makes it easy to obtain and also use it in CloneApp.
If Installed CloneApp will automatically detect the Installation path and recommend
command line options by clicking the Browse Button, otherwise a Dialog will be displayed
for entering a Custom path.
Use the Compress and Decompress Textboxes to edit the command line options for
compression and decompression.
If you make a second click on this option, you will enable the second mode Respond silent
to all Clone conflicts. While this option is enabled, CloneApp will respond to all Clone and
Windows conflicts automatically with Yes and hide all User Interface and dialog boxes if an
error occurs. In this case, file/folders will be automatically overwritten, folders will be created
if they do not exist and running Applications/Processes will be ignored.
Note: By enabling this option, you will have to try NOT to evocate Windows conflicts e.g. a running
Application such as Mozilla Firefox will not be backed up and/or restored completely while it is
opened, because CloneApp (and also every other Application/Process) cannot copy and/or replace files
in use.
This option is set by default and displays confirmation dialogs if a file/folder already exists
and should be overwritten, if a folder does not exist and should be created or if the
Application being backed up is running and the files cannot be copied. This and such other
normal Windows file conflicts will always be displayed if an error occurs.
13
BELIM
DOCUMENTATION CLONEAPP
CustomRegKeys.dat
This file is used to save the Custom Registry Keys added in the Custom tab of CloneApp.
CustomCommands.dat
This file is used to save the Custom Commands added in the Custom tab of CloneApp.
CustomFolders.dat
This file is used to save the Custom Folders added in the Custom tab of CloneApp.
14
BELIM
DOCUMENTATION CLONEAPP
5. Advanced Usage
5.1 Including Custom Items to the Backup process
You can choose specific Files, Folders and Registry Keys and Commands to be included in
the CloneApp Backup operations.
Note: User-defined Files are currently NOT included to the Restoration process.
To include Custom items to the Backup process, go to the Custom tab of CloneApp and
select the items in that you want to be included to the Backup process.
The Custom Backup process supports the same Filetypes and Environment Variables as the
default Application Backup. (Read more about this feature in the chapter CloneApp Rules)
Each Item category has to be separately proceeded by clicking the Start Backup button.
You can also trigger the Custom section through the Plug-in Engine, by using the
following Commands:
Backup
Restore
Backup Files
Restore Files
File1=BackupFileCustom|
File1=RestoreFileCustom|
Backup Folders
Restore Folders
File1=BackupFolderCustom|
File1=RestoreFolderCustom|
File1=BackupRegKeyCustom|
File1=RestoreRegKeyCustom|
Backup Commands
Restore Commands
File1=RunCommandCustom|
File1=RestoreCommandCustom|
15
BELIM
DOCUMENTATION CLONEAPP
Parameter
Explentation
CloneApp.exe /AUTO
CloneApp.exe /B
CloneApp.exe /SB
CloneApp.exe /R
CloneApp.exe /SR
CloneApp.exe /P
There are six parameters you can use when running CloneApp, as follows.
You can use them in batch files, scripting, shortcuts, or the Task Scheduler to automate
CloneApp operations.
16
BELIM
DOCUMENTATION CLONEAPP
CloneApp will copy now all your selected Applications in the separate My Apps directory.
Note: CloneApp will always load the My Apps folder first.
To load the default Plug-ins directory, you just have to remove the My Apps folder.
6. Troubleshooting
Currently there are NO issues known while running CloneApp.
If you have Problems and need support, just follow CloneApp on the Community forum,
Facebook or Twitter.
7. Documentation Info
Chapter: 6. Troubleshooting
17