{"id":15288482,"url":"https://github.com/kai-kj/ptmv","last_synced_at":"2026-01-08T10:10:59.989Z","repository":{"id":44645697,"uuid":"297291607","full_name":"kai-kj/ptmv","owner":"kai-kj","description":"An utf-8/truecolor image and video viewer for the terminal ","archived":false,"fork":false,"pushed_at":"2022-02-18T08:34:39.000Z","size":7099,"stargazers_count":41,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-20T16:05:05.828Z","etag":null,"topics":["image","linux","python","terminal-app","terminal-graphics","video","youtube"],"latest_commit_sha":null,"homepage":"","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/kai-kj.png","metadata":{"files":{"readme":"README-PIP.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":"2020-09-21T09:29:05.000Z","updated_at":"2024-11-14T01:47:54.000Z","dependencies_parsed_at":"2022-09-10T00:41:17.104Z","dependency_job_id":null,"html_url":"https://github.com/kai-kj/ptmv","commit_stats":null,"previous_names":["kai-kj/ptmv","kal39/ptmv"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai-kj%2Fptmv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai-kj%2Fptmv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai-kj%2Fptmv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai-kj%2Fptmv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kai-kj","download_url":"https://codeload.github.com/kai-kj/ptmv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248674674,"owners_count":21143760,"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":["image","linux","python","terminal-app","terminal-graphics","video","youtube"],"created_at":"2024-09-30T15:49:18.123Z","updated_at":"2026-01-08T10:10:59.947Z","avatar_url":"https://github.com/kai-kj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ch1 align=\"center\"\u003e\u003cb\u003ePython Terminal Media Viewer\u003c/b\u003e\u003c/h1\u003e\n    \u003cp align=\"center\"\u003e\u003cb\u003eView images and videos without leaving the console\u003c/b\u003e\u003c/p\u003e\n\t\u003ch2 align=\"center\"\u003e\u003ca href=\"https://github.com/kal39/ptmv\"\u003eMore info on GitHub\u003c/a\u003e\u003c/h2\u003e\n\u003c/p\u003e\n\n\n\n\n----\n\n### Features\n\n* View **images** form any terminal\n* Watch **videos** from any terminal\n* Watch **youtube** videos from any terminal (`-y`, `--youtube`)\n* Play videos at **any fps** (`--fps`) with sound\n* **Resize** images / videos (`--width`, `--height`)\n* Easy to use\n\n----\n\n### Requirements\n\n* A terminal that supports **truecolor** ([list](https://gist.github.com/XVilka/8346728)) and **utf-8** (most terminals should support utf-8).\n\n----\n\n### Usage\n\n```shell\nptmv FILE [OPTIONS]\n```\n\n* **Required arguments**  \n\n    * `FILE`\n\n        File to display/play or youtube url\n\n* **Optional arguments**  \n\n  * `-y`. `--youtube` \n    View youtube videos\n\n  * `--height` \n    Set height (setting both `width` and `height` will ignore original aspect ratio)\n\n  * `--width` \n    Set width (setting both `width` and `height` will ignore original aspect ratio)\n\n  * `--start-time`\n    \n    Set start position for video.\n\n  * `-f`, `--fps` \n    Set fps (default 15 fps)\n\n  * `-m`, `--mute` \n    Mute audio\n\n  * `-h`, `--help ` \n    Display help\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkai-kj%2Fptmv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkai-kj%2Fptmv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkai-kj%2Fptmv/lists"}