This is the only available installation manual for Zekr. If you are still unable to install it, check out project trouble shooting page. If that wasn't also helpful post your question on project mailing list.
In order to use Zekr on Windows, you should have:
- Windows 2000, XP or Vista, Seven, 2003 or 2008 server,
- complex language support for your Windows enabled (optional for Arabic searching),
- a Java (JRE) 1.5.0 or newer (get Java here).
- Flash player plugin for your browser (Internet Explorer) (only for Zekr 0.7.1 and older versions. This dependency is removed in 0.7.5 and newer versions).
To make sure that you have complex language support on Windows, see this page. There is also a good manual on Wikipedia:
- Enabling complex text support on Windows 2000
- Enabling complex text support on Windows XP and Server 2003
Zekr is tested and works fine on Windows 2000, XP and Vista. You should simply run executable setup file (zekr-[xyz]-setup.exe, where [xyz] is the version number) to install software on your computer. After installation, you can find Zekr on your programs section in "Start Menu".
Windows trouble shooting
If you had any problem running Zekr, make sure if you have a JRE 1.4.2 (or newer) installed on your system using the following command line (Start > Run > type cmd and click OK):
This should give you a result like this (note that this is Sun's HotSpot VM, you might have other JVM like IBM's, or BEA's):
java version "1.5.0_02"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_02-b09) Java HotSpot(TM) Client VM (build 1.5.0_02-b09, mixed mode, sharing)
If you are given a result like the following, then you should probably not having Java installed:
'java' is not recognized as an internal or external command, operable program or batch file.
- 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 command to update the your package cache:
sudo apt-get update
- To install extra fonts run the following commnads:
sudo apt-get install ttf-farsiweb
Install A Compatible Java JRE
sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner" sudo apt-get update sudo apt-get install sun-java6-jre
- Running the following command:
sudo update-java-alternatives -l
you will see some Java versions available. For example you will see some output like this:
java-1.5.0-sun 53 /usr/lib/jvm/java-1.5.0-sun java-6-sun 63 /usr/lib/jvm/java-6-sun
- you should then set your default Java to Sun Java using the following command:
sudo update-java-alternatives --set java-6-sun
- Note that the above instructions may differ from an Ubuntu version to another.
- ttf-me-quran and ttf-sil-scheherazade are two necessary fonts for Zekr. Download them from here. Then install them (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 ttf-sil-scheherazade_[xyz].deb
- Make sure that first you have installed one of the compatible Java JREs discussed in #Install A Compatible Java JRE, if not zekr won't get configured correctly at the installation time.
- Download the latest version of Zekr from here. Get zekr_[version]_i386.deb or zekr_[version]_amd64.deb based on your Machine architecture. Then, Install Zekr with the following command line:
sudo dpkg -i zekr_[xyz].deb
- To install extra Quran translations available for Zekr, download zekr-quran-translation-[ab]-[author]_[version]_all.deb from here ([ab] is the ISO code of the language and [author] is the author of the translation ). Install it by the following command:
sudo dpkg -i zekr-quran-translation-[ab]-[author]_[version]_all.deb
NOTE: use repository ONLY IF your distribution is either 'lucid', 'karmic', 'jaunty', 'intrepid', or 'hardy'. IF NOT use #Manual Installation
- To add the Zekr repository, run the following command in a terminal:
sudo gedit /etc/apt/sources.list
- Add ONLY ONE of the following lines based on your OS (Ubuntu Lucid 10.04, Karmic 9.10, Jaunty 9.04, Intrepid 8.10, or Hardy 8.04) at the end of /etc/apt/sources.list
deb http://ppa.launchpad.net/zekr/ubuntu lucid main deb http://ppa.launchpad.net/zekr/ubuntu karmic main deb http://ppa.launchpad.net/zekr/ubuntu jaunty main deb http://ppa.launchpad.net/zekr/ubuntu intrepid main deb http://ppa.launchpad.net/zekr/ubuntu hardy main
- To install Zekr and the necessary fonts, run the following commands in the terminal:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys EF400C7C sudo apt-get update sudo apt-get install zekr ttf-me-quran ttf-sil-scheherazade sudo apt-get install ttf-farsiweb
- Zekr comes with extra Quran translations in English, Russian, Tatar, Persian, Bahasa Indonesia, Turkish, French, Dutch, Urdu, Bosnian, Portuguese, Spanish, Italian, and German packaged as zekr-quran-translation-XY-ID where XY is the ISO code of the language and ID is the id of the translation. Run
apt-cache search zekr-quran-translation
in a shell to list them all. Then among the result list choose the appropriate package and install it: For example if you want to install the English Translation of Quran by Abdullah Yusuf Ali run the following command:
sudo apt-get install zekr-quran-translation-en-yusufali
Fedora or SUSE
You can simply install .rpm package (if provided) with the following command (having root privilege):
rpm -i zekr-[version]-[xyz].rpm
where [version] is the version of Zekr, and [xyz] is package versioning and architecture info. A full name of an RPM can be: zekr-0.6.6-0.1.i386.rpm.
If you are using base .tar.gz package of the Zekr, you try to put the following code at the beginning of zekr.sh (if your firefox is installed in /usr/lib/firefox):
It's also probable that the above doesn't work. In that case try to change it to one of the followings until you find one which works:
1. export MOZILLA_FIVE_HOME=/usr/lib/mozilla 2. export MOZILLA_FIVE_HOME=/usr/share/firefox 3. export MOZILLA_FIVE_HOME=/usr/share/mozilla
There is a step-by-step instruction for installing Zekr on openSUSE on its wiki.
Enabling Audio Recitation Support If It Is Not Working With 64-Bit Linux
The following information is the result of my experiences with Fedora 10, Fedora 11, and OpenSUSE 11.1 all 64bit. It may work on other distributions and architectures but I can give no guarantee that it will work. If you have properly installed Flash for Linux (the 64 bit alpha ) and the Quran recitation still doesn't work please follow the following step.
1. Copy the plugin (libflashplayer.so) to the (~/.mozilla/plugins) folder. In OpenSUSE 11.1 64-bit, libflashplayer.so is usually installed in (/usr/lib64/browserplugins) your default location may vary with other distributions. For 64-bit Linux installations, it is highly recommended that you use the 64bit alpha release of flash.
Alternatively you can save this code as a script (zekrflash.sh) and execute it from a terminal.
#!/bin/bash # Script created by # Romeo-Adrian Cioaba firstname.lastname@example.org # # http://www.myscienceisbetter.info/2008/11/install-native-64bit-flash-player-10-on-linux.html # Adaptação para Opensuse 11.0 - Claudio de Taunay # Edited by inxane for Zekr recitation support echo "Stopping any Firefox that might be running" sudo killall -9 firefox echo "Removing any other flash plugin previously installed:" sudo rm -f /usr/lib64/browser-plugins/npwrapper.libflashplayer.so sudo rm -f /usr/lib/browser-plugins/libflashplayer.so sudo rm -f /usr/lib/flash-plugin/libflashplayer.so sudo rm -rfd /usr/lib/nspluginwrapper echo "Installing Flash Player 10" wget http://download.macromedia.com/pub/labs/flashplayer10/libflashplayer-10.0.32.18.linux-x86_64.so.tar.gz tar zxvf libflashplayer-10.0.32.18.linux-x86_64.so.tar.gz echo "Creating directories if necessary" sudo mkdir $HOME/.mozilla sudo mkdir $HOME/.mozilla/plugins echo "Copying the plugin to appropriate locations" sudo cp libflashplayer.so /usr/lib64/browser-plugins/libflashplayer.so sudo cp libflashplayer.so /usr/lib/browser-plugins/libflashplayer.so sudo cp libflashplayer.so $HOME/.mozilla/plugins/libflashplayer.so # now doing some cleaning up: echo "Cleaning up..." sudo rm -rf libflashplayer.so sudo rm -rf libflashplayer-10.0.22.87.linux-x86_64.so.tar.gz
Sometimes upgrading to the bleeding edge of various mozilla-suite products causes breakage, right?
Here's a good solution:
In Gentoo in particular, mozilla-firefox libraries live in /usr/lib/mozilla-firefox. Download and extract the zekr-linux-<xy>.tar.gz.
export MOZILLA_FIVE_HOME=/usr/lib/mozilla-firefox ./zekr.sh
If that doesn't work,
emerge mozilla-thunderbird export MOZILLA_FIVE_HOME=/usr/lib/mozilla-thunderbird ./zekr.sh
Mandriva Linux 2010.0
- Add Mandriva Turkiye repository via urpmi:
urpmi.addmedia mvt-2010.0-i586-nonfree ftp://ftp.linux.org.tr/mandriva-tr/2010.0/i586/non-free with media_info/synthesis.hdlist.cz
urpmi.addmedia mvt-2010.0-x86_64-nonfree ftp://ftp.linux.org.tr/mandriva-tr/2010.0/x86_64/non-free with media_info/synthesis.hdlist.cz
- Enable Official Mandriva Linux contrib and non-free repositories using these commands:
su drakrpm-edit-media --expert
- If installed remove official Mandriva's or Adobe's flash plugin packages. (Zekr package depends on PLF's flash plugin package)
- If you use i586 arch,
- Add Penguin Liberation Font (PLF) repositories via Easyurpmi
- Install "flash-player-plugin" package
- If you using x86_64 arch no need to add PLF repositories 64 bit flash-player is available on Mandriva Turkiye repository,
- Install "flash-player-plugin" package
- Update your repositories and install zekr using RPMDrake
- Also, you can try zekr-downloader script (available at Mandriva Turkiye repository) to automatically download and install Holly Quran recitations and translations.
Slackware Linux 13.0
With Slackware Linux 13.0 fresh installation, you can add Zekr application with simple steps. 1. download Zekr for Slackware. For example if you want Zekt 0.7.5, you can download it with the following command:
2. Install it with installpkg command. For Zekr 0.7.5, you should write:
Other Linux distributions
If you are using other distributions such as Fedora Core or SUSE, simply use our .tar.gz package, but first make sure to set your Mozilla installation directory manually in zekr.sh as
You should first download and install a Mozilla GTK2 (1.4+) browser from mozilla.org (Firefox can also be used on some distributions). You can download Mozilla 1.7.3 GTK2 from Mozilla.org.
Please remember where the Mozilla in installed (examples are /usr/local/mozilla, /usr/share/mozilla, or /usr/lib/mozilla), and check if there is a components folder inside the Mozilla home directory. You should set an environment variable MOZILLA_FIVE_HOME to the Mozilla home directory. If there is no components folder inside Mozilla home, check [mozilla home]/lib, and if there was such a folder, set the environment variable to this location.
To set the variable you can simply run this command at your system startup, or (alternatively) put this line in zekr.sh file:
or set this variable to whatever location your Mozilla is installed.
On many Macs, including Mac OS X Leopard (10.5) and Mac OS X Tiger (10.4.11), you can either unpack .tgz package or simply run .dmp archive. However, if audio doesn't work, try the steps below.
IMPORTANT NOTE: be careful about the path you install Zekr on. If you are installing .tgz package, and path has any white spaces, it fails to run, without any meaningful error message. It is always more safe to put it in the Applications directory.
Enabling Audio Recitation Support If It Is Not Working
The following notes have been compiled on Mac OS X Tiger version 10.4.10. They might work on lower Tiger (10.4.x) versions but no guarantees can be given. The purpose of these instructions is to to get Zekr working with audio recitation support, which on the Mac unfortunately does not work following the regular installation procedure (see above). Also note that the procedure below only works with Zekr 0.6.6 or newer.
IMPORTANT NOTE: After following the procedures below, recitation support is enabled and will work, however there is still a rather annoying cosmetic issue in that the audio controls are not fully rendered on screen initially. However, if you hover your mouse over the area where the controls should be, you'll see that they will (partially) get drawn. This issue is yet to be resolved.
1. Unpack the archive and I would recommend you install Zekr in the Applications Folder by dragging it there.
2. Ensure you have the latest version of Flash (currently 9,0,47,0) for Firefox (or any Mozilla based browser, such as Flock). You can check this here
3. Ensure you have Java for Mac OS X 10.4, Release 5 or newer. You can check this by opening Terminal and issueing the following command:
This will give you a long listing as shown in picture 1. your version number is right at the top. Alternatively you can also issue this command: java -version, which simply prints the version info.
5. Now in the finder go to the /Library/Internet Plug-Ins folder and select the 'Flash Player.plugin' and the 'flashplayer.xpt' files and copy them (hint; choose Copy from the Edit menu)
6. Now move to the /Library/frameworks/xul.framework/Version/Current folder and open the plugins folder and paste the 'Flash Player.plugin' and the 'flashplayer.xpt' files there.
7. Lastly you'll need to edit the Zekr config.properties file which is in a hidden directory in your home folder. To do this, open the Terminal application and type the following command:
Now issue the following command:
this will give you the screen shown in picture 2. With your cursor keys move to the line that reads 'options.browser.useMozilla = false' and change 'false' to 'true'. Then exit nano by through the CTRL X key combination and type a 'y' end enter to confirm the changes.
InshAllah that should enable audio recitation for you on the Mac :-).
- Zekr main download page
- Zekr Quran translations
- Zekr download page in SourceForge.net
- Zekr FAQ
- Zekr project mailing list on Google Groups