Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexadam/save-as-ebook
Save a web page/selection as an eBook (.epub format) - a Chrome/Firefox/Opera Web Extension
https://github.com/alexadam/save-as-ebook
ebook ebooks epub epub-format productivity webextension webextensions
Last synced: 8 days ago
JSON representation
Save a web page/selection as an eBook (.epub format) - a Chrome/Firefox/Opera Web Extension
- Host: GitHub
- URL: https://github.com/alexadam/save-as-ebook
- Owner: alexadam
- License: mit
- Created: 2016-07-14T12:11:19.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-02-26T12:47:38.000Z (over 2 years ago)
- Last Synced: 2024-08-02T15:53:51.705Z (3 months ago)
- Topics: ebook, ebooks, epub, epub-format, productivity, webextension, webextensions
- Language: JavaScript
- Homepage:
- Size: 4.33 MB
- Stars: 1,098
- Watchers: 30
- Forks: 70
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# save-as-ebook
Save a web page/selection as an eBook (.epub format) - a Chrome/Firefox/Opera Web Extension
## How to install it
### From [Chrome Web Store](https://chrome.google.com/webstore/detail/save-as-ebook/haaplkpoiimngbppjihnegfmpejdnffj)
or manually (tested on v. 52.0.2743.116)
```
1. Navigate to chrome://extensions/
2. Load unpacked extension ...
3. Select the extension's directory
```
### From [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/saveasebook/)
or manually (tested on v. 50.0a2)
```
1. Navigate to about:debugging
2. Load temporary add-on ...
3. Select the extension's directory
```
### Opera (tested on v. 39.0.2256.48)
```
1. Navigate to opera:extensions
2. Load unpacked extension ...
3. Select the extension's directory
```
## Convert .epub to .mobi
```
sudo apt-get install calibre
ebook-convert "book.epub" "book.mobi"
```
## Default Keyboard Shortcuts
**NOTE** These shortcuts are not fixed and the browser will assign a different shortcut if the default one is taken
| Shortcut | Description |
| --- | --- |
| Alt + Shift + 1 | Save current page as eBook |
| Alt + Shift + 2 | Save current selection as eBook |
| Alt + Shift + 3 | Add current page as chapter |
| Alt + Shift + 4 | Add current selection as chapter |
## How to change the default Shortcuts
in Chrome:
```
1. Navigate to chrome://extensions/
2. Scroll down
3. Click on Keyboard shortcuts
```
## Added in 1.4.2
- Added MIME type to the generated .epub file
## Added in 1.4.1
- Remove unnecessary permissions
- Detect image type if the URL doesn't have a file extension (jpg, gif, png)
- Reset the Busy indicator on errors
- Remove hidden elements when style is not included
- Replace iframes with divs
## Added in 1.4
- Smaller ebook file size
- Fix for #37 - custom styles not applied
- Fix for #36 - br tag missing from pre blocks
- Fix for #31 - hanging in Busy state
- Other misc bug fixes
## Added in v1.3.4
- Fix for MathML - the rendered expression is too large (Issue #26)
- Add translation in Russian (thanks to @ Emil Khalikov) & Brazilian Portuguese (thanks to @welksonramos)
## Added in v1.3
- Keyboard shortcuts
- Simplified tool bar menu
- Misc bug fixes
## Added in v1.2.2
- fixed & & issue in title; Issue # 10
## Added in v1.2.1
- support for hr/br html tags
## Added in v1.2
- BETA: Support for CSS
- BETA: Create / edit custom Styles
- No errors from EPUB Validator (http://validator.idpf.org/) + this should fix the Google Play upload issue
## Added in v1.1
- Chapter Editor: option to save changes
- Chapter Editor: option to remove all chapters
- persist Chapter Editor changes & chapters after generating an eBook or after a browser restart
## To-Do
- make the Custom Style Editor more user friendly
- support backup / restore for Custom Styles
- DONE fix all 'epubcheck' errors (https://github.com/IDPF/epubcheck)
- clean & optimize code
- create tests
- support other formats (mobi, pdf etc.)
- show confirmations (ui/ux)
- display errors (ui/ux)
- DONE support custom style
- add 'remove from ebook' right click menu action
## Run Tests (Work in progress...)
```
cd tests
yarn install # install puppeteer
node test/index.js # should start a chrome instance with Save as eBook loaded
# it will generate and save the ebook in ./tmp-downloads
....
```
## Credits
- http://ebooks.stackexchange.com/questions/1183/what-is-the-minimum-required-content-for-a-valid-epub
- https://github.com/blowsie/Pure-JavaScript-HTML5-Parser
- https://stuk.github.io/jszip/
- http://johnny.github.io/jquery-sortable/
- https://github.com/eligrey/FileSaver.js/
- https://www.iconfinder.com/icons/753890/book_books_education_library_study_icon#size=128
- Thanks to [pumpk0n](https://github.com/pumpk0n) and [Francois Bocquet](https://github.com/fbocquet) for helping me with the French translation