Author: faymaz

A GNOME Shell extension that lets you listen to Quran recitations directly from your desktop.

• Full list of all 114 Quran surahs organized in groups
• Multiple reciter options including Mustafa Ismail and Abdulbasit Abdussamed
• English and German translation options available
• Playback controls (play/pause, next, previous, stop)
• Resume from exact position after pausing
• Customizable settings
• Notifications for playback status
• Support for custom reciter lists
• Multiple language interfaces (English, Turkish, German, Arabic)
• Juz (section) based playback support

• GNOME Shell 45 or newer
• glib-compile-schemas (part of glib2.0-dev package)

You can install the extension in two ways:

1. Visit Quran Player on GNOME Extensions
2. Toggle the switch to ON to install the extension
3. Follow any additional prompts to complete installation

1. Clone or download this repository
2. Copy all files to the extension directory:

   mkdir -p ~/.local/share/gnome-shell/extensions/[email protected]
   cp -r * ~/.local/share/gnome-shell/extensions/[email protected]/

3. Create and compile the schema:

   cd ~/.local/share/gnome-shell/extensions/[email protected]/schemas
   glib-compile-schemas .

4. Restart GNOME Shell:
   • On X11: Press Alt+F2, type 'r', and press Enter
   • On Wayland: Log out and log back in
5. Enable the extension:

   gnome-extensions enable [email protected]

After installation, you'll see a Quran icon in the GNOME top bar. Click it to open the Quran Player menu.

• Browse surahs by group (organized in sets of 15) or browse juz (sections)
• Click on any surah or juz to start playback
• Use the player controls to:
  • Play/Pause (continues from the same position when paused)
  • Stop
  • Skip to previous surah/juz
  • Skip to next surah/juz
• Select different reciters from the Reciters submenu
• Access settings from the menu

Access the extension settings by:

• Clicking "Settings" in the extension menu
• Or using GNOME Extensions app and clicking the gear icon next to the extension

In the settings panel, you can:

• Select your preferred reciter
• Toggle autoplay for the next surah/juz
• Enable/disable notifications
• Set a custom surah or juz list file
• Change interface language
• Enable debug logging for troubleshooting

You can edit the custom-reciters.json file to add or modify reciters. The format is:

[
  {
    "name": "Reciter Name",
    "baseUrl": "https://example.com/path/to/audio/",
    "audioFormat": "%id%.mp3",
    "type": "surah"
  },
  {
    "name": "Reciter with Special Format",
    "baseUrl": "https://example.com/path/to/audio/",
    "audioFormat": "%specialFormat%",
    "type": "surah",
    "hasSpecialFormat": true,
    "formatMap": {
      "01": "special-format-file-001.mp3",
      "02": "special-format-file-002.mp3"
    }
  }
]

The audioFormat field supports these placeholders:

• %id%: 3-digit surah number (001, 002, etc.)
• %audioId%: The audioId from surahs.json
• %name%: Surah name

Note: If a reciter has incomplete surahs or juz (some missing), set "hasIncomplete": true in the reciter definition. You will see a warning indicator (!) next to these reciters in the list.

Adding New Reciters:
If you would like to add a new reciter to the list, please open an issue on GitHub with the reciter's name and the internet links for all surahs or juz. I will add them to the extension.

If the extension doesn't work:

1. Make sure you're using GNOME Shell 45 or newer
2. Check for errors in Looking Glass (Alt+F2, type 'lg')
3. Make sure the schema file is correctly compiled
4. Verify that ~/.local/share/gnome-shell/extensions/[email protected]/schemas/ contains gschemas.compiled
5. Enable debug logging in the extension settings and check the logs

Suggestions, bug reports, and pull requests are welcome on GitHub!

Masaüstünüzden doğrudan Kur'an-ı Kerim tilavetlerini dinlemenizi sağlayan bir GNOME Shell uzantısı.

• Gruplar halinde düzenlenmiş tüm 114 Kur'an suresinin tam listesi
• Mustafa İsmail ve Abdulbasit Abdussamed dahil birçok Hafız seçeneği
• İngilizce ve Almanca meal seçenekleri mevcut
• Oynatma kontrolleri (oynat/duraklat, sonraki, önceki, durdur)
• Duraklatıldıktan sonra tam kaldığı yerden devam etme
• Özelleştirilebilir ayarlar
• Oynatma durumu bildirimleri
• Özel Hafız listesi desteği
• Çoklu dil arayüzü (İngilizce, Türkçe, Almanca, Arapça)
• Cüz bazlı oynatma desteği

• GNOME Shell 45 veya daha yeni
• glib-compile-schemas (glib2.0-dev paketinin bir parçası)

Uzantıyı iki şekilde kurabilirsiniz:

1. GNOME Uzantılar'daki Kuran Tilaveti sayfasını ziyaret edin
2. Uzantıyı kurmak için anahtarı AÇIK konumuna getirin
3. Kurulumu tamamlamak için ek yönergeleri izleyin

1. Bu depoyu klonlayın veya indirin
2. Tüm dosyaları uzantı dizinine kopyalayın:

   mkdir -p ~/.local/share/gnome-shell/extensions/[email protected]
   cp -r * ~/.local/share/gnome-shell/extensions/[email protected]/

3. Şemayı oluşturun ve derleyin:

   cd ~/.local/share/gnome-shell/extensions/[email protected]/schemas
   glib-compile-schemas .

4. GNOME Shell'i yeniden başlatın:
   • X11'de: Alt+F2 tuşlarına basın, 'r' yazın ve Enter'a basın
   • Wayland'da: Oturumu kapatıp tekrar açın
5. Uzantıyı etkinleştirin:

   gnome-extensions enable [email protected]

Kurulumdan sonra, GNOME üst çubuğunda bir Kur'an simgesi göreceksiniz. Kur'an Oynatıcı menüsünü açmak için tıklayın.

• Sureleri gruplar halinde (15'li setler halinde düzenlenmiş) veya cüzleri görüntüleyin
• Oynatmayı başlatmak için herhangi bir sureye veya cüze tıklayın
• Oynatıcı kontrollerini kullanarak:
  • Oynat/Duraklat (duraklatıldığında aynı pozisyondan devam eder)
  • Durdur
  • Önceki sure/cüze geç
  • Sonraki sure/cüze geç
• Hafızlar alt menüsünden farklı Hafızları seçin
• Menüden ayarlara erişin

Uzantı ayarlarına şu şekilde erişin:

• Uzantı menüsünde "Ayarlar"a tıklayarak
• Veya GNOME Uzantılar uygulamasını kullanarak uzantının yanındaki dişli simgesine tıklayarak

Ayarlar panelinde şunları yapabilirsiniz:

• Tercih ettiğiniz Hafızı seçin
• Sonraki sure/cüz için otomatik oynatmayı açın/kapatın
• Bildirimleri etkinleştirin/devre dışı bırakın
• Özel bir sure veya cüz listesi dosyası ayarlayın
• Arayüz dilini değiştirin
• Sorun giderme için hata ayıklama günlük kayıtlarını etkinleştirin

Hafız eklemek veya düzenlemek için custom-reciters.json dosyasını düzenleyebilirsiniz. Format şu şekildedir:

[
  {
    "name": "Hafız Adı",
    "baseUrl": "https://example.com/path/to/audio/",
    "audioFormat": "%id%.mp3",
    "type": "surah"
  },
  {
    "name": "Özel Formatlı Hafız",
    "baseUrl": "https://example.com/path/to/audio/",
    "audioFormat": "%specialFormat%",
    "type": "surah",
    "hasSpecialFormat": true,
    "formatMap": {
      "01": "ozel-format-dosya-001.mp3",
      "02": "ozel-format-dosya-002.mp3"
    }
  }
]

audioFormat alanı şu yer tutucuları destekler:

• %id%: 3 basamaklı sure numarası (001, 002, vb.)
• %audioId%: surahs.json'daki audioId
• %name%: Sure adı

Not: Eğer bir hafızın eksik sureleri veya cüzleri varsa (bazıları eksikse), hafız tanımında "hasIncomplete": true olarak ayarlayın. Listede bu hafızların yanında uyarı göstergesi (!) göreceksiniz.

Yeni Hafız Ekleme:
Listeye eklemek istediğiniz Hafız varsa, GitHub'daki issue altına ismi ve tüm cüzleri veya tüm sureleri için internet bağlantıları ile bana iletin, inşallah ekliyeyim.

Uzantı çalışmıyorsa:

1. GNOME Shell 45 veya daha yenisini kullandığınızdan emin olun
2. Looking Glass'ta hataları kontrol edin (Alt+F2, 'lg' yazın)
3. Şema dosyasının doğru şekilde derlendiğinden emin olun
4. ~/.local/share/gnome-shell/extensions/[email protected]/schemas/ dizininin gschemas.compiled içerdiğini doğrulayın
5. Uzantı ayarlarında hata ayıklama günlük kaydını etkinleştirin ve günlükleri kontrol edin

Öneriler, hata raporları ve çekme istekleri GitHub'da memnuniyetle karşılanır!