Metadata-Version: 2.1
Name: glfy
Version: 0.1.5
Summary: Convert videos and images to ASCII art, including live streaming.
Author: dumgum82
Author-email: dumgum42@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: opencv-python
Requires-Dist: Pillow
Requires-Dist: numpy
Requires-Dist: mediapipe
Requires-Dist: pyvirtualcam
Requires-Dist: mss

GLFY is a tool for converting videos, images, and live streams into ASCII art. It supports video conversion, live video capture, virtual camera streaming, and screen capturing.

Features

- Video to ASCII Art: Convert video files into ASCII art video files.
- Image to ASCII Art: Convert image files into ASCII art images.
- Live Video to ASCII Art: Utilizes a virtual camera to capture live video from a camera or screen and display it as ASCII art.

# Installation

Install GLFY directly from PyPI:

pip install glfy

GLFY can be used from the command line or within a Python script.

Command Line Usage

- Convert an image to ASCII art:
  glfy image path/to/image.jpg

- Convert a video to ASCII art:
  glfy video path/to/video.mp4

- Start live video ASCII conversion:
  glfy live

# Python Script Usage

You can use GLFY’s CLI from within a Python script using the subprocess module:

import subprocess

Convert an image to ASCII art using the CLI
subprocess.run(['glfy', 'image', 'path/to/image.jpg'])

Convert a video to ASCII art using the CLI
subprocess.run(['glfy', 'video', 'path/to/video.mp4'])

Start live video ASCII conversion using the CLI
subprocess.run(['glfy', 'live'])

# Customizable Parameters

GLFY allows you to adjust various parameters to customize the ASCII art output:

- Brightness, Contrast, and Vibrancy Adjustments: Modify the appearance of the ASCII art.
- Gamma Correction:  Fine-tune brightness and color balance for a more accurate visual representation.
- Background Manipulation: Adjust background vibrancy, brightness, and blur.
- ASCII Character Set: Use different ASCII characters for varied artistic effects.
- Resolution and Frame Rate: Set resolution and frame rate for virtual camera streaming or video processing.

License

This project is licensed under the MIT License.

Enjoy creating ASCII art with GLFY!
