https://github.com/malavika-suresh/screen_recorder

Python-based screen recording utility featuring audio, click effects, and FFmpeg integration for smooth MP4 output.
https://github.com/malavika-suresh/screen_recorder

audio-recording automation ffmpeg opencv python screen-recorder video-processing

Last synced: 2 months ago
JSON representation

Python-based screen recording utility featuring audio, click effects, and FFmpeg integration for smooth MP4 output.

• Host: GitHub
• URL: https://github.com/malavika-suresh/screen_recorder
• Owner: malavika-suresh
• Created: 2025-08-18T05:31:28.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-08-18T05:43:38.000Z (11 months ago)
• Last Synced: 2025-08-18T07:24:26.070Z (11 months ago)
• Topics: audio-recording, automation, ffmpeg, opencv, python, screen-recorder, video-processing
• Language: Python
• Homepage:
• Size: 6.84 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

          
# 🎥 Python Screen Recorder with Audio & Mouse Highlight

[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)

[![OpenCV](https://img.shields.io/badge/OpenCV-4.x-green.svg)](https://opencv.org/)

[![PyAutoGUI](https://img.shields.io/badge/PyAutoGUI-automation-orange.svg)](https://pyautogui.readthedocs.io/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

A lightweight **screen recorder** built in Python using OpenCV & PyAutoGUI, with **audio capture** and **mouse click highlights**.  

Perfect for creating tutorials, presentations, or recording gameplay.

---

## ✨ Features

- 📺 **Full HD screen recording** with custom resolution & FPS  

- 🎤 **Audio recording** from microphone  

- 🖱️ **Mouse click highlighting** for tutorials  

- 💾 **Saves as AVI or MP4** (via FFmpeg)  

- ⏱️ **Manual or auto-stop** recording  

- 🔄 **Cross-platform** (Windows, macOS, Linux)

---

## 📦 Installation

### 1️⃣ Clone the repository

```bash

git clone https://github.com//screen-recorder-python-gui.git

cd screen-recorder-python-gui

```

### 2️⃣ Install dependencies

```bash

pip install -r requirements.txt

```

### 3️⃣ Install FFmpeg  

- **Windows**: [Download here](https://ffmpeg.org/download.html#build-windows) and add to PATH  

- **Mac**:  

```bash

brew install ffmpeg

```

- **Linux**:  

```bash

sudo apt install ffmpeg

```

---

## 🚀 Usage

```bash

python recorder.py

```

Press **`q`** to stop recording manually.  

The recorded file will be saved in the current directory.

---

## 📂 File Structure

```

screen-recorder-python-gui/

│── recorder.py          # Main script

│── requirements.txt     # Dependencies

│── README.md            # Documentation

```

---

## 📜 Requirements

- Python 3.8+  

- [PyAutoGUI](https://pyautogui.readthedocs.io/)  

- [OpenCV](https://opencv.org/)  

- [SoundDevice](https://python-sounddevice.readthedocs.io/)  

- [SciPy](https://scipy.org/)  

- [mouse](https://pypi.org/project/mouse/)  

---