{"id":47757244,"url":"https://github.com/odest/iclock","last_synced_at":"2026-04-03T04:37:16.124Z","repository":{"id":214945833,"uuid":"737723532","full_name":"odest/iClock","owner":"odest","description":"Fully Customizable Clock Widget","archived":false,"fork":false,"pushed_at":"2025-05-31T14:31:27.000Z","size":10208,"stargazers_count":28,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-01T02:39:38.681Z","etag":null,"topics":["desktop","gui","linux","macos","modern","pyqt5","pyqt6","pyside2","pyside6","python","widgets","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/odest.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":"odest","buy_me_a_coffee":"odest"}},"created_at":"2024-01-01T08:35:57.000Z","updated_at":"2025-05-31T14:31:30.000Z","dependencies_parsed_at":"2024-06-08T22:26:35.574Z","dependency_job_id":"f73b52c3-ff26-4cf7-a942-eeb48c669c7e","html_url":"https://github.com/odest/iClock","commit_stats":{"total_commits":39,"total_committers":1,"mean_commits":39.0,"dds":0.0,"last_synced_commit":"8c58e071db259bcbc969108607b5d3b60e25a5a0"},"previous_names":["odest/iclock"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/odest/iClock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odest%2FiClock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odest%2FiClock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odest%2FiClock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odest%2FiClock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/odest","download_url":"https://codeload.github.com/odest/iClock/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odest%2FiClock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31333712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T03:20:36.090Z","status":"ssl_error","status_checked_at":"2026-04-03T03:20:35.133Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["desktop","gui","linux","macos","modern","pyqt5","pyqt6","pyside2","pyside6","python","widgets","windows"],"created_at":"2026-04-03T04:37:15.439Z","updated_at":"2026-04-03T04:37:16.117Z","avatar_url":"https://github.com/odest.png","language":"Python","funding_links":["https://github.com/sponsors/odest","https://buymeacoffee.com/odest"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/logo.png\" alt=\"logo\" width=\"80\" height=\"80\"/\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\niClock\n===========================\n\u003ch4\u003e Fully Customizable Clock Widget \u003c/h4\u003e\n\n[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat)](https://github.com/odest/iClock)\n[![python](https://img.shields.io/badge/python-3.12.0-green)](https://www.python.org/downloads/release/python-3120/)\n[![pyqt5](https://img.shields.io/badge/PyQt5-5.15.10-green)](https://pypi.org/project/PyQt5/5.15.10/)\n[![tag](https://img.shields.io/badge/tag-v0.0.1-green)](https://github.com/odest/iClock)\n[![version](https://img.shields.io/badge/version-PreRelease-orange)](https://github.com/odest/iClock)\n[![license](https://img.shields.io/badge/License-GPLv3-blue?color=#4ec820)](https://github.com/odest/iClock?tab=GPL-3.0-1-ov-file#readme)\n---\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n**iClock** is an *open-source, cross-platform desktop clock widget* project. This project enables users to add an aesthetic and functional clock to their desktops. With the features offered by **iClock**, users can personalize their clocks and add a unique touch to their desktops.\n\n\u003c/div\u003e\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003ccenter\u003e\n\n![banner](docs/banner.png)\n\n\u003c/center\u003e\n\n\u003cbr\u003e\n\n\n## Table of Contents\n\n  - [Table of Contents](#table-of-contents)\n  - [Installation and Usage](#installation-and-usage)\n  - [Customization Options](#customization-options)\n  - [Features](#features)\n  - [Platform Support Test](#platform-support-test)\n  - [Sources](#sources)\n  - [License](#license)\n\n\u003cbr\u003e\n\n\n\n\n## Installation and Usage\n\n\n*To install* **iClock**, *follow these steps:*\n\n1. *Clone the repository:*\n\n    ```bash\n    git clone https://github.com/odest/iClock.git\n    ```\n\n2. *Navigate to the* **iClock** *directory:*\n\n    ```bash\n    cd iClock\n    ```\n\n3. *Install the required dependencies using* **pip:**\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n\n4. *Run the* **main.py** *script using* **Python:**\n\n    ```bash\n    python main.py\n    ```\n\n\u003cbr\u003e\n\n  *By following these steps, you will have successfully installed* **iClock** *and its dependencies.*\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003e [!IMPORTANT]\n\u003e - If you encounter *ModuleNotFoundError: No module named 'PyQt5.QtSvg'* error in **Linux**, install the necessary modules as shown below:\n\u003e ```bash\n\u003e sudo apt-get install python3-pyqt5.qtsvg\n\u003e ```\n\u003e \n\u003e - If you encounter *ModuleNotFoundError: No module named 'PyQt5.QtX11Extras'* error in **Linux**, install the necessary modules as shown below:\n\u003e ```bash\n\u003e sudo apt-get install python3-pyqt5.qtx11extras\n\u003e ```\n\n\u003cbr\u003e\n\n\n## Customization Options\n \n- **Background Customizations**\n    - **Background Type**\n      - **Gif**\n      - **Image**\n      - **Color**\n    - **Background Opacity**\n    - **Animation Duration**\n    - **Border**\n      - **Color**\n      - **Size**\n      - **Radius**\n    \n- **Text Customizations**\n  - **Size**\n  - **Coord**\n  - **Opacity**\n  - **Color**\n  - **Font**\n\n- **Settings**\n  - **Show Tooltips**\n  - **Show on Taskbar**\n  - **Stays on Top**\n  - **Blinking Colon**\n  - **Advanced Options**\n  - **Back to Default**\n\n\n\u003cbr\u003e\n\n\n## Features\n\n- **Fully Customizable:** *You can customize all components and details of the widget.*\n- **Your preferences are remembered:** *Once customized and saved, you can use it in the same way every time.*\n- **Ability to revert to default configurations:** *At any time, you can revert to the default configurations and start reconfiguring as needed.*\n\n\u003cbr\u003e\n\n- **Flexibility:** *You can bring and utilize the widget in any size you desire.*\n- **Mobility:** *You can move the widget anywhere you want and use it freely.*\n- **Positioning:** *You can position and use the widget wherever you desire by fixing it to your preferred location.*\n\n\u003cbr\u003e\n\n- **Tooltips:** *You can choose whether tooltips are displayed or not.*\n- **Taskbar Visibility:** *You can choose whether the widget appears on the taskbar.*\n- **Stays on Top:** *You can choose whether the widget appears above or below other applications.*\n\n\u003cbr\u003e\n\n- **Background GIF:** *You can add any animated GIF you want to the background.*\n- **Background Image:** *You can add any image you want to the background.*\n- **Background Color:** *You can add any color you want to the background.*\n\n\u003cbr\u003e\n\n## Platform Support Test\n\n*A test result table regarding whether it works on which operating system:*\n\n|Windows|Linux|MacOs|\n|--|--|--|\n|\u003ctable\u003e \u003ctr\u003e\u003cth\u003ePlatform\u003c/th\u003e\u003cth\u003eTest Result\u003c/th\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eWindows 11\u003c/td\u003e\u003ctd\u003epassed\u003c/td\u003e\u003c/tr\u003e \u003ctr\u003e\u003ctd\u003eWindows 10\u003c/td\u003e\u003ctd\u003epassed\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eWindows 8.1\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e \u003ctr\u003e\u003ctd\u003eWindows 8\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e \u003ctr\u003e\u003ctd\u003eWindows 7\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e  \u003c/table\u003e|\u003ctable\u003e\u003ctr\u003e\u003cth\u003ePlatform\u003c/th\u003e\u003cth\u003eTest Result\u003c/th\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eMX Linux (MX-23.2 / Fluxbox / x64)\u003c/td\u003e\u003ctd\u003epassed\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eDebian (12-12.5 / Gnome / x64)\u003c/td\u003e\u003ctd\u003epassed\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e| \u003ctable\u003e \u003ctr\u003e\u003cth\u003ePlatform\u003c/th\u003e\u003cth\u003eTest Result\u003c/th\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003emacOS 14 (Sonoma)\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003emacOS 13 (Ventura)\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e \u003ctr\u003e\u003ctd\u003emacOS 12 (Monterey)\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e \u003ctr\u003e\u003ctd\u003emacOS 11 (Big Sur)\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e \u003ctr\u003e\u003ctd\u003emacOS 10.15 (Catalina)\u003c/td\u003e\u003ctd\u003enot tested\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e|\n\n\u003cbr\u003e\n\n## Sources\n- **DS-Digital Font** *from* **[DAFONT](https://www.dafont.com/ds-digital.font)**\n- **Typefesse Font** *from* **[VELVETYNE](https://velvetyne.fr/fonts/typefesse/)**\n- **Background Gif** *from* **[LENNSAN](https://lennsan.tumblr.com/image/157438772656)**\n- **Background Image** *from* **[WSUPERCARS](https://www.wsupercars.com/car-wallpaper-download/?title=2023%20Porsche%20911%20GT3%20R%20Rennsport\u0026res=2800%20x%202100\u0026pic=https://www.wsupercars.com/wallpapers-regular/Porsche/2023-Porsche-911-GT3-R-Rennsport-004-2100.jpg)**\n- **Svg Icons** *from* **[FEATHERICONS](https://feathericons.com/)**\n- **Png Icons** *from* **[FLATICON](https://www.flaticon.com/)**\n\n\u003e [!NOTE]\n\u003e *You can take a look at the* **[assets.json](https://github.com/odest/iClock/blob/master/src/data/assets.json)** *file for more detailed information.*\n\n\u003cbr\u003e\n\n## License  \n- *This project is licensed under the* **GPL-3.0 License** - *see the* [LICENSE](https://github.com/odest/iClock?tab=GPL-3.0-1-ov-file) *file for details.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodest%2Ficlock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fodest%2Ficlock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodest%2Ficlock/lists"}