A simple terminal based ebook server
+Terminal based ebook server. Open source & Lightweight.
-Frustrated with Calibre being my only option for hosting my eBook collection, I have decided to spin up my own. +Having used Calibre for hosting my eBook collection in the past, I found myself frustrated having to install X on my server, or manage my library externally, Thus I have decided to spin up my own. -Calibre is a great organizational tool for your books, however not having a terminal based option for running and maintaining -a server is cumbersome when running on a headless server. -Calibre does have a console based server solution, However there is currently no way to create, and manage your library in a headless enviroment. +## Current Features +* Recursive Scanning +* Fast database access +* Django based frontend +* Basic seaching via a SearchVector of author, title, & file_name fields. -Thus I am creating pyShelf and I hope to be able to provide all the functionality required to organize and host all your ebooks. +## Currently Supported Formats +* epub +## Installation Example
* In addition to the above steps you must now also make the requisite changes in config.json to reflect the connection to your postgresql server
-I am open to and hoping for community help in the design and execution of this program.
-
## 0.3.0 Patch Notes.
### "And now we search."
@@ -41,23 +43,19 @@ There is one new requirement
* Before advancing version numbers be sure to set PROJECT_NUMBER in doxygen.conf accordingly.
## Configuration
-All pyShelf configuration is done in config.json.
-* Be sure to set the path to your library, and database connection details.
-### Nginx configuration
-I have included a default nginx config file pyshelf_nginx.conf. This file should be sufficient to get you up and running. You are required to change the location alias's to reflect your pyshelf install folder leaving everything after /frontend intact.
+### Nginx
+Included is a default nginx config file {pyshelf_nginx.conf}. This file should be sufficient to get you up and running. You are required to change the location alias's to reflect your pyshelf install folder leaving everything after /frontend intact.
Further resources for nginx setup may be found @ [This nginx, django, & uwsgi, guide](https://uwsgi-docs.readthedocs.io/en/latest/tutorials/Django_and_nginx.html)
-### uwsgi configuration
+### uwsgi
Inside uwsgi.ini you should make changes to reflect your install directory, and the port you wish uwsgi to listen on. Alternativly you can make the requisite changes to listen on a socket instead. This change would also require a change to the pyshelf_nginx.conf file as well.
-### pyShelf configuration
-User configuration is contained within config.json in the project root. The only currently required configuration is to set book_path to the location of your books.
-
-## Current Features
-Currently pyShelf will recursively scan your collection, extract and store some metadata in the sqlite database. It will also provide you with a web based frontend to view and download your books. The search feature is currently in its infancy, and by default searches the author, title, & file_name fields. There is no way to change this in the program right now.
+### pyShelf
+User configuration is contained within config.json in the project root. You must set book_path to the location of your books, and change the database connection details to match your environment.
+## Misc
Django has been implemented to power the frontend experience, and web based database maintenance. A properly configured web server is required for hosting the frontend, and a PostgreSQL server for the database, configuration of these servers is outside of the scope of this readme.
Running via the Django test server might be possible, albeit not recomended.