In this article, we are going to see how to develop a Clock Application with Kivy using Python.
Kivy is a graphical user interface opensource Python library that allows you to develop multi-platform applications on Windows, macOS, Android, iOS, Linux, and Raspberry-Pi. In addition to the regular mouse and keyboard inputs, it also supports multitouch events.
We will be using the time module to get the current time and update it every second. Moreover, we will be also be displaying two times of different timezones.
Functions Used
- asctime(): By default gets the local time. You can also pass the time zone in it to get the time of another zone as done in Example 2.
- BoxLayout(): It is used to arrange layouts in vertical or horizontal boxes.
- schedule_interval(): Is used to create time intervals and recall the function/event.
- add_widget(): Adds widget to the screen.
Example 1: Local time app using kivy
# importing modules # it will allow us to get time import time
# The App class is the base for # creating Kivy applications from kivy.app import App
# it will allow us to make interval calls from kivy.clock import Clock
# Label widget will be used to render text from kivymd.uix.label import Label
# we will be using this to resize app window from kivy.core.window import Window
# it will allow us to create layouts from kivy.uix.boxlayout import BoxLayout
# declaring window size Window.size = ( 400 , 700 )
# clock class class myclock(Label):
def update( self , * args):
# get the current local time
self .text = time.asctime()
# App class class TimeApp(App):
def build( self ):
layout = BoxLayout(orientation = 'vertical' )
# it will create vertical layouts in app
# calling clock class for time
clock1 = myclock()
# updates time with the interval of 1 sec
Clock.schedule_interval(clock1.update, 1 )
# adding layout to the screen
layout.add_widget(clock1)
# adding text to screen
layout.add_widget(Label(text = 'INDIA' ))
return layout
root = TimeApp()
root.run() # running the app
|
Output:
Code Explanation
- The code starts with importing the modules that we need to use.
- The first module is time which will allow us to get the current local time.
- Next, it imports the Clock class which will be used for scheduling updates of myclock widget.
- It then creates a new app called TimeApp and builds it by adding a layout boxlayout and text label.
- The code is a sample of how to create an application with the Kivy framework.
- The first line imports modules that will allow us to get time and use it in our code.
- Line 3 declares the App class which is the base for creating Kivy applications.
- It allows us to make interval calls, add widgets, and return layouts.
- Line 4 creates a new instance of myclock widget which renders text.
- Line 5 schedules 1 second update intervals on clock1 by calling Clock.schedule_interval().
- Line 6 adds layout to screen with widgets added and returns layout as result of build() function call.
- Line 7 adds text to screen with Label widget added and returns layout as result of build() function call.
Example 2: Adding another time zone in the time app
Create another clock class and Add an extra layout for clock 2 in-app class.
import time
from kivy.app import App
from kivy.clock import Clock
from kivymd.uix.label import Label
from kivy.core.window import Window
from kivy.uix.boxlayout import BoxLayout
Window.size = ( 400 , 700 )
class myclock(Label):
def update( self , * args):
self .text = time.asctime()
class myclock2(Label):
def update( self , * args):
t = time.gmtime()
self .text = time.asctime(t)
class TimeApp(App):
def build( self ):
layout = BoxLayout(orientation = 'vertical' )
clock1 = myclock()
Clock.schedule_interval(clock1.update, 1 )
layout.add_widget(clock1)
layout.add_widget(Label(text = 'INDIA' ))
clock2 = myclock2()
Clock.schedule_interval(clock2.update, 1 )
layout.add_widget(clock2)
layout.add_widget(Label(text = 'LONDON' ))
return layout
root = TimeApp()
root.run() |
Output:
Code Explanation:
- The code starts by creating two Label widgets.
- The first is myclock1 and the second is myclock2.
- They are both created with a function called update, which takes no arguments and returns nothing.
- This means that when they are updated, their text will be set to the current time in asctime().
- The next step is to create a BoxLayout widget with an orientation of ‘vertical’.
- It then adds these two Label widgets to it.
- Finally, it creates another BoxLayout widget but this one has an orientation of ‘horizontal’ and adds those two Label widgets again.
- The code is designed to create a widget that displays the current time on screen.
- The first widget, myclock1, will update every second and display the current time in text form.
- The second widget, myclock2, will update every second and display the current time in text form with an extra line of text at the top displaying the difference between seconds (in this case 1).