arab-transliterator 1.0.3

python script for arabic text transcription

Phonetic Transcription

The phonetic transcription below is based on the scheme found in Arabic Through the Quran by Alan Jones (Islamic Texts Society, 2008). The correct form of pronunciation will depend on context, especially for the letters hamza and alif maksūra. The basic form of transcription is shown below.

Phonetic transcription for letters

	Letter	Transcription
0	alif	ā
1	bā	b
2	tā	t
3	thā	th
4	jīm	j
5	ḥā	ḥ
6	khā	kh
7	dāl	d
8	dhāl	dh
9	rā	r
10	zāy	z
11	sīn	s
12	shīn	sh
13	ṣād	ṣ
14	ḍād	ḍ
15	ṭā	ṭ
16	ẓā	ẓ
17	ʿayn	ʿ
18	ghayn	gh
19	fā	f
20	qāf	q
21	kāf	k
22	lām	l
23	mīm	m
24	nūn	n
25	hā	h
26	wāw	w
27	yā	y
28	hamza	'
29	alif maksura	ā
30	ta marbūta	t

Phonetic transcription for diactrics

	Diacritic	Transcription
0	fathatan	an
1	dammatan	un
2	kasratan	in
3	fatha	a
4	damma	u
5	kasra	i
6	shadda	(double)
7	sukūn	'

The long vowels are indicated by ā, ī and ū, and the maddah may also be used to lengthen a vowel. The shadda is indicated by the doubling of a letter

Usage

Python 3.9 or later required

pip install arab-transliterator

python -m arab_transliterator.transliterator [-t arab_text] [-f arab_file]

Ex1.

python -m arab_transliterator.transliterator -t "وَلَقَدْ آتَيْنَا مُوسَى الْكِتَابَ وَقَفَّيْنَا مِن بَعْدِهِ بِالرُّسُلِ ۖ وَآتَيْنَا عِيسَى ابْنَ مَرْيَمَ الْبَيِّنَاتِ وَأَيَّدْنَاهُ بِرُوحِ الْقُدُسِ ۗ أَفَكُلَّمَا جَاءَكُمْ رَسُولٌ بِمَا لَا تَهْوَىٰ أَنفُسُكُمُ اسْتَكْبَرْتُمْ فَفَرِيقًا كَذَّبْتُمْ وَفَرِيقًا تَقْتُلُونَ
"

output

walaqad ’ātaynā mūsá l-kitāba waqaffaynā min baʿdihi birrusuli  wa’ātaynā ʿīsá b-na maryama l-bayyināti wa'ayyadnāhu birūḥi l-qudusi  afakullamā jā'akum rasūlun bimā lā tahwá anfusukumu s-takbartum fafarīqan kadhdhabtum wafarīqan taqtulūna

Ex2

>>> from arab_transliterator.transliterator import ArabTransliterator
>>> Trans = ArabTransliterator()
>>> Trans.translate("وَفَرِيقًا تَقْتُلُونَ")
'wafarīqan taqtulūna'
>>>

Contributors

Feel free to contribute by making pull-requests or writing issues. Thanks