https://github.com/kimuracoz/pypass-gen
A Python-based tool to generate secure passwords via terminal (CLI) or visual interface (GUI).
https://github.com/kimuracoz/pypass-gen
automation cli gui password-generator python security tools
Last synced: about 1 month ago
JSON representation
A Python-based tool to generate secure passwords via terminal (CLI) or visual interface (GUI).
- Host: GitHub
- URL: https://github.com/kimuracoz/pypass-gen
- Owner: KimuraCoz
- Created: 2025-12-22T12:39:11.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-22T14:10:26.000Z (6 months ago)
- Last Synced: 2025-12-24T01:16:02.159Z (6 months ago)
- Topics: automation, cli, gui, password-generator, python, security, tools
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PyPass Gen (Network Edition)
**PyPass Gen** is a versatile security tool built with Python, specifically designed for **Network Engineers** and IT enthusiasts.
Unlike standard password generators, this tool includes specialized features for network security, such as **WPA2 Wi-Fi Keys** and **MAC Address** generation. Available in both **CLI** (Terminal) and **GUI** (Visual) modes.
## Project Structure
- `main.py`: The main entry point of the application.
- `cli_app.py`: The script for running the generator in the terminal (Command Line Interface).
- `gui_app.py`: The script for running the generator with a visual interface (Graphical User Interface).
- `requirements.txt`: List of dependencies required to run the project.
## Key Features
1. **Standard Password Mode**
Generate strong, random passwords with customizable length (Letters, Digits, Symbols).
2. **WPA2 Key Generator (Wi-Fi)**
Generates a **64-character Hexadecimal Key** (32 bytes). This is the highest security standard format for WPA2-PSK Wi-Fi passwords.
3. **MAC Address Generator**
Generates a random **Media Access Control (MAC) Address** (Format: `XX:XX:XX:XX:XX:XX`). Useful for network testing, spoofing, or assigning fake identities to devices.
## Installation & Setup
To run this project, it is recommended to use a virtual environment to keep dependencies isolated.
1. **Clone or Download the repository**
2. **Create a Virtual Environment**
Open your terminal in the project folder and run:
```bash
python -m venv .venv
```
3. **Activate the Virtual Environment**
* **Windows (Command Prompt):**
```bash
.venv\Scripts\activate
```
* **Windows (PowerShell):**
```powershell
.venv\Scripts\Activate.ps1
```
* **Mac/Linux:**
```bash
source .venv/bin/activate
```
4. **Install Dependencies**
Once the virtual environment is active (you will see `(.venv)` in your terminal), install the required libraries:
```bash
pip install -r requirements.txt
```
## Usage
Make sure your virtual environment is activated before running the scripts.
### Option 1: Run via Main Entry
Usually, this will let you choose between CLI or GUI mode:
```bash
python main.py
```
### Option 2: Run CLI Mode Directly
If you prefer using the terminal:
```bash
python cli_app.py
```
### Option 3: Run GUI Mode Directly
If you prefer a visual interface:
```bash
python gui_app.py
```
## Requirements
* Python 3.x
* Libraries listed in `requirements.txt` (e.g., `colorama`, etc.)
## Bonus: Create a Desktop Shortcut (No Console Window)
Want to run the app like a real software without opening VS Code or seeing a black terminal window? Follow these steps:
1. **Create Shortcut**
- Right-click on `gui_app.py`.
- Select **Send to** > **Desktop (create shortcut)**.
2. **Configure Properties (Crucial Step!)**
- Go to your Desktop, right-click the new shortcut, and select **Properties**.
- In the **Target** field, you need to point it to the Python inside the `.venv` folder using `pythonw.exe` (this hides the terminal).
- Change the **Target** to look like this format:
```text
"[PATH_TO_PROJECT]\.venv\Scripts\pythonw.exe" "[PATH_TO_PROJECT]\gui_app.py"
```
*(Replace `[PATH_TO_PROJECT]` with the actual location of your folder).*
3. **Set "Start in" Folder**
- Make sure the **Start in** field points to your project folder:
```text
"D:\Your\Project\Folder\PyPass-Gen"
```
4. **Change Icon (Optional)**
- In the **Shortcut** tab, click **Change Icon**.
- Browse and select a `.ico` file (e.g., a lock image) to make it look professional!
---
*Created for educational purposes.*