Search packages, repositories and app categories

Package detailsv3.0.0

vocsy_epub_viewer

vocsy_epub_viewer is an epub ebook reader that encapsulates the folioreader framework.

AndroidiOS
30-day downloads
86
Likes
98
Pub points
140

Install package

flutter pub add vocsy_epub_viewer

Package Overview

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

vocsy_epub_viewer is a Flutter package that provides an EPUB ebook reader by wrapping the folioreader framework. It enables seamless reading of EPUB files within Flutter applications on Android and iOS platforms. The package offers a clean, customizable interface for navigating through ebooks with features like page turning, text selection, and bookmarking. Designed for developers seeking to integrate EPUB support into their apps, it simplifies the process of handling EPUB content without requiring deep knowledge of underlying libraries.

Use cases

  • Reading EPUB books in Flutter apps
  • Integrating digital library features
  • Building educational or e-learning applications
  • Creating custom eBook readers
  • Embedding interactive textbooks

Key features

  • Built on folioreader framework
  • Supports Android and iOS
  • Customizable UI components
  • Page navigation and text selection
  • Bookmark and annotation support

Suitable for

  • Educational app developers
  • Digital publishing platforms
  • E-book application creators
  • Mobile learning tools
  • Content-rich Flutter applications

Considerations

  • Limited to EPUB format only
  • Depends on folioreader's stability
  • May require additional styling for UI consistency
  • No built-in search functionality
  • Requires manual handling of file paths for EPUBs

Original README

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

Vocsy Epub Viewer pub package

originally a fork of epub_kitty with few more features. i made this out of epub_kitty because the author was inactive(he isn't merging PRs or attending to issues) and i started having alot of issues with the plugin

vocsy_epub_viewer is an epub ebook reader that encapsulates the folioreader framework. It supports iOS and android.

Features

Name Android iOS
Reading Time Left / Pages left ✅ ✅
Last Read Locator ✅ ✅
Distraction Free Reading ✅ ❌
Load E-Pub from Asset ✅ ✅
Copy and Share Text ✅ ✅
Highlight Text ✅ ✅
Multiple Theme [Light / Dark] ✅ ❌
Support Multiple Device Language ✅ ✅
Change FontStyle ✅ ❌
Android 13 Supported ✅ ❌

ScreenShots

  • Light                  

  • Dark

              

Install

This plugin requires Swift to work on iOS. Also, the minimum deployment target is 9.0

platform :ios, '9.0'

Import into pubspec.yaml

dependencies:
  vocsy_epub_viewer: latest_version

NOTE Please add this to the release build type in your app build.gradle to avoid crashes on android release builds

minifyEnabled false
shrinkResources false

NOTE Add These Lines In manifest

  
  • 1
    <uses-permission android:name="android.permission.INTERNET" />
  • 2
   xmlns:tools="http://schemas.android.com/tools"
  • 3
   android:usesCleartextTraffic="true"
   android:requestLegacyExternalStorage="true"
   android:networkSecurityConfig="@xml/network_security_config"
  • 4
   android:exported="true"

NOTE android -> app -> src -> main -> res -> xml Inside xml Folder create xml file network_security_config.xml

Usage

VocsyEpub.setConfig(
           themeColor: Theme.of(context).primaryColor,
           identifier: "iosBook",
           scrollDirection: EpubScrollDirection.ALLDIRECTIONS,
           allowSharing: true,
           enableTts: true,
           nightMode: true,
       );

/**
 * @bookPath
 * @lastLocation (optional and only android)
 */
VocsyEpub.open(
          'bookPath',
           lastLocation: EpubLocator.fromJson({
	   "bookId": "2239",
	   "href": "/OEBPS/ch06.xhtml",
	   "created": 1539934158390,
	   "locations": {
		"cfi": "epubcfi(/0!/4/4[simple_book]/2/2/6)"
	          }
	    }), // first page will open up if the value is null
        );

// Get locator which you can save in your database

VocsyEpub.locatorStream.listen((locator) {
	print('LOCATOR: ${EpubLocator.fromJson(jsonDecode(locator))}');
	// convert locator from string to json and save to your database to be retrieved later
});

You can also load epub from your assets using EpubViewer.openAsset()

await VocsyEpub.openAsset('assets/3.epub',
lastLocation: EpubLocator.fromJson({
	"bookId": "2239",
	"href": "/OEBPS/ch06.xhtml",
	"created": 1539934158390,
	"locations": {
	"cfi": "epubcfi(/0!/4/4[simple_book]/2/2/6)"
	  }
	}), // first page will open up if the value is null
   );

// Get locator which you can save in your database

VocsyEpub.locatorStream.listen((locator) {
	print('LOCATOR: ${EpubLocator.fromJson(jsonDecode(locator))}');
	// convert locator from string to json and save to your database to be retrieved later
});

Check the Example for implementation

Issues

If you encounter any problems feel free to open an issue. If you feel the library is missing a feature, please raise a ticket on Github and I'll look into it. Pull request are also welcome.

For help getting started with Flutter, view the online documentation.

For help on editing plugin code, view the documentation.

Categories

Dependencies

Dependency list 2 items

Source repository

Projects using this package