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> {}’

-o, --outfile TEXT

Specify output file

-d, --debug

Debug mode: show current/target fps

-s, --subs

Subtitle file to use

--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.5.3.tar.gz (22.9 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.5.3-py3-none-any.whl (23.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for ascvid-1.5.3.tar.gz
Algorithm Hash digest
SHA256 0114354fd7c6677acf25ea9cca650c7d93112b67657528a2ce83ad0bd7c7d1d0
MD5 5ba6bb695784289ac997c061083d9545
BLAKE2b-256 fb1e97f317cfe73efbfd8d3fd049ff1a3166ad47a907f5b96a7f0d8b2f3e6adc

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for ascvid-1.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 036bc5e49d5ce23ab77264e114dfad7957f97b36668a5437b120f56ea26fc4ed
MD5 ff21709fd3647473bc6ab1d8dcb54afb
BLAKE2b-256 a537d82abe8396d3b31be1093d85382dbba52badc494627d53d14d4fa4bd4fd9

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