Skip to content

iamx-ariful-islam/CTk-Quote-Generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CTk Quote Generator

A modern and minimal quote generator application built with Python, CustomTkinter, and the Quotable API, featuring theme switching, a clean UI and fast quote retrieval.

✨ Features

  • 🎨 Modern UI using CustomTkinter
  • 🔄 Light/Dark theme toggle
  • 🎲 Random theme color each time the app starts
  • 📝 Fetch inspirational quotes using the Quotable API
  • 🔗 Clickable API link (opens in browser)
  • 📋 Right-click menu (Copy, Paste, Cut)
  • 🖥 Cross-platform (Windows, Linux, macOS)
  • ⚡ Fast, lightweight, beginner-friendly codebase

🖼 Preview

Here are some screenshots of the CTk Quote Generator project:

Main Page with Dark Mode
Main Page
Output Page with Light Mode
Output Page

🛠 Technologies Used

  • Python 3.11+
  • CustomTkinter
  • Requests
  • Tkinter
  • Quotable.io API

📦 Installation

1. Clone the Repository

git clone https://github.com/iamx-ariful-islam/CTk-Quote-Generator.git
cd CTk-Quote-Generator

2. Install Dependencies

Make sure pip is available in your system PATH.

pip install -r requirements.txt
# or (Linux/MacOS)
sudo pip install -r requirements.txt

The requirements.txt file, lists of all the python libraries that my "CTk Quote Generator" depends on and installs those packages from the file.

3. Run the Application

python main.py

📁 Project Structure

Here’s the structure of the CTk Quote Generator project:

CTk-Quote-Generator/
│
│── screenshots/
│── main.py
│── LICENSE
├── README.md
└── requirements.txt

🌐 API Used

This project uses the Quotable API: https://api.quotable.io/random

💡 How It Works

  1. Click Generate Quote → The app calls the Quotable API
  2. The app parses the JSON response
  3. The quote and author are displayed in the text box
  4. Users can copy/paste text via right-click menu
  5. Appearance can be toggled between Light/Dark

🔧 Customization

Change default random theme

Inside main.py:

ctk.set_default_color_theme(random.choice(['blue', 'green', 'dark-blue']))

You can add more themes or set a static theme.

🤝 Contributing

Contributions, suggestions, and feedback are always welcome! ❤️
To contribute:

  1. Fork the repository
  2. Create a new branch (feature/new-feature)
  3. Commit your changes
  4. Push and submit a Pull Request

💬 You can also open an issue if you’d like to discuss a feature or report a bug.

🌐 For more or connect with me

                   

📜 License

The MIT License (MIT)

💖 Thank You for Visiting!

“Good design is about making things simple yet significant”
Md. Ariful Islam

Releases

No releases published

Packages

 
 
 

Contributors

Languages