Why Shamila? Arabic Libraries on your Computer

The most famous Arabic digital library (both online and on computer) is al-Shamila. It contains roughly 7260 Arabic books (when this post was written) on the various ِArabic (mostly Islamic) sciences and literature genres. Shamila comes with a desktop application to make access easy. The main problem of al-Shamila desktop application— apart from its clumsy interface — is that it only works on Windows. Running the al-Shamila .exe file on Mac in Wine application does not do the trick,  even though Wine works with almost all other applications such as notepad++ (see below).

Wine

 

The other option will be is to either run a so-called virtual machine, which runs Windows. To integrate this into the regular MacOS user experience you can use Parallels or CrossOver. Yet, both are unstable and buggy, not to mention that one will need to set the language on their Mac to Arabic and everything will go right to left. The better solution is to run the program in VirtualBoxVM (see this post on DO), but honestly why do this if all you want is Shamila.

Introducing مكتبة القرطاس (Maktabat al-Qirṭās):

For some reason the programers (AbouZakaria & kovax) who created it transliterate the program’s name as Elkirtasse, so we will stick with that. Elkirtasse  works on a whole slew of operating systems such as Linux, Windows, Ubuntu, Opensuse, Fedora, Haiku, and MacOS (formerly known as OSX). The application’s graphic resolution on mac may be a bit low, but if anything that contributes to the application running smooth as soft butter. As for the books, the programers decided not to reinventing the wheel, the program simply uses the books of al-Shamila; you  can import them or add them from elkirtasse website in their native elkirtasse .xml format. The program is open source, free, and pretty stable, smooth, and powerful.

There is in fact another program. The other program that one can use is أسفار that has, in my opinion, only one advantage over القرطاس; its just looks better. Asfar can be downloaded from the Mac app store for free. The main problem with Asfar is its slowness, it is buggy, and crashes for any (or no apparent) reason.

Bug

لسان
Another problem is when searching for a book Asfar application won’t show it if you uncheck (إظهار الكتب المحملة في الجهاز فقط)

Another problem that I have with Asfar is the search engine. Unlike Elkirtasse, if you are reading a book in Asfar you can only search for a word in the current page. If the searched word is not in the current page the application will jump to the first word appearance in the text without giving you a a separate window or a tab for the search results.

خمر اسفار
In Asfar, you can see how long it took the program to spit the results.
خمر
In Elkitasse, you can immediately jump to the result pages.

Take for example a search for the root Khamr (in Tafsīr al-baghawī) Asfar returned only 59 results while Elkirtasse 167, meanwhile al-Shamila —both online and the desktop application— returned 15! And you can see using Elkirtasse how much easier one can select and search: book, books, collection e.g. all the tafsīr books.  Plus you have the advantage of searching for word-root, search for several words (together in a page or separated), and search for the word in the first line in the book pages, and save the search results for later.

Screenshot 2018-10-25 at 21.19.17
Searching Asfar.
خمر تفسير.gif
Searching Elkirtasse.
Screenshot 2018-10-25 at 22.28.20
Searching Al-Shamila.
Screenshot 2018-10-25 at 22.28.47
Searching Al-Shamila online.

My main problem with Asfar is that you can’t add new books to it. In other words you are stuck with what the programer (Nayef Āl Mansī) decided to put there. The programer took the books that were available on al-Shamila when he released the program in 2012. Therefore the last book in Asfar is this one from June 2012. Al-Shamila team added around 1200 book since then, you can’t read those in Alasfar.  I told the programer about this two years ago and he promised to work on it (see the picture below). Another unpleasant thing is his elimination of some books in Asfar, for example the encyclopaedic masterpiece Kitāb al-aghānī is not there.

Screenshot 2018-11-01 at 21.35.13

On the other hand, in Elkirtasse you can create your own books, import text, html, and xml, and other files as books. You can export already existing book to a text file or html one. Unfortunately, the programers stopped updating the program since 2010 and some bugs like importing al-Shamila books (*.bok files) does not work on the Mac version. Also the link to update all the books automatically is a dead dropbox link. Other than that you can edit the books yourself, edit the table of content, open several books in tabs, print, search the table of content of one or several books,  add books to favourite, write your notes on the page that your reading, and make links between pages and passages from any book to any other one.

In short, Elkirtasse is an excellent application that makes it very easy to use the digital library Shamela. Its dead development cycle is a sore point which needs to be addressed. If you have questions (about installing or navigating etc.) do not hesitate to leave a comment below or send me a message on twitter.

 

Edited on Nov 1: added a paragraph about Asfar unable to import nor add new books

11 thoughts on “Why Shamila? Arabic Libraries on your Computer

  1. Hey! Thank you so much for this information. I have downloaded elkirtasse and played with it some, but I can’t seem to import books from al-shamila. I have them in .bok and .epub formats. The books I’m interested in are the عيون الأنباء في طبقات الأطباء and the إخبار العلماء بأخبار الحكماء. In my version of elkirtasse the option to convert .bok files claims the data is corrupted and the option that would convert epub files (if I’m reading it right) is greyed out. Do you have any hints or tricks that would allow me to read these books in elkirtasse? If not, I suppose the epub files can be read by iBooks. Thanks again!

  2. Hello! Thank you so much for this article. I have a question: is there any other alternative to converting epub files into xml for elkirtasse on mac? Everytime i check on the elkirtasse book source link, the books I need are not there (there is an empty page where the link should begin download!)
    Do you think a xml converter will do the trick so i can finally access my books in elkirtasse?
    Thank you in advance

    1. Hi there ADC,
      the short answer is no -unfortunately. You see, the e-books are made by the al-Shāmila team ( and other volunteers). What happens is, they add the new typed book to al-Shāmila application (on windows) and then manually will go through the book and mark it and tag it.

      Yeah, the dopbox book source link is out of date and dead, see the video above to see how to add new books to al-kirtasse.
      دُمتم بخير

      1. Hey maximabdulatif, thank you for making this very useful guide! I just downloaded elkirtasse. Am I correct in understanding that all the books of shamila are included in the original download except for the ones included in the google folders you linked (and that I’ll have an up-to-date library after I’ve added the books included in that google folder)?

        (this is what I downloaded: http://elkirtasse.sourceforge.net/index.php/menu-down-all/down-elkirtasse/78-down-elkirtasse)

        If so, how would I know when new books are available to add and how would I add them (would you post here regarding such an update/how to add the new books)?

        Sorry if my questions are unclear, I am a beginner student of these subjects at Stanford and am accessing shamila for the first time (the programs’ websites are somewhat difficult for me to navigate). If you are free for a brief call at some point to provide some guidance, I would really appreciate that. I can reach you on Facebook (I sent you a friend request).

        Thanks a bunch!

      2. My bad, I just realized that the link you posted just included the books requested by Joseph. I was curious to know how I might make sure I have all the shamila books accessible via elkirtasse (including those added by shamila after elkirtasse stopped being updated).

  3. There is another opensource library that has been updated in 2020:

    https://sourceforge.net/projects/asmaalibrary/

    > who created it transliterate the program’s name as Elkirtasse, so we will stick with that

    I think the authors are from North Africa, this is why it is spelled that way.

    Here are some of the gripes I have:

    – All these projects continue to use sourceforge, which has a confusing and painful UI that makes it difficult to use
    – These apps are built for fluent native Arabic speakers only(no labels or translations or even GitHub/other-git tools to add translations). Plenty of non-native Arabic learners would find these apps more useful if there was some support in at least English, but you first have to figure out the Arabic words for “search” “open file” etc. before you can actually use these programs.

    The whole dev ecosystem around Islamic software is all over the place. Mostly sad I guess.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s