# ๐ Python Projects and Code Examples โ Automation, Networking, Desktop GUI, Media and Machine Learning
Independent Python utilities, applications and learning examples
Small, independent projects exploring **automation ยท desktop apps ยท networking ยท media ยท data ยท machine learning**
This repository is a portfolio of standalone **Python projects for beginners and intermediate developers**, from short language examples to command-line tools, desktop interfaces and data-science demos. Examples include a **TCP port scanner**, a **Wi-Fi scanner and Flask dashboard**, an **internet speed test**, **image-to-ASCII and photo-to-sketch converters**, **PNG steganography**, **QR code generation**, **text-to-speech**, **MP3 tag reading**, a **Tkinter contact book backed by SQL Server**, **ARIMA/SARIMAX COVID-19 forecasting**, and **scikit-learn salary prediction**. Pick a project below to open its guide, check its requirements and known limitations, and learn how to run it.
> ๐จ **No single setup fits every project:** dependencies and setup instructions are documented in each project's README. Some projects also need particular operating systems, local assets, external services, or credentials.
## ๐งญ Project index
### ๐ Web, networking & automation
| Project | What it does |
|---|---|
| [Async HTTP](Async%20HTTP/readme.md) | Interactive asynchronous GET, POST, PUT, and DELETE requests to a sample REST API. |
| [Bookmark](Bookmark/readme.md) | Save, search, edit, delete, and open links stored in a local SQLite database. |
| [FixNetwork](FixNetwork/readme.md) | Windows network diagnostics and repair steps, including network-stack and adapter resets. |
| [Internet Speed Test](Internet%20Speed%20Test/readme.md) | Measure download, upload, and ping using Speedtest.net servers. |
| [Port Scanner](Port%20Scanner/readme.md) | Concurrent TCP port scans with IPv4/IPv6, optional banners, and JSON output. |
| [Simple Selenium Scraper](Simple%20Selenium%20Scraper/readme.md) | Use headless Chrome and Selenium to collect cricket-news headlines. |
| [Streamlit Demo](Streamlit/readme.md) | Explore Streamlit widgets, interactive data, and charts in a browser app. |
| [WiFi Radar](Wifi%20Radar/readme.md) ยท [Online guide](https://gcfernando.github.io/python_codes/Wifi%20Radar/guide.html) | Local Flask dashboard for nearby access points, with live scanning and CSV export. |
| [WiFi Scanner](Wifi%20Scanner/readme.md) | Scan nearby wireless networks and display signal, frequency, and security details. |
| [WiFi Profiles](Wifi%20Profiles/readme.md) | Manage saved Windows Wi-Fi profiles and inspect their stored connection details. |
### ๐ง Media, images & creative tools
| Project | What it does |
|---|---|
| [Graphite CLI](Graphite_CLI/README.md) | Convert a photo into a black-and-white graphite pencil sketch with a single OpenCV command. |
| [Image to ASCII](Image%20to%20ASCII/readme.md) | Convert an image into ASCII art saved as a text file. |
| [Image2Cartoon](Image2Cartoon/readme.md) | Apply OpenCV filters to create a cartoon-style image. |
| [Improve MP3 Quality](Improve%20MP3%20Quality/readme.md) | Re-encode MP3 files with configurable bitrate, channels, and sample rate. |
| [Lyrics](Lyrics/readme.md) | Search Genius for song metadata and a lyrics preview. |
| [MP3 Player](MP3%20Player/readme.md) | Shuffle a folder of MP3s with background preloading and crossfade transitions. |
| [MP3 Tags](MP3%20Tags/readme.md) | Read ID3 metadata and technical audio details from an MP3 file. |
| [QR Code](QR%20Code/readme.md) | Generate a styled QR code image from text or a URL. |
| [Remove Background](Remove%20Background/readme.md) | Remove an image background and composite the subject onto a solid backdrop. |
| [Steganography](Stenography/readme.md) | Hide and retrieve text in PNG images using least-significant-bit encoding. |
| [Story Reader](StoryReader/readme.md) | Extract text from a PDF and read it aloud with text-to-speech. |
| [Tag Clouds](TagClouds/readme.md) | Collect web-page text and render a word cloud using an image mask. |
| [Text2Audio](Text2Audio/readme.md) | Desktop text-to-speech app with selectable language and locale options. |
### ๐ฅ๏ธ Desktop apps & system utilities
| Project | What it does |
|---|---|
| [Contact Book](GUI_Apps/README.md) | Desktop contact manager backed by Microsoft SQL Server. |
| [Extract CPU Information](Extract%20CPU%20Information/readme.md) | Display CPU model, architecture, frequency, and core information. |
| [Health Monitor](Health%20Monitor/readme.md) | Live process-memory dashboard with heuristic growth warnings. |
| [Load Libraries](LoadLibraries/readme.md) | Call a compiled C#/.NET calculator library from Python using `pythonnet`. |
| [Password Utility](Password%20Utility/readme.md) | Generate passwords and estimate password strength. |
| [Setup Wizard โ Fruit Wiki](SetupWizard/readme.md) | Browse fruit images and descriptions in a paginated desktop GUI. |
| [Simple WhatsApp Sender](Simple%20WhatApp%20Sender/readme.md) | Schedule a WhatsApp message through WhatsApp Web. |
| [Use Twilio](Use%20Twilio/readme.md) | Send SMS or WhatsApp messages and place calls through Twilio. |
| [Use Windows Login](Use%20Windows%20Login/readme.md) | Demonstrate checking the current Windows account credentials. |
### ๐ง Machine learning & data
| Project | What it does |
|---|---|
| [COVID Forecast](ML/COVID%20Forecast/readme.md) | Analyze and forecast daily COVID-19 case data with ARIMA/SARIMAX models. |
| [Salary Prediction](ML/Salary/readme.md) | Train a linear-regression salary model and use it for interactive predictions. |
### ๐งฉ Python fundamentals & persistence
| Project | What it does |
|---|---|
| [Custom Exception](Custom%20Exception/readme.md) | Define, raise, and catch a custom Python exception. |
| [Database](Database/README.md) | Store and retrieve key-value data using Python's built-in `dbm` module. |
| [Object Clone](Object%20Clone/readme.md) | Demonstrate independent object copies with `copy.deepcopy()`. |
## ๐ Getting started
1. Choose a project from the index and open its README for the exact requirements and instructions.
2. Install the dependencies listed by that project. A virtual environment is a good way to keep them isolated:
```bash
python -m venv .venv
```
Activate it, then install that project's documented packages.
3. Run the command shown in the project's README, from the directory and with the configuration it specifies.
> ๐ก There is no repository-wide `requirements.txt`: installing every project's packages is unnecessary, and some projects rely on operating-system tools or services that cannot be installed with `pip`.
## โ ๏ธ Before you run a project
- **Network tools:** Only scan systems and networks you own or have permission to assess. `FixNetwork` performs system network resets and is Windows-only; read its guide before running it.
- **Wi-Fi profiles:** The Windows profile utility can display saved network credentials and delete profiles. Use it only on your own machine and review the deletion settings first.
- **File changes:** The MP3 re-encoder replaces original files in place. Back up audio before using it.
- **Credentials and APIs:** Configure your own API tokens, account credentials, connection strings, and phone numbers where a project requires them. Do not commit private credentials.
- **External dependencies:** Some demos need internet access, a browser/driver, FFmpeg, SQL Server, a .NET runtime, or a platform-specific feature; each project guide has details.
## ๐๏ธ Repository layout
Projects are organized in their own folders, generally with a `Console_Code/` or `GUI_Code/` directory and a project-specific README. The `ML/` folder groups the forecasting and salary-prediction projects; `GUI_Apps/` currently contains the Contact Book application.
## โ FAQ
**Who is this repository for?**
Python learners and developers who want small, readable, runnable examples of a specific task โ scanning ports, reading Wi-Fi networks, processing images or audio, building a desktop GUI, or training a simple model โ rather than one large framework.
**Do I need to install everything?**
No. Each project is independent; install only the packages listed in the README of the project you want to run.
**Do the projects work on Linux and macOS?**
Many do, but some use Windows-only features (for example `FixNetwork`, `Wifi Profiles`, and `Use Windows Login`) or need external tools such as FFmpeg, a browser driver, or SQL Server. Check the project README before running it.
**Can I call .NET code from Python?**
Yes โ [Load Libraries](LoadLibraries/readme.md) shows how to load a compiled C# library with `pythonnet`. The reverse direction (calling Python from C#) is in the [C# PythonBridge example](https://github.com/gcfernando/csharp_codes/tree/main/PythonBridge).
## ๐ Related projects
- [Audio8D](https://github.com/gcfernando/audio-8d) โ a complete Python desktop and command-line 8D audio converter built on FFmpeg
- [Machine-learning datasets](https://github.com/gcfernando/datasets) โ small datasets for regression, classification, and forecasting practice
- [Developer knowledge base](https://github.com/gcfernando/document) โ includes a complete Python OOP guide and a Python dunder-methods reference
- [C# and .NET code examples](https://github.com/gcfernando/csharp_codes) โ the companion collection for .NET
---
โจ **Browse a project, try an idea, and keep learning Python.** โจ
---
## Documentation links
[Read all Python Projects and Code Examples guides online](https://gcfernando.github.io/python_codes/documentation/) ยท [Project overview](https://gcfernando.github.io/python_codes/) ยท [All developer projects](https://gcfernando.github.io/gcfernando/projects/)