# termux-sriparna
A voice assistant for Termux written in python using [Termux Api](https://wiki.termux.com/wiki/Termux:API)
With sriparna you can:
1) Call any number ✅
2) Check battery status ✅
3) Send messages ❌
4) Open any app ✅
5) Check whether ✅
6) See current date and time ✅
7) See live location (with google maps link) ❌
8) Read call logs ❌ (Deprecated)
9) Perform any search ✅
10) Turn Flash on/off ✅
More features coming...
**Note: This is a voice assistant and not to be used as a chatbot !**
If you like the project, don't forget to leave a star ⭐ to the repository.
It motivates me to keep continue the project.
**PR's are welcomed !!**
**Report Bugs(if any)**
## Requirements:
• [Termux](https://f-droid.org/en/packages/com.termux/)
• [Termux-Api](https://f-droid.org/en/packages/com.termux.api/)
• [Termux-Widget](https://f-droid.org/en/packages/com.termux.widget/) (Optional: For shortcut application)
Note: Download these apps from the following official links only.
Do not use playstore version !!
**Please grant all permission to Termux-api and disable battery optimisation for the app beforehand.**
## Installation:
##### Install using pypi
```
pkg update && pkg upgrade -y
pkg install python -y
pip install -Uv termux-sriparna
```
After using the above commands you can type ```sriparna``` or ```sriparna-gui``` to run the voice assistant.
##### or
1. Clone the GitHub repository:
```
git clone https://github.com/ayusc/termux-sriparna
```
2. Navigate to the project directory:
```
cd termux-sriparna
```
3. Run the setup script
```
bash setup.sh
```
4. Run the voice assistant:
```
python sriparna/sriparna.py
```
For terminal version
**or**
```
python sriparna/sriparna.py
```
For gui version
## Commands
Each command is assisted with a pattern type:
##### To call any number you can say "hey sriparna call XXXXXXXXXX"
You can also include country code in your query "hey sriparna call plus(country code)******" it will read the number as "+(country code)number"
Besides you can call a number from your contact list just say "sriparna call ayus", "please call ayus2" etc...
Note: In certain cases the speech recognition may not correctly identify the contact name. In such case it's better to spell the letters in the name individually. For example "sriparna please call a y u s", "call a y u s 2" etc...
##### To check battery you can say "sriparna how much is my battery", "tell my battery percentage", "hello what is my battery status", "tell my battery health"
##### To open any application you can say "open whatsapp", "sriparna please open youtube" etc...
You can open chrome, gmail, youtube and whatsapp with this, if you want more applications you need to specify their package names and class name in app.json
You can use [Shortcut Maker](https://play.google.com/store/apps/details?id=rk.android.app.shortcutmaker) to find package name and class names of installed applications.
For pypi installation: You can directly edit the apps.json file with `vi /data/data/com.termux/files/usr/lib/python$(python -c 'import sys; print(sys.version_info[0])').$(python -c 'import sys; print(sys.version_info[1])')/site-packages/sriparna/apps.json
`
##### To check the current weather conditions you can "hi sriparna whats the weather alike", "tell me the weather forecast", "what is the current weather condition", "how is the weather today"
##### To turn on flashlight you can say "hey please turn on the flash/torch", "flash/torch on", similarly you can say "hey please turn off the flash/torch", "flash/torch off" to turn it off.
##### To know current date and time you can say "what is(or what's) the time", "what is today's date", "what date is today"
# Credits
[xtekky](https://github.com/xtekky) for [g4f](https://github.com/xtekky/gpt4free)
Slash Mark IT for the project idea.
Raw data
{
"_id": null,
"home_page": "https://github.com/ayusc/termux-sriparna",
"name": "termux-sriparna",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, voice assistant, termux, termux-api, g4f",
"author": "Ayus Chatterjee",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/ad/1f/03b00e3d8df4f1637bc0bad2765beb6655fc980c683f754060b36ebdbde9/termux-sriparna-1.1.0.tar.gz",
"platform": null,
"description": "\n# termux-sriparna\n\n\n\nA voice assistant for Termux written in python using [Termux Api](https://wiki.termux.com/wiki/Termux:API)\n\nWith sriparna you can:\n\n1) Call any number \u2705\n2) Check battery status \u2705\n3) Send messages \u274c\n4) Open any app \u2705\n5) Check whether \u2705\n6) See current date and time \u2705\n7) See live location (with google maps link) \u274c\n8) Read call logs \u274c (Deprecated)\n9) Perform any search \u2705\n10) Turn Flash on/off \u2705\n \nMore features coming...\n\n**Note: This is a voice assistant and not to be used as a chatbot !**\n\nIf you like the project, don't forget to leave a star \u2b50 to the repository.\nIt motivates me to keep continue the project.\n\n**PR's are welcomed !!**\n**Report Bugs(if any)**\n\n## Requirements:\n\n\u2022 [Termux](https://f-droid.org/en/packages/com.termux/)\n\n\u2022 [Termux-Api](https://f-droid.org/en/packages/com.termux.api/)\n\n\u2022 [Termux-Widget](https://f-droid.org/en/packages/com.termux.widget/) (Optional: For shortcut application)\n\nNote: Download these apps from the following official links only.\n\nDo not use playstore version !!\n\n**Please grant all permission to Termux-api and disable battery optimisation for the app beforehand.** \n\n## Installation:\n\n##### Install using pypi\n\n```\npkg update && pkg upgrade -y\npkg install python -y\npip install -Uv termux-sriparna\n```\n\nAfter using the above commands you can type ```sriparna``` or ```sriparna-gui``` to run the voice assistant.\n\n\n##### or\n\n1. Clone the GitHub repository:\n\n```\ngit clone https://github.com/ayusc/termux-sriparna\n```\n\n2. Navigate to the project directory:\n\n```\ncd termux-sriparna\n```\n\n3. Run the setup script\n \n```\nbash setup.sh\n```\n\n4. Run the voice assistant:\n\n```\npython sriparna/sriparna.py \n```\nFor terminal version \n\n**or**\n\n```\npython sriparna/sriparna.py \n```\nFor gui version\n\n## Commands\n\nEach command is assisted with a pattern type:\n\n##### To call any number you can say \"hey sriparna call XXXXXXXXXX\"\n\nYou can also include country code in your query \"hey sriparna call plus(country code)******\" it will read the number as \"+(country code)number\"\n\nBesides you can call a number from your contact list just say \"sriparna call ayus\", \"please call ayus2\" etc...\n\nNote: In certain cases the speech recognition may not correctly identify the contact name. In such case it's better to spell the letters in the name individually. For example \"sriparna please call a y u s\", \"call a y u s 2\" etc...\n\n##### To check battery you can say \"sriparna how much is my battery\", \"tell my battery percentage\", \"hello what is my battery status\", \"tell my battery health\"\n\n##### To open any application you can say \"open whatsapp\", \"sriparna please open youtube\" etc...\n\nYou can open chrome, gmail, youtube and whatsapp with this, if you want more applications you need to specify their package names and class name in app.json\n\nYou can use [Shortcut Maker](https://play.google.com/store/apps/details?id=rk.android.app.shortcutmaker) to find package name and class names of installed applications.\n\nFor pypi installation: You can directly edit the apps.json file with `vi /data/data/com.termux/files/usr/lib/python$(python -c 'import sys; print(sys.version_info[0])').$(python -c 'import sys; print(sys.version_info[1])')/site-packages/sriparna/apps.json\n`\n\n##### To check the current weather conditions you can \"hi sriparna whats the weather alike\", \"tell me the weather forecast\", \"what is the current weather condition\", \"how is the weather today\"\n\n##### To turn on flashlight you can say \"hey please turn on the flash/torch\", \"flash/torch on\", similarly you can say \"hey please turn off the flash/torch\", \"flash/torch off\" to turn it off.\n\n##### To know current date and time you can say \"what is(or what's) the time\", \"what is today's date\", \"what date is today\"\n\n# Credits\n[xtekky](https://github.com/xtekky) for [g4f](https://github.com/xtekky/gpt4free)\n\nSlash Mark IT for the project idea.\n",
"bugtrack_url": null,
"license": null,
"summary": "A voice assistant for Termux written in python using Termux Api",
"version": "1.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/ayusc/termux-sriparna/issues",
"Feature Requests": "https://github.com/ayusc/termux-sriparna/issues/1",
"Homepage": "https://github.com/ayusc/termux-sriparna",
"Source Code": "https://github.com/ayusc/termux-sriparna"
},
"split_keywords": [
"python",
" voice assistant",
" termux",
" termux-api",
" g4f"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad1f03b00e3d8df4f1637bc0bad2765beb6655fc980c683f754060b36ebdbde9",
"md5": "50958a1ecb6bf13eba9cbd9ae0300de2",
"sha256": "5e6d33b87151a71a98051f9255fa3777dcef49e98e44421914d909ce6f9e6a1b"
},
"downloads": -1,
"filename": "termux-sriparna-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "50958a1ecb6bf13eba9cbd9ae0300de2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1026227,
"upload_time": "2024-03-26T09:18:51",
"upload_time_iso_8601": "2024-03-26T09:18:51.204267Z",
"url": "https://files.pythonhosted.org/packages/ad/1f/03b00e3d8df4f1637bc0bad2765beb6655fc980c683f754060b36ebdbde9/termux-sriparna-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-26 09:18:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ayusc",
"github_project": "termux-sriparna",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "speechrecognition",
"specs": []
},
{
"name": "g4f",
"specs": []
},
{
"name": "brotli",
"specs": []
},
{
"name": "python_weather",
"specs": []
},
{
"name": "pytz",
"specs": []
},
{
"name": "geopy",
"specs": []
},
{
"name": "pythondialog",
"specs": []
},
{
"name": "python-dateutil",
"specs": []
}
],
"lcname": "termux-sriparna"
}
JSON
