Skip to content

Latest commit

 

History

History

contact_book

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

Contact List

contact_list_with_python_tkinter

About

This is a desktop app built with Python Tkinter for saving, viewing, updating and deleting contacts with details such as; name (compulsory), phone (compulsory), email (optional but must be valid) and adrress (optional as well).

The app was built and tested on Ubuntu 22.04.2

SQLite was used for the database

Features

  1. A beautiful user interface built with Python, using Tkinter as the GUI tool

  2. Data validation while creating or updating contacts;

    • The Name and Phone fields cannot be empty
    • The email must be a valid one
    • Each of the four fields have maximum length of characters allowed, repectively and they cannot be exceeded
  3. CRUD operations and more:

    • Create contact
    • View contacts
    • View contact details
    • Update an existing contact
    • Delete contacts
    • Page navigation and background color toggle during error display and focus on a popup widget, for a good user experience
  4. Feedback when operation is successful and warnings when there's an error

How to Use the App

To learn how the app is used, watch this demo of how the application works

Installation

You may prefer seeing this video tutorial, to watch and learn.

Open your terminal (command line) and do the following:

Install python3:

The first thing is to download and install python3, if you do not have it on the machine already, visit https://www.python.org/downloads to get it.

The first code block of instructions can be skipped, by Windows users, but is very necessary for those who use Linux distros (such as Debian, Ubuntu, Fedora, and openSUSE), who may get the ModuleNotFoundError

Install the module:

# Tkinter is inbuilt in python3 but, if you're a Linux distro, you may need to do this:
$ python3 -m tkinter
# This is supposed to display a brief information on a small window about tkinter
# If it rather says "/usr/bin/python3: No module named tkinter" then do this
$ sudo apt install python3-tk
# Confirm that it is now present
$ python3 -m tkinter

Get the app and run it:

# Clone the git repository on your CLI
$ git clone https://github.com/tpauldike/CODSOFT.git
# Check to see whether you have CODSOFT on your terminal by now
$ ls
# Navigate into the calculator folder
$ cd CODSOFT/contact_book
# Run the app
$ python3 app.py
# alternatively, you can do
$ ./app.py