{"id":15209287,"url":"https://github.com/librum-reader/librum","last_synced_at":"2025-05-14T15:06:51.604Z","repository":{"id":37456964,"uuid":"454812611","full_name":"Librum-Reader/Librum","owner":"Librum-Reader","description":"The Librum client application","archived":false,"fork":false,"pushed_at":"2024-07-29T12:41:21.000Z","size":30025,"stargazers_count":4424,"open_issues_count":39,"forks_count":143,"subscribers_count":38,"default_branch":"main","last_synced_at":"2025-04-02T09:14:01.624Z","etag":null,"topics":["cmake","cpp","ebook-reader","ebooks","library-management","linux","qml","qt","qt6","reader"],"latest_commit_sha":null,"homepage":"https://librumreader.com","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Librum-Reader.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["Librum-Reader"],"custom":["https://librumreader.com/contribute/donate"]}},"created_at":"2022-02-02T14:43:19.000Z","updated_at":"2025-04-02T06:38:30.000Z","dependencies_parsed_at":"2023-10-14T16:45:43.986Z","dependency_job_id":"67238cd5-6893-40ee-ae46-343d1b7087e7","html_url":"https://github.com/Librum-Reader/Librum","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Librum-Reader%2FLibrum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Librum-Reader%2FLibrum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Librum-Reader%2FLibrum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Librum-Reader%2FLibrum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Librum-Reader","download_url":"https://codeload.github.com/Librum-Reader/Librum/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248027400,"owners_count":21035594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cmake","cpp","ebook-reader","ebooks","library-management","linux","qml","qt","qt6","reader"],"created_at":"2024-09-28T07:23:04.379Z","updated_at":"2025-04-09T11:02:59.148Z","avatar_url":"https://github.com/Librum-Reader.png","language":"C++","readme":"# Librum\n\nLibrum is an application designed to make reading \u003cb\u003eenjoyable\u003c/b\u003e and \u003cb\u003estraightforward\u003c/b\u003e for everyone.\n\nIt'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, AI tooling, and highlighting, while offering customization to make it as personal as you want!\n \nLibrum also provides free access to over 70,000 books and personal reading statistics while being free and completely open source.\n\n\u003cbr\u003e\n\nDownload Librum from [our website](https://librumreader.com)!\n\n\u003cbr\u003e\n\n# Table of Contents\n- [Preview](#Preview)\n- [Contributing](#Contributing)\n- [Contact](#Contact)\n- [Donations](#Donations)\n- [Translations](#Translations)\n- [Documentation](#Documentation)\n- [Self-hosting](#Self-hosting)\n- [Details](#Details)\n- [Build Guide](#Build-Guide)\n\n\u003cbr\u003e\n\n# Preview\n\nSetup and manage your own online library\n\n![HomeScreenDark](https://github.com/Librum-Reader/Librum/assets/69865187/ea94fc68-1bf0-4933-8d80-43a57c6590c5)\n\n\u003cbr\u003e\n\nA simple and modern interface\n\n![image](https://github.com/Librum-Reader/Librum/assets/69865187/bf1d0401-62bd-4f4e-b008-523fb2efd275)\n\n\n\u003cbr\u003e\n\nAdd your books to collections, tag them, and sort them in any way you want\n\n![folders_dark](https://github.com/Librum-Reader/Librum/assets/69865187/00fec031-a835-4cae-89f1-79dbce24b356)\n\n\n\u003cbr\u003e\n\nCustomize Librum to make it personal to you\n\n![image](https://github.com/Librum-Reader/Librum/assets/69865187/b8995cf1-a0e6-4993-8c8b-92f7f8e79ebd)\n\n\n\u003cbr\u003e\n\n# Contributing\n\nIf you'd to support Librum's development, check out: https://librumreader.com/contribute\n\u003cbr\u003e\n\u003cbr\u003e\nAll of the current feature requests, bugs and tasks are listed in the [issues](https://github.com/Librum-Reader/Librum/issues). Easy tasks are labeled \"good first issue\", so that is a good starting point.\n\u003cbr\u003e\n\u003cbr\u003e\nPS: Feel free to tag me (@DavidLazarescu) in the comments of any issue if you have questions. \n\n\u003cbr\u003e\n\n# Contact\n\nFor questions, you can reach us under: help@librumreader.com\n\u003cbr\u003e\nFor business related contact, reach out to us here: contact@librumreader.com\n\n\u003cbr\u003e\n\n# Donations\n\nDonations make it possible for us to cover our server costs and allow us to make investments into new areas of development.\n\u003cbr\u003e\nIf you would like to support us, check out: https://librumreader.com/contribute/donate or become a Github sponsor! \n\u003cbr\u003e\n\u003cbr\u003e\nAs a team of opensource developers we rely on donations to continue working on projects like Librum. Your help is greatly appreciated.\n\n\u003cbr\u003e\n\n# Translations\n\nLibrum is currently available in the languages listed [here](https://github.com/Librum-Reader/Librum/tree/main/src/presentation/translations)\n\nIf you want to translate Librum to another language, follow the steps below:\n- Download [this file](https://github.com/Librum-Reader/Librum/blob/dev/develop/src/presentation/translations/librum_en.ts)\n- Rename the file to contain your language's suffix, e.g. \"librum_ru.ts\" for Russian or \"librum_de.ts\" for German\n- Download the translation software (Qt Linguist) either for Windows from [here](https://github.com/thurask/Qt-Linguist) or using the [Qt Installer](https://www.qt.io/download-open-source)\n- Now start Qt Linguist, open the downloaded file, set the target language to the language you want to translate to and start translating.\n(Check out [this guide](https://youtu.be/xNIz78IPBu0?t=347) for a quick overview of Qt Linguist)\n\nOnce you are done, create a pull request or open up an issue with your new translation file!\u003cbr\u003e\nIf you run into any problems, need guidance or have questions, feel free to reach out to us at: contact@librumreader.com\n\n\u003cbr\u003e\n\nNotes:\n- Make sure that your translations are approximately the same length as the original text\n- Please carefully check for spelling mistakes (including punctuation and capitalization)\n\n\u003cbr\u003e\n\n# Documentation\n\nFor documentation go to [Librum's GitHub-wiki](https://github.com/Librum-Reader/Librum/wiki)\n\n\u003cbr\u003e\n\n# Self-hosting\nTo self-host Librum you need to run [Librum-Server](https://github.com/Librum-Reader/Librum-Server) locally (instructions can be found [here](https://github.com/Librum-Reader/Librum-Server#self-hosting)) and tell the client to use your self-hosted server by:\n- (Linux) Editing ~/.config/Librum-Reader/Librum.conf and setting `selfHosted=true` and `serverHost` to your server's url (e.g. `serverHost=https://127.0.0.1:5001`)\n- (Windows) Opening the registry editor (Press `Win + R` and search for `regedit`), navigating to `HKEY_CURRENT_USER\\Software\\Librum-Reader\\Librum` and setting `selfHosted=true` and `serverHost` to your server's url\n\nMake sure to run the application before following the steps above, to generate the required files.\n\n\u003cbr\u003e\n\n# Details\n\n### Supported platforms\nPart 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 \u003cb\u003ecross platform\u003c/b\u003e.\u003cbr\u003e\nWe support:\n- Windows\n- GNU/Linux\n- MacOS\n- IOS (Coming Soon)\n- Android (Coming Soon)\n\u003cbr\u003e\n\n### Supported formats\nLibrum is the best choice for all kinds of books, since Librum supports \u003cb\u003eall\u003c/b\u003e major book formats\u003cbr\u003e\nincluding:\n- PDF\n- EPUB\n- CBZ (Comic books)\n- FB2\n- TIFF\n- Mobi\n- XPS\n- Images\n\nAnd many more!\n\n\u003cbr\u003e\n\n### Features\nLibrum's objective is to make your reading more \u003cb\u003eproductive\u003c/b\u003e; to that end, we provide you with a variety of features that you can access via a \u003cb\u003esimple\u003c/b\u003e and \u003cb\u003estraightforward\u003c/b\u003e interface.\u003cbr\u003e\nThese features include:\n- A modern e-reader\n- A personalized and customizable online library\n- Book meta-data editing\n- A free in-app bookstore with more than 70,000 books\n- Book syncing across all of your devices\n- Highlighting\n- Bookmarking\n- Text search\n- Unlimited customization\n- Fine-grained organization through Librum's folder system\n- Note-taking (Coming Soon)\n- TTS (Coming Soon)\n- Personalized reading statistics (Coming Soon)\n\nWant a new feature? Feel free to leave a feature request ticket!\n\n\u003cbr\u003e\u003cbr\u003e\n\n# Build Guide\n\nFollow this guide to build Librum from source.\n\u003cbr\u003e\n\n\n## For GNU/Linux\n\n### Prerequisites\n- cmake                             (https://cmake.org/download)\n- make                              (http://ftp.gnu.org/gnu/make)\n- g++                               (https://gcc.gnu.org)\n- python3-venv                      (on ubuntu use `sudo apt install python3-venv`)\n- Qt 6.5                            (https://www.qt.io/download-open-source)\n\n### Installation\nThe installation is straight forward, just follow the steps below:\n\n\u003cbr\u003e\n\n1. Clone the repository.\n    ```sh\n    git clone https://github.com/Librum-Reader/Librum.git --recursive\n    ```\n2. Step into the cloned project folder.\n    ```sh\n    cd Librum\n    ```\n3. Create the build folder and step into it.\n    ```sh\n    mkdir build-Release\n    cd build-Release\n    ```\n4. Run cmake.\n    ```sh\n    cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=\u003cpath/to/Qt\u003e ..\n    ```\n    Set `CMAKE_PREFIX_PATH` to your Qt installation path. Installing Qt via the online installer usually installs it to `/home/\u003cname\u003e/Qt/\u003cversion\u003e/gcc_64`\n6. Build the project\n    ```sh\n    cmake --build . -j $(nproc)\n    ```\n7. Install Librum\n    ```sh\n    cmake --install .\n    ```\n\u003cbr\u003e\n\n### Troubleshooting\nHere are solutions to some common errors. If your error is not listed here, please open an issue.\n\u003cbr\u003e\n\n- Error: `Failed to find required Qt component \"Quick\".`\u003cbr\u003e\n- 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`.\n\n- Error: `Could not load the qt platform plugin \"xcb\" even though it was found`\n- Solution: Install the libxcb-cursor-dev, on ubuntu its `sudo apt install libxcb-cursor-dev`\n\n\u003cbr\u003e\n\n\n## For Windows\n### Prerequisites\n- cmake                             (https://cmake.org/download)\n- Visual Studio \u003cb\u003e19\u003c/b\u003e           (https://visualstudio.microsoft.com/de/vs/older-downloads)\n- Python                            (https://www.python.org/downloads)\n- Qt 6.5                            (https://www.qt.io/download-open-source)\n\n### Installation\nTo build Librum on windows, run the following commands in the Powershell:\n\n\u003cbr\u003e\n\n1. Clone the repository.\n    ```sh\n    git clone https://github.com/Librum-Reader/Librum.git --recursive\n    ```\n2. Step into the cloned project folder.\n    ```sh\n    cd Librum\n    ```\n3. Create the build folder and step into it.\n    ```sh\n    mkdir build\n    cd build\n    ```\n4. Run cmake.\n    ```sh\n    cmake -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=\u003cpath/to/qt\u003e ..\n    ```\n    Set `CMAKE_PREFIX_PATH` to your Qt installation path. Installing Qt via the online installer usually installs it to `\u003cDrive\u003e\\\\Qt\\\\\u003cversion\u003e\\\\msvc2019_64`\n6. Build the project\n    ```sh\n    cmake --build . --config Release\n    ```\n7. Run the app\n    ```sh\n    ./librum\n    ```\n\n### Additional Info\nHere are some things to keep in mind during the build process.\n\u003cbr\u003e\n\n- Make sure to add cmake and the Qt binaries to the `PATH` environment variable\n- You need Visual Studio 2019, newer versions will **not** work\n- For the Qt installation, you **only** need to choose \"MSVC 2019 64-bit\", you can untick everything else to reduce the download size\n\n\u003cbr\u003e\n\n## For MacOS\n\n### Prerequisites\n- cmake                             (https://cmake.org/download)\n- make                              (http://ftp.gnu.org/gnu/make)\n- g++                               (https://gcc.gnu.org)\n- python3                           (https://www.python.org/downloads)\n- Qt 6.5                            (https://www.qt.io/download-open-source)\n\n### Installation\nThe installation is straight forward, just follow the steps below:\n\n\u003cbr\u003e\n\n1. Clone the repository.\n    ```sh\n    git clone https://github.com/Librum-Reader/Librum.git --recursive\n    ```\n2. Step into the cloned project folder.\n    ```sh\n    cd Librum\n    ```\n3. Create the build folder and step into it.\n    ```sh\n    mkdir build-Release\n    cd build-Release\n    ```\n4. Run cmake.\n    ```sh\n    cmake -DCMAKE_INSTALL_PREFIX=/usr/local -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=Off -DCMAKE_PREFIX_PATH=\u003cpath/to/Qt\u003e ..\n    ```\n    Set `CMAKE_PREFIX_PATH` to your Qt installation path. Installing Qt via the online installer usually installs it to `/Users/\u003cname\u003e/Qt/\u003cversion\u003e/macos`\n6. Build the project\n    ```sh\n    cmake --build . -j $(nproc)\n    ```\n7. Install Librum\n    ```sh\n    cmake --install\n    ```\nNote: Make sure to add `/usr/local/lib` to your DYLIB path, for MacOS to find the installed libraries by exporting `DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/usr/local/lib`.\n\n\u003cbr\u003e\n","funding_links":["https://github.com/sponsors/Librum-Reader","https://librumreader.com/contribute/donate"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrum-reader%2Flibrum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibrum-reader%2Flibrum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrum-reader%2Flibrum/lists"}