jwl-backup-merger

This Python-based utility simplifies the process of merging backups made by the JW Library app.

Features

• Combine two or more JW Library backups into one, which can then be re-imported into JW Library on all your devices.
• Automatically detect and merge conflicting data between backups.
• Coming soon: allow for manual conflict resolution.

Warning and disclaimer

Before attempting to restore merged backups generated by this app, it is strongly recommended to create backups using JW Library on all your devices and to store these backups safely.

Please note that this project is not affiliated with jw.org or the official JW Library app. It is an independent tool created by me, for personal use. Use this app at your own risk.

Usage

Pre-requisites:

pip install pandas tqdm tk

Running the app:

python jwl-backup-merger.py [--debug] [--folder FOLDER_PATH] [--file FILE_PATH] [--file FILE_PATH] ...

Arguments

• --test: Run the built-in automated test suite.
• --folder FOLDER_PATH: Folder containing JW Library backups to merge.
• --file FILE_PATH: JW Library backup to add to the list of backups to merge. You can specify multiple --file arguments to merge multiple backups.
• --debug: Enable verbose output and Excel file creation to help with debugging; also prevents deletion of temporary files.

Example usage

python jwl-backup-merger.py --folder /path/to/folder-with-jwl-backups
python jwl-backup-merger.py --folder /path/to/folder-with-jwl-backups --file /path/to/additional-file1.jwlibrary
python jwl-backup-merger.py --file /path/to/phone.jwlibrary --file /path/to/tablet.jwlibrary --file /path/to/computer.jwlibrary

Highlight conflict handling

• For identical rendered highlight text conflicts, you can configure a preferred highlight color order before merge.
• For container-vs-contained highlight conflicts, the tool prompts which contained highlight the container should fold into.