Trouble shooting

From ZekrWiki

Jump to: navigation, search

This page is an ongoing effort to address some common problems with already discussed posts on the mailing list.

Contents

Questions and Answers

Installation

Q: I used to listen to default Zekr recitation (Al-Minshawi (versebyversequran.com)), but it doesn't work any more.

A: Zekr website is changed from siahe.com/zekr to zekr.org. So the default online recitation of Minshawi doesn't work any more. Please update your recitation pack.

Q: In Ubuntu, When I starts zekr I receive this warning "flashplugin-nonfree is not installed: Quran recitation cannot be used. Install flashplugin-nonfree to enable Quran recitation.". What should I do?

A: Install flashplugin-nonfree from the multiverse repository through the following steps:

Add extra Ubuntu/Debian repositories using the Software Sources application, which can be found in the menu: System -> Administration -> Software Sources. Check main, universe, and multiverse repositories (They are necessary for getting sun-java and some additional fonts and flashplugin). Run the following commands:

sudo apt-get update
sudo apt-get install flashplugin-nonfree

Q: In Ubuntu, When I starts zekr I receive this warning "ttf-me-quran is not installed.: Uthman-Taha experimental theme cannot be used. Install ttf-me-quran to enable Uthman-Taha theme." What should I do?"

A: Download ttf-me-quran font package from here. Then install it using the following command (Ubuntu example; [xyz] is version and architecture details and should be replaced based on what you have downloaded):
sudo dpkg -i ttf-me-quran_[xyz].deb

Q: On Ubuntu Gutsy/Feisty, although I have flash-plugin-nonfree package installed, Zekr recitation doesn't work

A: Sound, recitation doesn't work Ubuntu Gutsy.

Q: On Debian Sid, recitation doesn't work (player widget is not shown)?

A: Buggy flash-plugin-nonfree package on Debian.

Q: How can I enable Zekr audio support for XULRunner (Debian and Mac)?

A: Debian, Mac.

Q: Where can I find Zekr source code?

A: You can find check it out from the CVS, or find it here in almost all downloadable packages from Zekr website: [zekr package]/res/dist/zekr-src.jar. This source package is not included with our Debian package ([1]).

Q: How can I use Zekr together with XULRunner on Mac?

A: Zekr + XULRunner + Mac.

Q: How can I customize Zekr icons?

A: Change Zekr image folder.

Q: I'm behind a proxy server. How can I listen to online recitations?

A: No problem with IE or Safari. On Linux, follow instructions here.

Usability

Q: How can I test claimed textual miracles in the Quran (for example number of word Rajul, and Imra'at)?

A: Number of search hits.

Q: How can I have Quran text scrollbar on the right side of the screen on Windows, IE?

A: Scrollbar on right.

Add-ons

There is a blocking issue in Zekr 0.7.1 on Mac OS X which prevents user adding a new translation pack. There is a bug fix available (until the next version is out) for download. Please copy (overwrite) the following files inside Zekr.app/Contents/Resources/Java.

There was also a non-blocking issue discovered shortly after 0.7.1 release, which caused Bookmark sets not to save correctly. Please download the following files and put (replace) them in your [zekr installation folder]/dist as a patch:

Exceptions

In some cases, user may face the following exception:

org.eclipse.swt.SWTException: Failed to execute runnable (org.eclipse.swt.SWTException: Failed to execute runnable (java.lang.IllegalThreadStateException))
       org.eclipse.swt.SWT.error(Unknown Source)
       org.eclipse.swt.SWT.error(Unknown Source)
       org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Unknown Source)
       org.eclipse.swt.widgets.Display.runAsyncMessages(Unknown Source)
       org.eclipse.swt.widgets.Display.readAndDispatch(Unknown Source)
       net.sf.zekr.ui.BaseForm.loopEver(BaseForm.java:36)
       net.sf.zekr.ZekrMain.startZekr(ZekrMain.java:63)
       net.sf.zekr.ZekrMain.main(ZekrMain.java:88)

This happens mainly because of Zekr failing to check zekr.org if a newer version is available. User may however disable it, to workaround this unpleasant behavior. Here is the instruction:

1. edit C:\Documents and Settings\<username>\.zekr\config\config.properties (assuming that you are a Win XP/2k. On Vista, C:\Users\<username>\.zekr, on Mac OS X, /Users/<username>/.zekr, and on Linux the default home folder of Zekr is /home/<username/.zekr).

2. change update.enable to false:

update.enable = false

3. start Zekr.

Personal tools