Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/0xzer0x/quran-companion
Free and open-source desktop Quran reader and player 💻
https://github.com/0xzer0x/quran-companion
cross-platform islam linux qt qt6 qt6-gui qt6-widgets quran quran-audio quran-companion quran-offline quran-reader quran-recitation quran-search quran-tafseer quran-translation tafsir windows
Last synced: 6 days ago
JSON representation
Free and open-source desktop Quran reader and player 💻
- Host: GitHub
- URL: https://github.com/0xzer0x/quran-companion
- Owner: 0xzer0x
- License: other
- Created: 2023-03-19T05:57:49.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-19T14:44:09.000Z (about 2 months ago)
- Last Synced: 2024-12-30T01:14:12.063Z (13 days ago)
- Topics: cross-platform, islam, linux, qt, qt6, qt6-gui, qt6-widgets, quran, quran-audio, quran-companion, quran-offline, quran-reader, quran-recitation, quran-search, quran-tafseer, quran-translation, tafsir, windows
- Language: C++
- Homepage: https://0xzer0x.github.io/projects/quran-companion/
- Size: 1020 MB
- Stars: 117
- Watchers: 6
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README-AR.md
- Changelog: CHANGELOG.md
- License: license-ar.txt
Awesome Lists containing this project
- Awesome-Muslims - Quran Companion - platform Quran reader & player written in Qt/C++. (Desktop Apps / C/C++ <a name="c-cpp"></a>)
README
بسم الله الرحمن الرحيم
رفيق القرآن
قارئ و مشغل للقرآن الكريم متعدد-المنصات
أهم المميزات •
الصور •
التحميل •
الحقوق •
بلّغ عن مشكلة •
الترخيص
فهرس المحتويات
## عن المشروع ✨
رفيق القرآن هو برنامج متعدد-المنصات لقراءة و سماع القرآن الكريم مع إمكانية تحميل التلاوات، تظليل الآيات، حجم خط متغير للمصحف، و مجموعة مميزة من كتب التفسير و الترجمات
### أهم المميزات
- واجهة عصرية تدعم الوضع الداكن
- قراءة القرآن من صفحة المصحف أو قراءة ايآت الصفحة كلٌ على حدة
- حجم صفحة المصحف قابل للتغيير
- إمكانية تحميل تلاوات القرآن الكريم لمجموعة من المشايخ و القرّاء
- تظليل الآية عند تلاوتها
- مجموعة من كتب التفسير و الترجمات
- خاصية البحث السريع في آيات القرآن الكريم
### الصور
#### الواجهة الإنجليزية
## التنصيب ⚙️
#### ويندوز
مثّبت البرنامج يمكنك تحميله من [هنا][win-installer]
#### ماك
1. قم بتحميل و فتح ملف [الdmg][macos-dmg-url].
2. قم بسحب البرنامج لمجلد التطبيقات.
#### لينكس
يمكنك تحميل البرنامج بأي صيغة من الصيغ المتوفرة (snap, flatpak, appimage, aur package)
## البناء من المصدر 🛠️
لإنشاء التطبيق في نظامك، ستحتاج إلى تثبيت التبعيات المطلوبة له وقد تختلف أسماء الحزم لكل توزيعة، راجع التبعيات أدناه لمزيد من المعلومات. يمكنك أيضا تثبيت معظم تبعيات Qt عبر [المثبت](https://www.qt.io/download-qt-installer). إذا كنت تقوم بتطوير تطبيقات Qt من قبل ، فمن المحتمل أن تكون لديك بالفعل. يستخدم هذا المشروع نظام بناء [CMake](https://cmake.org/) ، لذلك تحتاج إلى تثبيته من أجل بناء المشروع (في معظم توزيعات لينكس يتوفر في المستودعات الرئيسية كحزمة تسمى cmake). كما يمكنك فتح وبناء / تصحيح المشروع في بيئة تطوير لغة ++C متكاملة. على سبيل المثال ، في Qt Creator ، يجب أن تكون قادرا ببساطة على فتح "CMakeLists.txt" عبر "فتح ملف أو مشروع" في القائمة بعد تثبيت CMake في نظامك. [مزيد من المعلومات حول مشاريع CMake في Qt Creator](https://doc.qt.io/qtcreator/creator-project-cmake.html).
### التبعيات
- GCC / MSVC
- CMake
- Qt >= 6.5
- `qtbase`
- `qtimageformats`
- `qtsvg`
- `qtmultimedia`
- `qttools`
### البناء
- استنساخ المستودع
```sh
git clone --depth=1 -b main https://github.com/0xzer0x/quran-companion.git
```
#### ويندوز
- قم بتثبيت Qt باستخدام المثبت عبر الانترنت
- إضافة مجلد bin الخاص ب Qt لمسار البحث الخاص بالنظام (PATH)، في الأغلب يكون المسار
C:\Qt\6.X.X\msvc_2019\bin
- البناء (استبدل 6.x.x بنسخة Qt الخاصة بك)
```sh
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
```
#### لينكس
- تنصيب التبعيات
**أوبونتو**
```sh
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
```
**آرش لينكس**
```sh
sudo pacman -Sy base-devel cmake qt6-base qt6-multimedia qt6-tools qt6-imageformats qt6-translations
```
- البناء
```sh
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -G "Ninja" ..
cmake --build .
```
## خارطة الطريق 🎯
- [x] إضافة خاصية الآية اليومية
- [x] إضافة نافذة الايآت المفضلة
- [x] تحسين خاصية البحث
- [x] البحث في نطاق عدد معين من الصفحات
- [x] البحث في سور محددة فقط
- [x] إضافة كتب تفسير جديدة
- [x] أيسر التفاسير - أبو بكر الجزائري
- [x] التسهيل لعلوم التنزيل (تفسير إبن جزي)
- [x] أضواء البيان - الشنقيطي
راجع [المشكلات المفتوحة](https://github.com/0xzer0x/quran-companion/issues) للحصول على قائمة كاملة بالميزات المقترحة (والمشكلات المعروفة).
## المشاركة 💡
إذا كان لديك اقتراح من شأنه أن يجعل هذا أفضل ، فيرجى تفريع المستودع وإنشاء طلب سحب. يمكنك أيضا ببساطة فتح مشكلة باستخدام العلامة "تحسين".
### التوثيق 📚
- تم توثيق كافة أجزاء البرنامج باستخدام منهجية [Doxygen](https://www.doxygen.nl/) يمكنك بناء التوثيق في هيئة html عن طريق الخطوات التالية
- `git clone https://github.com/0xzer0x/quran-companion.git`
- `cd quran-companion/docs`
- `doxygen`
### الترجمة 🌐
ألق نظرة على [هذه الصفحة][translation-wiki] (إنجليزية)
### التلاوات 📻
ألق نظرة على [هذه الصفحة][recitations-wiki] (إنجليزية)
## الحقوق 📌
تم استخدام المشاريع/المواقع التالية في تطوير البرنامج:
- [Ayat](https://quran.ksu.edu.sa/index.php)
- [Quran.com API](https://api-docs.quran.com/)
- [Every Ayah recitations](https://everyayah.com/recitations_ayat.html)
- [Mosshaf](https://mosshaf.com/)
## الترخيص
مرخّص بموجب رخصة [وقف العامة](https://ojuba.org/waqf-2.0:%D8%B1%D8%AE%D8%B5%D8%A9_%D9%88%D9%82%D9%81_%D8%A7%D9%84%D8%B9%D8%A7%D9%85%D8%A9)
## التواصل
> 0xzer0x - [email protected]
>
> رابط المشروع: [https://github.com/0xzer0x/quran-companion](https://github.com/0xzer0x/quran-companion)
[latest-release]: https://github.com/0xzer0x/quran-companion/releases/latest
[win-installer]: https://github.com/0xzer0x/quran-companion/releases/download/v1.1.9/qc_online_installer_x64_win.exe
[translation-wiki]: https://github.com/0xzer0x/quran-companion/wiki/Contributing-Translations
[recitations-wiki]: https://github.com/0xzer0x/quran-companion/wiki/Contributing-Recitations
[macos-dmg-url]: https://github.com/0xzer0x/quran-companion/releases/download/v1.3.2/Quran_Companion-1.3.2-x86_64.dmg