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.2.tar.gz (21.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.2-py3-none-any.whl (22.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ascvid-1.5.2.tar.gz
  • Upload date:
  • Size: 21.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.2.tar.gz
Algorithm Hash digest
SHA256 3b4a4ac4339fc3e96f9c873d796297fbfe0ea63687f27be6eae25975b4a51279
MD5 3d8fda571ceaf87709d07330e7210ab1
BLAKE2b-256 6083639fe23c43ddcf8b992df25aa77fabaa6bd5b51e3225201a8413d3ff7ec9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ascvid-1.5.2-py3-none-any.whl
  • Upload date:
  • Size: 22.7 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0c741abc1902118dcf1a71dc433ef97ae86c5524aab14a1be2931e6f32c373dd
MD5 23ec96a8f82c6f17ecd350d7dc738079
BLAKE2b-256 0a7ddf53315faba515041f1de68250f8dc399d3e3624dbdf96597ca99171fb04

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