.. image:: 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:
.. image:: 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
============
.. code-block:: console
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.
Raw data
{
"_id": null,
"home_page": "https://github.com/jenca-adam/ascvid",
"name": "ascvid",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Video,ASCII,Terminal",
"author": "Adam Jenca",
"author_email": "jenca.a@gjh.sk",
"download_url": "https://files.pythonhosted.org/packages/fb/1e/97f317cfe73efbfd8d3fd049ff1a3166ad47a907f5b96a7f0d8b2f3e6adc/ascvid-1.5.3.tar.gz",
"platform": null,
"description": "\n.. image:: https://raw.githubusercontent.com/jenca-adam/ascvid/main/asc.png\n\n``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).\nHere is a little showcase of what it can do: \n\n.. image:: https://raw.githubusercontent.com/jenca-adam/ascvid/main/rick.gif\n\nIt 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.\n``ascvid`` also supports audio output and pausing your video! It's a true video player.\n\n\nInstallation\n============\n\n.. code-block:: console\n \n python3 -m pip install ascvid\n\nThen you can just run ``ascvid`` and you're good to go.\n\nCLI Options\n===========\n*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.*\n.. code-block:: console\n \n Usage: ascvid [OPTIONS] FILE\n\n Options:\n -H, --hide-cursor Hide the cursor while playing the video\n -A, --no-audio Don't play audio stream\n -f, --fps TEXT Number of FPS the video's supposed to run at. If\n None, it's determined from the video. If \"max\",\n ascvid will try its best to keep the video from\n lagging\n -c, --char TEXT Character to be used while rendering the video\n frames\n -C, --no-color Don't color output\n -a, --ascii Use multiple ASCII characters. Best to be used with\n --no-truecolor\n -T, --no-truecolor Reduces color palette. Use this flag on more stupid\n terminals (windows).\n -F, --fast Toggles off resizing each frame individually, rather\n resizes the entire video. Use this if the video is\n lagging too much.\n -d, --disable-controls Disables pausing the video\n -t, --title TEXT Sets the title of the video. If not set, file name\n will be used instead\n -h, --hide-title hides the title\n -n, --new-window Opens in a new terminal window\n -t, --term TEXT Specify terminal in format '<terminal command> <run\n command switch> {}'\n -o, --outfile TEXT Specify output file\n -d, --debug Debug mode: show current/target fps\n -s, --subs Subtitle file to use\n\n --help Show this message and exit.\n \n \n",
"bugtrack_url": null,
"license": "",
"summary": "ASCII Video player.",
"version": "1.5.3",
"project_urls": {
"Homepage": "https://github.com/jenca-adam/ascvid"
},
"split_keywords": [
"video",
"ascii",
"terminal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a537d82abe8396d3b31be1093d85382dbba52badc494627d53d14d4fa4bd4fd9",
"md5": "ff21709fd3647473bc6ab1d8dcb54afb",
"sha256": "036bc5e49d5ce23ab77264e114dfad7957f97b36668a5437b120f56ea26fc4ed"
},
"downloads": -1,
"filename": "ascvid-1.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ff21709fd3647473bc6ab1d8dcb54afb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23881,
"upload_time": "2023-06-04T19:37:23",
"upload_time_iso_8601": "2023-06-04T19:37:23.637162Z",
"url": "https://files.pythonhosted.org/packages/a5/37/d82abe8396d3b31be1093d85382dbba52badc494627d53d14d4fa4bd4fd9/ascvid-1.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fb1e97f317cfe73efbfd8d3fd049ff1a3166ad47a907f5b96a7f0d8b2f3e6adc",
"md5": "5ba6bb695784289ac997c061083d9545",
"sha256": "0114354fd7c6677acf25ea9cca650c7d93112b67657528a2ce83ad0bd7c7d1d0"
},
"downloads": -1,
"filename": "ascvid-1.5.3.tar.gz",
"has_sig": false,
"md5_digest": "5ba6bb695784289ac997c061083d9545",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 22921,
"upload_time": "2023-06-04T19:37:25",
"upload_time_iso_8601": "2023-06-04T19:37:25.047357Z",
"url": "https://files.pythonhosted.org/packages/fb/1e/97f317cfe73efbfd8d3fd049ff1a3166ad47a907f5b96a7f0d8b2f3e6adc/ascvid-1.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-04 19:37:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jenca-adam",
"github_project": "ascvid",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ascvid"
}
JSON
