zamo22 / bookwyrm

A basic companion application for bookworms

BookWyrm

An iOS application intended for bookworms to discover and keep track of books that they're interested in.

Features

Book Search

The application makes use of Google's massive database of books to help users find the books they want, regardless of how obscure it may be.

     

Book Details

Naturally, you should be able to do more than just see high level search results. Selecting a book allows you to see important information to help you find your next read. An average Goodreads rating, Critic Review snippets and other similar books are just some of the information presented to you.

     

Critic Reviews

Using the iDreamBooks API, the application fetches relevant book reviews by reputable and recognizable critics to help you decide on a book.

Posting your own Review

As an avid book fan, you would of course want to share your thoughts on the book you just read, positive or negative. The application allows you to leave your review for a book which will later be used when recommending you books.

     

Bookshelf

Of course you, may want to bookmark certain books that you have read or may want to read (which you can do very conventiently with the bookmark icon). Books that you have bookmarked show up on your personal bookshelf for easy revisiting and are utilized when generating recommendations for you.

     

Recommendations

Uses your personal tastes based on how you rated books that you added to your shelf to suggest books you may enjoy. Additionally, the top sellers worldwide are shown as well.

Technologies Used

• Alamofire, for speedy data retrieval
• SwiftyJSON for simple JSON parsing
• SWXMLHash to facilitate XML parsing
• OAuthSwift, to manage OAuth Tokens
• Shelfview, to create and manage an aesthetic Bookshelf experience
• Firebase, for a wide range of analytics

API Services Used

• Google Books: https://developers.google.com/books/
• Goodreads: https://www.goodreads.com/api
• iDreamBooks: https://idreambooks.com/api
• TasteDive: https://tastedive.com/read/api
• BookWyrm-Backend: https://bookwyrm-backend.vapor.cloud/ (Self-Made Backend Server to assist with recommendations) Github: https://github.com/Zamo22/BookWyrmBackend

Requirements

• iOS 12.0+
• Xcode 10.2
• Swift 4.2

Installation

This application does not currently support installation via Cocoapods.

1. Download the project
2. Open the project and add your API Keys where necessary

License

BookWyrm is licensed under the MIT license. See License for details