Search packages, repositories and app categories

Package detailsv2.1.0

epub

Epub Parser for Dart. Suitable for use on the Server, the Web, or in Flutter

30-day downloads
352
Likes
54
Pub points
35

Install package

flutter pub add epub

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The epub package is a Dart library for parsing and reading EPUB files, designed to work across server, web, and Flutter environments. It enables developers to extract content, metadata, and structure from EPUB documents programmatically. The package supports standard EPUB formats and provides access to chapters, images, and styling information. Ideal for applications requiring e-book processing, such as readers, converters, or content management systems.

Use cases

  • Reading EPUB files in Flutter apps
  • Parsing e-books on the server
  • Converting EPUB content to other formats
  • Building e-reader applications
  • Extracting metadata from e-books

Key features

  • Supports standard EPUB format
  • Cross-platform compatibility
  • Extracts chapters, images, and metadata
  • Lightweight and efficient
  • Open-source with active maintenance

Suitable for

  • Flutter mobile apps needing e-book support
  • Server-side e-book processing
  • Web-based e-reader tools
  • Content aggregation platforms
  • Educational or publishing software

Considerations

  • Limited to EPUB parsing (no writing)
  • Requires valid EPUB files
  • No built-in rendering engine
  • Depends on external dependencies for display
  • Not optimized for very large EPUBs

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

dart-epub

Build Status

Epub Reader and Writer for Dart inspired by this fantastic C# Epub Reader

This does not rely on the dart:io package in any way, so it is avilable for both desktop and web-based implementations

Installing

Add the package to the dependencies section of your pubspec.yaml

dependencies:
  epub: ^2.0.0

Example


//Get the epub into memory somehow
String fileName = "hittelOnGoldMines.epub";
String fullPath = path.join(io.Directory.current.path, fileName);
var targetFile = new io.File(fullPath);
List<int> bytes = await targetFile.readAsBytes();


// Opens a book and reads all of its content into memory
EpubBook epubBook = await EpubReader.readBook(bytes);
            
// COMMON PROPERTIES

// Book's title
String title = epubBook.Title;

// Book's authors (comma separated list)
String author = epubBook.Author;

// Book's authors (list of authors names)
List<String> authors = epubBook.AuthorList;

// Book's cover image (null if there is no cover)
Image coverImage = epubBook.CoverImage;

            
// CHAPTERS

// Enumerating chapters
epubBook.Chapters.forEach((EpubChapter chapter) {
  // Title of chapter
  String chapterTitle = chapter.Title;
              
  // HTML content of current chapter
  String chapterHtmlContent = chapter.HtmlContent;

  // Nested chapters
  List<EpubChapter> subChapters = chapter.SubChapters;
});

            
// CONTENT

// Book's content (HTML files, stlylesheets, images, fonts, etc.)
EpubContent bookContent = epubBook.Content;

            
// IMAGES

// All images in the book (file name is the key)
Map<String, EpubByteContentFile> images = bookContent.Images;

EpubByteContentFile firstImage = images.values.first;

// Content type (e.g. EpubContentType.IMAGE_JPEG, EpubContentType.IMAGE_PNG)
EpubContentType contentType = firstImage.ContentType;

// MIME type (e.g. "image/jpeg", "image/png")
String mimeContentType = firstImage.ContentMimeType;

// HTML & CSS

// All XHTML files in the book (file name is the key)
Map<String, EpubTextContentFile> htmlFiles = bookContent.Html;

// All CSS files in the book (file name is the key)
Map<String, EpubTextContentFile> cssFiles = bookContent.Css;

// Entire HTML content of the book
htmlFiles.values.forEach((EpubTextContentFile htmlFile) {
  String htmlContent = htmlFile.Content;
});

// All CSS content in the book
cssFiles.values.forEach((EpubTextContentFile cssFile){
  String cssContent = cssFile.Content;
});


// OTHER CONTENT

// All fonts in the book (file name is the key)
Map<String, EpubByteContentFile> fonts = bookContent.Fonts;

// All files in the book (including HTML, CSS, images, fonts, and other types of files)
Map<String, EpubContentFile> allFiles = bookContent.AllFiles;


// ACCESSING RAW SCHEMA INFORMATION

// EPUB OPF data
EpubPackage package = epubBook.Schema.Package;

// Enumerating book's contributors
package.Metadata.Contributors.forEach((EpubMetadataContributor contributor){
  String contributorName = contributor.Contributor;
  String contributorRole = contributor.Role;
});

// EPUB NCX data
EpubNavigation navigation = epubBook.Schema.Navigation;

// Enumerating NCX metadata
navigation.Head.Metadata.forEach((EpubNavigationHeadMeta meta){
  String metadataItemName = meta.Name;
  String metadataItemContent = meta.Content;
});

// Writing Data
var written = await EpubWriter.writeBook(epubBook);

// You can even re-read the book into a new object! 
var bookRoundTrip = await EpubReader.readBook(written);

Categories

Dependencies

Dependency list 6 items

Source repository

Projects using this package

No data available yet.