문서

모든 기능을 GUI / CLI / MCP에서 사용할 수 있습니다. 아래는 전체 레퍼런스입니다.

명령어 이름, 플래그, JSON 키는 실제로 입력하는 내용과 일치하도록 영어로 유지합니다. 주변 설명은 한국어로 번역되어 있습니다.

빠른 시작

설치

AI 에디션 설치 프로그램을 다운로드하고 실행하세요. 모든 의존성이 포함되어 있어 PATH 수정이 필요 없습니다.

터미널에서 시도

# Open a file
unflick play movie.mp4

# Save a screenshot of the current frame
unflick screenshot --output frame.png

# Cut a 30-second GIF starting at 00:01:00
unflick clip 60 90 --file movie.mp4 --gif

# Generate subtitles (AI edition: zero config)
unflick subtitle generate movie.mp4

AI 클라이언트에 연결

다음 설정을 MCP 클라이언트(Claude Desktop / Cursor / Codex CLI 등)에 추가하면 에이전트가 39개 도구와 3개 라이브 리소스로 재생, 자막 생성, 라이브러리 스캔 등을 수행할 수 있습니다.

{
  "mcpServers": {
    "unflick": {
      "command": "C:\\Users\\<you>\\AppData\\Local\\unflick\\unflick.exe",
      "args": ["--mcp"]
    }
  }
}

CLI 레퍼런스

모든 명령어는 stdout에 JSON을 반환합니다. jq로 파이프, 스크립트에서 파싱, 자유롭게 자동화하세요. 서브명령어는 첫 사용 시 백그라운드 daemon을 자동 시작합니다.

Playback

`unflick play <FILE> [--seek N] [--volume 0-100] [--speed N]`	Open a file and start playback. Resumes from saved position by default.
`unflick pause`	Pause the currently playing file.
`unflick resume`	Resume a paused file.
`unflick stop`	Stop playback and save the current position.
`unflick seek <SECONDS>`	Jump to an absolute position in seconds.
`unflick volume <0-100>`	Set the volume level.
`unflick speed <RATE>`	Set playback speed multiplier (e.g. 1.5).
`unflick status`	Print current playback state as JSON.

Media tools

`unflick info <FILE>`	Probe a file for duration, codecs, fps, container — without disrupting playback.
`unflick screenshot [--output PATH]`	Save the current frame as a PNG.
`unflick clip <START> <END> [--file PATH] [--output PATH] [--gif]`	Extract a segment to MP4 or animated GIF (uses bundled ffmpeg).

Tracks

`unflick subtitle load <FILE>`	Load an external .srt / .ass / .sub file.
`unflick subtitle list`	List embedded and external subtitle tracks.
`unflick subtitle select <ID>`	Switch to a subtitle track (0 disables).
`unflick subtitle generate <VIDEO> [--mode local\|api] [--whisper PATH] [--model PATH] [--api-key KEY]`	AI-generate subtitles. Auto-detects bundled whisper in the AI edition.
`unflick subtitle translate <SRT> --to <LANG> --api-key <KEY>`	Translate an SRT file via OpenAI.
`unflick audio list`	List embedded audio tracks.
`unflick audio select <ID>`	Switch to an audio track (0 disables).

Playlist

`unflick playlist add <FILE>`	Append a file to the playlist.
`unflick playlist remove <INDEX>`	Remove an entry by index.
`unflick playlist list`	Show all playlist entries with the current track marked.
`unflick playlist play <INDEX>`	Jump to a specific entry.
`unflick playlist next`	Advance to the next track.
`unflick playlist prev`	Go back to the previous track.
`unflick playlist clear`	Remove all entries.

Library

`unflick library scan <DIR>`	Scan a directory for video files into the SQLite library.
`unflick library search <QUERY>`	Search the library by title or path.
`unflick library list`	List every entry in the library.
`unflick library remove <ID>`	Remove an entry by ID.

Filters

`unflick filter list`	Show current values of brightness / contrast / saturation / gamma / hue.
`unflick filter set <NAME> <-100..100>`	Adjust a single filter.
`unflick filter reset`	Set every filter back to 0.

Settings

`unflick settings path`	Print the absolute settings.json path.
`unflick settings get [--key K]`	Print all settings, or a single key.
`unflick settings set <KEY> <JSON-VALUE>`	Set a key (parses as JSON; falls back to string).
`unflick settings unset <KEY>`	Remove a key.

Server

`unflick daemon`	Start the background daemon explicitly. Other CLI commands auto-start it on first use.
`unflick --mcp`	Start the MCP server over stdio. See the MCP section below.
`unflick shutdown`	Stop the running daemon.

MCP 레퍼런스

--mcp로 시작하면 unflick은 stdio를 통해 Model Context Protocol 서버를 노출합니다. 모든 CLI 기능이 도구로 제공되며 상태를 구독할 수 있는 3개의 리소스도 있습니다.

도구 (39)

`play`	Play a video file with optional seek/volume/speed.
`pause`	Pause playback.
`resume`	Resume playback.
`stop`	Stop playback.
`seek`	Seek to a position in seconds.
`set_volume`	Set the volume (0-100).
`set_speed`	Set playback speed.
`get_status`	Read state, file, position, duration, volume, speed.
`file_info`	Probe a media file (duration, resolution, codecs, fps, container).
`load_subtitle`	Load an external subtitle file.
`subtitle_list`	List subtitle tracks (embedded + external).
`subtitle_select`	Switch subtitle track by ID (0 disables).
`audio_list`	List embedded audio tracks.
`audio_select`	Switch audio track by ID.
`generate_subtitles`	Whisper-generate subtitles (local or OpenAI mode).
`translate_subtitles`	Translate an SRT via OpenAI.
`playlist_add`	Append a file to the playlist.
`playlist_remove`	Remove a playlist entry by index.
`playlist_list`	List playlist entries.
`playlist_play`	Jump to a playlist entry by index.
`playlist_next`	Advance to the next track.
`playlist_prev`	Go back to the previous track.
`playlist_clear`	Remove all entries.
`library_scan`	Scan a directory for video files into the library.
`library_search`	Search the library by title or path.
`library_list`	List every entry.
`library_remove`	Remove a library entry by ID.
`screenshot`	Save the current frame as a PNG.
`clip`	Extract a video segment to MP4 or GIF.
`save_position`	Save a playback position for later resume.
`get_position`	Look up the saved position for a file.
`settings_path`	Get the path of settings.json.
`settings_get`	Read all settings, or a single key.
`settings_set`	Set a single settings key to any JSON value.
`settings_unset`	Remove a settings key.
`filter_list`	Read brightness/contrast/saturation/gamma/hue.
`filter_set`	Set one of those filters to a value in -100..100.
`filter_reset`	Reset all filters to 0.
`shutdown`	Shut down the unflick daemon.

리소스 (3)

`unflick://now-playing`	Current playback state — file, position, duration, volume, speed.
`unflick://playlist`	Current playlist with the active track marked.
`unflick://library`	Every media file in the library.