Skip to main content
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.

Metadata

Release files for ascvid 1.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ascvid 1.5.3
File Size Uploaded
ascvid-1.5.3.tar.gz 22.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ascvid 1.5.3
File Interpreter ABI Platform
ascvid-1.5.3-py3-none-any.whl Python 3 none any Details

Total release size: 46.8 kB

Release files / ascvid-1.5.3.tar.gz

Download URL ascvid-1.5.3.tar.gz
Size 22.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0114354fd7c6677acf25ea9cca650c7d93112b67657528a2ce83ad0bd7c7d1d0
BLAKE2b-256 checksum
How to use checksums
fb1e97f317cfe73efbfd8d3fd049ff1a3166ad47a907f5b96a7f0d8b2f3e6adc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Release files / ascvid-1.5.3-py3-none-any.whl

Download URL ascvid-1.5.3-py3-none-any.whl
Size 23.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
036bc5e49d5ce23ab77264e114dfad7957f97b36668a5437b120f56ea26fc4ed
BLAKE2b-256 checksum
How to use checksums
a537d82abe8396d3b31be1093d85382dbba52badc494627d53d14d4fa4bd4fd9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Release history Release notifications | RSS feed

This release

1.5.3 This release

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page