BicBucStriim streams books, digital books. It fills a gap in the functionality of current NAS devices that provide access to music, videos and photos -- but not books. BicBucStriim fills this gap and provides web-based access to your e-book collection.
PHP HTML Cucumber Ruby JavaScript CSS ApacheConf
Permalink
Failed to load latest commit information.
data Added role information for admin Feb 22, 2015
features Changed bad parameter tests for id templates, fixes issue #200 Jan 15, 2016
img Added author default thumbnail Aug 22, 2013
js Search fields in panels will now get automatic focus (with desktop br… May 7, 2016
lib/BicBucStriim Enabled language processing for ES, GL, HU. Aug 16, 2016
style Added additional guards for bad user data in cookies. Fixes #190 Nov 19, 2015
templates Added additional search input in results page, fixes #182 May 8, 2016
tests Added resolution of forwarding headers used by proxies, see #209 and #… May 7, 2016
vendor Added cookie path handling via Aura\Session to enable multiple instan… Oct 1, 2015
.gitignore Updated integration test config Sep 15, 2015
.htaccess DB access is now split into Calibre and BicBucStriim classes. Aug 26, 2013
.ruby-version Updated Ruby dependencies Apr 6, 2016
ChangeLog Added Hungarian translation by @gersey, fixes #202 Apr 6, 2016
Gemfile Updated Ruby dependencies Apr 6, 2016
Gemfile.lock Updated Ruby dependencies Apr 6, 2016
Guardfile Debugged admin page and introduced flash handling Jun 16, 2012
LICENSE Changing documentation for release May 7, 2013
NOTICE Updated jQuery Mobile to 1.4.0 final Feb 8, 2014
README.md Prepare for release 1.3.0 Oct 1, 2015
Rakefile.rb Added spanish translation from #223 Aug 16, 2016
bbs-icon.png Added Apple Icon for home screens etc, fixes #97 Feb 21, 2015
composer.json Added cookie path handling via Aura\Session to enable multiple instan… Oct 1, 2015
composer.lock Added cookie path handling via Aura\Session to enable multiple instan… Oct 1, 2015
favicon.ico Added icon Dec 11, 2012
index.php Added spanish translation from #223 Aug 16, 2016
installcheck.php Fix GD test in installation check for new phpinfo format, fixes #204 Apr 25, 2016
messages.yml Added spanish translation from #223 Aug 16, 2016

README.md

BicBucStriim

BicBucStriim streams books, digital books. It fills a gap in the functionality of current NAS devices that provide access to music, videos and photos -- but not books. BicBucStriim fills this gap and provides web-based access to your e-book collection.

BicBucStriim was created when I bought a NAS device (Synology DS 512+) to store my media on it. NAS devices like the Synology DS typically include media servers that publish audio, video, photos, so that you can access your media from all kinds of devices (TV, smart phone, laptop ...) inside the house, which is very convenient. Unfortunately there is nothing like that for e-books. So BicBucStriim was created.

BicBucStriim is a simple PHP application that runs in the Apache/PHP environment provided by the NAS. It assumes that you manage your e-book collection with Calibre. The application reads the Calibre data and publishes it in HTML form. To access the e-book catalog you simply point your ebook reader to your NAS, select one of your e-books and download it.

Features & Issues

  • shows the most recent titles of your library on the main page
  • there are sections for browsing through book titles, authors, tags and series
  • individual books can be downloaded or emailed
  • information about your favourite authors can be added (links, picture)
  • global search
  • speaks Dutch, English, French, German, Galician, Italian
  • is ready for mobile clients
  • provides login-based access control
  • users can be restricted by book language and/or tag
  • provides OPDS book catalogs for reading apps like Stanza
  • has an admin GUI for configuration

  • no support for Calibre's virtual libraries

  • only simple custom columns supported

Install

There are 3 options for installation:

  1. Download an installation archive. These are stable releases with a reduced footprint, unnecesary files are removed.
  2. Install directly from Github by cloning a release tag. These are also stable releases, but contain all files in the repository.
  3. Live dangerously and clone/fork the Github master. Please be aware that this branch contains most often a version under development, which could be slow or partially broken.

The easy way assumes that BicBucStriim lives right below the web root of your device and can be addressed like http://<your ip>/bbs/:

  • Unarchive the downloaded archive below the web server root of your NAS (e.g. "/volume1/web" on a Synology device).
  • Rename the newly created directory (e.g. BicBucStriim-1.2.0.zip) to "bbs".
  • The "data" directory and its contents must be writeable for all. Depending on your method of unarchiving this might be already the case. However, in case you experience access error just use a terminal to correct this: chmod -R ga+w data.
  • BicBucStriim should now be working, start your web browser and navigate to http://<address of your NAS>/bbs/
  • Login as the administrator with the default login admin/admin (please don't forget to change the password afterwards).
  • A freshly installed BicBucStriim app will show you the admin section, where you will have tell the app where your Calibre library is located. Everything else is optional. Just have a look.
  • OPDS catalogs are available at http://.../bbs/opds/

Upgrading

The database structure of version 1.2 is incompatible with previous versions, so exisiting users should start with a fresh install. However, if you have lots of books and don't want to regenerate all the thumbnails for them:

  • Backup your old BicBucStriim installation, eg. mv bbs bbs.old
  • Install the new version and run it
  • There should be a new directory: bbs/data/titles
  • Copy the thumbnail files (thumb_*.png) from your old data directory to bbs/data/titles
  • Use chmod -R ga+w bbs/data/titles to correct the permissions after copying if there are access errors

After that the thumbnails should appear again.

Troubleshooting

If you encounter problems, use the installation test to check your environment. Invoke this test by navigating to http://<NAS address>/bbs/installcheck.php. This test checks for certain problems, which users experienced in the past.

Requirements

BicBucStriim publishes Calibre libraries via a web server, so it requires some modules to be pre-installed on your machine. The required modules are common ones for NAS, however you should check first if your device supports them:

  • Apache web server with PHP 5.3.7+, including support for mcrypt and sqlite3
  • Optional: if PHP module intl (php5-intl) is installed, book languages will be displayed

If you can't/won't use Apache: BicBucStriim is known to work with other web servers too. Check the wiki for other configurations.

License

BicBucStriim itself is licensed under the MIT license, for the licenses of the libraries used see the file NOTICE.

(The MIT License)

Copyright (c) 2012-2015 Rainer Volz

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.