View Single Post
Old 04-01-2016, 05:06 AM   #1
chaley
Grand Sorcerer
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 12,449
Karma: 8012886
Join Date: Jan 2010
Location: Notts, England
Device: Kobo Libra 2
[Library Closed Plugin] Backup configuration folder(s)

When calibre is closed this plugin makes a backup copy of the calibre configuration folder. A backup isn't made if calibre is closed before an automatic restart.

Configuration:
To configure the plugin, go to calibre's Preferences / Plugins / Library Closed plugins. Either double-click on the plugin or select this plugin and press the "Customize plugin" button, then fill in the boxes as you wish. Documentation is in the tooltips for the entry boxes.

Notes:
  • Backups are per-configuration, not per-library.
  • The plugin automatically deletes old configuration backups. Go to the plugin configuration to set the number of days to keep backups. The default is to keep all backups for 3 days then keep the last backup of the day for 10 more days.
  • If you delete the JSON configuration file for this plugin, the existing backup files won't ever be automatically deleted. If you restore your calibre configuration folder then configuration backup files made after the backup you restored won't ever be automatically deleted. From time to time you should check to see if there are unwanted backup files.
  • You must manually clean any backups made before installing version 1.0.3.
  • To restore a backup, use your favorite archive utility to expand the archive into the calibre configuration folder. Exactly how you do this depends on the utility. For example, using the built-in Windows 11 archive manager you would:
    1. Navigate to the folder containing the configuration backup zip files.
    2. Right-click on the desired zip archive and select "Extract all".
    3. Use the "Browse" button to navigate to the existing calibre configuration folder. This is usually
      Quote:
      C:\Users\{your name}\AppData\Roaming\calibre
      You can find the path of the configuration folder in calibre using Preferences / Miscellaneous / Open calibre configuration folder.
    4. Click "Extract".
    5. Allow overwrite of existing files.
    If you want to be ultra-sure, delete the contents of the existing calibre configuration folder before restoring the backup. Only do this if you are sure both that your backup zip is valid and of the steps to do a restore. One way to be sure is to restore the zip to a new folder, rename the existing configuration folder, then rename the new folder to the name the configuration folder had.
  • Requires Calibre 5.35 or later.

Version History:
Spoiler:

Version 1.1.2: (08/Feb/2025):
Changes:
  • Added translation support and the Spanish translation (thanks to @Dunhill)
Version 1.1.0: (05/Feb/2025):
I consider this to be a stable release. The change rate should slow down.
Changes:
  • Allow calibre version 5.35 and newer.
  • Add timed print debugging statements
  • Add the archive size to the debug output.
Version 1.0.4: (05/Feb/2025):
Changes:
  • Stop throwing exceptions and failing when deleting a backup file that is supposed to be there but isn't.
  • Add another line to the configuration dialog showing the full path to the backup folder.
  • Internal restructuring to make my IDE, and therefore me, happier. This shouldn't have changed any behavior.
Version 1.0.3: (03/Feb/2025):
Changes:
  • Addition of automatic removal of old backup files. The number of days to
    keep is controlled by two new configuration values. Note: backups
    made before this version is installed won't be automatically removed.
  • Addition of a button to open the backup folder.
  • Improvement in tooltips.
Version 1.0.2: (03/Feb/2025):
Changes:
  • Improvement in tooltips
Version 1.0.1: (02/Feb/2025):
Initial beta version.
Attached Files
File Type: zip Backup Configuration Folder_1_1_2.zip (22.6 KB, 8809 views)

Last edited by chaley; 02-08-2025 at 04:13 AM.
chaley is offline   Reply With Quote