Skip to main content

Convert videos and images to ASCII art, including live streaming.

Project description

GLFY Tool

GLFY is a versatile tool for converting videos, images, and live streams into ASCII art. It supports video conversion, live video capture, virtual camera streaming, and screen capturing. GLFY is designed for efficiency and customization, making it ideal for artistic and fun applications.

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: Capture live video from your webcam and display it as ASCII art.
  • Virtual Camera Support: Stream ASCII art to a virtual camera for use in video applications.
  • Screen Capture: Stream your screen as ASCII art in real-time.
  • Customizable Parameters: Adjust brightness, contrast, vibrancy, gamma, and more.

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

  • Start live video conversion from camera: glfy live -src cam

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 the brightness of the ASCII output.
  • Background Manipulation: Adjust background vibrancy, brightness, and blur.
  • ASCII Character Set: Use different ASCII characters for varied artistic effects.
  • Virtual Camera Settings: Set resolution and frame rate for virtual camera streaming.

License

This project is licensed under the MIT License.

Enjoy creating ASCII art with GLFY!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glfy-0.1.2.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

glfy-0.1.2-py3-none-any.whl (1.6 MB view details)

Uploaded Python 3

File details

Details for the file glfy-0.1.2.tar.gz.

File metadata

  • Download URL: glfy-0.1.2.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for glfy-0.1.2.tar.gz
Algorithm Hash digest
SHA256 1693d2926f155aee7b901afed6023a89ba837e0083a067128422a93e7c0b5de3
MD5 7d113ed52dc699bdade0cede2c5868e9
BLAKE2b-256 f982e9086e5281d4ac8282ad628424d90244b808f6f7e7df97f235677594aeab

See more details on using hashes here.

File details

Details for the file glfy-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: glfy-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for glfy-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6c1f72d94d19328223cdc1efb94d3faabdf748f02c96ea3de3c53d3fa28ebff6
MD5 831e18d8c189d67efde9813643225b0f
BLAKE2b-256 40339ff35f2fee5f2e3b9642ef4f58c7e62e48b5f1e3f423538c8a68a1610583

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page