{"id":24049870,"url":"https://github.com/leinstay/asciiclip","last_synced_at":"2025-04-22T14:22:14.112Z","repository":{"id":63872029,"uuid":"571378586","full_name":"leinstay/asciiclip","owner":"leinstay","description":"CLI tool that applies an ASCII filter to video or image.","archived":false,"fork":false,"pushed_at":"2023-06-20T13:30:40.000Z","size":64,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-22T14:22:11.446Z","etag":null,"topics":["ascii-art","image-processing","python","video-processing"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/asciiclip/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leinstay.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-28T01:42:53.000Z","updated_at":"2024-12-03T01:38:56.000Z","dependencies_parsed_at":"2023-01-23T08:46:22.035Z","dependency_job_id":null,"html_url":"https://github.com/leinstay/asciiclip","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leinstay%2Fasciiclip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leinstay%2Fasciiclip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leinstay%2Fasciiclip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leinstay%2Fasciiclip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leinstay","download_url":"https://codeload.github.com/leinstay/asciiclip/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250255907,"owners_count":21400434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ascii-art","image-processing","python","video-processing"],"created_at":"2025-01-09T01:12:58.847Z","updated_at":"2025-04-22T14:22:14.094Z","avatar_url":"https://github.com/leinstay.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ASCII Clip\n\nCLI tool that applies an ASCII filter to video or image. \n\n[![demo1](https://user-images.githubusercontent.com/8215580/204165144-848c2fc8-9ea3-4fbb-be8d-142bb3210d48.png)](https://www.youtube.com/watch?v=lY-HOrYV_bk)\n\n## Installation\n\n### Python package from PyPI\n\n[pypi]: https://pypi.python.org/pypi/asciiclip\n\nasciiclip is available on [PyPI] and can be installed with pip (Python 3\nwith setuptools required):\n\n```sh\npython3 -m pip install asciiclip\n```\n\nInstalling from [PyPI] is the recommended way of installation, which gives you the latest released version.\n\n## Examples\n\nCreate an ASCII clip from YouTube video or local video:\n\n```sh\nasciiclip -o https://www.youtube.com/watch?v=xxxxxxxx -d /dest/\nasciiclip -o /from/clip.mp4 -d /to/ -s 10 -e 30\n```\n\nCreate an ASCII image of a particular second from YouTube video or local video:\n\n```sh\nasciiclip -o https://www.youtube.com/watch?v=xxxxxxxx -d /dest/ -r 120\nasciiclip -o /from/clip.mp4 -d /to/ -r 5\n```\n\nCreate an ASCII image from local image using custom ASCII character list:\n\n```sh\nasciiclip -o /from/image.png -d /to/ -a \".:;-+*uo@\"\n```\n\nCreate an ASCII clip using custom settings:\n\n```sh\nasciiclip -o https://www.youtube.com/watch?v=xxxxxxxx -d /dest/ -a \".:;-+*uo@\" -q 1080 -h 6 6 -fs 6\n```\n\n## Usage\n\nWhen you run `asciiclip` with no arguments help message is displayed, listing all options.\n\nUsage: asciiclip [OPTIONS]\n\nAvailable options:\n\n-   `-o, --source PATH`               - Link to YouTube video or path to image or video  *[required]*\n-   `-d, --destination DIRECTORY`     - Output folder  *[required]*\n-   `-f, --filename TEXT`             - Output file name  [default: ascii]\n-   `-s, --start INTEGER`             - Used to trim video, sets the beginning point in seconds\n-   `-e, --end INTEGER`               - Used to trim video, sets the ending point in seconds\n-   `-r, --frame INTEGER`             - Turns the frame at a specified second of video into an image (-s/-e will be ignored)\n-   `-t, --threads INTEGER RANGE`     - Number of threads used for video processing [default: 8; 1\u003c=x\u003c=32]\n-   `-a, --chars TEXT`                - List of ASCII characters arranged from dark to light  [default: .;*uo]\n-   `-p, --preset [720|1080]`         - A set of settings that will produce a 720p or 1080p output file (-h/-ft/-fs/-q will be ignored)\n-   `-q, --sourcequality [360|480|720|1080]` - Height in pixels to which the video or image will be scaled down (the final result will be about [fontsize/chunk] times this value) [default: 360]\n-   `-h, --chunk INTEGER RANGE...`    - Size of the rectangular area that will be consolidated to a single ASCII symbol [default: 2, 2; 0\u003c=x\u003c=128]\n-   `-g, --gsv FLOAT RANGE...`        - RGB weights used when desaturating an image or video  [default: 0.299, 0.587, 0.114; 0\u003c=x\u003c=1]\n-   `-c, --compression INTEGER RANGE` - PNG compression level  [default: 0; 0\u003c=x\u003c=9]\n-   `-ft, --font FILE`                - Path to custom font  [default: moby.ttf]\n-   `-fs, --fontsize INTEGER RANGE`   - Font size  [default: 6; 0\u003c=x\u003c=128]\n-   `-fc, --fontcolor INTEGER RANGE`  - Font color  [default: 255, 255, 255; 0\u003c=x\u003c=255]\n-   `--keepaspectratio`               - Preserves original aspect ratio, otherwise if the video is thinner than 16:9 bars will be added to the sides\n-   `--mute`                          - Removes the audio track from the video\n-   `--quiet`                         - Suppress all console messages\n-   `--help`                          - Show this message and exit.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleinstay%2Fasciiclip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleinstay%2Fasciiclip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleinstay%2Fasciiclip/lists"}