{"id":18232033,"url":"https://github.com/mohammedtsmu/studyzone","last_synced_at":"2026-03-07T17:33:13.958Z","repository":{"id":258706478,"uuid":"874299234","full_name":"MohammedTsmu/StudyZone","owner":"MohammedTsmu","description":"StudyZone - A productivity application that helps you manage your study sessions effectively using the Pomodoro and other Techniques. Includes features like customizable timers, task management, reminders, session logs, and a mini timer for convenience.","archived":false,"fork":false,"pushed_at":"2025-01-04T08:03:01.000Z","size":772277,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T23:51:25.836Z","etag":null,"topics":["csharp","focus","pomodoro","productivity","reminder-application","reminders","study","studyzone","task-management","task-scheduler","timer","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":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MohammedTsmu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2024-10-17T15:25:22.000Z","updated_at":"2025-01-04T06:49:24.000Z","dependencies_parsed_at":"2024-10-25T06:41:23.274Z","dependency_job_id":"428012df-42a4-443a-8d58-912dccec6740","html_url":"https://github.com/MohammedTsmu/StudyZone","commit_stats":{"total_commits":70,"total_committers":2,"mean_commits":35.0,"dds":"0.41428571428571426","last_synced_commit":"40405a928eacb75294f5de71dc21b439f3f8c763"},"previous_names":["mohammedtsmu/studyzone"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammedTsmu%2FStudyZone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammedTsmu%2FStudyZone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammedTsmu%2FStudyZone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammedTsmu%2FStudyZone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MohammedTsmu","download_url":"https://codeload.github.com/MohammedTsmu/StudyZone/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248328667,"owners_count":21085365,"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":["csharp","focus","pomodoro","productivity","reminder-application","reminders","study","studyzone","task-management","task-scheduler","timer","windows-forms"],"created_at":"2024-11-04T13:03:07.028Z","updated_at":"2026-03-07T17:33:13.898Z","avatar_url":"https://github.com/MohammedTsmu.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StudyZone\n\n**StudyZone** is a productivity application designed to help you manage your study sessions effectively using the Pomodoro Technique. Enhance your focus, organize your tasks, and monitor your productivity with StudyZone's intuitive features.\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n  - [Prerequisites](#prerequisites)\n  - [Installation Methods](#installation-methods)\n    - [Method 1: Installing via Releases](#method-1-installing-via-releases)\n    - [Method 2: Building from Source](#method-2-building-from-source)\n- [Usage](#usage)\n  - [Setting Up a Study Session](#setting-up-a-study-session)\n  - [Managing Tasks](#managing-tasks)\n  - [Setting Reminders](#setting-reminders)\n  - [Using the Mini Timer](#using-the-mini-timer)\n  - [Viewing Session Logs](#viewing-session-logs)\n- [Screenshots](#screenshots)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n- [Disclaimer](#disclaimer)\n\n## Features\n\n- **Session Timer**: Customize your study and break durations to suit your preferences.\n- **Pause Session Reminders**: Receive reminders to resume your study session if it remains paused for a certain period.\n- **Task Manager**: Keep track of your study tasks, set due dates, and assign them to specific sessions.\n- **Reminders**: Create one-time or recurring reminders for important events.\n- **Mini Timer**: Use a compact timer window that stays on top for convenience.\n- **Session Logs**: Review your past study sessions and monitor your productivity.\n- **Notifications**: Get notified about tasks that are due soon or overdue.\n- **System Tray Integration**: Minimize the app to the system tray for quick access.\n- **Customizable Settings**: Enable startup with Windows and adjust other preferences.\n\n## Installation\n\n### Prerequisites\n\nBefore installing **StudyZone**, ensure you have the following prerequisites:\n\n- **Operating System**: Windows 10 or higher\n- **.NET Framework**: .NET 5.0 or higher (if building from source)\n- **Internet Connection**: Required for downloading dependencies and updates\n\n### Installation Methods\n\nYou can install **StudyZone** using one of the following methods based on your preference:\n\n#### Method 1: Installing via Releases\n\nIf you prefer not to build the application from source, you can download precompiled releases.\n\n1. **Navigate to the Releases Page**:\n\n    - Go to the [StudyZone Releases](https://github.com/MohammedTsmu/StudyZone/releases) page on GitHub.\n\n2. **Download the Latest Release**:\n\n    - Find the latest stable release (e.g., `StudyZone-v1.0.0-setup.exe`).\n    - Download the appropriate installer for your operating system.\n\n3. **Run the Installer**:\n\n    - **Windows**:\n        - Double-click the downloaded `.exe` file.\n        - Follow the on-screen instructions to install StudyZone on your Windows machine.\n    - **macOS/Linux**:\n        - If available, follow the provided instructions or extract the downloaded archive.\n        - Ensure you have the necessary permissions to run the executable.\n\n4. **Launch the Application**:\n\n    - After installation, launch **StudyZone** from the Start Menu or desktop shortcut.\n\n#### Method 2: Building from Source\n\nFollow these steps to build and run the application from the source code.\n\n1. **Clone the Repository**:\n\n    ```bash\n    git clone https://github.com/MohammedTsmu/StudyZone.git\n    ```\n\n2. **Open the Project in Visual Studio**:\n\n    - Navigate to the cloned repository folder.\n    - Open the `StudyZone.sln` solution file with Visual Studio.\n\n3. **Restore NuGet Packages**:\n\n    - If prompted, restore the required NuGet packages to ensure all dependencies are installed.\n\n4. **Build the Solution**:\n\n    - In Visual Studio, build the solution by selecting **Build \u003e Build Solution** or pressing `Ctrl+Shift+B`.\n\n5. **Run the Application**:\n\n    - Start the application from Visual Studio by pressing `F5` or selecting **Debug \u003e Start Debugging**.\n\n## Usage\n\n### Setting Up a Study Session\n\n1. **Set Study and Break Durations**:\n\n    - Use the numeric up-down controls to set your desired study and break times.\n\n2. **Start the Session**:\n\n    - Click the **Start** button to begin the study session.\n\n3. **Pause/Resume the Session**:\n\n    - Use the **Pause** button to pause the timer and **Resume** to continue.\n\n4. **Pause Reminders**:\n\n    - If you pause the session and forget to resume it, StudyZone will remind you after a certain period to get back to your study session.\n\n5. **Stop the Session**:\n\n    - Click the **Stop** button to end the session prematurely.\n\n### Managing Tasks\n\n1. **Open Task Manager**:\n\n    - Click on the **Task Manager** button to open the task management window.\n\n2. **Add New Task**:\n\n    - Click **Add Task**, fill in the details like title, description, due date, and assign it to a session.\n\n3. **Edit or Delete Tasks**:\n\n    - Select a task from the list and choose **Edit** or **Delete** as needed.\n\n4. **Mark Tasks as Completed**:\n\n    - Check the box next to a task to mark it as completed.\n\n### Setting Reminders\n\n1. **Open Reminders**:\n\n    - Click on the **Reminders** button to manage your reminders.\n\n2. **Add New Reminder**:\n\n    - Click **Add Reminder**, enter the reminder name, set the time, and choose if it’s recurring.\n\n3. **Edit or Delete Reminders**:\n\n    - Select a reminder from the list and choose **Edit** or **Delete**.\n\n### Using the Mini Timer\n\n1. **Open Mini Timer**:\n\n    - Click on the **Mini Timer** button to open the compact timer window.\n\n2. **Control Session**:\n\n    - Start, pause, or stop the session directly from the mini timer.\n\n3. **Stay Focused**:\n\n    - The mini timer stays on top, allowing you to keep track of time while working in other applications.\n\n### Viewing Session Logs\n\n1. **Open Session Logs**:\n\n    - Click on the **Session Logs** button to view your study history.\n\n2. **Review Past Sessions**:\n\n    - Browse through the logs to analyze your study patterns and productivity.\n\n3. **Export Logs (Optional)**:\n\n    - Export your session logs to a file for external analysis (feature to be implemented).\n\n## Screenshots\n\n### Main Interface of StudyZone\n\n![Main Interface](https://github.com/MohammedTsmu/StudyZone/blob/master/screenshots/main-interface.png)  \n*Figure: Main Interface of StudyZone*\n\n### Task Manager Window\n\n![Task Manager](https://github.com/MohammedTsmu/StudyZone/blob/master/screenshots/task-manager.png)  \n*Figure: Task Manager Window*\n\n### Mini Timer in Action\n\n![Mini Timer](https://github.com/MohammedTsmu/StudyZone/blob/master/screenshots/mini-timer.png)  \n*Figure: Mini Timer in Action*\n\n### Mini Timer in Dimmed and Unfocused (Read Mode)\n\n![Mini Timer](https://github.com/MohammedTsmu/StudyZone/blob/master/screenshots/mini-timer-dim.png)  \n*Figure: Mini Timer in Dimmed and Unfocused (Read Mode)*\n\n## Contributing\n\nContributions are welcome! If you have ideas for improvements or new features, feel free to open an issue or submit a pull request.\n\n### Steps to Contribute\n\n1. **Fork the Repository**:\n\n    - Click the **Fork** button at the top-right corner of the repository page on GitHub.\n\n2. **Create a Feature Branch**:\n\n    ```bash\n    git checkout -b feature/YourFeature\n    ```\n\n3. **Commit Your Changes**:\n\n    ```bash\n    git commit -m \"Add your message\"\n    ```\n\n4. **Push to the Branch**:\n\n    ```bash\n    git push origin feature/YourFeature\n    ```\n\n5. **Open a Pull Request**:\n\n    - Navigate to your forked repository on GitHub.\n    - Click on **Compare \u0026 pull request**.\n    - Provide a clear description of your changes and submit the pull request.\n\n## License\n\nThis project is licensed under the [AGPL-3.0](https://github.com/MohammedTsmu/StudyZone/blob/master/LICENSE).\n\n## Contact\n\n**Developer**: Dr. Mohammed Qasim\n\nFeel free to reach out for any questions or feedback!\n\n## Disclaimer\n\nThis application is provided as-is without any guarantees or warranty. Use it at your own risk.\n\nThank you for using **StudyZone**! We hope it helps you achieve your study goals.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohammedtsmu%2Fstudyzone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohammedtsmu%2Fstudyzone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohammedtsmu%2Fstudyzone/lists"}