{"id":13835476,"url":"https://github.com/Ajatt-Tools/videoclip","last_synced_at":"2025-07-10T07:32:17.187Z","repository":{"id":44413638,"uuid":"289175511","full_name":"Ajatt-Tools/videoclip","owner":"Ajatt-Tools","description":"🍗 Easily create videoclips with mpv.","archived":false,"fork":false,"pushed_at":"2024-07-18T21:47:05.000Z","size":115,"stargazers_count":104,"open_issues_count":8,"forks_count":14,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-05T14:16:20.114Z","etag":null,"topics":["addon","ajatt","audioclip","clip","mpv","mpv-script","videoclip"],"latest_commit_sha":null,"homepage":"https://tatsumoto-ren.github.io/blog/join-our-community","language":"Lua","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/Ajatt-Tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"tatsumoto_ren","liberapay":"Tatsumoto","custom":"https://tatsumoto.neocities.org/blog/donating-to-tatsumoto.html"}},"created_at":"2020-08-21T04:16:37.000Z","updated_at":"2024-08-05T14:16:20.115Z","dependencies_parsed_at":"2024-03-08T17:34:52.810Z","dependency_job_id":"900b0d07-3f5f-4fb0-9810-6d396ab05e40","html_url":"https://github.com/Ajatt-Tools/videoclip","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/Ajatt-Tools%2Fvideoclip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajatt-Tools%2Fvideoclip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajatt-Tools%2Fvideoclip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajatt-Tools%2Fvideoclip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ajatt-Tools","download_url":"https://codeload.github.com/Ajatt-Tools/videoclip/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225627385,"owners_count":17498975,"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":["addon","ajatt","audioclip","clip","mpv","mpv-script","videoclip"],"created_at":"2024-08-04T14:01:02.914Z","updated_at":"2025-07-10T07:32:17.181Z","avatar_url":"https://github.com/Ajatt-Tools.png","language":"Lua","funding_links":["https://patreon.com/tatsumoto_ren","https://liberapay.com/Tatsumoto","https://tatsumoto.neocities.org/blog/donating-to-tatsumoto.html"],"categories":["Video Editing"],"sub_categories":[],"readme":"![screenshot](https://github.com/Lemmmy/videoclip/assets/858456/855bff15-b0cd-4c12-a9ac-40a5e01d3b83)\n\n# videoclip\n\n[![Chat](https://img.shields.io/badge/chat-join-green)](https://tatsumoto-ren.github.io/blog/join-our-community.html)\n![GitHub](https://img.shields.io/github/license/Ajatt-Tools/videoclip)\n![GitHub top language](https://img.shields.io/github/languages/top/Ajatt-Tools/videoclip)\n[![Patreon](https://img.shields.io/badge/support-patreon-orange)](https://tatsumoto.neocities.org/blog/donating-to-tatsumoto.html)\n\nEasily create video and audio clips with mpv in a few keypresses.\nVideoclips are saved as `.mp4` or `.webm`.\nSubtitles can be embedded into the clips.\n\n## Prerequisites\n\n1) [Install mpv](https://mpv.io/installation/).\n2) Add the directory where `mpv` is installed\n   to the [PATH](https://www.mojeek.com/search?q=path+variable).\n\n   If you're using GNU/Linux, this step is likely unnecessary\n   because package managers (`apt`, `pacman`, etc.)\n   place executable files to `/usr/bin` which is already added to the `PATH`.\n   If you have installed `mpv` to a non-standard location,\n   or if you're not using the GNU operating system,\n   you need to make sure that `mpv` is added to the `PATH`.\n\n## Installation\n\n### Using git\n\nClone the repository to the `mpv/scripts` directory.\nThe command below works on the GNU operating system with `git` installed.\n\n``` bash\ngit clone 'https://github.com/Ajatt-Tools/videoclip.git' ~/.config/mpv/scripts/videoclip\n```\n\nTo update the user-script on demand later, you can execute:\n\n``` bash\ncd ~/.config/mpv/scripts/videoclip \u0026\u0026 git pull\n```\n\n### Manually\n\nDownload\n[the repository](https://github.com/Ajatt-Tools/videoclip/archive/refs/heads/master.zip)\nand extract the folder containing\n`videoclip.lua`\nto your [mpv scripts](https://github.com/mpv-player/mpv/wiki/User-Scripts) directory:\n\n| OS | Location |\n| --- | --- |\n| GNU/Linux | `~/.config/mpv/scripts/` |\n| Windows | `C:/Users/Username/AppData/Roaming/mpv/scripts/` |\n\nNote: in [Celluloid](https://www.archlinux.org/packages/community/x86_64/celluloid/)\nuser scripts are installed by switching to the \"Plugins\" tab\nin the preferences dialog and dropping the files there.\n\n\u003cdetails\u003e\n\n\u003csummary\u003eExpected directory tree\u003c/summary\u003e\n\n```\n~/.config/mpv/scripts\n|-- other_addon_1\n|-- other_addon_2\n`-- videoclip\n    |-- main.lua\n    |-- ...\n    `-- videoclip.lua\n```\n\n\u003c/details\u003e\n\n## Configuration\n\nThe config file should be created by the user, if needed.\n\n| OS | Config location |\n| --- | --- |\n| GNU/Linux | `~/.config/mpv/script-opts/videoclip.conf` |\n| Windows | `C:/Users/Username/AppData/Roaming/mpv/script-opts/videoclip.conf` |\n\nIf a parameter is not specified in the config file, the default value will be used.\nmpv doesn't tolerate spaces before and after `=`.\n\nExample configuration file:\n\n```\n# Absolute paths to the folders where generated clips will be placed.\n# `~` is supported, but environment variables (e.g. `$HOME`) are not supported due to mpv limitations.\nvideo_folder_path=~/Videos\naudio_folder_path=~/Music\n\n# Menu size\nfont_size=24\n\n# OSD settings. Line alignment: https://aegisub.org/docs/3.2/ASS_Tags/#\\an\nosd_align=7\nosd_outline=1.5\n\n# Clean filenames (remove special characters) (yes or no)\nclean_filename=yes\n\n# Video settings\nvideo_width=-2\nvideo_height=480\nvideo_bitrate=1M\n# Available video formats: mp4, vp9, vp8\nvideo_format=mp4\n# The range of the scale is 0–51, where 0 is lossless,\n# 23 is the default, and 51 is worst quality possible.\n# Insane values like 9999 still work but produce the worst quality.\nvideo_quality=23\n# Use the slowest preset that you have patience for.\n# https://trac.ffmpeg.org/wiki/Encode/H.264\npreset=faster\n# FPS / framerate. Set to \"auto\" or a number.\nvideo_fps=auto\n#video_fps=60\n\n# Audio settings\n# Available formats: opus or aac\naudio_format=opus\n# Opus sounds good at low bitrates 32-64k, but aac requires 128-256k.\naudio_bitrate=32k\n\n# Catbox.moe upload settings\n# Whether uploads should go to litterbox instead of catbox.\n# catbox files are stored permanently, while litterbox is temporary\nlitterbox=yes\n# If using litterbox, time until video expires\n# Available values: 1h, 12h, 24h, 72h\nlitterbox_expire=72h\n\n# Filename format\n# Available tags: %n = filename, %t = title, %s = start, %e = end, %d = duration,\n#                 %Y = year, %M = months, %D = day, %H = hours (24), %I = hours (12),\n#                 %P = am/pm %N = minutes, %S = seconds\n# Title will fallback to filename if it's not present\n#filename_template=%n_%s-%e(%d)\nfilename_template=%n_%s-%e\n```\n\n### Key bindings\n\n| OS | Config location |\n| --- | --- |\n| GNU/Linux | `~/.config/mpv/input.conf` |\n| Windows | `C:/Users/Username/AppData/Roaming/mpv/input.conf` |\n\nAdd this line if you want to change the key that opens the script's menu.\n\n```\nc script-binding videoclip-menu-open\n```\n\n## Usage\n\n- Open a file in mpv and press `c` to open the script menu.\n- Follow the onscreen instructions. You need to set the `start point`,\n`end point`, and then press `c` to create the clip.\n\nIt is possible to create silent videoclips.\nTo do that, first mute audio in mpv.\nThe default key binding is `m`.\n\nIf a video has visible subtitles, they will be embedded automatically.\nToggle them off in mpv if you don't want any subtitles to be visible.\nThe default key binding is `v`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAjatt-Tools%2Fvideoclip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAjatt-Tools%2Fvideoclip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAjatt-Tools%2Fvideoclip/lists"}