- Move books, covers, metadata, preferences, and plugins without rebuilding your calibre library.
- Fix empty libraries, wrong paths, cloud conflicts, permissions, and missing settings.
- Verify book counts and metadata before deleting the old library.
- Confirm the Symptom With a Small Safe Test
- Choose the Correct calibre Migration Method
- Check the Library, Preferences, Plugins, and Paths
- Check Operating System and Storage Problems
- Use Logs and Focused Diagnostics When Needed
- Run a Clean Temporary Test Before Reinstalling
- Quick Fix Checklist
- Frequently Asked Questions
Moving calibre to a new computer should bring across your books, covers, metadata, tags, custom columns, plugins, and preferences without forcing you to rebuild the library. Problems usually occur because only the book files were copied, calibre opened the wrong folder, cloud synchronization left files incomplete, the new operating system cannot use an old path, or the library arrived without calibre's separate configuration data. The safest approach is to identify exactly what is missing, run a small read-only test, and then choose between copying the whole library folder or using calibre's Export/import all calibre data feature.

Start with free Canva bundles
Browse the freebies page to claim ready-to-use Canva bundles, then get 25% off your first premium bundle after you sign up.
Free to claim. Canva-ready. Instant access.
1. Confirm the Symptom With a Small Safe Test
Before copying the library again or changing preferences, determine what actually failed. A missing library, missing settings, and unreadable books are different problems with different fixes.
1.1 Identify What Came Across
Open calibre on the new computer and check the following items:
- The total number of books shown in the status area
- A few familiar titles, authors, tags, ratings, and series entries
- Custom columns and saved searches
- Cover images for several books
- The available formats listed for selected books, such as EPUB, PDF, or AZW3
- Installed third-party plugins
- Device, conversion, email, news, and Content server preferences
If the books and metadata are present but plugins and preferences are missing, the library itself was probably moved correctly. The missing data belongs to calibre's configuration rather than the library folder. If calibre shows an empty or nearly empty library, it may be pointing at a newly created library instead of the copied one.
1.2 Test Three Representative Books
Choose three books rather than testing the entire collection. Use one ordinary EPUB, one book with a custom cover or edited metadata, and one book stored in multiple formats. Open each book in calibre's viewer, inspect its metadata, and confirm that its cover and formats are present.
If all three work and the displayed book count matches the old computer, stop changing library settings. Continue only with checks for preferences, plugins, devices, or services that you actually use.
1.3 Record the Old Library Location and Count
On the old computer, click or right-click the calibre library icon and open Switch/create library. Record the current library path. Also record the number of books and, if you maintain multiple libraries, the name and count of each one.
The old location might resemble C:\Users\Name\Calibre Library on Windows, /Users/Name/Calibre Library on macOS, or /home/name/Calibre Library on Linux. The new computer does not need to use the same path. In fact, paths usually change when moving between operating systems or user accounts.
2. Choose the Correct calibre Migration Method
There are two reliable migration methods. Use Export/import all calibre data when you want the most complete transfer, including settings and plugins. Copy the entire library folder when you primarily need the books and library metadata or when export and import cannot be completed.
2.1 Use Export and Import for the Most Complete Move
calibre's migration tool is normally the best choice because it is designed to transfer libraries, settings, and plugins together.
- Close editing, conversion, download, and device-transfer jobs on the old computer.
- Disconnect any e-book reader or mobile device connected to calibre.
- Right-click the calibre library icon on the main toolbar.
- Select Export/import all calibre data.
- Choose Export all your calibre data.
- Confirm the libraries that should be exported.
- Select an empty destination folder with enough free space.
- Wait for the export to finish before copying or ejecting the storage device.
- Copy the complete export folder to the new computer.
- Install and open calibre on the new computer.
- Open Export/import all calibre data and select Import previously exported data.
- Select the copied export folder, then choose a new empty destination for each library.
After the import, calibre should restart with the imported libraries, preferences, and plugins available. Success means that book counts, metadata, custom columns, plugins, and important preferences match the old installation. Once they do, do not repeat the import into the same destination.
If Export/import all calibre data is missing, first disconnect any attached reading device. The option may not be available while calibre is working with a connected device.
2.2 Copy the Whole Library Folder Manually
A manual copy works because a calibre library is the complete library folder, including all of its subfolders and the metadata.db database at its top level. Do not copy only EPUB or PDF files, individual author folders, or files returned by a search.
- On the old computer, use Switch/create library to identify the exact library folder.
- Exit calibre completely so that no library operation is running.
- Copy the entire folder, including hidden items and every subfolder, to external storage or a direct network transfer location.
- Allow the copy to finish and safely eject removable storage.
- Place the copied folder in a stable local location on the new computer.
- Open calibre and choose Switch/create library.
- Select the option to use a previously existing library at the new location.
- Browse to the copied library folder itself, not an author or book subfolder.
Success means calibre immediately displays the existing records with their tags, covers, series data, custom columns, and formats. If calibre creates an empty library, you probably selected the wrong folder or chose the option for creating a new library.
Manual library copying does not necessarily transfer the separate calibre configuration that contains application preferences and third-party plugins. If those items matter, use the export and import method whenever possible.
2.3 Move Multiple Libraries Separately
Some users keep separate libraries for fiction, research, work, languages, or family members. Confirm every library listed on the old computer instead of assuming the currently visible one is the only library.
The export process can include multiple libraries. With manual copying, copy each complete library folder separately and attach each one through Switch/create library on the new computer. Use Quick switch to verify that every library opens and has the expected book count.
3. Check the Library, Preferences, Plugins, and Paths
When a calibre move appears incomplete, inspect the component related to the symptom. Avoid changing conversion, device, email, and server settings unless those features are specifically failing.
3.1 Verify That calibre Opened the Correct Library
If the new installation shows only a Getting Started book, an empty list, or a small subset of your collection, open Switch/create library and inspect the current location. Browse to the folder you copied from the old machine.
The correct folder normally contains metadata.db at its top level, along with author folders. Do not select a folder above the library if that folder merely contains the actual library as a subfolder.
Once the expected book count and metadata appear, stop changing library locations. The problem was the selected path, not missing books.
3.2 Understand What the Library Folder Contains
The library folder holds books, covers, the main metadata database, and the folder structure managed by calibre. It is not an ordinary folder that should be reorganized manually. Renaming author folders, moving formats between records, or merging duplicate-looking folders in a file manager can separate files from the database records that manage them.
Use calibre's own Edit metadata, Add books, Remove books, Copy to library, and Save to disk actions for routine management after the migration.
3.3 Restore Plugins and Preferences Correctly
Third-party plugins and many application preferences are stored outside the library. This explains why a manually copied library can contain every book while calibre looks or behaves like a fresh installation.
If the old computer is still available, perform an Export all calibre data operation and import it on the new computer. This is safer than manually combining configuration folders from different operating systems.
After import, open Preferences and check:
- Plugins under the advanced preferences
- Conversion defaults and preferred output format
- Metadata download sources
- Device-specific settings
- Email delivery accounts and recipient addresses
- Scheduled news downloads
- Content server settings
- Toolbar and menu customization
Passwords, operating-system credentials, firewall approvals, or keychain-dependent information may still require confirmation on the new computer. Test only the features you use.
3.4 Correct Paths That Belong to the Old Computer
A Windows path cannot be reused literally on macOS or Linux. Even a Windows-to-Windows move may involve a different username, drive letter, or external disk assignment. Review settings that reference folders or files outside the library, including save-to-disk destinations, automatic-add folders, news recipe files, temporary working folders, and plugin-specific paths.
If books open correctly but an automated task fails, look for an old absolute path in that task's settings. Replace it with a valid destination on the new computer. Success means the task completes without affecting the main library.
3.5 Check Services Separately
The Content server, email delivery, metadata downloads, news downloads, device transfers, conversion, and the viewer are separate functions. A successful library migration does not guarantee that the operating system will allow every service immediately.
For example, if books and covers are present but the Content server cannot be reached, do not copy the library again. Check the server setting, firewall permission, listening port, network profile, and address used by the other device.

4. Check Operating System and Storage Problems
A complete library can still appear broken if calibre cannot read or write its new location. Permissions, cloud placeholders, antivirus controls, path length, removable drives, and network filesystems are common causes.
4.1 Prefer a Local Folder for the Working Library
Keep the active calibre library on a local disk controlled by one computer. Network shares and NAS locations can lack filesystem behavior calibre expects, and opening the same library from two computers can cause conflicts.
If you transferred the library through a NAS or shared folder, copy it from there to a local folder before selecting it in calibre. Success means calibre can open books, edit metadata, and retain a small test change after restarting.
4.2 Avoid Cloud Sync Conflicts During Migration
Cloud storage can be useful for transferring or backing up a closed copy, but it can complicate a live migration. Files may exist as online-only placeholders, synchronization may still be running, or another computer may update the database at the same time.
Before opening a cloud-transferred library:
- Confirm that all files are downloaded locally
- Pause synchronization while making the first verification
- Make sure calibre is closed on the old computer
- Copy the synchronized library into a normal local folder if possible
- Do not open the same active library simultaneously on multiple computers
Success means the book count remains stable, covers load without waiting for downloads, and metadata changes survive a calibre restart. At that point, stop moving the folder and decide on a separate backup strategy.
4.3 Check Folder Permissions
calibre needs permission to read and write its library. A copied folder may be read-only, owned by another Linux account, blocked by macOS privacy controls, or protected by Windows security software.
Try editing the metadata of one test book by adding a temporary tag, save the change, close calibre, and reopen it. If the tag disappears or calibre reports a permission error, correct the ownership or access rights for the library folder. Do not solve this by deleting metadata.db.
On a managed work computer, ask the administrator to permit calibre and its library location rather than disabling security controls globally.
4.4 Inspect Antivirus and Controlled Folder Access
If calibre can read books but fails when editing metadata, adding books, or converting formats, security software may be preventing writes to the library or temporary folder. Review the security product's event history for a block involving calibre.
Allow the installed calibre application and use a normal user-writable library folder. Avoid broad exclusions for an entire drive unless your security administrator recommends them. Success means a small metadata change and a test conversion both complete normally.
4.5 Check External Drives and Changed Drive Letters
When a library lives on removable storage, Windows may assign a different drive letter on the new computer. macOS and Linux may also mount the disk under a different path. Use Switch/create library to select the library at its current location instead of trying to recreate the old path.
Make sure the drive uses a filesystem that the new operating system can write to, not merely read. If write support is uncertain, move the library to an internal local disk before testing.
5. Use Logs and Focused Diagnostics When Needed
Most migrations do not require command-line tools. Use diagnostics only when the library path, permissions, and transfer method look correct but a specific feature still fails.
5.1 Read Job Details First
If conversion, metadata download, news download, email delivery, or another background task fails, open calibre's Jobs area and view the failed job's details. Look for a missing path, permission denial, connection failure, unavailable executable, or plugin error.
Fix the first clear error and repeat the same small test. Do not simultaneously reinstall calibre, move the library, disable plugins, and change conversion settings because that makes the result difficult to interpret.
5.2 Restart calibre in Debug Mode
calibre provides a Restart in debug mode option through the Preferences button menu. Reproduce the problem once, close calibre, and inspect the generated debug information.
Debug mode is particularly useful when calibre itself starts incorrectly, a plugin fails to load, or an interface action produces an unexplained error. If the problem disappears after disabling one third-party plugin, leave that plugin disabled while checking its compatibility or support information.
5.3 Use calibre-debug Only for Persistent Problems
Advanced users can start the graphical interface from a terminal with calibre-debug -g. This can expose startup, plugin, path, and permission messages that are not obvious in the regular interface.
Use the command only after reproducing the issue with a copied test library or after preserving the old library. Save the output if you need to request support, but remove personal paths, email addresses, or account information before sharing it publicly.
5.4 Do Not Use Database Repair as a Routine Migration Step
Database restoration is intended for a genuinely damaged or missing metadata database, not for an ordinary move to a new computer. If the original library works on the old computer, assume the source database is healthy until evidence shows otherwise.
An empty display on the new computer is more likely to mean that calibre opened the wrong location or received an incomplete copy. Verify the path and copy first. Repairing a healthy library adds unnecessary risk and may obscure the real migration problem.
6. Run a Clean Temporary Test Before Reinstalling
If calibre is not working correctly after migration, test a small local copy before reinstalling the application or deleting anything.
6.1 Create a Controlled Test
- Close calibre on both computers.
- Make a separate copy of the migrated library, or create a small test library containing a few non-sensitive books.
- Place the test library in a short, local, user-writable path.
- Pause cloud synchronization for that test location.
- Open the test library through Switch/create library.
- Open a book, edit one tag, restart calibre, and confirm the tag remains.
- Run one conversion or other failing operation if relevant.
If the test library works, the calibre installation is probably functional. The original destination, permissions, synchronization tool, external drive, or path is the likely cause. If the clean test also fails, restart in debug mode and test without nonessential third-party plugins.
6.2 Reinstall Only After the Test
Reinstalling calibre generally does not fix a wrong library path, incomplete copy, cloud placeholder, or unwritable folder. It can also distract from the actual cause because the library and configuration are separate from the application itself.
If you do reinstall, keep the old computer, original library, export folder, and migrated copy untouched. Reinstall the application only, then point it to the verified library. Never delete the source library as part of reinstalling calibre.
6.3 Keep the Old Library Until Verification Is Complete
Do not erase, repurpose, or overwrite the old computer immediately. Keep the original library until you have completed several normal tasks on the new machine and have an independent backup.
A sensible verification includes matching book counts, checking multiple formats, opening representative books, confirming covers and custom metadata, reviewing plugins, connecting a reader if used, and testing the Content server or email delivery if those features matter to you.
Once the new installation has worked normally for several sessions and your backup is confirmed, you can retire the old copy according to your storage and privacy needs.
7. Quick Fix Checklist
- Record the old library path and book count before moving anything
- Use Export/import all calibre data when plugins and preferences must transfer
- Disconnect reading devices if the export and import option is unavailable
- For a manual move, copy the entire library folder and every subfolder
- Confirm that
metadata.dbexists at the copied library's top level - Use Switch/create library to select the existing folder on the new computer
- Do not expect Windows, macOS, and Linux paths to remain identical
- Keep the active library on a local, writable disk
- Ensure cloud files are fully downloaded before opening the library
- Do not run calibre against the same library from two computers
- Compare book counts, covers, tags, custom columns, and formats
- Test one metadata edit and restart calibre to confirm write access
- Check plugins and preferences separately from books and metadata
- Use job details or debug mode only for a reproducible failure
- Keep the old library unchanged until the new installation is verified
8. Frequently Asked Questions
8.1 Does Copying the calibre Library Folder Include Metadata and Covers?
Yes, if you copy the complete library folder. Its database and managed subfolders contain the library records, book formats, covers, tags, series information, and custom columns. Copying only the visible e-book files will not reproduce the complete library.
8.2 Why Are My Books Present but My Plugins and Preferences Missing?
The library and calibre's application configuration are separate. A manual library-folder copy transfers the books and library metadata, but it may not transfer plugins and preferences. Use Export/import all calibre data from the old installation to migrate those items together.
8.3 Why Does calibre Show an Empty Library on the New Computer?
calibre is probably opening a new default library or the wrong folder. Use Switch/create library and select the copied folder containing metadata.db. If the database file is absent, the copy may be incomplete or you may be looking at the wrong directory.
8.4 Can I Move a calibre Library From Windows to macOS or Linux?
Yes. Choose a valid local destination on the new operating system and attach the copied library or import the exported data there. Do not attempt to preserve a Windows drive-letter path on macOS or Linux. Review any external paths saved in plugins, automatic-add settings, or other tasks.
8.5 Can I Keep My Active calibre Library in a Cloud Drive?
A cloud drive can introduce synchronization conflicts, online-only placeholders, and incomplete file availability. For the safest operation, keep the working library in a local folder and back it up separately. If cloud storage is involved in the transfer, ensure every file is local and synchronization is paused during initial verification.
8.6 When Is the Move Finished?
The migration is complete when the new computer shows the expected book count, representative books open, covers and formats are present, metadata survives a restart, and the plugins or services you use function normally. At that point, stop changing settings, create a fresh backup, and retain the old library until you are comfortable that the new setup is stable.