Skip to main content

A simple tool to stream camera in shell.

Project description

CamShell

CamShell, a light weight ASCII art video streamer.

Installation

Using pip:

pip install camshell

How to Use

CLI Usage:

After installation, you can run the camshell command-line tool or by providing the device id.

# Run the default device
camshell

# Or run by device-id
camshell 1

# Or a device path specifically
camshell /dev/video3

# Or stream from a file
camshell -f ./my_video.mp4

Python API Usage

If you’d like to use CamShell in your Python code, here’s how:

from camshell import CamShell

# simply call:
device_id = "/dev/video0"
CamShell.start(device_index=device_id)

# or in case of MacOS
CamShell.start(avf_source=True)

Run on a custom screen

from camshell import CamShell
from camshell.display import Display
from camshell.vision.camera import GenericCamera

# Create a GStream-based camera object
camera = GenericCamera(device_index=cap_id, avf_source=True)

# Create a Curses display
display = Display()

# Create and run the CamShell
cs = CamShell(camera, display)
cs.initialize()
cs.run()

Output Example

Example Output

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

camshell-0.1.8.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

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

camshell-0.1.8-py3-none-any.whl (12.1 kB view details)

Uploaded Python 3

File details

Details for the file camshell-0.1.8.tar.gz.

File metadata

  • Download URL: camshell-0.1.8.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for camshell-0.1.8.tar.gz
Algorithm Hash digest
SHA256 52c65762b620302d93244520d49d68962d5477a32e7625dd35973778dad0a50e
MD5 127f68c2d4fc4127dbbb2409808ab1a4
BLAKE2b-256 6a0f7bfe6878b7b3801b122ae17ae353f5d5fa2c56bb7abd5532a36c0ac26ada

See more details on using hashes here.

File details

Details for the file camshell-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: camshell-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 12.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for camshell-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 9dbb6a01d463c0af08c2ae21ac9888767441b7ce93e68b969e025663f8be0f8f
MD5 9737bf25f841c05aeb8681bfae78ffa2
BLAKE2b-256 eeadf9fc136bda77d2a006ff5f943c93c81d83f76add8ef523c915e09513cb44

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