{"id":21543841,"url":"https://github.com/thealexdev23/terminal-video-player","last_synced_at":"2025-07-16T12:31:18.132Z","repository":{"id":44603686,"uuid":"454087735","full_name":"TheAlexDev23/Terminal-Video-Player","owner":"TheAlexDev23","description":"A program that can display video in the terminal using ascii characters","archived":false,"fork":false,"pushed_at":"2022-10-04T21:25:24.000Z","size":67,"stargazers_count":15,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-05-09T11:57:46.641Z","etag":null,"topics":["ascii","python","terminal","terminal-app","video","video-play","video-player"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheAlexDev23.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-01-31T16:43:59.000Z","updated_at":"2023-05-07T13:47:08.000Z","dependencies_parsed_at":"2023-01-19T03:20:16.406Z","dependency_job_id":null,"html_url":"https://github.com/TheAlexDev23/Terminal-Video-Player","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAlexDev23%2FTerminal-Video-Player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAlexDev23%2FTerminal-Video-Player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAlexDev23%2FTerminal-Video-Player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAlexDev23%2FTerminal-Video-Player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheAlexDev23","download_url":"https://codeload.github.com/TheAlexDev23/Terminal-Video-Player/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226126335,"owners_count":17577497,"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","python","terminal","terminal-app","video","video-play","video-player"],"created_at":"2024-11-24T05:15:50.169Z","updated_at":"2024-11-24T05:15:51.036Z","avatar_url":"https://github.com/TheAlexDev23.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terminal Video Player\n\n- This code will allow you to play any video in the terminal!\n- Works perfectly with video formats like mkv mp4 and mov formats, other are still left to be tested\n- Can download any video of YouTube and play it.\n\n## How to run\n\n### If you want to play a video saved on your computer run the following\n\n```bash\npython ./Player.py [Location of the file you want to play]\n```\n\n### If you want to play a video from YouTube run the following\n\n```bash\npython ./Player.py -y [URL of the YouTube video]\n```\n\n#### Or if you want to play the video from YouTube with subtitles there's 2 ways\n\nPlay with default subtitles:\n\n```bash\npython ./Player.py -y [URL of the YouTube video] -c\n```\n\nPlay subtitles in a certain language:\n\n```bash\npython ./Player.py -y [URL of the YouTube video] -c [lang]\n```\n\n## Examples of usage\n\n### Video from computer\n\n```bash\npython ./Player.py ~/Videos/NeverGonnaGiveYouUp.mp4\n```\n\n### Video from YouTube without subtitles\n\n```bash\npython ./Player.py -y \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"\n```\n\n### Video from YouTube with default subtitles\n\n```bash\npython ./Player.py -y \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\" -c\n```\n\n### Video from YouTube with english subtitles\n\n```bash\npython ./Player.py -y \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\" -c en\n```\n\n## Things to know before using\n\n- Playing any video would create 2 folders each having `X` amount of jpgs, where `X` is the amount of frames the video has\n- Playing a video from YouTube would download it under ``` YouTubeTemporary/video.mp4 ```\n- If you already played a video from YouTube and you want to play another one, you need to first delete the video.mp4 from the YouTubeTemporary folder (note, that this is not necessary if you would be playing the same video or a video from your computer)\n- If subtitles are not found (maybe because there's no subtitles in the video or not in the specified language), an exception would be thrown\n- If the video is not found (maybe because it doesn't exist or there's no internet connection) an exception would also be thrown\n\n### Huge thanks to [talwat](https://github.com/talwat) for the contributions and ideas!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthealexdev23%2Fterminal-video-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthealexdev23%2Fterminal-video-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthealexdev23%2Fterminal-video-player/lists"}