Användarmanual

1. Introduktion

Välkommen till Tajweed Koranen-appen — en interaktiv lärplattform som undervisar Tajweed-regler, kontrollerar ditt uttal under recitation, testar din memorering och svarar på dina frågor om Koranen och Tajweed-regler.

Koranens text visas alltid i arabisk Uthmani-skrift. Appens gränssnitt (knappar, menyer och förklaringar) översätts till över 68 språk, beroende på ditt val från språkmenyn högst upp på sidan.

2. Kontrollpanel och flikar

När du öppnar appen visas tre huvudflikar:

Varje regelruta öppnar en sida som visar verserna där regeln förekommer med färgkodade ord, referensrecitatörens röst och översättning/tolkning av versen enligt visningsspråket.

3. Språk och hjälp

Välja språk

Överst till vänster på varje sida (eller överst till höger i höger-till-vänster-språk) hittar du språkmenyn. Välj ditt språk — menyknapparna, rubrikerna och förklaringarna ändras omedelbart. Standardspråket är arabiska.

Hjälpknapp

Bredvid språkmenyn finns knappen ”Hjälp”. Den öppnar denna manual på ditt nuvarande språk i ett nytt fönster. Om en översättning till ditt språk inte är tillgänglig ännu, visas manualen på arabiska.

Tillbaka till kontrollpanelen

Knappen ”Tajweed-regler” överst till höger på sidan tar dig tillbaka till huvudsidan från vilken undersida som helst.

4. Tajweed-regelsidor

Varje regelsida visar:

• Definitionen av regeln på arabiska med översättning/transliteration på visningsspråket.
• En tabell eller Mushaf som markerar de berörda orden med en distinkt färg.
• Val av recitatör och uppspelning av versen eller sidans ljud.
• Markering av ord under uppspelning (karaoke): markeringen rör sig med recitatören ord för ord.
• Översättningsfält: från Kalimat.dev eller lokal tolkning beroende på valt språk.

Ljuduppspelning och ordval

• Enkelt klick på ett ord: Markerar det som en startpunkt (himmelsblå markering).
• Enkelt klick på ett annat ord: Utökar markeringen till ett intervall mellan de två orden.
• Klick inom det markerade intervallet: Spelar upp ljudet endast för det markerade intervallet med läsföljning (karaoke).
• Klick utanför intervallet: Återställer markeringen till det nya klickade ordet.
• Dubbelklick: Markerar ordet och läser det enskilt.
• Dra (Touch/Mouse Drag): För att markera ett avsnitt med en enda beröring och spela upp det omedelbart efter släpp.
• Knappen ”Lyssna”: Läser från det markerade ordet till slutet av versen (i vers- och sidlägen) med karaoke-färgning av orden.
• Knappen ”Upprepa”: Spelar upp det markerade avsnittet i en loop för övning.
• Klick utanför versområdet: Avmarkerar så att knappen ”Lyssna” återgår till att läsa versen från början.

5. Smart recitation (uttalskorrigering)

Sidan /r/recite/ låter dig recitera framför mikrofonen med ord-för-ord-verifiering med hjälp av en anpassad Koran-transkriptionsmodell (Whisper).

Skärmlayout

Uppifrån och ner:

1. Kontrollområde: Val av sura, intervall (vers/sida/sura), recitatör, mikrofon och acceptansgräns.
2. Navigationsfält: Spela/pausa versljud, sedan knapparna ” ” för verser och ” › ” för ord och för att upprepa.
3. Tajweed-färgkodningsguide: Visas direkt ovanför verstexten för enkel referens under recitation.
4. Versens text: Färgade och markerade ord för det aktuella ordet.

Starta recitation

1. Välj sura och intervall (en vers rekommenderas för nybörjare).
2. Texten visas automatiskt när sidan öppnas eller suran ändras.
3. Ange din e-postadress (sparas en gång för alla sidor).
4. Klicka på ”Starta recitation” och tillåt webbläsaren att komma åt mikrofonen.
5. Läs det markerade ordet; vid korrekt uttal blir det grönt och markeringen flyttas till nästa ord.

Navigationsknappar

Ordacceptansgräns

Du kan justera den lägsta förtroendenivån (från 30% till 70%) via skjutreglaget. Ett ord accepteras om dess uttal når eller överstiger denna gräns. Ett ord under gränsen visas med sin poäng i orange för att hjälpa dig att förbättra dig.

Färgkodning av Tajweed-regler

Aktivera ”Färgkodning av Tajweed-regler” för att se färgade tips på orden (Qalqalah, Ghunnah, Ikhfā’, Iẓhār, Lām al-Jalālah…). Det kan stängas av om du vill ha en Mushaf utan färger.

Bedömning av Tajweed-regler (valfritt)

När ”Bedömning av Tajweed-regler” är aktiverat, kontrolleras även Madd, Ghunnah och Qalqalah akustiskt — akustisk förtroende räcker inte ensamt.

Sök med recitation

Klicka på ”Sök med recitation” och läs några ord; appen visar matchande verser. Välj en vers för att öppna den direkt.

Ordpoäng och rensning

När du återvänder till en vers som du tidigare har reciterat, visas dina poäng för varje ord. Använd ”Rensa intervallpoäng” för att rensa poängen för versen/sidan/suran och försöka igen.

6. Hifz-test (memoreringstest)

Sidan /r/hifz/ testar din memorering: versen börjar tom, och varje ord visas när det uttalas korrekt.

• Klicka på ”Starta” och läs från minnet; korrekta ord visas gradvis.
• Ett felaktigt uttal ger en varningssignal utan att avslöja ordet.
• Du kan manuellt ”Visa ord” eller ”Visa vers” som en ledtråd.
• Övergången till nästa vers är manuell om du inte har slutfört hela versen korrekt.
• Kumulativa poäng för suran och hela Koranen registreras och är kopplade till din e-postadress.

7. Smart assistent

Från fliken ”Smart assistent” eller sidan /r/chatbot/ kan du ställa frågor om:

• Tajweed-regler (Vad är الإخفاء (Ikhfā’)? Var finns det i sura …?)
• Koranens text (Hur många verser finns i Juz’ Amma? Verser som innehåller ordet …)
• Sökning efter rot, upprepning eller stavning/Uthmani-skrift

Assistenten använder Tajweed-kunskapsbasen och Koran-databasen med Gemini-2.5-flash för att svara på ditt språk. Du kan:

• Utöka frågerutan (dra den nedre kanten eller skriv flera rader med Shift+Enter).
• Öppna nya konversationer, arkivera dem, radera dem eller ladda ner dem som PDF/Markdown.
• Använda exempelfrågor för att snabbt komma igång.

8. Poäng och rapporter

Ange din e-postadress en gång — den används för recitation, memorering och Tajweed-test. Poängen sparas i databasen och du kan:

• Se den kumulativa poängen för suran och Koranen i statusfältet.
• Granska dina tidigare försök för varje vers.
• Begära ”Skicka min rapport som PDF” för att få en detaljerad rapport skickad till din e-post (genomsnitt, högsta, lägsta, datum).

9. Ljudinställningar

Från knappen ”Ljud” på recitations- eller memoriseringssidan:

• Mikrofon: Välj inmatningsenhet om det finns fler än en.
• Högtalare: Välj utmatningsenhet (stöds i Chrome/Edge; kanske inte fungerar i Safari).
• Nivåindikator: Ett grönt fält som visar styrkan på din röst under recitation.
• Diagnostik: En teknisk logg för att felsöka transkriptionsproblem (lägg till ?debug=1 till länken).

10. Vanliga frågor

Varför förväntar sig appen ord jag inte har sagt (som Basmalah)?

Vissa recitatörer brukade börja med Basmalah före ”الم” eller ”آلم” i början av surorna. Vi har åtgärdat detta genom att upptäcka inledningen och justera om. Om problemet kvarstår, använd diagnostiken eller försök igen efter tre misslyckade försök, då appen automatiskt går vidare.

Fungerar det på mobilen?

Ja — Chrome på Android och Safari på iOS. Du kan behöva ett första klick för att aktivera ljudet (webbläsarpolicyer).

Är mina data privata?

Poängen är kopplade till din e-post och är isolerade mellan användare. Ljudinspelningar delas inte med tredje part — de behandlas på servern endast för verifiering.

Varifrån kommer översättningarna av verserna?

Kalimat.dev, den lokala databasen eller Tafsir al-Jalalayn översatt via Gemini för språk som inte stöds — och inte en direkt översättning av Koranens text med artificiell intelligens.