FolioReader/FolioReaderKit — Gitpedia

FolioReader logo
FolioReaderKit is an ePub reader and parser framework for iOS written in Swift.

Version
License

Features

Who is using it?

On AppSight you can see apps that are using it in production.

Demo

Custom Fonts :smirk:	Text Highlighting :heart_eyes:

Reading Time Left :open_mouth:	Media Overlays 😭

Installation

FolioReaderKit is available through CocoaPods and Carthage.

Cocoapods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

bash
$ gem install cocoapods

To integrate FolioReaderKit into your Xcode project using CocoaPods, specify it in your Podfile:

ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'FolioReaderKit'
end

Then, run the following command:

bash
$ pod install

Alternatively to give it a test run, run the command:

bash
$ pod try FolioReaderKit

Carthage

Add the following to your Cartfile

ruby
github "FolioReader/FolioReaderKit"

Run the following command:

bash
$ carthage update --platform iOS --no-use-binaries

Then, follow the steps as described in Carthage's README.

Requirements

iOS 9.0+
Xcode 10.1+

Basic Usage

To get started, this is a simple usage sample of using the integrated view controller.

swift
import FolioReaderKit

func open(sender: AnyObject) {
    let config = FolioReaderConfig()
    let bookPath = Bundle.main.path(forResource: "book", ofType: "epub")
    let folioReader = FolioReader()
    folioReader.presentReader(parentViewController: self, withEpubPath: bookPath!, andConfig: config)
}

For more usage examples check the Example folder.

Storyboard

To get started, here is a simple example how to use the integrated view controller with storyboards.

swift
import FolioReaderKit

class StoryboardFolioReaderContrainer: FolioReaderContainer {
    required init?(coder aDecoder: NSCoder) {
        super.init(coder: aDecoder)
        
        let config = FolioReaderConfig()
        config.scrollDirection = .horizontalWithVerticalContent
        
        guard let bookPath = Bundle.main.path(forResource: "The Silver Chair", ofType: "epub") else { return }
        setupConfig(config, epubPath: bookPath)
    }
}

Go to your storyboard file, choose or create the view controller that should present the epub reader. In the identity inspector set StoryboardFolioReaderContrainer as class.