Introduction

Kavita Import Tool

icon

Description

Kavita Import Tool allows users to import a variety of eBook, manga, and image files and export them into the correct folder structure for Kavita. When multiple files are imported with the same name, the program picks the best format or the format selected by the user.

The tool currently supports simple file name-based structures like the one below. If you have a different structure you would like to see supported, please create an issue with the details.

Example folder structure:

kavita-import-tool-output-[epoch time]
  ┖── LearningAssemblyLanguage
        ┖── LearningAssemblyLanguage.epub 
      RustForTypeScriptDevelopers
          ┖── RustForTypeScriptDevelopers.pdf
      DesigningMultimediaPipelinesWithGStreamer
          ┖── DesigningMultimediaPipelinesWithGStreamer.cbz

Installation

Read the Quickstart Guide for a step-by-step guide on how to use the program.

TL;DR:

  • Download the latest release from the releases page for your operating system
  • Install the program (not currently signed, so you may need to allow the installation)

Features / Roadmap

  • Import EPUB files
  • Import PDF files
  • Support for all file types supported by Kavita
  • Select file based on a ranked list of formats
  • Allow users to select the preferred format to use
  • Export directly into the selected output folder or into a container folder for manual import
  • Drag and drop or select files to import
  • Automatic updates
  • Support for episodic and series-based content following the Kavita format
  • Your feature idea here! Create an issue to suggest a feature

Development Setup

  • Clone the repository
  • Ensure Rust and cargo are installed and setup
  • Run npm install to install dependencies
  • Install Rust dependencies by running cargo build
  • Run npm run tauri dev to start the development server and open the program in a window

Disclaimer

Read the disclaimer here

Kavita Import Tool is a project by Mackenly Jones
Sponsor or donate to this project via GitHub Sponsors @mackenly