-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b1d36ba
commit 4eec20d
Showing
2 changed files
with
44 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,44 @@ | ||
# Page | ||
--- | ||
description: Flutter Package to parse EPUB files (EBooks), with support for Media Overlays! | ||
--- | ||
|
||
# 📑 EPUB Parser for Flutter 📑 | ||
|
||
![](https://codecov.io/gh/SofieTorch/epub\_decoder/graph/badge.svg?token=0D5LI5EWM6) ![](https://img.shields.io/pub/v/epub\_decoder?color=blue) | ||
|
||
{% hint style="info" %} | ||
If you found this package useful, star this repo and drop a like in pub.dev! 🌟 | ||
{% endhint %} | ||
|
||
### Features | ||
|
||
* ✅ Read EPUB from bytes | ||
* ✅ Read EPUB from dart:io file | ||
* ✅ List metadata: title, authors, language, etc. (with support for EPUB2) | ||
* ✅ List resources: audio, images, text, etc. | ||
* ✅ List sections (also commonly named "chapters") in default reading order | ||
* ✅ Get section audio (if exists) | ||
* ✅ Get text-audio synchronization info for each section | ||
* ✅ Get text segment given a time for each section | ||
|
||
#### Work in Progress | ||
|
||
* [ ] Direct getters for relevant attributes (such as title, authors, etc.) | ||
* [ ] Read navigation definition | ||
* [ ] Support for bindings | ||
|
||
### Getting started | ||
|
||
Install `epub_decoder` as a dependency. | ||
|
||
### Usage | ||
|
||
Start by instancing an Epub from an Epub file: | ||
|
||
```dart | ||
import 'package:epub_decoder/epub_decoder.dart'; | ||
// Creating an EPUB from an asset transformed to bytes | ||
final epubFile = await rootBundle.load('assets/example.epub'); | ||
final epub = Epub.fromBytes(epubFile.buffer.asUint8List()); | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,3 @@ | ||
# Table of contents | ||
|
||
* [Page](README.md) | ||
* [📑 EPUB Parser for Flutter 📑](README.md) |