Skip to main content

A python Quran viewer

Project description

Overview

Noor is a program written in Python for viewing quran. Currently it contains a GTK interface that uses PyGtk library, a CGI interface that can be used in web servers and a text interface that outputs a sura to a text file. Also you can specify translation files; The translation of each aya is shown after it.

New Features

  • Changing CGI and GTK interfaces fonts

Getting Started

For using the GTK interface you need to install Python and PyGTK (they are installed by default in some linux distributions like Ubuntu). You can start it by running “noorgtk.py” script either from the command line or by double clicking it in the extracted folder. That is, no installation is necessary.

But if you like, you can run “python setup.py install” to install Noor. After that you’ll be able to run “noorgtk.py” in the terminal from any location.

Installing the CGI script, “noorcgi.py”, is like installing any other CGI script. You probably have to copy it to the cgi-bin directory of your web server. Bu before that you should either install noor as described in the previous paragraph or change the line in noorcgi.py file which looks like:

# Add noor to the python path if its not installed:
sys.path.append('/noor/extracted/folder/')

to point to the folder in which you’ve extracted noor. Note that if you want to use the CGI interface you no longer need to install PyGTK.

Adding Translations

You can edit the ~/.noor file:

[common]
translation = /path/to/translation/file

The translation file can be in two formats. It can be either a zip file in the same format as Zekr translation files which can be obtained from http://siahe.com/zekr/resources.html or it can be a utf-8 text file with translation of each aya in one line.

Changing Font

You can change the GTK or CGI fonts in ~/.noor file:

[gtk]
font = nazli 19

[cgi]
font = nazli 4

Project details


Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page