https://github.com/mostafabaghi/python-contacts-list
📇 Python Contacts List — A simple desktop contact manager built with Python and Tkinter, allowing you to add, edit, and delete contacts stored as .txt files in a local contacts/ folder. Fast, offline, and beginner-friendly.
https://github.com/mostafabaghi/python-contacts-list
address-book beginner-project contact-list contact-manager crud desktop-app file-system gui offline-app personal-organizer python simple-gui text-file-storage tkinter
Last synced: 7 days ago
JSON representation
📇 Python Contacts List — A simple desktop contact manager built with Python and Tkinter, allowing you to add, edit, and delete contacts stored as .txt files in a local contacts/ folder. Fast, offline, and beginner-friendly.
- Host: GitHub
- URL: https://github.com/mostafabaghi/python-contacts-list
- Owner: mostafabaghi
- License: mit
- Created: 2025-06-06T22:05:30.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-06T22:20:08.000Z (12 months ago)
- Last Synced: 2025-06-06T23:20:01.006Z (12 months ago)
- Topics: address-book, beginner-project, contact-list, contact-manager, crud, desktop-app, file-system, gui, offline-app, personal-organizer, python, simple-gui, text-file-storage, tkinter
- Language: Python
- Homepage: https://mostafabaghi.com/
- Size: 131 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📇 Python Contacts List
A simple and lightweight desktop contact manager built with Python and Tkinter.
This app allows you to create, view, edit, and delete contact information, stored locally as `.txt` files in a `contacts/` folder.
---
## ✨ Features
- 🔍 View all contacts in a scrollable list
- ➕ Add new contact with name, phone, and email
- ✏️ Edit existing contacts
- 🗑️ Delete contacts
- 🧾 Automatically stores each contact in a `.txt` file
- 📁 Works offline — no database or internet required
---
## 📂 Folder Structure
```
project-folder/
├── main.py
└── contacts/
├── John_Doe.txt
├── Jane_Smith.txt
└── ...
```
Each contact file contains:
```
Name: John Doe
Phone: 123-456-7890
Email: john@example.com
```
---
## 🛠️ Requirements
Just make sure you have Python 3.x installed.
If Tkinter is not installed, run:
```bash
pip install tk
```
---
## ▶️ How to Run
1. Place `main.py` in your working folder.
2. Create a `contacts/` folder in the same directory (if not already created automatically).
3. Run the app:
```bash
python main.py
```
---
## 📸 Screenshot
> 📸 Screenshot of the app interface:
---
## 🙌 Author
Made with ❤️ by [Mostafa Baghi](https://github.com/mostafabaghi)