calibre KEPUB Conversion Not Working: How to Fix It

When calibre KEPUB conversion is not working, the visible symptom can be misleading. The problem may be a failed conversion, but it may also be an incorrect Kobo driver setting, a damaged source EPUB, a transfer that sent ordinary EPUB instead, a metadata expectation that Kobo does not support, or a book that has not yet been imported by the device after disconnection. The fastest solution is to separate conversion, transfer, and Kobo behavior into individual tests rather than changing several settings at once.

Modern calibre releases include native KEPUB handling and can convert an EPUB to KEPUB while sending it to a Kobo. That means the calibre library may continue to show only an EPUB even though the copy delivered to the device is KEPUB. Use the steps below to determine which part of that workflow is failing and stop as soon as the expected result appears.

1. Confirm the Symptom With a Small Safe Test

Begin with one ordinary, DRM-free EPUB that opens correctly in calibre's viewer. A simple public-domain EPUB or another known-good file is ideal. Do not start with a large textbook, comic, fixed-layout title, unusually formatted document, or file downloaded through a retailer application. Those sources introduce extra variables.

1.1 Identify What Is Actually Not Working

Before making changes, classify the problem into one of these categories:

• KEPUB is not offered as an output format in the conversion dialog.
• The conversion job fails and produces an error.
• Conversion succeeds, but only EPUB appears in the library.
• The book transfers, but Kobo treats it like an ordinary EPUB.
• The book does not appear on Kobo after transfer.
• The book appears, but its title, author, series, cover, or collection is wrong.
• Reading statistics, page numbering, highlighting, or navigation do not behave as expected.

This distinction matters because calibre can create a permanent KEPUB library format through conversion, or it can generate KEPUB temporarily while sending an EPUB to a Kobo. In the second workflow, not seeing KEPUB beside EPUB in calibre is normal.

1.2 Run the Baseline Transfer

1. Add the known-good EPUB to a temporary calibre library or select it in your normal library.
2. Open it in the calibre viewer and confirm that chapters, text, and the table of contents work.
3. Connect the Kobo with a data-capable USB cable.
4. Wait until calibre displays the Device button.
5. Send the EPUB using the normal Send to device command.
6. Wait for all calibre jobs to finish.
7. Use calibre's Eject device command, then disconnect the cable.
8. Allow Kobo to finish importing and processing the book before opening it.

Success means the test book appears on Kobo, opens without an import error, and uses the expected Kobo reading interface. If this test succeeds, stop changing global settings. The original book or its individual conversion settings are the likely cause.

2. Check the Kobo and KEPUB Settings Directly

KEPUB troubleshooting should focus on the Kobo workflow rather than ordinary EPUB conversion. A successful EPUB-to-EPUB conversion proves that calibre can process the source, but it does not prove that the Kobo driver is configured to create or send KEPUB.

2.1 Check the Connected Kobo Driver

Connect the Kobo, wait for calibre to detect it, and open the device configuration from the Kobo or Device button. Look for the option controlling automatic EPUB-to-KEPUB conversion when books are sent. The exact arrangement can differ among calibre releases, but the setting belongs to the Kobo device driver rather than the general EPUB output panel.

Also review the driver's supported-format order. If ordinary EPUB is preferred ahead of KEPUB, calibre may send an existing EPUB without creating the Kobo-specific form you expected. Do not randomly change every format or template option. Change only the EPUB-to-KEPUB or preferred-format setting, resend the single test book, and eject safely.

Success means the newly transferred test book is processed by Kobo and displays KEPUB-specific behavior. Once that happens, stop. There is no benefit in repeatedly converting the same book or changing unrelated conversion preferences.

2.2 Understand Permanent Conversion Versus Send-Time Conversion

A permanent conversion adds a KEPUB format to the calibre book record. Send-time conversion leaves the source EPUB in the library and creates the device copy during transfer. Both approaches can work.

• Use send-time conversion when you want to keep a clean EPUB master and primarily read on Kobo.
• Use permanent KEPUB conversion when you need to inspect, export, test, or retain the generated KEPUB file.
• Do not assume failure merely because the library's Formats field still says EPUB after a successful send-time conversion.

On the device, a KEPUB may use a Kobo-oriented filename such as one ending in .kepub.epub. Renaming a normal EPUB to that extension is not a reliable conversion method because KEPUB processing involves changes inside the book, not just a filename change.

2.3 Check the Output Profile Without Overestimating It

The conversion output profile can influence screen-size assumptions and image handling. Choose a Kobo profile appropriate for the device when one is available, or use a profile with similar screen characteristics. However, the profile alone does not activate KEPUB transfer. If the Kobo driver is sending ordinary EPUB, changing the output profile will not solve that format-selection problem.

Success means images and page layout are appropriate for the screen without unexpected shrinking or cropping. If the format is still EPUB, return to the device driver's format and send settings.

2.4 Check for Old or Conflicting Kobo Plugins

Plugins are relevant when an older setup used KoboTouchExtended, KePub Output, or related Kobo extensions. Current calibre releases have native KEPUB capabilities, so an old plugin is not automatically required. A stale plugin can also conflict with the built-in Kobo driver or preserve outdated settings.

Open Preferences, then Plugins, and search for Kobo or KePub. Record what is installed before changing anything. If the problem started after a calibre update, temporarily disable the third-party Kobo extension, restart calibre, and repeat the baseline test with the built-in driver. Do not remove several plugins simultaneously.

Success means the Kobo is detected and the standard EPUB transfers as KEPUB with the third-party extension disabled. In that case, leave the conflicting plugin disabled unless you need a specific feature that the built-in driver does not provide.

3. Separate Format Problems From Metadata and Kobo Behavior

A book can be a valid KEPUB while still showing unexpected metadata or statistics. Format conversion, embedded metadata, calibre's library database, Kobo's local database, and Kobo account services are separate systems.

3.1 Correct Metadata Before Resending

Select the book and open Edit metadata. Verify the title, author, author sort, series, series number, language, identifiers, and cover. Then resend the book while the Kobo is connected. If an older copy already exists on the device, remove that copy through calibre first, eject safely, let Kobo update its library, reconnect, and send the corrected copy.

Simply editing calibre's database does not always update a file already present on the device. Kobo may also retain information from its local database until the book is removed, resent, and re-imported.

Success means the title and author appear correctly after import. Series or collection information may require the device to complete its first import before a later connection lets calibre update database-backed information. If core metadata is correct, avoid repeated conversions because conversion is not the same as refreshing Kobo's database.

3.2 Set Realistic Reading Statistics Expectations

KEPUB uses Kobo's Kobo-specific reading engine and can provide behavior that differs from ordinary sideloaded EPUB, including Kobo-style page or chapter presentation and other reading interface features. It does not automatically transform a sideloaded book into a Kobo Store purchase.

Local reading statistics, annotations, progress, and page calculations can depend on the Kobo firmware, book structure, transfer method, and optional synchronization tools. Account-based synchronization across Kobo devices or applications should not be assumed for independently sideloaded books. If the title opens in the Kobo reading engine and local progress is retained after closing and reopening it, the KEPUB transfer itself is probably working.

3.3 Check the Viewer and Editor Separately

If the book looks wrong in calibre's viewer, test the original EPUB and generated KEPUB separately. Right-click the View button when necessary to select a specific format. If the EPUB is already broken, KEPUB conversion is unlikely to repair it.

Use Edit book and run its book-checking tools on a copy if chapters are missing, links fail, or the table of contents is empty. Fixing malformed HTML, duplicate identifiers, missing resources, or broken navigation in the source EPUB is safer than applying many speculative conversion options.

Success means the source EPUB opens correctly and the generated KEPUB preserves its chapters, navigation, images, and readable text. Once both pass, remaining differences are likely Kobo rendering behavior rather than conversion failure.

4. Check USB, Permissions, Storage, and Source Quality

4.1 Verify USB Detection and Safe Ejection

A charging cable is not necessarily a data cable. If calibre does not show the Device button, try a known data-capable cable, a direct computer USB port, and another port if available. Avoid unpowered hubs while testing. On the Kobo, accept the computer connection prompt when it appears.

Close other software that may be accessing the Kobo storage. File managers, synchronization utilities, backup tools, and security software can hold files open or delay writes. Wait for calibre's jobs indicator to reach zero, eject through calibre, and then use the operating system's eject function if it still shows the device.

Success means Kobo displays its processing or importing message after disconnection and the book appears afterward. If you open the device library before processing finishes, a correctly transferred book may look missing.

4.2 Protect the calibre Library From Cloud-Sync Conflicts

Do not actively synchronize a live calibre library database through a cloud-storage client while calibre is writing to it. File locking, delayed synchronization, and conflict copies can cause missing formats or database inconsistencies. If the library is stored in a cloud-managed folder, pause synchronization during the test or copy one book into a new local temporary library.

Confirm that your user account can write to the calibre library folder and the configured temporary directory. On Windows, avoid forcing calibre to run as administrator as a routine fix because doing so can create ownership and drag-and-drop complications. On macOS and Linux, check folder ownership and permissions rather than granting broad system access unnecessarily.

Success means conversion completes in the local temporary library. That result points to permissions, synchronization, or the original library location rather than the Kobo format engine.

4.3 Test the Source EPUB

Source quality matters. An EPUB can open in one viewer while still containing malformed markup, invalid navigation, missing files, damaged images, or extreme CSS that causes conversion trouble. Add a different standard EPUB and attempt the same KEPUB workflow.

• If the standard EPUB works, repair or replace the original source.
• If every EPUB fails, investigate the driver, calibre configuration, permissions, or plugins.
• If conversion succeeds but only one title fails during Kobo import, simplify or validate that title.

Do not attempt to process books protected by DRM or retailer access controls. Use an authorized, DRM-free source that calibre can legally read and convert.

4.4 Check Storage and Reader Limitations

Confirm that the Kobo has adequate free space. A nearly full device can accept a partial transfer but fail during later database processing. Very large image-heavy books, fixed-layout publications, and unusual EPUB features may also exceed what the device handles comfortably.

If a small text-based EPUB works but a large title does not, test a reduced copy or a repaired EPUB rather than resetting the Kobo. Success with the small file proves that the basic KEPUB and USB path is functioning.

5. Use calibre Logs to Find the Exact Failure

5.1 Read the Job Details First

Click calibre's Jobs indicator after the conversion or transfer finishes. Double-click the failed job to open its detailed log. Read from the bottom upward and locate the first meaningful error, not just the final message saying the job failed.

Useful clues include an unreadable input file, missing resource, permission denial, no space left, plugin initialization error, device disconnection, or failure to write the Kobo database. Copy the log before retrying so that evidence is not lost.

Success means the job ends without an exception and identifies the expected output or completed transfer. When the job succeeds but Kobo still does not show the book, focus on safe ejection, device processing, filenames, and Kobo's database.

5.2 Use Debug Device Detection

If calibre does not recognize the Kobo, open Preferences, choose Miscellaneous, and run Debug device detection with the device attached. The report can reveal whether the operating system sees the USB storage and whether calibre identifies a compatible driver.

If the operating system cannot see the device, fix the cable, port, connection mode, or operating system issue first. If the operating system sees it but calibre does not, temporarily disable conflicting device plugins and repeat the report.

5.3 Save Conversion Debug Output

For a reproducible conversion failure, open the conversion dialog and enable debug output to an empty folder. calibre can save intermediate stages of its conversion pipeline, allowing you to see whether damage appears during input parsing, structure processing, CSS processing, or final output.

Nontechnical users do not need to inspect every file. First compare whether the content exists in the input and processed folders. If a chapter is absent at the input stage, the source reader or input parser is the issue. If it exists until the final stage, the output step deserves attention.

5.4 Use calibre-debug Only When Necessary

Advanced users can run calibre's command-line debugging tools. The calibre-debug --kepubify function converts an EPUB to KEPUB without a full conversion and follows the same general process used by the Kobo driver during sending. The graphical workflow should remain the first choice, but this command can isolate whether send-time KEPUB creation works independently of USB transfer.

You can also launch the graphical interface in debug mode and capture startup or plugin errors. Stop once the logs identify the failing component. Debug commands are diagnostic tools, not a reason to delete the library or reset the reader.

6. Run a Clean Temporary Test Before Reinstalling

Reinstallation rarely fixes a damaged book, conflicting plugin setting, inaccessible library folder, or bad USB cable. A clean test provides stronger evidence with less risk.

1. Create a new empty calibre library in a normal local folder.
2. Add one known-good, DRM-free EPUB.
3. Leave conversion options at their defaults.
4. Disable only third-party Kobo conversion or device plugins for the test.
5. Restart calibre.
6. Connect the Kobo and verify detection.
7. Enable the built-in Kobo driver's EPUB-to-KEPUB send option if needed.
8. Send the single book and wait for jobs to finish.
9. Eject safely and let Kobo complete its import.

If this works, calibre itself does not need reinstalling. Compare the temporary library with the original setup, especially plugins, library location, per-book conversion settings, and source quality. Restore or change one item at a time.

If the clean test fails, save the job log and device-detection output. At that point, checking for a supported calibre update, reporting a reproducible issue, or testing another cable and computer is more useful than deleting the main library.

7. Quick Fix Checklist

• Test one known-good, DRM-free EPUB before troubleshooting the original title.
• Confirm whether you expect permanent KEPUB output or send-time conversion.
• Check the connected Kobo driver's EPUB-to-KEPUB and preferred-format settings.
• Do not mistake an EPUB-only library record for failed send-time conversion.
• Temporarily disable an old KoboTouchExtended or KEPUB plugin if conflicts are suspected.
• Correct metadata before sending, then remove and resend stale device copies.
• Wait for every calibre job to finish before ejecting.
• Use a data-capable USB cable and a direct computer port.
• Let Kobo finish processing books after safe ejection.
• Test from a local temporary library if cloud sync or permissions may interfere.
• Read the detailed job log before changing more settings.
• Use Debug device detection when the Kobo is not recognized.
• Use conversion debug output when one source file repeatedly fails.
• Stop changing settings as soon as the standard EPUB works correctly.

8. Frequently Asked Questions

8.1 Why Does calibre Still Show EPUB After Sending KEPUB to Kobo?

The Kobo driver can create KEPUB during transfer without adding a permanent KEPUB format to the calibre library. In that workflow, EPUB remains your library master while the device receives the Kobo-optimized copy. This is normal if the book behaves as KEPUB on the reader.

8.2 Do I Still Need KoboTouchExtended or KePub Output?

Not necessarily. Current calibre releases have built-in KEPUB support, including send-time conversion for Kobo devices. Third-party plugins may still provide specialized workflows, but they should be installed only when you need their specific features. If calibre KEPUB conversion stops working after an update, test the built-in driver with older Kobo plugins disabled.

8.3 Why Does the Book Open as an Ordinary EPUB on Kobo?

The device driver may be prioritizing EPUB, automatic KEPUB creation may be disabled, or an existing EPUB copy may remain on the device. Check the Kobo driver configuration, remove the old device copy through calibre, resend the test title, eject safely, and wait for Kobo to re-import it.

8.4 Will KEPUB Make Sideloaded Reading Statistics Sync With My Kobo Account?

KEPUB enables Kobo-specific local rendering behavior, but it does not make a sideloaded title equivalent to a Kobo Store purchase. Local progress and statistics may work, while account-based or cross-device synchronization may remain unavailable or differ by device software and workflow.

8.5 Why Is the Metadata Still Wrong After I Edited It?

Editing calibre's library record does not guarantee that an existing device copy is immediately rewritten. Remove the stale Kobo copy, eject and let the device update, reconnect, and resend the corrected book. Some database-backed information may not settle until Kobo has imported the title and calibre connects again.

8.6 Should I Reinstall calibre or Reset My Kobo?

Not as a first step. Test a standard EPUB in a new local library, inspect the job log, disable only relevant third-party plugins, and check USB detection first. Reinstalling does not normally repair malformed source files or library permissions, while a Kobo reset can erase local content and reading data without addressing the underlying conversion problem.