{"id":25900505,"url":"https://github.com/aria-hosseini/nina","last_synced_at":"2026-05-06T04:03:47.360Z","repository":{"id":280309881,"uuid":"941578061","full_name":"Aria-Hosseini/Nina","owner":"Aria-Hosseini","description":"Nina is a smart voice assistant built with C# and Windows Forms, designed to help you perform everyday tasks using voice commands. From opening apps to searching Google or interacting with custom forms, Nina makes your computer experience hands-free and fun!","archived":false,"fork":false,"pushed_at":"2025-03-02T16:24:13.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-02T17:29:12.793Z","etag":null,"topics":["assistant","cplusplus","csharp","nestedv","nina","vihancode","voice-assistant","windows-forms"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aria-Hosseini.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-02T16:15:38.000Z","updated_at":"2025-03-02T16:27:12.000Z","dependencies_parsed_at":"2025-03-02T17:29:25.537Z","dependency_job_id":"3383bf58-68b4-4dc5-b6c8-60d87d81e744","html_url":"https://github.com/Aria-Hosseini/Nina","commit_stats":null,"previous_names":["aria-hosseini/nina"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aria-Hosseini%2FNina","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aria-Hosseini%2FNina/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aria-Hosseini%2FNina/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aria-Hosseini%2FNina/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aria-Hosseini","download_url":"https://codeload.github.com/Aria-Hosseini/Nina/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241596277,"owners_count":19988045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assistant","cplusplus","csharp","nestedv","nina","vihancode","voice-assistant","windows-forms"],"created_at":"2025-03-03T02:17:02.837Z","updated_at":"2026-05-06T04:03:47.290Z","avatar_url":"https://github.com/Aria-Hosseini.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# English Version\n\n# Nina - Voice Assistant\n\n**Nina** is a smart voice assistant built with C# and Windows Forms, designed to help you perform everyday tasks using voice commands. From opening apps to searching Google or interacting with custom forms, Nina makes your computer experience hands-free and fun!\n\n---\n\n## ✨ Features\n\n- **Open Applications**: Use commands like \"Open Chrome\", \"Open Telegram\", or \"Open VS Code\" to launch your favorite apps.\n- **Simple Conversations**: Responds to greetings, jokes, and questions like \"What time is it?\".\n- **Google Search**: Say \"Search weather in Tehran\" to search in your default browser.\n- **Custom Forms**: Open custom forms like \"Open Applist\" to view installed programs.\n- **Time-Based Responses**: Reacts appropriately to the time of day (morning, afternoon, evening).\n- **Voice Customization**: Change Nina’s voice to your preference (e.g., Microsoft Zira or David).\n\n---\n\n## 🛠 Prerequisites\n\nTo run or develop Nina, you’ll need:\n- **Windows 7/8/10/11** (uses Windows Forms and Speech API)\n- **Visual Studio 2019 or later** (for building and debugging)\n- **.NET Framework 4.7.2 or higher**\n- **Microphone** (for voice command recognition)\n\n---\n\n## 📦 Installation and Setup\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/Aria-Hosseini/nina-voice-assistant.git\n   ```\n   (Replace with your repo URL if hosted)\n\n2. **Open the Project**:\n   - Open `Voice_Assistant.sln` in Visual Studio.\n\n3. **Build and Run**:\n   - Build the project (F5 or Build \u003e Build Solution).\n   - Click the \"Start\" button in the form to begin using Nina!\n\n---\n\n## 🎙 How to Use\n\nAfter launching, press \"Start\" to make Nina listen. Try these commands:\n- \"Hello\" → \"Hi there!\"\n- \"Open Chrome\" → Opens Google Chrome\n- \"Search best C# tutorials\" → Searches Google\n- \"Open Applist\" → Shows a list of installed programs\n- \"Goodbye\" → \"Goodbye! Have a great day!\"\n\nClick \"Stop\" to pause listening.\n\n---\n\n## 🖥 User Interface\n\n- **RichTextBox**: Displays your commands and Nina’s responses.\n- **Status Label**: Shows \"Listening...\" in green or \"Not Listening\" in red.\n- **Buttons**: Start, Stop, Minimize, and Close for controlling the assistant.\n\n---\n\n## 🔧 Development and Customization\n\n### Change Voice\nTo switch Nina’s voice:\n1. In `mainform.cs`, in the constructor:\n   ```csharp\n   Synthesizer.SelectVoice(\"Microsoft Zira Desktop\"); // Or any other voice\n   ```\n2. To list available voices:\n   ```csharp\n   foreach (var voice in Synthesizer.GetInstalledVoices())\n   {\n       MessageBox.Show(voice.VoiceInfo.Name);\n   }\n   ```\n\n### Add New Commands\n1. Add the command to `textStrings` in the constructor (e.g., \"Open Notepad\").\n2. Add a case in `RecognitionEngine_SpeechRecognized`:\n   ```csharp\n   case \"Open Notepad\":\n       richTextBox1.AppendText($\"{Environment.NewLine}Open Notepad\");\n       Synthesizer.Speak(\"Opening Notepad...\");\n       System.Diagnostics.Process.Start(\"notepad.exe\");\n       break;\n   ```\n\n---\n\n## 🐛 Known Issues\n\n- **App Opening Failures**: If an app’s executable isn’t in PATH, use the full path (e.g., for Telegram).\n- **Voice Recognition**: May struggle in noisy environments.\n\nReport any bugs in the Issues section!\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions!\n1. Fork the repository.\n2. Make changes in a new branch.\n3. Submit a Pull Request.\n\n---\n\n## 🙏 Acknowledgments\n\n- Thanks to the C# community for awesome libraries and tools!\n- And to you for trying out Nina!\n\n---\n\nStart Nina and enjoy a voice-powered experience! Questions? Hit me up in Issues. 🎤\n\n---\n\n# نسخه فارسی\n\n# نینا - دستیار صوتی\n\n\n\n**نینا** یه دستیار صوتی هوشمند ساخته‌شده با C# و Windows Forms هست که بهتون اجازه می‌ده با صدای خودتون کارهای روزمره رو انجام بدید. از باز کردن برنامه‌ها گرفته تا سرچ توی گوگل و تعامل با فرم‌های سفارشی، نینا تجربه کار با کامپیوتر رو بدون دست و جذاب می‌کنه!\n\n---\n\n## ✨ قابلیت‌ها\n\n- **باز کردن برنامه‌ها**: با دستوراتی مثل \"Open Chrome\"، \"Open Telegram\" یا \"Open VS Code\" برنامه‌های مورد علاقه‌تون رو باز کنید.\n- **مکالمه ساده**: به سلام‌ها، شوخی‌ها و سؤالاتی مثل \"What time is it?\" جواب می‌ده.\n- **سرچ در گوگل**: بگید \"Search weather in Tehran\" تا توی مرورگر پیش‌فرض سرچ کنه.\n- **فرم‌های سفارشی**: با \"Open Applist\" لیست برنامه‌های نصب‌شده رو ببینید.\n- **پاسخ بر اساس زمان**: به وقت روز (صبح، عصر، شب) جواب مناسب می‌ده.\n- **شخصی‌سازی صدا**: صدای نینا رو به دلخواه عوض کنید (مثلاً Microsoft Zira یا David).\n\n---\n\n## 🛠 پیش‌نیازها\n\nبرای اجرا یا توسعه نینا، این‌ها رو نیاز دارید:\n- **ویندوز 7/8/10/11** (چون از Windows Forms و Speech API استفاده می‌کنه)\n- **ویژوال استودیو 2019 یا جدیدتر** (برای بیلد و دیباگ)\n- **NET Framework 4.7.2 یا بالاتر**\n- **میکروفون** (برای تشخیص دستورات صوتی)\n\n---\n\n## 📦 نصب و راه‌اندازی\n\n1. **مخزن رو کلون کنید**:\n   ```bash\n   git clone https://github.com/Aria-Hosseini/nina-voice-assistant.git\n   ```\n   (اگه پروژه رو توی GitHub داری، آدرسش رو بذار)\n\n2. **پروژه رو باز کنید**:\n   - فایل `Voice_Assistant.sln` رو توی ویژوال استودیو باز کنید.\n\n3. **بیلد و اجرا**:\n   - پروژه رو بیلد کنید (F5 یا Build \u003e Build Solution).\n   - دکمه \"شروع\" رو توی فرم بزنید تا نینا آماده شنیدن بشه!\n\n---\n\n## 🎙 نحوه استفاده\n\nبعد از اجرا، دکمه \"شروع\" رو بزنید تا نینا گوش بده. این دستورات رو امتحان کنید:\n- \"سلام\" → \"سلام به شما!\"\n- \"Open Chrome\" → باز کردن گوگل کروم\n- \"Search best C# tutorials\" → سرچ توی گوگل\n- \"Open Applist\" → نمایش لیست برنامه‌های نصب‌شده\n- \"خداحافظ\" → \"خداحافظ! روز خوبی داشته باشید!\"\n\nبرای توقف، دکمه \"توقف\" رو بزنید.\n\n---\n\n## 🖥 رابط کاربری\n\n- **RichTextBox**: دستورات شما و جواب‌های نینا رو نشون می‌ده.\n- **برچسب وضعیت**: با رنگ سبز (\"در حال شنیدن\") یا قرمز (\"شنیدن متوقف\") حالت رو مشخص می‌کنه.\n- **دکمه‌ها**: شروع، توقف، کوچک کردن و بستن برای کنترل دستیار.\n\n---\n\n## 🔧 توسعه و شخصی‌سازی\n\n### تغییر صدا\nبرای عوض کردن صدای نینا:\n1. توی `mainform.cs`، توی سازنده:\n   ```csharp\n   Synthesizer.SelectVoice(\"Microsoft Zira Desktop\"); // یا هر صدای دیگه\n   ```\n2. برای دیدن صداهای موجود:\n   ```csharp\n   foreach (var voice in Synthesizer.GetInstalledVoices())\n   {\n       MessageBox.Show(voice.VoiceInfo.Name);\n   }\n   ```\n\n### اضافه کردن دستور جدید\n1. توی `textStrings` توی سازنده، دستور جدید رو اضافه کنید (مثلاً \"Open Notepad\").\n2. توی `RecognitionEngine_SpeechRecognized` یه کیس جدید بذارید:\n   ```csharp\n   case \"Open Notepad\":\n       richTextBox1.AppendText($\"{Environment.NewLine}Open Notepad\");\n       Synthesizer.Speak(\"Opening Notepad...\");\n       System.Diagnostics.Process.Start(\"notepad.exe\");\n       break;\n   ```\n\n---\n\n## 🐛 مشکلات شناخته‌شده\n\n- **باز نشدن برخی برنامه‌ها**: اگه مسیر فایل اجرایی توی PATH نباشه، باید مسیر کامل رو بدید (مثلاً برای Telegram).\n- **تشخیص صوت**: توی محیط‌های پر سر و صدا ممکنه خطا بده.\n\nاگه مشکلی پیدا کردید، توی بخش Issues بگید!\n\n---\n\n## 🤝 مشارکت\n\nاز کمک شما استقبال می‌کنیم!\n1. مخزن رو فورک کنید.\n2. تغییرات رو توی یه شاخه جدید اعمال کنید.\n3. Pull Request بفرستید.\n\n---\n\n## 🙏 تشکر\n\n- از جامعه C# برای ابزارها و کتابخونه‌های عالی!\n- و از شما که نینا رو امتحان می‌کنید!\n\n---\n\nنینا رو روشن کنید و از تجربه صوتی لذت ببرید! سؤالی دارید؟ توی Issues بپرسید. 🎤\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faria-hosseini%2Fnina","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faria-hosseini%2Fnina","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faria-hosseini%2Fnina/lists"}