Minstrel is a FLOSS hybrid reading app specifically designed for Audio-eBooks
MIT License
Minstrel is a FLOSS hybrid reading app specifically designed for Audio-eBooks
If you just want to install the app on your phone/tablet, you can download Menestrello, the official stable release of Minstrel maintained by ReadBeyond, using:
If you want to build the Android APK from command line,
make sure the Android SDK is in your $PATH
so that cordova
can run it.
Clone the GitHub repository and enter the cordova
directory:
$ git clone https://github.com/readbeyond/minstrel.git
$ cd minstrel/cordova
Create the Cordova project directory:
$ bash create_minstrel.sh
or
$ bash create_minstrel.sh android
$ bash create_minstrel.sh ios
The first command will create both versions of the app, the last two commands will create only the specified version.
Build the Android version:
$ cd minstrel/
$ bash build.sh
will build the app and copy the generated APK into /tmp/
.
Build the iOS version:
$ open minstrel/platforms/ios/Minstrel.xcodeproj
will open the generated project in Xcode.
Basically, all you have is the official Web page of the project and the comments in the source code.
Unfortunately, at the moment we do not have enough resources for properly documenting this project. You can help us by sponsoring this project.
<iframe>
(=> no monkey patching)Would you like supporting the development of Minstrel?
We are open to accept sponsorships to
Feel free to get in touch.
If you are able to contribute code directly, that's great! Feel free to open a pull request, we will be glad to have a look at it.
Please make your code consistent with the existing code base style and test your contributed code before opening the pull request.
Create a new branch (e.g., myfeature
)
for each logically-independent feature
you want to contribute.
Any contribution adding or altering the JS/native plugin interfaces must work for both Android and iOS before the contribution can be merged into the master branch of the app. This policy ensures that both platforms are supported and have the same features at any given time. Improvements to the existing native plugins that do not alter the JS/native interfaces are not subject to this rule.
Please note that, by opening a pull request, you automatically agree to apply the MIT license to the code you contribute.
If you think you found a bug, please use the GitHub issue tracker to file a bug report.
Minstrel is released under the terms of the MIT License (MIT). See the LICENSE file for details.
We value your privacy as much as we value ours. ReadBeyond does not collect any data about your eBooks, reading preferences, or reading statistics. On Android, the Network connection permission is requested solely because Minstrel uses a WebView ("in-app browser") to render the eBooks, however the app does not send data to nor receive data from the Internet, except for downloading a file when the user selects "Open with Minstrel" in the browser.
Copyright © 2011, Gesine Todt ([email protected]), with Reserved Font Name Amaranth. This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copyright © 2004-2011, SIL International (http://scripts.sil.org), with Reserved Font Names 'Andika' and 'SIL'. This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copyright © 2011, Dan Sayers ([email protected]), with Reserved Font Name Avería Serif. This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
This Font Software is Copyright © 1997-2011, SIL International (http://scripts.sil.org/) with Reserved Font Names "Charis" and "SIL". This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copyright © 2014, Dave Gandy (http://fontawesome.io), with Reserved Font Name Font Awesome. This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copyright © 2003-2008, SIL International (http://scripts.sil.org), with Reserved Font Names "Gentium" and "SIL". This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copyright © 2010, 2011, 2012 Georg Duffner (http://www.georgduffner.at). This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copying is an act of love. Please copy. OpenDyslexic(open-dyslexic) by Abelardo Gonzalez is licensed under a Creative Commons Attribution 3.0 Unported License. Based on a work at dyslexicfonts.com.
Copyright © 2012 Christian Robertson (https://plus.google.com/110879635926653430880/about). This Font Software is licensed under the Apache License, Version 2.0.
Web: http://www.google.com/fonts/specimen/Roboto
Copyright © 2013 Luciano Perondi (www.synsemia.org|[email protected]). Derived from Titillium Copyright © 2008-2010, Accademia di Belle Arti di Urbino (www.campivisivi.net|[email protected]), with Reserved Font Name TestMe. This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
Copyright © 2011, Cyreal (www.cyreal.org), with Reserved Font Name "Volkhov". This Font Software is licensed under the SIL Open Font License, Version 1.1.
Web: http://scripts.sil.org/OFL
This app has been compiled using Apache Cordova 5.0.0
by the Apache Software Foundation, released under the terms of the Apache License, Version 2.0.
Web: http://cordova.apache.org/
This app includes cssbeautify.js
code by Ariya Hidayat (Sencha Inc.), released under the terms of the MIT License.
EPUB
is a registered trademark of the International Digital Publishing Forum (IDPF).
Web: http://idpf.org/
This app includes Hammer.js
code by Jorik Tangelder, released under the terms of the MIT License.
Web: https://github.com/EightMedia/hammer.js
This app includes jQuery 1.9.1
code by the jQuery Foundation, released under the terms of the MIT License.
Web: https://jquery.org/
This app includes jQuery Mobile
code by the jQuery Foundation, released under the terms of the MIT License.
The UI theme is nativeDroid
by Raphael Wildhaber.
Web: http://nativedroid.godesign.ch/
On iOS, this app uses the Objective-Zip
wrapper for Zlib and MiniZip, released under the terms of the New BSD License.
Web: https://github.com/flyingdolphinstudio/Objective-Zip
On Android, this app uses the Sonic Library
by Bill Cox, released under the terms of the GNU Lesser General Public Licensee 2.1.
Web: http://dev.vinux-project.org/sonic/
This app includes sprintf.js
code by Ash Searle, released under the terms of the "This code is unrestricted: you are free to use it however you like." license.