Ψ¨Ψ³Ω Ψ§ΩΩΩ Ψ§ΩΨ±ΨΩ Ω Ψ§ΩΨ±ΨΩΩ
Key Features β’ Screenshots β’ Download β’ Credits β’ Report Bug β’ License
Table of Contents
Quran Companion is a cross-platform Quran reader/player with recitation download capabilities, verse highlighting, resizable quran font, and a variety of tafsir books & translations
- Modern UI with dark theme support
- Read the Quran from the mushaf page or read the page verses one-by-one
- Resizable Quran page size
- Quran recitation player
- Option for downloading recitations for a variety of reciters
- Verse highlighting as its read
- A collection of translations & tafsir books for the Quran
- Quran verse search functionality
Warning
Starting with version 1.5.0, Windows releases are distributed as self-contained offline installers instead of the previous online installer. To migrate, completely remove the old installation first, then install the setup.exe from the desired release.
Latest release installer can be downloaded from here.
- Download and open the application dmg.
- Drag the application into your Applications.
The application can be downloaded in any of the available packages (snap, flatpak, appimage, aur package).
To build the application in your system, you'll need to install the dependencies needed for it and package names might be different for each distribution, see Dependencies below for more information. You can also install most of the Qt dependencies via their installer. If you were developing Qt apps before, you probably already have them.
This project uses CMake build system, so you need to install it in order to build the project (on most Linux distributions it is available in the standard repositories as a package called cmake).
Also you can open and build/debug the project in a C++ IDE. For example, in Qt Creator you should be able to simply open CMakeLists.txt via Open File or Project in the menu after installing CMake into your system. More information about CMake projects in Qt Creator.
- GCC / MSVC
- CMake
- Qt >= 6.10
qtbaseqtimageformatsqtsvgqtmultimediaqttools
- Clone the repo, make sure to pass
--depth=1to reduce the download size
git clone --recursive --depth=1 -b main https://github.com/0xzer0x/quran-companion.git-
Install Qt using the online installer, make sure to select Qt Multimedia & Qt image formats
-
Add the Qt bin directory to the system PATH variable, usually
C:\Qt\6.x.x\msvc_2019\bin -
Build (replace 6.x.x with the Qt version you installed)
mkdir build
cd build
cmake.exe -DCMAKE_PREFIX_PATH="C:\Qt\6.x.x\msvc_2019" -DCMAKE_BUILD_TYPE=Release ..
cmake.exe --build . --config Release- Install dependencies (through the Qt online installer or using your distro's package manager)
- Ubuntu
sudo apt install build-essential cmake qt6-tools-dev qt6-base-dev qt6-image-formats-plugins qt6-multimedia-dev qt6-l10n-tools qt6-translations-l10n ffmpeg- Arch linux
sudo pacman -Sy base-devel cmake qt6-base qt6-multimedia qt6-tools qt6-imageformats qt6-translations ffmpeg- Build
Note: if you installed Qt through the online installer, you need to pass -DCMAKE_PREFIX_PATH=~/Qt/6.x.x/gcc_64 to CMake in order for the linker to find the Qt libs
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
# To launch quran-companion
./quran-companion- Install (optional)
sudo cmake --install .See the project board for the current roadmap and development progress.
You can also review open issues for planned features and reported problems.
Please check out the CONTRIBUTING.md file for guidelines on how to contribute, submit issues, or create pull requests.
The following projects/services were used in development:
Distributed under the Waqf General Public License. See license-en.txt for the English version.