Skip to main content

A simple tool to stream camera in shell.

Project description

CamShell

CamShell, A simple way to stream a camera as ASCII art directly in a terminal.

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

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.5.tar.gz (8.9 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.5-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: camshell-0.1.5.tar.gz
  • Upload date:
  • Size: 8.9 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.5.tar.gz
Algorithm Hash digest
SHA256 60763b76045c2ab1fadb1df67b13511dfb8f4e6686efda4d33a64d4ecc55794c
MD5 9d4f6964f2726963d24fe09abda845c5
BLAKE2b-256 80ed6b0a57cdbd61623422514931b8a491db0241c3da6a628e94f4bc46fa0ff4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: camshell-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 11.4 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 bc386001cf27e536e44d88744834394743d59901fa195a4504cd7db4d89d06a3
MD5 186c4dad756fa75938168671e495d971
BLAKE2b-256 1c3fb096c13d2e1c9c0a35faa35d3f5c0a4b64a5fa504605fa56e7b32de21f53

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