From 4448a9aa3a022bbbc3a38b39c69f74285e29eeca Mon Sep 17 00:00:00 2001 From: Rob <1572423+robweber@users.noreply.github.com> Date: Wed, 8 Nov 2017 11:27:36 -0600 Subject: [PATCH] cut/paste from README --- Configuration.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 Configuration.md diff --git a/Configuration.md b/Configuration.md new file mode 100644 index 0000000..371abdb --- /dev/null +++ b/Configuration.md @@ -0,0 +1,40 @@ +These options are found in the Settings area of the addon and should be setup prior to using. + +### General + +These are general settings regarding how backups are performed, maintained, and displayed. + +* Compress Archives - this will put the backup contents in a zip folder. See notes below regarding how this works in more detail. +* Backups to Keep - You can keep a set number of backups by setting the integer value of this setting greater than 0. +* Progress Display - the type of progress bar you want to display, or none if you don't want to see th progress of the backup. + +If you choose to compress your backups there are a few things you need to be aware of. Compressing takes place on the server you are trying to backup and then only the archive is copied to the remote backup location. This means you must have sufficient space available to allow for creating the archive. When restoring a zipped archive the process is the same. It is first copied to your local storage, extracted, and the contents put to their correct locations. The archive is then deleted. Zipped and non-zipped backups can be mixed in the same archive folder. + +### Remote Directories + +Here is where you setup the remote path the backup files will be copied to. Each backup will create a folder named in a YYYYMMDDHHmm format so you can create multiple backups. The options currently available are: + +* Browse Path - just browse for a path that Kodi can see via the normal network browser. +* Type Path - similar to browsing but you type the full path, including "smb://" or "nfs://" protocols as appropriate. See the [Kodi file sharing](http://kodi.wiki/view/File_sharing) page for more info on how to setup file share strings correctly. +* Dropbox - link the addon to your Dropbox account, see more info below on this. +* Google Drive - link the addon to your Google Drive account, see more info below on this. + +### File Selection Options + +Here you can select the items from your user profile folder that will be sent to the backup location. By default all are turned on except the Addon Data directory. You can also define non-Kodi directories on your device. See "Custom Directories" for more information on how these are handled. + +Here is a breakdown of the file selection options available in the settings. More information about Kodi file paths can be found on [the wiki](http://kodi.wiki/view/Special_protocol) + +* User Addons - these are all the addon files located in the main Kodi addons folder. The path is special://home/addons +* Addon Data - this is data saved by addons when changing their settings. The path is special://home/userdata/addon_data +* Database - these are the local Kodi SQLlite databases. Even if using the SQL database there are other DB files such as Addons.db that you would want in this folder. The path is special://home/userdata/Database +* Playlist - Playlists that are created in Kodi. The path is special://home/userdata/playlists +* Profiles - Any files in the profiles folder. Keep in mind this currently includes all database, thumnail and config files in here. The path is special://home/userdata/profiles +* Thumbnails/Fanart - the folder where all thumbnails and fanart is stored. The path is special://home/userdata/Thumbnails +* Config Files - config files refer to a collection of files that Kodi uses for information. This includes the keymaps and peripheral_data, and library directories in the userdata folder. It also includes all the XML files in the root of the userdata directory such as sources.xml, guisettings.xml, favorites.xml, advancedsettings.xml and others. For a full list of files in this directory see the [UserData folder wiki page](http://kodi.wiki/view/The_UserData_Folder) + +### Custom Directories + +You can define custom directories that are not a part of your Kodi folder structure for backup. These create a "custom_hash" folder in your backup destination. The hash for these folders is very important. During a restore if the hash of the file path in Custom 1 does not match the hash in the restore folder it will not move the files. This is to prevent files from being restored to the wrong location in the event you change file paths in the addon settings. A dialog box will let you know if file paths do not match up. + +Up to 2 Custom directories can be specified. \ No newline at end of file