Skip to main content

ASCII Video player.

Project description

https://raw.githubusercontent.com/jenca-adam/ascvid/main/asc.png

ascvid is an ASCII video player with quite exact results. It is mostly advised to be used under Linux, but it might work on Windows too (its behavior under Mac is untested, and it will likely not work well). Here is a little showcase of what it can do:

https://raw.githubusercontent.com/jenca-adam/ascvid/main/rick.gif

It requires a Truecolor terminal to work like this. If you are on a stupider terminal, the results will look less realistic.The produced graphics aren’t blinking as in other ASCII video players, however, the videos might lag a bit if your terminal is zoomed out. ascvid also supports audio output and pausing your video! It’s a true video player.

Installation

python3 -m pip install ascvid

Then you can just run ascvid and you’re good to go.

CLI Options

NOTE :: –no-truecolor option lags like my brain, so if you are on a stupid terminal, you are better off using –no-color in ASCII mode. .. code-block:: console

Usage: ascvid [OPTIONS] FILE

Options:
-H, --hide-cursor

Hide the cursor while playing the video

-A, --no-audio

Don’t play audio stream

-f, --fps TEXT

Number of FPS the video’s supposed to run at. If None, it’s determined from the video. If “max”, ascvid will try its best to keep the video from lagging

-c, --char TEXT

Character to be used while rendering the video frames

-C, --no-color

Don’t color output

-a, --ascii

Use multiple ASCII characters. Best to be used with –no-truecolor

-T, --no-truecolor

Reduces color palette. Use this flag on more stupid terminals (windows).

-F, --fast

Toggles off resizing each frame individually, rather resizes the entire video. Use this if the video is lagging too much.

-d, --disable-controls

Disables pausing the video

-t, --title TEXT

Sets the title of the video. If not set, file name will be used instead

-h, --hide-title

hides the title

-n, --new-window

Opens in a new terminal window

-t, --term TEXT

Specify terminal in format ‘<terminal command> <run command switch> {}’

--help

Show this message and exit.

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

ascvid-1.2.0.tar.gz (20.3 kB view details)

Uploaded Source

Built Distribution

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

ascvid-1.2.0-py3-none-any.whl (21.0 kB view details)

Uploaded Python 3

File details

Details for the file ascvid-1.2.0.tar.gz.

File metadata

  • Download URL: ascvid-1.2.0.tar.gz
  • Upload date:
  • Size: 20.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.10

File hashes

Hashes for ascvid-1.2.0.tar.gz
Algorithm Hash digest
SHA256 58d7aa266d6fa2c73853b6f0cfc20bd20b0e2a70cf9e4a4b9ab360b0f2ab43a9
MD5 743d58467088d4f77ab28e7102cbf74a
BLAKE2b-256 6e3243c6055eacfdcf458d4ced55f8a8a49aff7341de763d9b483d2abc34ac2a

See more details on using hashes here.

File details

Details for the file ascvid-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: ascvid-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 21.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.10

File hashes

Hashes for ascvid-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c7ef40dd084f27ae1caf2d8d8a4a67b3015be88e930ec40b13bb0a2c90aef994
MD5 5902a12d80d3f18ba6718410276ca77c
BLAKE2b-256 cd8b3484b298207e6d728dd52a1da8935d371bd38475fdc1caaa028ba600f1a8

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