README.md

JellyBook

A book and comic reader for Jellyfin

Hi, this is a passion project I am working on. Its an app that's meant to allow you to read ebooks, comics, and listen to audiobooks from your Jellyfin server.

Table of Contents

• ⚡ Installation:
• 📷 Screenshots (and videos):
• 📁 File formats:
  • 🎵 Audiobook formats:
• Currently Unsupported Filetypes
• Currently Unsupported Audiobooks Filetypes
• 🚧 Todo:
• 📞 Contact Me
• ⚙️ Contributing:
• 📚 Translating:
• 🎉 Special Thanks:
• 🤔 Why is Development so Slow?

⚡ Installation:

Platform	Link
iOS
Google Play and Galaxy Store	Download the latest release for your current platform from the releases. It will at some point be added to the Google Play store and may be added to the Galaxy Store
F-Droid	Soon to be submitted to the F-Droid store
Other Platforms	If you would like to see this app on your platform, please open an issue and I will see what I can do.

Note

Any distribution platforms listed above I consider official and trusted. Any sources not listed above are not official and may contain malware and are to be used at your own risk.

📷 Screenshots (and videos):

Click to expand

Screen	Images (Phone)	Images (Tablet)
Library Screen
Collection Screen
Book Info Screen
Search Screen

📁 File formats:

Format	Known Issues / Planned Features	Specification(s)
.cbr & .rar	CBR is a proprietary file format so is not necessarily encouraged. CBR files don't support streaming yet. The library is using deprecated functions. The view for them currently does not show a progress indicator.	CBR/RAR
.cbz & .zip	The view for them currently does not show a progress indicator.	CBZ/ZIP
.pdf	Sometimes throws an error that the content isn't downloaded even when it is. Only supports horizontal scrolling currently. No progress bar currently.	ISO 32000-1:2008(en) ISO 32000-2:2020(en)
.epub	Image support is not the greatest. No horizontal support yet. Just not in a state where I'd consider the support proper.	EPUB 3.2

🎵 Audiobook formats:

• Currently, the app supports the following formats:
  • flac
  • mpga
  • mp3
  • m3u
  • m3u8
  • m4a
  • m4b
  • wav

Note: this is partially due to the fact that Jellyfin Bookshelf Plugin only currently supports epub, mobi, pdf, cbz, and cbr for books and mp3, m4a, m4b, and flac for audiobooks. I am unsure if other formats can be added here until the plugin is updated.

Currently Unsupported Filetypes
.cbt/.tar .cba/.ACE .cb7/.7z tar.gz .WebP .gif .lrf/.lrx .djvu .pdb .fb2 .ibooks .azw/.azw3/.kf8/.kfx .pcf/.mobi .opf .txt .oxps/.xps
Currently Unsupported Audiobooks Filetypes
.aax .aac .ogg

🚧 Todo:

• A more consistent experience between all book formats
• Redesign several screens to give them a more cross-platform and polished feel
• Multiple server support
• For the download completed screen I want to add a image or GIF of a jellyfish reading a book (credit to thornbill on the Matrix server for that idea)
• UI overhaul in several areas of the app (will keep current as options for those who want it)
  • Part of the current issue is that it looks like an Android app made in Flutter; although it is made in Flutter, I want it to have a more cross-platform feel to it
  • I also want to make it more visually appealing (I am a programmer, not a designer and would love some help with this)
• Background download
• Publish to several stores
• Proper code documentation
• Proper testing (unit, integration, and widget... I have very little experience with this)
• Full code restructuring and refactoring
• Use Tentacle as new API client (must work on this first)
• Add a proper page on IzzyOnDroid using fastlane (see here)
• Add dynamic loading of books on library view to prevent slowdowns
• Allow user to edit metadata of books (both locally and on the server)
• Vertical scrolling
• Audiobooks
• Allow local caching of current files while viewing collection when offline (proper offline support)
• Remember user support
• Settings page

📞 Contact Me

• Discord: kmp3e
• Matrix: @kmp3e:matrix.org
• Email: mailto:kara.wilson.2005.08@gmail.com
• Feel free to submit an issue on GitHub

⚙️ Contributing:

• Check out our wiki here
• Check out our Weblate instance to help translate
• Add features mentioned in Todo
• Take a look at the project page to see planned features
• Take a look at the sponsors sections and help sponsor this project :)

📚 Translating:

🎉 Special Thanks:

• Thank you to u/anekdotos on Reddit for donating to the project so it could be published on iOS
• Thank you to Weblate for hosting translation
• Thank you to IzzyOnDroid for packaging and hosting the app on their repo
• Thank you to Sentry for providing error tracking (with their open source plan)
• And of course, thank you to all the contributors and users of the app

🤔 Why is Development so Slow?

• I am a full time student and work part time. I recently had midterms come up which caused me to have to slow down on my working on this project. This project is really fun to work on for me but that being said, without making any money from it or receiving any donations my ability to work on this project is hindered. This is since I do need money to help pay for my education and living expenses. I would really love to be able to work on open source full time but unfortunately that is not possible at this current time to work on it like how I was previously.
• That all being said, I do also have a tendency to burn out a lot when going at the rate I was going when I started this project so have tried to slow down to a pace where I'm ensuring I don't burn out and slowly over time plan to increase my frequency of working on this project to a place more close to where it was previously.