calibre Book List Blank: How to Fix a Missing Library View

You open calibre and the main book list is blank, yet the library folder still contains author folders, title folders, covers, and e-book files. This usually does not mean your books have been erased. The most likely causes are a hidden search result, an active Virtual library, the wrong library being open, a changed library path, or a missing or damaged metadata.db file. Cloud synchronization, network storage, permissions, and interface customizations can also contribute. This guide focuses on the main calibre library list, not the separate list of books shown when a reader or phone is connected.

1. Confirm the Symptom With a Small Safe Test

Before repairing the database or reinstalling calibre, determine whether the books are missing from the library or merely hidden from the current view. Avoid moving folders, deleting files, or adding the existing book files again during this test.

1.1 Clear searches and view restrictions

Look at the search bar above the book list. If it contains text, delete the entire query and run the empty search. Depending on your interface configuration, you may also be able to clear the search through its adjacent button or menu.

Next, inspect the Virtual library control near the search bar. Select <None> or the option that returns to the full library. A Virtual library displays only books matching its rules. If none of the current books match, the list can appear completely empty even though the underlying library is intact.

Also clear any additional restriction, saved search, or Tag browser selection that may be limiting the results. A restriction and an ordinary search can operate together, making the cause less obvious.

Success looks like this: The expected books immediately reappear, the displayed book count increases, and you can select and open a known title. If that happens, stop troubleshooting. Do not restore the database or reinstall calibre because the library itself is working.

1.2 Add one disposable test book only when appropriate

If the current library appears to be genuinely empty, you can create or download a small, non-sensitive test document and add it to calibre. Use a file you are legally allowed to import, such as a simple TXT or EPUB document you created yourself.

• If the test book appears, calibre can write to the currently selected library.
• If the test book appears but the old collection does not, the wrong library is probably selected.
• If adding the test book produces an error, examine the path, permissions, storage availability, and error details.
• If the test book vanishes after restarting, cloud synchronization, path changes, or database access may be involved.

Remove the disposable title after testing if you do not need it. Do not use repeated imports as a recovery method because that can create duplicates and lose carefully maintained metadata.

2. Check Which calibre Library Is Open

A calibre library is more than a directory containing e-book files. Its top-level folder normally contains metadata.db, while individual books are arranged in author and title subfolders. The main list is generated from the database, not by scanning every EPUB, PDF, or other format each time calibre starts.

2.1 Use the Choose library menu

Open the menu associated with the calibre library icon in the toolbar. Depending on the interface and release, the relevant command may be presented as Switch/create library, Choose library, or through a quick-switch list. Inspect the registered libraries and select the one that should contain your collection.

If the correct location is not listed, choose the option to use an existing library at a new location. Browse to the top-level library folder, meaning the folder that directly contains metadata.db. Do not select an individual author folder or a folder containing only exported books.

Success looks like this: The library name or path changes, the expected book count appears, and familiar titles populate the main list. Stop at this point. There is no reason to rebuild a database that calibre can already read.

2.2 Find a library whose path changed

Library paths commonly change after moving to a new computer, restoring files, renaming a parent folder, reconnecting an external drive, or changing a Windows drive letter. On macOS and Linux, an external volume may also mount under a different location or fail to mount before calibre opens.

If you do not know where the old library is, search your storage for metadata.db. Multiple results can represent separate libraries, backups, test libraries, or stale copies. For each candidate, inspect its parent folder without changing anything. A likely real library contains metadata.db alongside many author folders.

Make a backup copy of the entire candidate folder before performing repairs. Then point calibre to the folder through its library selection command.

2.3 Distinguish the library list from the device list

When a supported phone, tablet, or e-reader is connected, calibre can show a separate device view. A blank device list involves USB mode, device detection, drivers, storage permissions, or reader limitations. That is not the problem covered here.

For this symptom, click the Library icon or switch back to the computer library view. If books appear there, the calibre library is healthy even if the connected device view remains empty.

3. Check Searches, Virtual Libraries, and Interface State

If the correct library is open and calibre reports a nonzero total but displays no rows, a view restriction is more likely than missing metadata.

3.1 Remove combined filters

Clear the search bar, return the Virtual library selection to <None>, and remove additional restrictions. Also deselect active entries in the Tag browser, such as an author, format, rating, series, or tag. Look for visual indicators showing that a search or restriction is active.

Virtual libraries are designed to show a subset of a normal library. They can also be configured to activate when a particular library opens. Therefore, restarting calibre may not clear the apparently blank view.

Success looks like this: Removing one restriction repopulates the list. Once you identify it, keep or edit the Virtual library as needed, but do not change the database.

3.2 Test whether a plugin or saved layout is interfering

A plugin is not the usual cause of a genuinely empty database, but an interface plugin, custom search action, or startup behavior could apply a restriction or affect the visible layout. If the blank list began immediately after installing or updating a plugin, disable that specific plugin temporarily and restart calibre.

Change one item at a time. If disabling the plugin restores the books, leave it disabled while checking its documentation or support channel. If nothing changes, re-enable it rather than accumulating unrelated configuration changes.

The e-book viewer, editor, conversion settings, news download settings, email accounts, and Content server normally do not control whether local library rows appear. Do not reset those features unless the failure occurs specifically inside them.

4. Inspect metadata.db and the Library Folder

The presence of EPUB or PDF files inside author folders does not guarantee that the current database contains records for them. calibre relies on metadata.db to build the main book list.

4.1 Check whether metadata.db exists

Close calibre before inspecting or copying the library. Open the top-level library folder in your operating system's file manager and look for metadata.db. Do not confuse it with per-book metadata.opf files found deeper inside title folders.

• If metadata.db exists, make a backup copy of the entire library before attempting maintenance.
• If it is missing, confirm that you are inspecting the correct top-level folder.
• If it has an unexpectedly recent creation date and the library is empty, calibre may have created a new database in the wrong location.
• If it cannot be read or copied, investigate permissions, synchronization, disk errors, or another process holding the file.

Do not manually edit the SQLite database unless you have specialist knowledge and a verified backup. Routine recovery should use calibre's built-in tools.

4.2 Restore a missing or damaged database

After backing up the complete library folder, open the affected library in calibre. Open the library menu and choose Library maintenance, followed by Restore database. calibre can rebuild metadata.db using metadata backups stored with individual books.

Database restoration is a recovery action, not the first response to every blank list. It may not reproduce every library-level setting. Saved searches, user categories, certain conversion settings, custom recipes, and similar database information may require separate restoration from a full backup.

Success looks like this: The restore completes, the main list contains the recovered titles, and several sampled books show the expected formats and metadata. Once the library opens consistently after a restart, stop making changes and create a fresh backup.

4.3 Restore the whole library from backup when necessary

A complete library backup should include metadata.db, all author and title folders, book formats, covers, and the per-book metadata files. If the live folder has extensive damage, restoring the entire known-good library is often safer than combining pieces from different dates.

1. Close calibre and any synchronization application using the library.
2. Preserve the damaged folder by renaming or copying it rather than deleting it.
3. Restore the complete backup into a local folder with sufficient free space.
4. Use the Choose library or Switch/create library command to open that restored folder.
5. Check the book count and sample several titles before removing any old copy.

A folder containing only exported EPUB or PDF files is not necessarily a full calibre backup. If no database or per-book metadata is available, the files may need to be imported into a new library, but that should be a last resort because some metadata and library organization may be lost.

5. Check Storage, Permissions, and Synchronization

5.1 Move the active library away from network storage

Do not keep an actively used calibre library on a NAS or ordinary network share. calibre expects filesystem behavior that network filesystems may not reliably provide, including suitable locking. Concurrent access from more than one calibre instance can also damage the library.

For a safe test, close calibre and copy the complete library to a local internal drive. Keep the original untouched. Open the local copy through the library menu and check whether the books appear.

Success looks like this: The local copy opens with the expected titles and remains stable after restarting calibre. Continue using a local active library. If other computers need access, consider calibre's Content server rather than opening the same database directly across the network.

5.2 Pause cloud synchronization safely

Cloud tools can leave files online-only, create conflicting database copies, rename folders, or synchronize the database while calibre is writing to it. Google Drive is specifically identified by calibre's documentation as incompatible with storing an active calibre library. Other sync arrangements still require caution.

Do not simply drag a partially synchronized folder elsewhere while files are still downloading. First close calibre, allow the sync client to finish, make every library file available locally, and copy the full folder to a non-synchronized local location. Then open that copy.

Never run calibre against one copy while a sync tool is simultaneously modifying the same library. If the local test works, preserve it as the authoritative copy before deciding how backups will be handled.

5.3 Verify permissions and removable storage

Confirm that your user account can read and write the library folder and metadata.db. On Windows, check whether security software, Controlled Folder Access, a changed drive letter, or an unavailable external disk is blocking the path. On macOS, verify access to external volumes and protected folders. On Linux, check the mount state, ownership, permissions, and whether the filesystem became read-only.

Do not weaken security protections permanently. If antivirus or endpoint protection reports that it blocked calibre, review the product's event history and create the narrowest appropriate exception only after confirming that you installed calibre from its official source.

A successful permission fix allows calibre to open the existing library, add a disposable test book, preserve it after restart, and complete a library check without access errors.

6. Use calibre Diagnostics When the Cause Is Unclear

6.1 Run library maintenance checks

After making a backup, use Library maintenance to check the library. This can identify inconsistencies such as missing formats, unexpected files, invalid folders, or database entries that no longer correspond to files.

Review the results before deleting or moving anything. Extra files do not automatically mean corruption, and a missing format entry is different from a completely blank list. The goal is to find evidence supporting a specific repair.

6.2 Start calibre in debug mode

If the correct library path and database are present but the interface remains blank, restart calibre in debug mode through its interface, if available. Reproduce the problem, close calibre, and review the generated log for database, permission, plugin, path, or filesystem errors.

Advanced users can start the graphical application from a terminal or command prompt with:

calibre-debug -g

Copy the output into a text file before seeking help. Remove personal paths, usernames, email addresses, or other sensitive details before posting a log publicly.

Device detection logs, conversion debug output, conversion job details, viewer logs, and Content server logs address different problems. They are not the right starting point when only the main local library list is blank.

6.3 Use command-line checks cautiously

Experienced users can use calibredb check_library against a backed-up library to inspect filesystem and database consistency. The command-line database restoration function can also rebuild a damaged database, but calibre warns that regeneration can lose some library-level information.

If you are uncomfortable with command-line tools, use the graphical Library maintenance options instead. A command is not inherently safer or more complete than the corresponding built-in action.

7. Run a Clean Temporary Test Before Reinstalling

Reinstalling calibre usually does not repair a blank book list because the application and the library are separate. A clean temporary test provides more useful evidence.

1. Close calibre and back up the affected library.
2. Create a new local folder outside cloud and network storage.
3. Use calibre's library menu to create a temporary library there.
4. Add one harmless test document.
5. Close and reopen calibre.
6. Confirm that the test title remains visible.

If the temporary library works, the calibre installation is broadly functional. Focus on the original path, database, restrictions, permissions, or synchronization setup. If the temporary local library also fails, disable recently added plugins, inspect debug output, and verify that security software is not interfering.

Do not delete the original library, reset every preference, or reinstall repeatedly. Preserve the evidence until you know whether the problem belongs to the application, its configuration, or one particular library.

8. Quick Fix Checklist

• Clear the search bar and any Tag browser selection.
• Set the Virtual library to <None>.
• Remove additional restrictions or saved-search filters.
• Switch from the device view back to the main Library view.
• Open the Choose library or Switch/create library menu.
• Select the folder that directly contains the correct metadata.db.
• Search the computer for metadata.db if the path changed.
• Confirm that external storage is mounted under the expected path.
• Back up the complete library before running maintenance.
• Use Library maintenance to restore a missing or damaged database.
• Test a complete local copy if the library is on cloud or network storage.
• Check permissions and security-software event logs for blocked access.
• Run a temporary local library test before reinstalling calibre.
• Stop as soon as the expected books reappear and remain after restart.

9. Frequently Asked Questions

9.1 Why is the calibre book list blank when the files are still in the folder?

The main list comes from metadata.db, not from a fresh scan of every e-book file. calibre may be opening a different library, the path may have changed, the database may be missing or damaged, or a search or Virtual library may be hiding every record.

9.2 Can I point calibre at the author folders to recover the library?

No. Point calibre at the top-level library folder containing metadata.db. Selecting an individual author or title folder will not open the complete library. If the database is damaged, use Restore database from Library maintenance after making a backup.

9.3 Should I import all the EPUB files again?

Not initially. Reimporting can create duplicates and may discard library metadata, identifiers, tags, series information, covers, or stored settings. First clear filters, choose the correct library, and attempt database restoration. Reimport files only when no usable library database or metadata backup remains.

9.4 Will reinstalling calibre restore my missing books?

Usually not. Reinstallation replaces application files, while your book list and metadata live in the library folder. Run a clean temporary library test first. Reinstall only when evidence indicates that the application installation itself is failing.

9.5 Is it safe to keep a calibre library in a cloud folder or NAS?

An active library should be kept on reliable local storage. Network filesystems may not provide the locking behavior calibre needs, and cloud applications can modify or conflict with the database. Use backups or carefully managed synchronization only while calibre is closed. For remote access, the Content server is generally a better fit than directly sharing the live library folder.

9.6 When should I stop troubleshooting?

Stop once the correct titles are visible, a known book opens, and the list remains correct after restarting calibre. Make a fresh full backup at that point. Continuing to restore databases, move folders, or reset settings after success creates unnecessary risk.