Installation

From ZekrWiki

Installation notes

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 find more add-ons for the software (translations, themes, recitations), check out resources page.

Windows

Windows prerequisites

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:

Windows installation

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):

java -version

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.

Linux

Ubuntu/Debian

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

If you are on Ubuntu 10.04 (Lucid) or newer, first install Sun 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.

Installing Zekr

There are two ways to install Zekr in Ubuntu/Debian: manual installation through the #Manual Installation or automatic installation through the #Zekr Repository.

Manual Installation

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

Zekr Repository

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):

export MOZILLA_FIVE_HOME=/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 romeo.cioaba@spotonearth.com
# # 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

Gentoo

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

Mandriva Linux 2010.0

Add Mandriva Turkiye repository via urpmi:

i586 arch:

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

x86_64 arch

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

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:

wget http://sourceforge.net/projects/zekr/files/Zekr/zekr-0.7.5/final/zekr-0.7.5-slack13.0-1hdi.tgz/download

2. Install it with installpkg command. For Zekr 0.7.5, you should write:

installpkg zekr-0.7.5-slack13.0-1hdi.tgz

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 MOZILLA_FIVE_HOME variable.

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:

export MOZILLA_FIVE_HOME=/usr/share/mozilla

or set this variable to whatever location your Mozilla is installed.

Mac

Simple Installation

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.

Installation procedure

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:

java -showversion

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.

4. Install XULRunner. You'll require version 1.8.1.2 or newer, which can be found here. If you have an older version currently installed. Please follow the instructions here, to uninstall first.

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:

cd .zeker/config

Now issue the following command:

nano config.properties

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 :-).

References

Retrieved from "http://zekr.org/wiki/Installation"

Category: All pages