World Clock App

An animated aquarium-themed world clock application designed especially for couples and families in long-distance relationships.

Overview

World Clock is a desktop application that helps couples, families, and friends stay connected across different time zones. With its beautiful aquarium animation and dual time display, you can easily keep track of the local time for your loved ones abroad.

Perfect for:

• Long-distance relationships
• Families with members living abroad
• International business connections
• Anyone who needs to coordinate across different time zones

Features

• Dual Time Zone Display: View two different time zones simultaneously
• 12/24 Hour Format Toggle: Choose your preferred time format
• Date Display: Shows the current date for each location
• 12 Popular Time Zones: Including Manila, Arizona, New York, Tokyo, London, and more
• Animated Aquarium Background: Relaxing fish and bubble animations
• Dark Theme Interface: Easy on the eyes, especially for late-night check-ins

Installation

Windows Users (.exe file)

1. Download the latest release from the Releases page
2. Extract the ZIP file to your preferred location
3. Run the WorldClock.exe file - no installation needed!

For Developers (Source Code)

If you want to run from source or modify the code:

1. Clone this repository:

git clone https://github.com/yourusername/worldclock.git

2. Install the required dependencies:

pip install tkinter customtkinter pytz pillow

3. Run the application:

python worldclock.py

How to Use

1. Launch the application by double-clicking the executable file
2. Select your time zones using the dropdown menus
   • Choose your current location in one panel
   • Choose your loved one's location in the other panel
3. Choose your preferred time format (12-hour or 24-hour) using the radio buttons
4. The clock will automatically update every second

Tips for Long Distance Relationships

• Set up the clock to always show your partner's time zone to avoid confusion when planning calls
• Use the app to find the best overlapping awake hours for video chats
• Check the date display to be aware of day changes across international date line
• Keep the app open on your desktop as a constant reminder of your connection

Technical Requirements

• Windows 7 or higher (for .exe file)
• For developers:
  • Python 3.6+
  • Required libraries: tkinter, customtkinter, pytz, PIL

Customization

The application loads fish and bubble images from the same directory as the executable:

• fish_right.png - Right-facing fish
• fish_left.png - Left-facing fish
• Bubble1.png - Small bubble
• Bubble2.png - Large bubble

If these images are not found, the application will fall back to text-based symbols.

Support

Having issues or want to suggest improvements? Please open an issue on GitHub or contact me at: [email protected]

About the Developer

I created this application while living in the US to stay connected with my family and partner in the Philippines. I understand the challenges of maintaining relationships across time zones and hope this tool helps others in similar situations.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ for those separated by distance but connected by love.