Skip to content

odest/iClock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo


iClock

Fully Customizable Clock Widget

Documentation python pyqt5 tag version license


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.


banner


Table of Contents


Installation and Usage

To install iClock, follow these steps:

  1. Clone the repository:

    git clone https://github.com/odest/iClock.git
  2. Navigate to the iClock directory:

    cd iClock
  3. Install the required dependencies using pip:

    pip install -r requirements.txt
  4. Run the main.py script using Python:

    python main.py

By following these steps, you will have successfully installed iClock and its dependencies.



Important

  • If you encounter ModuleNotFoundError: No module named 'PyQt5.QtSvg' error in Linux, install the necessary modules as shown below:
sudo apt-get install python3-pyqt5.qtsvg
  • If you encounter ModuleNotFoundError: No module named 'PyQt5.QtX11Extras' error in Linux, install the necessary modules as shown below:
sudo apt-get install python3-pyqt5.qtx11extras

Customization Options

  • Background Customizations

    • Background Type
      • Gif
      • Image
      • Color
    • Background Opacity
    • Animation Duration
    • Border
      • Color
      • Size
      • Radius
  • Text Customizations

    • Size
    • Coord
    • Opacity
    • Color
    • Font
  • Settings

    • Show Tooltips
    • Show on Taskbar
    • Stays on Top
    • Blinking Colon
    • Advanced Options
    • Back to Default

Features

  • Fully Customizable: You can customize all components and details of the widget.
  • Your preferences are remembered: Once customized and saved, you can use it in the same way every time.
  • Ability to revert to default configurations: At any time, you can revert to the default configurations and start reconfiguring as needed.

  • Flexibility: You can bring and utilize the widget in any size you desire.
  • Mobility: You can move the widget anywhere you want and use it freely.
  • Positioning: You can position and use the widget wherever you desire by fixing it to your preferred location.

  • Tooltips: You can choose whether tooltips are displayed or not.
  • Taskbar Visibility: You can choose whether the widget appears on the taskbar.
  • Stays on Top: You can choose whether the widget appears above or below other applications.

  • Background GIF: You can add any animated GIF you want to the background.
  • Background Image: You can add any image you want to the background.
  • Background Color: You can add any color you want to the background.

Platform Support Test

A test result table regarding whether it works on which operating system:

Windows Linux MacOs
PlatformTest Result
Windows 11passed
Windows 10passed
Windows 8.1not tested
Windows 8not tested
Windows 7not tested
PlatformTest Result
MX Linux (MX-23.2 / Fluxbox / x64)passed
Debian (12-12.5 / Gnome / x64)passed
PlatformTest Result
macOS 14 (Sonoma)not tested
macOS 13 (Ventura)not tested
macOS 12 (Monterey)not tested
macOS 11 (Big Sur)not tested
macOS 10.15 (Catalina)not tested

Sources

Note

You can take a look at the assets.json file for more detailed information.


License

  • This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

Sponsor this project

  •  

Packages

No packages published

Languages