{"id":18744997,"url":"https://github.com/rkstudio585/advanced-digital-clock","last_synced_at":"2025-11-22T20:30:17.361Z","repository":{"id":256885398,"uuid":"850525466","full_name":"rkstudio585/advanced-digital-clock","owner":"rkstudio585","description":"The Advanced Digital Clock is a Python terminal application that displays the current date and time in a clean, 12-hour format with AM/PM notation. It features a continuously updating display and is cross-platform compatible, making it ideal for learning and integration.","archived":false,"fork":false,"pushed_at":"2024-09-01T03:09:05.000Z","size":14,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-28T20:14:27.067Z","etag":null,"topics":["clock","program","programming","python","python-clock","python3","rk","rk-studio"],"latest_commit_sha":null,"homepage":"https://github.com/mdriyadkhan585","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rkstudio585.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-09-01T03:00:15.000Z","updated_at":"2024-09-01T03:09:08.000Z","dependencies_parsed_at":"2024-09-13T16:23:06.583Z","dependency_job_id":null,"html_url":"https://github.com/rkstudio585/advanced-digital-clock","commit_stats":null,"previous_names":["rkstudio585/advanced-digital-clock"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkstudio585%2Fadvanced-digital-clock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkstudio585%2Fadvanced-digital-clock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkstudio585%2Fadvanced-digital-clock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkstudio585%2Fadvanced-digital-clock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rkstudio585","download_url":"https://codeload.github.com/rkstudio585/advanced-digital-clock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239627247,"owners_count":19670844,"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":["clock","program","programming","python","python-clock","python3","rk","rk-studio"],"created_at":"2024-11-07T16:16:32.785Z","updated_at":"2025-11-22T20:30:15.267Z","avatar_url":"https://github.com/rkstudio585.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Advanced Digital Clock in Python\n---\n[In C script](https://github.com/mdriyadkhan585/advanced-digital-clock-C)\n\n![Clock Logo](logo.svg)\n\n---\n## Table of Contents\n1. [Introduction](#introduction)\n2. [Features](#features)\n3. [Prerequisites](#prerequisites)\n4. [Installation](#installation)\n5. [Usage](#usage)\n6. [Code Overview](#code-overview)\n7. [How It Works](#how-it-works)\n8. [Customization](#customization)\n9. [Known Issues](#known-issues)\n10. [Contributing](#contributing)\n11. [License](#license)\n\n## Introduction\nThe Advanced Digital Clock project is a terminal-based clock application written in Python. It displays the current date and time in a user-friendly format with 12-hour clock and AM/PM notation. This project is designed for learning, demonstration, and integration into larger applications. It features a clean and continuously updating interface and is compatible with various operating systems.\n\n## Features\n- **Real-time Date and Time Display**: Continuously shows the current date and time in the format `DD-MM-YYYY | HH:MM:SS AM/PM`.\n- **12-Hour Format**: Time is displayed in a 12-hour format with AM/PM indicator.\n- **Clean Interface**: The clock clears the screen before each update, ensuring a clear display.\n- **Cross-Platform Compatibility**: Works on UNIX-like systems (Linux, macOS) and can be adapted for Windows.\n\n## Prerequisites\nTo run this project, ensure you have the following:\n- Python 3.x installed on your system.\n- A terminal or command prompt to execute the script.\n- For Windows users, you might need to configure your terminal to handle screen clearing commands.\n\n## Installation\n### Step 1: Clone the Repository\nClone the repository to your local machine using `git`:\n\n```bash\ngit clone https://github.com/mdriyadkhan585/advanced-digital-clock\n```\n\n### Step 2: Navigate to the Directory\nChange to the directory containing the script:\n\n```bash\ncd advanced-digital-clock\n```\n\n### Step 3: Run the Program\nExecute the Python script using:\n\n```bash\npython digital_clock.py\n```\n\n## Usage\nThe script will display the current date and time, updating every second. The display will clear and refresh to maintain a clean interface.\n\n### Exiting the Program\nTo exit the program, press `Ctrl+C` in the terminal.\n\n### Example Output\n```\n======================================\n      Welcome to the Digital Clock    \n======================================\n\nPress Ctrl+C to exit the program.\n\nCurrent Date and Time:\n======================================\n  Date: 01-09-2024\n  Time: 02:23:15 PM\n======================================\n```\n\n## Code Overview\n### Main Components\n1. **`clear_screen()`**: Clears the terminal screen for a clean update.\n2. **`print_welcome_message()`**: Displays a welcome message and exit instructions.\n3. **`display_clock()`**: Main function that retrieves and formats the current time, then updates the display.\n4. **`if __name__ == \"__main__\":`**: Ensures that `display_clock()` runs only when the script is executed directly.\n\n### How It Works\n- The script uses the `time` module to fetch the current local time.\n- It converts the time into a 12-hour format with AM/PM notation.\n- The terminal screen is cleared before each update to keep the clock in the same position.\n\n## Customization\nYou can modify the script to suit your needs:\n- **Change Date and Time Format**: Adjust the format in the `print()` statements to alter how the date and time are displayed.\n- **Add Colors**: Enhance the display by adding ANSI escape codes for colored text.\n- **Additional Features**: Implement new features such as alarms or different time zones.\n\n## Known Issues\n- **Screen Clearing**: The `clear_screen()` function may not work on all systems, particularly on Windows without special configuration.\n- **Time Drift**: Minor inaccuracies may occur over extended periods due to the `time.sleep()` function.\n\n## Contributing\nContributions are welcome! If you have suggestions, improvements, or bug fixes, please submit a pull request or open an issue.\n\n### Steps to Contribute\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-branch`).\n3. Make your changes and commit them (`git commit -m 'Add feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Open a pull request.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](https://github.com/mdriyadkhan585/advanced-digital-clock?tab=MIT-1-ov-file) file for more details.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frkstudio585%2Fadvanced-digital-clock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frkstudio585%2Fadvanced-digital-clock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frkstudio585%2Fadvanced-digital-clock/lists"}