videoclip - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #go #golang #deep-learning #docker #nodejs #java #cli #kubernetes #mcp #openai

videoclip

(★ 196)

🍗 Easily create videoclips with mpv.

파일 탐색기

최종 버전 다운로드 (.zip)

- - config.yml
  - issue.md
- - release-boilerplate.md
- - auto-release.yml
- dependabot.yml
- FUNDING.yml
- run.lua
- setup.lua
- - config.lua
  - default_config.conf
  - defaults.lua
- - encoder.lua
  - executables.lua
  - ffmpeg.lua
  - mpv.lua
  - utils.lua
- helpers.lua
- main.lua
- osd_styler.lua
- platform.lua
- test_fixtures.lua
- timings_mgr.lua
- videoclip.lua
.gitignore
LICENSE
main.lua
Makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/Ajatt-Tools/videoclip

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd videoclip

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![screenshot](https://github.com/Lemmmy/videoclip/assets/858456/855bff15-b0cd-4c12-a9ac-40a5e01d3b83)

# videoclip

[![Chat](https://img.shields.io/badge/chat-join-green)](https://tatsumoto-ren.github.io/blog/join-our-community.html)
![GitHub](https://img.shields.io/github/license/Ajatt-Tools/videoclip)
![GitHub top language](https://img.shields.io/github/languages/top/Ajatt-Tools/videoclip)
[![Patreon](https://img.shields.io/badge/support-patreon-orange)](https://tatsumoto.neocities.org/blog/donating-to-tatsumoto.html)

Easily create video and audio clips with mpv in a few keypresses.
Videoclips are saved as `.mp4` or `.webm`.
Subtitles can be embedded into the clips.

## Prerequisites

1) [Install mpv](https://mpv.io/installation/).
2) Add the directory where `mpv` is installed
   to the [PATH](https://www.mojeek.com/search?q=path+variable).

If you're using GNU/Linux, this step is likely unnecessary
   because package managers (`apt`, `pacman`, etc.)
   place executable files to `/usr/bin` which is already added to the `PATH`.
   If you have installed `mpv` to a non-standard location,
   or if you're not using the GNU operating system,
   you need to make sure that `mpv` is added to the `PATH`.

## Installation

### Using git

Clone the repository to the `mpv/scripts` directory.
The command below works on the GNU operating system with `git` installed.

``` bash
git clone 'https://github.com/Ajatt-Tools/videoclip.git' ~/.config/mpv/scripts/videoclip
```

To update the user-script on demand later, you can execute:

``` bash
cd ~/.config/mpv/scripts/videoclip && git pull
```

### Using make

Clone the repository first, then install to `~/.config/mpv` by running:

``` bash
git clone 'https://github.com/Ajatt-Tools/videoclip.git'
cd videoclip
make install
```

The installation target copies the `videoclip/` directory to `~/.config/mpv/scripts/`.
If none exists, installs the example config to `~/.config/mpv/script-opts/videoclip.conf`.

To uninstall, run:

``` bash
make uninstall
```

To install to a different mpv config directory, set `PREFIX`:

``` bash
make PREFIX="$HOME/.config/mpv" install
```

### Manually

1) Download
   [the latest release](https://github.com/Ajatt-Tools/videoclip/releases)
   or [the master branch (trunk)](https://github.com/Ajatt-Tools/videoclip/archive/refs/heads/master.zip)
2) Extract the `videoclip/` directory from the zip file
   to your [mpv scripts](https://github.com/mpv-player/mpv/wiki/User-Scripts) directory.

| OS | Location |
| --- | --- |
| GNU/Linux | `~/.config/mpv/scripts/` |
| Windows | `C:/Users/Username/AppData/Roaming/mpv/scripts/` |

Note: in [Celluloid](https://www.archlinux.org/packages/community/x86_64/celluloid/)
user scripts are installed by switching to the "Plugins" tab
in the preferences dialog and dropping the files there.

<details>

<summary>Expected directory tree</summary>

```
~/.config/mpv/scripts
|-- other_addon_1
|-- other_addon_2
`-- videoclip
    |-- main.lua
    |-- ...
    `-- videoclip.lua
```

</details>

## Configuration

The config file should be created by the user, if needed.

| OS | Config location |
| --- | --- |
| GNU/Linux | `~/.config/mpv/script-opts/videoclip.conf` |
| Windows | `C:/Users/Username/AppData/Roaming/mpv/script-opts/videoclip.conf` |

If a parameter is not specified in the config file, the default value will be used.
mpv doesn't tolerate spaces before and after `=`.

The example configuration file is stored in
[`videoclip/config/default_config.conf`](videoclip/config/default_config.conf).
Release pages also provide it as `videoclip.conf`.

Copy it to your `script-opts` directory and edit it as needed.

### Key bindings

| OS | Config location |
| --- | --- |
| GNU/Linux | `~/.config/mpv/input.conf` |
| Windows | `C:/Users/Username/AppData/Roaming/mpv/input.conf` |

Add this line if you want to change the key that opens the script's menu.

```
c script-binding videoclip-menu-open
```

## Usage

- Open a file in mpv and press `c` to open the script menu.
- Follow the onscreen instructions. You need to set the `start point`,
`end point`, and then press `c` to create the clip.

It is possible to create silent videoclips.
To do that, first mute audio in mpv.
The default key binding is `m`.

If a video has visible subtitles, they will be embedded automatically.
Toggle them off in mpv if you don't want any subtitles to be visible.
The default key binding is `v`.

## Running tests

Run tests without mpv or a media file:

```bash
lua tests/run.lua
luajit tests/run.lua
```

Run tests inside a real mpv instance with a local media file:

```bash
VIDEOCLIP_TEST=TRUE mpv --msg-level=all=no,videoclip=warn "/path/to/video.mkv"
```