rdp-cli
RDP로 Shotcut 영상 자르기와 내보내기
대상 버전 및 환경: macOS · Windows 11 RDP · Shotcut 26.8.1
이 가이드에서 만들 결과
rdp-cli로 8초 영상을 Windows에 보내고 Shotcut에서 4초로 자른 뒤 내보낸 MP4를 다운로드합니다. 편집은 원격 앱에서 이루어지며 Agent는 화면과 입력 명령으로 조작합니다.

원본 스크린샷 보기 — 밝게 ↗ · 원본 스크린샷 보기 — 어둡게 ↗
화면에 대응하는 결과 파일: 밝은 테마 · 어두운 테마
소스 준비와 업로드
아래 Mac 다운로드와 빠른 시작을 사용하세요. 허가된 Windows RDP 서버에 Shotcut이 설치되어 있고 드라이브 리디렉션이 허용되어야 하며 입력과 파일 권한도 필요합니다. 소스를 현재 로컬 디렉터리의 source-motion.mp4로 저장하고 자신의 data.session으로 SESSION을 바꾸세요.
rdp-cli files upload --session SESSION --local ./source-motion.mp4 --path source-motion.mp4
반환된 data.transfer_id를 TRANSFER_ID로 보관하고 data.state가 completed가 될 때까지 조회합니다. 소스 크기는 3,319,412바이트입니다. queued는 접수만 뜻합니다. 경로는 해당 세션 교환 드라이브의 상대 경로이며 임의의 Windows 디스크를 가리키지 않습니다.
rdp-cli files status --session SESSION --transfer-id TRANSFER_ID
원격 타임라인을 4초로 자르기
rdp-cli screenshot --session SESSION
화면을 캡처하고 data.path의 PNG를 읽어 data.observation을 보관합니다. 원격 Shotcut에서 리디렉션된 드라이브의 source-motion.mp4를 열고 타임라인에 추가하세요. 8초, 960 × 540, 24 fps인지 확인합니다. 글에 있는 화면 좌표를 복사하지 말고 새 스크린샷에서 실제 대상을 선택하세요.
타임라인 클립을 선택하고 Properties를 엽니다. Duration 필드에 포커스를 맞추고 기존 값을 선택한 뒤 새 캡처로 해당 필드를 확인합니다. 현재 토큰을 OBSERVATION에 넣어 4초를 입력하세요.
결과 복구가 필요할 수 있는 입력은 서로 다른 작업마다 고유한 --request-id를 미리 지정해 저장하고, 예제의 요청 ID를 자신의 값으로 바꾸세요. 오류 JSON을 받았다면 최상위 request_id를 보관하고, 응답이 완전히 사라지고 원래 ID도 저장하지 않았다면 새 ID로 이전 작업을 조회하거나 확인 없이 다시 보내지 마세요.
rdp-cli type --session SESSION --text "00:00:04.000" --observation OBSERVATION --request-id TYPE_REQUEST_ID
rdp-cli screenshot --session SESSION
새 PNG에서 길이 텍스트를 확인하고 그 응답의 data.observation을 NEW_OBSERVATION으로 사용해 확정합니다.
rdp-cli key --session SESSION --keys ENTER --observation NEW_OBSERVATION --request-id COMMIT_REQUEST_ID
rdp-cli screenshot --session SESSION
새 화면에서 클립과 타임라인 모두 4초가 되었는지 확인하세요. 입력 성공 응답은 전송만 증명하며 Shotcut의 수정 수락을 보장하지 않습니다. 좌표, 포커스, 토큰은 자신의 세션에서 가져와야 합니다.
자신의 결과 내보내기와 가져오기
Export 패널에서 편집한 타임라인을 H.264 MP4, 960 × 540, 24 fps로 세션 리디렉션 드라이브의 edited-motion.mp4에 내보냅니다. Jobs의 녹색 완료 표시를 기다리세요. 다운로드한 보관용 참고 파일과 구분하도록 자신의 원격 결과는 로컬의 edited-motion-reproduced.mp4로 가져옵니다.
rdp-cli files download --session SESSION --path edited-motion.mp4 --local ./edited-motion-reproduced.mp4
이번 다운로드의 새 data.transfer_id로 files status를 조회하고 completed 이후 로컬 영상을 여세요. 파일 이름이 보이거나 전송이 대기열에 있다는 사실만으로 완료를 판단하지 않습니다.
영상 검증과 오류 처리
받은 영상을 재생해 잘린 결과를 확인하세요. 로컬에 FFmpeg가 있으면 선택적으로 ffprobe로 디코딩된 영상 프레임 수도 셀 수 있습니다. rdp-cli 실행에 필수인 도구는 아닙니다.
ffprobe -v error -count_frames -select_streams v:0 -show_entries stream=codec_name,width,height,r_frame_rate,nb_read_frames,duration -of json ./edited-motion-reproduced.mp4
내보낸 영상을 재생하고 H.264, 960 × 540, 24 fps, 영상 길이 4초(96프레임)를 확인하세요. 인코딩 설정과 메타데이터에 따라 컨테이너 길이나 파일 크기가 달라질 수 있습니다.
- 잘못된 필드나 오래된 관찰 토큰이면 입력을 멈추고 새 화면을 확인합니다. 일시 정지, 제어권 전환, 재연결 뒤에는 갱신하고 허가된 반환 후에만 재개하세요.
- 내보내기 진행 중 또는
FILE_BUSY이면 Shotcut이 끝날 때까지 기다린 뒤 Jobs와 전송 상태를 확인합니다. 저장 경로가 원격 바탕 화면에만 있지 않고 교환 드라이브에 있는지 확인하세요. - 대상이 이미 있으면 새 로컬 파일 이름을 쓰거나 교체가 의도된 경우에만
--overwrite를 사용하세요. 참고 파일을 실수로 덮어쓰지 마세요. - 입력 시간 초과는 원래 요청 ID로
operations status를 조회하고 화면을 확인한 뒤 재시도를 결정합니다. 응답을 모른다고 수정이 없었다는 뜻은 아닙니다.