fristhon / Librum

The Librum client application

Librum

Librum is an application designed to make reading enjoyable and straightforward for everyone.

It's not just an e-book reader. With Librum, you can manage your own online library and access it from any device anytime, anywhere. It has features like note-taking, bookmarking, and highlighting, while offering customization to make it as personal as you want!

Librum also provides free access to over 70,000 books and personal reading statistics while being free and completely open source.

Note: Librum is still in development, the servers are not public. This means Librum is not yet available for public use.

An alpha release will be available soon, bringing the servers online and making the application available to end users.

Preview

The login and starting page of Librum

A simple and modern interface that removes any distractions and clutter

Customize Librum to make it personal to you

Dark mode support. Need we say more?

Setup and manage your own library

Documentation

For documentation go to Librum's GitHub-wiki

Donations

If you like the Librum project, consider donating to the opensource developers at https://www.patreon.com/librumreader.

As a team of opensource developers we rely on donations to continue working on projects like Librum. All help is greatly appreciated.

Contributing

If you are interested in contributing, feel free to contact us on either:

1. Discord (m_david#0631)
2. Email ([e-mail])

We are following a pull request workflow where every contribution is sent as a pull request and merged into the dev/develop branch for testing.
Please make sure to run clang format, keep to the conventions used throughout the application and ensure that all tests pass, before submitting any pull request.

Contact

For questions, you can reach us under: [e-mail]
For business related contact, reach out to us here: [e-mail]

Details

Supported platforms

Part of Librum's aim is to work on any platform. No matter where you are or which device you use, you can always continue your book with Librum, as it is cross platform.
We support:

• Windows
• GNU/Linux
• MacOS
• IOS
• Android

Supported formats

Librum is the best choice for all kinds of books, since Librum supports all major book formats
including:

• PDF
• EPUB
• CBZ (Comic books)
• XPS
• PS
• All plain text formats
• Images

Features

Librum's objective is to make your reading more productive; to that end, we provide you with a variety of features that you can access via a simple and straightforward interface.
These features include:

• A modern e-reader
• A personalized and customizable library
• Book meta-data editing
• A free in-app bookstore with more than 70.000 books
• Book syncing across all of your devices
• Highlighting
• Bookmarking
• Text search
• Unlimited customization
• Note-taking (Coming Soon)
• TTS (Coming Soon)
• Personalized reading statistics (Coming Soon)
• No-login book reading (Coming Soon)

Want a new feature? Feel free to leave a feature request ticket!

Build Guide

Here's how to get Librum up and running in your environment.

For GNU/Linux

Prerequisites

• cmake (https://cmake.org/download)
• make (http://ftp.gnu.org/gnu/make)
• g++ (https://gcc.gnu.org)
• python3-venv (on ubuntu use sudo apt install python3-venv)
• Qt 6.5 (https://www.qt.io/download-open-source)

Installation

The installation is straight forward, just follow the steps below:

1. Clone the repository.

   git clone https://github.com/Etovex/Librum.git --recursive

2. Step into the cloned project folder.

   cd Librum

3. Create the build folder and step into it.

   mkdir build-Release
   cd build-Release

4. Run cmake.

   cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=/home/<username>/Qt/<version>/gcc_64 ..

   CMAKE_PREFIX_PATH needs to be set to the Qt install path. Qt is usually installed at /home/name/Qt, so an example might be:

   cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=/home/john/Qt/6.5.1/gcc_64 ..

5. Build the project

   cmake --build .

6. Run the app

   ./appLibrum

Troubleshooting

Here are solutions to some common errors. If your error is not listed here, please open an issue.

• Error: Failed to find required Qt component "Quick".
  
• Solution: Install the libGL mesa dev package, on ubuntu its sudo apt install libgl1-mesa-dev and on fedora its sudo dnf install mesa-libGL-devel.

For Windows

Prerequisites

• cmake (https://cmake.org/download)
• Visual Studio 19 (https://visualstudio.microsoft.com/de/vs/older-downloads)
• Python (https://www.python.org/downloads)
• Qt 6.5 (https://www.qt.io/download-open-source)

Installation

To build Librum on windows, run the following commands in the Powershell:

1. Clone the repository.

   git clone https://github.com/Etovex/Librum.git --recursive

2. Step into the cloned project folder.

   cd Librum

3. Create the build folder and step into it.

   mkdir build
   cd build

4. Run cmake.

   cmake -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=<Drive>\\Qt\\<version>\\msvc2019_64 ..

   CMAKE_PREFIX_PATH needs to be set to the Qt install path, for example:

   cmake -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=C:\\Qt\\6.5.1\\msvc2019_64 ..

5. Build the project

   cmake --build . --config Release

6. Run the app

   ./appLibrum

For macOS

Support coming soon!