Apps
Knowledge
People
Register
Login


-
- Content .- Fans (12) .- Knowledge Base  . 

Reader (ebook reader)

   1.0.4  

ownCloud Productivity

Score 70%
Reader (ebook reader)
zoom


Reader (ebook reader)
zoom


Reader (ebook reader)
zoom


Screenshots:  Link
Version Control:  Link
Minimum required   ownCloud 8.1
Maximum required   ownCloud 9.2
Downloads:  4450
Submitted:  Sep 29 2014
Updated:  Apr 9 2017

Description:

Reader is an ebook reader based on pure javascript renderers. It works for books formatted according to the following standards:

  • Epub

  • CBR and CBZ ('comics')

  • For Epub Reader uses the futurepress epub.js renderer to provide near-native looks, especially when used full-screen. Turn pages by pressing the left/right hand side of the screen/window or using the cursor keys (if you have those), use the sidebar to browse through chapters or bookmarks and add annotations.

    CBR and CBZ are supported using a custom renderer inspired by balaclark's work. As with Epub, books can be navigated using the keyboard as well as mouse or touch navigation. Reader generates a visual index of all pages, show in the sidebar (thumbnail generation can be disabled for low-memory and/or -speed devices). As CBx files are often of varying quality, a set of image enhancement filters are provided.

    Features

    Reader remembers the last-visited page in a book and returns to that page when the book is re-opened. As all settings are stored on the server these features are device-independent, ie. you can start reading on a mobile device, continue on a PC to finish the book on a tablet.

    Text-based formats

  • seamless full-screen mode supported on browsers which allow full user-control, ie. not on Apple)

  • single- and double-page viewing mode

  • user-configurable font and colour settings

  • night mode, toggled by clicking the book title/author on top of the viewer

  • full-text search with keyword highlighting

  • bookmarks (with automatic snippet generation)

  • annotations

  • keyboard and pointer/touch-based navigation


  • CBR/CBZ ('Comics')

  • seamless full-screen mode supported on browsers which allow full user-control, ie. not on Apple)

  • single- and double-page viewing mode

  • optional image enhancement filters

  • Left-to-right and right-to-left (manga) modes

  • visual index (thumbnail size user-configurable, can be disabled for low-memory or -cpu devices)

  • keyboard and pointer/touch-based navigation


  • Keyboard navigation

    Reader supports both pointer/touch-based as well as keyboard-based navigation. Pointer/touch based is mostly self-explanatory,


    left,
    page-up move to previous page; move to next page in RTL (manga) mode

    right,
    page-down,
    space move to next page; move to previous page in RTL (mange) mode

    home move to first page
    end move to last page
    s toggle side bar
    esc close sidebar
    f toggle full screen
    t toggle toolbar
    l CBR: toggle layout
    a EPUB: annotate
    b EPUB: bookmark
    r EPUB: reflow text when sidebar is open
    d EPUB: toggle day (custom colour) mode
    n EPUB: toggle night mode


    Defaults and Preferences

    Reader stores defaults - settings which are independent of fileId (ie. independent of the book currently open) - and preferences - fileId-dependent (ie. different for every book) - on the server. Defaults are not shared between renderers, ie. the CBR renderer does not share defaults with the EPUB renderer. Defaults and preferences are removed from the server when the associated book or user is deleted.

    Annotations and Bookmarks

    Reader supports annotations (notes linked to a given position in a book) and bookmarks (position markers with automatically generated text snippets). An automatically generated bookmark (called '__ CURSOR __', not visible in the bookmarks list) is used to keep track of the current reading position. Annotations and bookmark snippets can be edited or deleted in the sidebar.

    Screenshots

    Due to limitations imposed by this silly forum it is not possible to post more screenshots than the 3 listed on this page. If you want to see more of Reader please have a look at the Nextcloud app repository page for Reader:

    https://apps.nextcloud.com/apps/files_reader


    The Reader app is hosted on github: https://github.com/Yetangitu/owncloud-apps

    Current limitations

  • The futurepress epub renderer is rather picky when it comes to accepting malformed epub files. If your book does not show, this is likely to be the reason.

  • Compatibility with Internet Explorer is not guaranteed, the first version to even attempt to produce sensible results is 0.7.0. Please test and let me know whether it works.



  • Changelog:

    1.0.4
    Fixed:
  • #43, remove table aliases in hooks to avoid being bit by querybuilder/doctrine/MySQL incompatibility/idiosyncracy

  • #39, #41 and #42, NOTE: if you're on MySQL or MariaDB you might need to enable 4-byte support if this has not been done yet, otherwise you'll get a '1071 Specified key was too long' error on install. More information on this issue - which also occurs when trying to use Emoji characters in a NC/OC installation on a MySQL or MariaDB database - can be found here: https://docs.nextcloud.com/server/11/admin_manual/maintenance/mysql_4byte_support.html


  • 1.0.3
    Fixed:
  • #40, detect shared file OR folder and (try to) get fileId for such when applicable


  • 1.0.2
    Fixed:
  • #37, use getAppManager()->isInstalled('files_opds') instead of class_exists to avoid log spam


  • 1.0.1
    Fixed:
  • Reader now again works when OC is hosted in a subdirectory, this failed in 1.0.0...


  • 1.0.0
    New:
  • Reader now supports CBR/CBZ ('comics') files

  • Book position ('cursor') is saved on server and restored on next in‐ vocation

  • Default settings (independent of fileid) and file-specific settings are saved and restored

  • Bookmarks and annotations (notes) are saved and restored (bookmarks are a type of annotation).

  • Full-text search implemented.

  • Framework to support more file format renderers

  • hooks added to remove defaults, settings and annotations/bookmarks for deleted files or users


  • epubreader
  • night mode now works more reliably

  • new 'day mode', ie. user-defined colours

  • new font settings: font weight

  • column width user-configurable

  • new mode: maximize reader area, for small-screen devices

  • page turn arrows optional, hidden by default


  • cbreader
  • supports CBR (rar) and CBZ (zip) archives

  • single and double page (spread) mode, auto-adjusts to screen geometry

  • optional image enhancement filters

  • seamless full screen mode (where browser allows user full control of experience, ie. not on apple)


  • Fixed:
  • lots of stuff


  • 0.8.4
    Fixed:
  • #31: ReferenceError: cleanStartTextContent is not defined, caused by failure to declare local var in epub.js


  • 0.8.3
    Fixed:
  • Missing $title parameter in templates/reader.php caused warnings in log -> fixed.


  • 0.8.2
    Fixed:
  • Workaround implemented for incompatibility introduced by Nextcloud port. Nextcloud mandates the use of CSPv3 while Owncloud does not support this (for now), Reader now checks whether support is available and implements workaround if it is not.


  • 0.8.1
    0.8.0

    TEMPORARILY WITHDRAWN DUE TO INCOMPATIBILITY WITH OWNCLOUD due to the use of Nextcloud-specific functions
    Changed:
  • Sanitised info.xml for inclusion in Nextcloud app repository

  • LICENCE CHANGED FROM LGPL TO AGPL to enable inclusion in Nextcloud app repository (which only supports AGPL-licenced code)


  • 0.8
    New:
  • Updated futurepress epub.js library to 0.2.15

  • Compatible with Nextcloud [up to v12)

  • Change:
  • New logo


  • 0.7.2
    Change:
  • Raised maximum OC/NC version to 9.2


  • 0.7.1
    Change:
  • Add minimum supported version in info.xml to keep OC9.0 from complaining about this being an error in OC11...


  • 0.7.0
    New:
  • Updated futurepress epub.js library to 0.2.13

  • Experimental compatibility with Internet Explorer (using Wicked Good XPath: https://github.com/google/wicked-good-xpath) - please test


  • 0.6.1
    New:
  • Ported to Owncloud 8.1, does NOT work in 8.0 and lower.

  • Updated futurepress epub.js library to 0.2.8


  • 0.6.0
    New:
  • Ported to Owncloud 8, should work with OC7 as well - please test

  • Updated futurepress epub.js library to 0.2.5, relocated to /vendor directory to make updating easier


  • 0.5.0
    Changed:
  • Updated futurepress epub.js library to 0.2.3, using JSZip.


  • 0.4.6
    Fix:
  • Reader did not handle files with '+' in filename due do (double) url_decode (https://github.com/Yetangitu/owncloud-apps/issues/2), this now works. Please test with 'strange' filenames, it is possible that this fix breaks other files


  • 0.4.5
    Fix:
  • Added ocsid to appinfo/info.xml

  • Initial preparations for L10N (no translations available yet)

  • Reverted to tar.gz (instead of zip) for the distribution file


  • Distribution is now through a link to a github repo instead of a locally uploaded file.

    0.4.4
    Fix:
  • Earlier versions mangled some filenames due to overenthusiastic URL encoding, rendering these files inaccessible to Reader. This has been fixed.

  • Updated futurepress epub.js library to 0.2.2


  • 0.4.3
    Fix:
  • 0.4.2 did not work as intended on mobile/small-screen devices, this has been fixed.


  • 0.4.2 - withdrawn (caused problems on mobile)
    Fix:
  • Use private js namespace ('READER') for Reader to avoid collisions with other apps. An example of such a collision was the inability of Reader and ePubViewer to coexist peacefully, this now works as intended.


  • 0.4.1
    Fix:
  • Updated version number (was still at 0.3). No other changes.


  • 0.4
    New:
  • New option: disable extra wide page navigation area. While handy on touch-screen devices, the extra-wide page navigation area overlaps the content window and makes it impossible to select links in the overlapped area. When this option is enabled, the page navigation area is always outside of the content margins, making it possible to select links - but harder to turn pages on touch-screen devices. This option is disabled by default on touch-screen devices, enabled otherwise.


  • Fix:
  • The app info section contained the wrong name, this has been corrected.

  • Automatic app-store install did not work for some users, probably due to the fact that Reader was distributed as a gzipped tar file. This version is distributed as a zip file, maybe it works now?


  • 0.3.1
    Fix:
  • Bug related to iOS devices fixed


  • 0.3
    New:
  • Ignore book formatting by forcing your own font style and size. This can be configured and toggled in the Settings dialog.


  • Improved:
  • Night mode colours can now be configured in the Settings dialog. The static style sheet is no longer included.


  • Fixed:
  • The Settings dialog was unusable in the previous version due to a misconfigured style directive. This has been fixed.


  • 0.2
    New:
  • Night mode, toggle by clicking/pressing book title/author, colours are defined in css/night.css (just don't mess with the CSS selector ('.night *') if you want the thing to work as planned). Maybe this should be user-configurable from within reader? Maybe later.


  • Improved:
  • Free memory by explicitly destroying book context when the close button is pressed

  • Apple-specific markup to allow reader to work as a full-screen app. This works elsewhere without needing vendor-specific markup - IE6 is dead, long live Safari?


  • 0.1

    This is the first version. At the core of Reader lies the futurepress epub.js library (https://github.com/futurepress/epub.js) with some small modifications to fix some bugs and some additions to make it run on a wider spectrum of devices.

    It has been tested on Gecko-based browsers (Firefox and Seamonkey) on Linux and Android, Chromium on Linux and Android, Chrome on Android and Safari on iOS 7.

    The current version works on the latest (4.4) Android default browser, earlier Android versions lacked certain features needed to get it (or rather the embedded zip.js library) to work. For those earlier versions of Android the Chrome and Firefox browsers are good alternatives.




    LicenseAGPL
    All Versions
    Send to a friend
    Subscribe
    Other  Apps  from Yetanfou
    Report inappropriate content

    . . ..


    goto page: prev   1  2 

    -
    .

     Version 0.6.1 forces owncloud into maintenance mod

     
     by conradh on: Oct 15 2015
     
    Score 50%

    I tried today to install the latest version on our owncloud 8.1.3 version.
    Copied the files manually into the apps directory.
    Enable it on the app page.

    Then next screen is Owncloud maintenance wants to upgrade to 8.1.3. That is the installed version.

    Manually disabled the app with occ command on the prompt.


    Reply to this

    -

     Re: Version 0.6.1 forces owncloud into maintenance

     
     by Yetanfou on: Jan 9 2017
     
    Score 50%

    This is expected behaviour, Owncloud (and its sibling Nextcloud) need to update when you install a new (version of an) app. Just perform the update, even if it seems silly to update from OC version X to OC version X. If you look at the update process you'll notice that it updates the newly installed app as well.


    Reply to this

    -

     No books shown in 0.8.2

     
     by billsen on: Jan 10 2017
     
    Score 50%

    Hi, i have this 2 Errors after upgrade from 0.7.2 to 0.8.1 and no book is shown. (OC 9.1.2)

    Undefined index: title at /xxxxxxx/apps/files_reader/templates/reader.php#16

    Call to undefined method OC\Server::getContentSecurityPolicyNonceManager() at /xxxxx/apps/files_reader/templates/reader.php#23


    Reply to this

    -

     Re: No books shown in 0.8.2

     
     by Yetanfou on: Jan 10 2017
     
    Score 50%

    I withdrew this update from the repository as it relies on a function which is available in Nextcloud but not in Owncloud. Unfortunately Nextcloud (which has more strict security wrt. the loading of external Javascript) requires the use of these functions while Owncloud does not provide them. I'd prefer to keep a single version of these apps for both Nextcloud as well as Owncloud so I'll have to implement dummy-versions of these functions for Owncloud.

    For now please downgrade to 0.7.2 while I figure out how to handle this (or migrate to Nextcloud, but that might not be an option).


    Reply to this

    -

     Re: No books shown in 0.8.2

     
     by Yetanfou on: Jan 10 2017
     
    Score 50%

    This is fixed in 0.8.2


    Reply to this

    -
    .

     Update 3hrs ago? Woot!

     
     by BloodyIron on: Mar 16 2017
     
    Score 50%

    I'm coincidentally updating my owncloud install, saw that this app has been updated recently!

    Going to update it and see how it works, I'm excited! Thanks for your work! :)


    Reply to this

    -
    .

     Re: Update 3hrs ago? Woot!

     
     by BloodyIron on: Mar 16 2017
     
    Score 50%

    Just tried a rather complex anime cbr, omg it looks so good! Now I'm EVEN MORE EXCITED!!! :DDD

    Thanks a bunch hey! If I find any issues I'll be sure to let you know =^^=


    Reply to this

    -
    .

     Some CBZ/other comics are "blank"

     
     by BloodyIron on: Mar 18 2017
     
    Score 50%

    Some cbr files load just fine, yay! Some others don't (so far my example that doesn't work is a CBZ). It tries to load it, except stays a while page, and I don't see any pages in the index either. Not sure where to be looking for errors. What can I do? I'm on oc9.1.4


    Reply to this

    -

     Re: Some CBZ/other comics are "blank"

     
     by Yetanfou on: Mar 18 2017
     
    Score 50%

    There can be several reasons for a file not loading. It can be corrupt, it can be incompatible with the used un-rar/un-zip library (bitjs unrar and unzip), it can be too large for your machine's memory... When you say it shows a 'blank page', does that mean you do not get the loading sequence (file load to 100%, cloud icon turns green, image extract to 100%, ...)?


    Reply to this

    -
    .

     Re: Re: Some CBZ/other comics are "blank"

     
     by BloodyIron on: Mar 18 2017
     
    Score 50%

    The loading sequence _looks_ like it happens, but after it's done no content comes up. One of the problematic examples is about 13MB in file size, but a known-working one is about 188MB, so size isn't a factor here. Also, the "problematic" example is usable in other readers, so I'm not sure if those readers are fixing an indexing issue, or something else. I'm not sure how to get more useful data than just my anecdotal evidence.

    Thanks for the fast response though! What more can I do to help you out here? :)

    I'm so digging this addon btw, thanks for doing this! :D


    Reply to this

    -

     Re: Re: Re: Some CBZ/other comics are "blank"

     
     by Yetanfou on: Mar 18 2017
     
    Score 50%

    Check the browser console (use 'inspect' in the context menu) or javascript error log and look for any 'interesting' messages. If it is an archiving problem it might help to re-pack the offending file, just unzip it somewhere convenient and re-zip it with whatever you use to zip files. Just make sure to zip the whole thing recursively so that the archive contains all needed files in the right position.


    Reply to this

    -

     Re: Some CBZ/other comics are "blank"

     
     by Yetanfou on: Apr 11 2017
     
    Score 50%

    Try the latest version (1.0.4), it contains an updated version of the bitjs unarchiver which has improved RAR support. It'll probably cope with your hitherto-blank CBRs.


    Reply to this

    goto page: prev   1  2 

    Add commentBack



    ... .

    -
     
     Who we are
    Contact
    Register
    Explore
    Apps
    Knowledge
    People
    Participate
    Add App
    Public API
    About apps.ownCloud.com
    Legal Notice
    Report Abuse
     

    Copyright 2011-2017 apps.ownCloud.com Team  
    All rights reserved. apps.ownCloud.com is not liable for any content or goods on this site.
    All contributors are responsible for the lawfulness of their uploads.