Code Monkey home page Code Monkey logo

altaqwaa-islamic-app-english's Introduction

This project is an English verison of the original Al-Taqwaa app.

preview|690x388


Contents


App Features


  • The Noble Quran text and audio
  • A large collection of adhkar for morning, evening, daily life, sleep, and prayer
  • Various praises and supplications
  • Hisnul Muslim (Fortress of the Muslim)
  • English translation and transliteration available for Quran and Adhkar
  • Prayer times according to your location coordinates and time zone
  • Various methods of calculating prayer times (Umm al-Qura, Muslim World League and more...)
  • Audio notification (for the call to prayer)
  • Audio notification of morning and evening dhikr at a user-specific time
  • Download content to local directory for offline use
  • Customizable settings and user-interface
  • Modern, user-friendly design with light and dark modes
  • Completely free and open source under the GNU General Public License GPL-3.0
  • Support for Windows, Mac, and Linux operating systems


Screenshots


Dark Mode Light Mode
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa
altaqwaa altaqwaa

Settings

altaqwaa



Download



Installation

  • Windows: Run Altaqwaa.Setup.{ver}.exe or Altaqwaa.{ver}.msi and follow onscreen prompts. Once installed, the app should be accessible from the start menu.

  • MacOS: Run Altaqwaa-{ver}.dmg and drag icon into Applications folder.

  • Linux: Can be installed through multiple methods

    • Appimage: Run the .Appimage file to launch app

    • Debian: cd into location of .deb file and run command: sudo dpkg -i altaqwaa_{ver}_amd64.deb

    • Snap: cd into location of .snap file and run command: sudo snap install --devmode altaqwaa_{ver}_amd64.snap

    • Tar: cd into location of .tar.gz file and run:

    tar -xzf altaqwaa-{ver}.tar.gz
    cd altaqwaa-{ver}
    altaqwaa

    Installation via DEB or SNAP: Can launch app by running altaqwaa from any terminal or from Applications list in GUI.



FAQs

  • Is there a version of Altaqwaa for Android systems?

    Yes, you can find the repo for the Andriod version here.

  • What are the sources of content used in Altaqwaa?

    Altaqwaa is built with complete transparency and all sources used can be found here with accompanying links to the original data.


Contribute to the project

There are several ways to contribute to the Altaqwaa project:

  1. Contributing to the development process

    • Altaqwaa is build using the ElectronJS framework.
    • The majority of development involves work in Node.js and underlying languages HTML/CSS/JS.
    • If you have sufficient experience within this framework, please contact a contributor.
  2. Report issues on GitHub page here

    • Please provide a clear and descriptive title of the issue.
    • Include devise specifications and operating system (and distribution/interface used for Linux users).
    • Detailed description of the issue and steps to reproduce.
  3. Support the originial project financially through Github Sponsors from here

  4. Suggest new features and improvements

    • Contact a contributor with details on your idea to improve future Altaqwaa.
    • Open a new issue on GitHub page with suggestions to be added.
  5. Share Altaqwaa with people you know

    • Ibn Mas'ud (RAA) narrated that the Messenger of Allah (ﷺ) said:

    “He who guides (others) to an act of goodness, will have a reward similar to that of its doer.” Related by Muslim.



Running in development mode


Basic operating requirements:

  • nodejs
  • git
  • yarn or npm

using YARN


git clone https://github.com/rn0x/Altaqwaa-Islamic-Desktop-Application

cd Altaqwaa-Islamic-Desktop-Application

yarn install

yarn run dev

using NPM


git clone https://github.com/rn0x/Altaqwaa-Islamic-Desktop-Application

cd Altaqwaa-Islamic-Desktop-Application

npm install

npm run dev


Build from source


Application will be built according to the build configuration in package.json

using YARN


#Windows
yarn run packwin

#MacOS
yarn run packmac

#Linux
yarn run packlinux

using NPM


#Windows
npm run packwin

#MacOS
npm run packmac

#Linux
npm run packlinux


Dependencies

  • adhan-js
  • electron
  • fs-extra
  • moment-js (moment-duration-format, moment-hijri, moment-timezone)
  • node-fetch
  • menubar
  • v8-compile-cache
  • nodemon for developers only


Sources


Source Link
The Noble Quran https://github.com/rn0x/Quran-Json
Translation (The Clear Quran) https://theclearquran.com
Audio Files (Noble Quran) https://www.mp3quran.net/api/_arabic.json
Supplications https://www.islambook.com/azkar
Hisnul Muslim https://www.hisnmuslim.com
Geolocation API http://ip-api.com/json
Icons https://www.flaticon.com
Noble Quran Font https://fonts.qurancomplex.gov.sa/wp02
Arabic Font https://github.com/rastikerdar/vazirmatn
Animation Effects https://animate.style


Contributors



rn0x

kemzops


Glory is to You, O Allah, and praise; I bear witness that there is none worthy of worship but You. I seek Your forgiveness and turn to You in repentance.


altaqwaa-islamic-app-english's People

Contributors

yusif-razzaq avatar

Stargazers

 avatar Geek avatar  avatar rn0x avatar Aziz Mazouz Jaber avatar  avatar

Watchers

rn0x avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.