documentation and requirements update

README.md

@@ -1,2 +1,140 @@
-# Beginner-Python-Projects
-Beginner level projects in Python
+# Beginner Python Projects
+
+This repository contains a collection of beginner-level Python projects. Each project is designed to help you practice and improve your Python programming skills. Below is a detailed explanation of each project.
+
+---
+
+## Projects
+
+### 1. **Alarm Clock**
+- **Description**: A simple alarm clock application that plays a sound after a specified time or at a particular time.
+- **Features**:
+  - Allows users to set alarms in a 24-hour format.
+  - Plays a sound repeatedly for 10 seconds when the alarm goes off.
+- **Technologies Used**: `tkinter`, `datetime`, `playsound`.
+- **File**: [Alarm Clock/Alarm-Clock.py](Alarm%20Clock/Alarm-Clock.py)
+
+---
+
+### 2. **Binary to Decimal and Back Converter**
+- **Description**: A program that converts decimal numbers to binary and binary numbers to decimal.
+- **Features**:
+  - Supports both binary-to-decimal and decimal-to-binary conversions.
+  - User-friendly menu-driven interface.
+- **File**: [binary-decimal.py](binary-decimal.py)
+
+---
+
+### 3. **Count Vowels**
+- **Description**: A program that counts the number of vowels in a given string.
+- **Features**:
+  - Displays the total number of vowels.
+  - Provides a breakdown of the count for each vowel (a, e, i, o, u).
+- **File**: [count-vowels.py](count-vowels.py)
+
+---
+
+### 4. **Each Word Count**
+- **Description**: Counts the occurrences of each word in a given text file.
+- **Features**:
+  - Reads text from a file.
+  - Outputs a dictionary with words as keys and their counts as values.
+- **File**: [each-word-count.py](each-word-count.py)
+
+---
+
+### 5. **Find Prime Numbers**
+- **Description**: A program that generates prime numbers until the user decides to stop.
+- **Features**:
+  - Continuously generates prime numbers.
+  - Allows the user to stop the program by entering 'q'.
+- **File**: [find-prime-numbers.py](find-prime-numbers.py)
+
+---
+
+### 6. **Prime Factorization**
+- **Description**: Finds all the prime factors of a given number.
+- **Features**:
+  - Handles edge cases like 1 and negative numbers.
+  - Displays the prime factors in a readable format.
+- **File**: [prime-factorization.py](prime-factorization.py)
+
+---
+
+### 7. **Reverse a String**
+- **Description**: A program that reverses a given string.
+- **Features**:
+  - Takes user input and prints the reversed string.
+- **File**: [reverse-string.py](reverse-string.py)
+
+---
+
+### 8. **Tax Calculator**
+- **Description**: Calculates the tax and total cost based on the user's input of cost and country.
+- **Features**:
+  - Reads tax rates from a CSV file.
+  - Displays the calculated tax and total cost.
+- **Technologies Used**: `tkinter`, `pandas`.
+- **Files**:
+  - [Tax Calculator/tax-calculator.py](Tax%20Calculator/tax-calculator.py)
+  - [Tax Calculator/tax.csv](Tax%20Calculator/tax.csv)
+
+---
+
+### 9. **Password Generator**
+- **Description**: Generates strong passwords based on user preferences.
+- **Features**:
+  - Allows users to include uppercase letters, lowercase letters, numbers, and special characters.
+  - Adjustable password length.
+  - Displays password strength using a progress bar.
+- **Technologies Used**: `tkinter`, `pyperclip`.
+- **File**: [Password Genetator/Password-Generator.py](Password%20Genetator/Password-Generator.py)
+
+---
+
+### 10. **Number to Words**
+- **Description**: Converts numbers into their English word representation.
+- **Features**:
+  - Supports positive numbers, negative numbers, zero, and floating-point numbers.
+- **Technologies Used**: `tkinter`, `num2words`.
+- **File**: [Num2Words/num-to-words.py](Num2Words/num-to-words.py)
+
+---
+
+### 11. **Image Slideshow**
+- **Description**: Displays images in a slideshow format.
+- **Features**:
+  - Includes smooth transitions between images.
+  - Uses `Pillow` for image processing.
+- **Technologies Used**: `tkinter`, `Pillow`.
+- **File**: [Image-Slideshow/image-slideshow.py](Image-Slideshow/image-slideshow.py)
+
+---
+
+### 12. **GIF Creator**
+- **Description**: Creates GIFs from images or videos.
+- **Features**:
+  - Converts a video clip into a GIF.
+  - Combines multiple images into a GIF.
+- **Technologies Used**: `moviepy`, `imageio`.
+- **Files**:
+  - [Gif-Creator/video-to-gif.py](Gif-Creator/video-to-gif.py)
+  - [Gif-Creator/gif-creator.py](Gif-Creator/gif-creator.py)
+
+---
+
+### 13. **Text Editor**
+- **Description**: A Notepad-style text editor.
+- **Features**:
+  - Open, edit, and save text files.
+  - Includes light and dark themes.
+- **Technologies Used**: `tkinter`.
+- **File**: [Text Editor/txteditor.py](Text%20Editor/txteditor.py)
+
+---
+
+## How to Run
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/your-username/Beginner-Python-Projects.git
+   ```

requirement.txt

@@ -0,0 +1,8 @@
+tkinter
+pandas
+num2words
+Pillow
+moviepy
+imageio
+playsound
+pyperclip