플러그인 패널을 열지 않고 Figma Quick Actions에서 자주 쓰는 TinyImage 작업을 실행하세요. 아래에서 이름이 붙은 바로가기를 고르면 돼요. 세부 설정과 작성 작업은 일반 플러그인 패널을 사용하세요.
Quick Action 실행
열린 패널에만 있는 Figma Motion 컨트롤 값은 실행 사이에 유지되지 않아요. 이 컨트롤에는 바로가기에서 직접 입력한 값이나 문서에 나온 대체값이 사용돼요.
모든 바로가기는 확인된 유효한 라이선스나 남은 체험 횟수가 있어야 실행돼요. 확인에 실패하거나 체험 횟수가 끝났다면 일반 플러그인 패널을 열어 라이선스를 활성화하세요. 패널은 계속 열 수 있어요.
- 바로가기가 선택 항목을 사용한다면 작업할 레이어를 선택하세요.
- Mac에서는 Command + /, Windows에서는 Ctrl + / 로 Figma Quick Actions를 여세요.
- 플러그인을 검색하고 아래의 바로가기 이름을 선택하세요.
- 표시되는 필드를 입력하세요. 선택 필드는 건너뛸 수 있으며, Tab으로 이동해 편집할 수 있어요. 바로가기를 실행한 다음 결과를 확인하거나 저장 대화 상자를 완료하세요.
생성 바로가기는 이름이나 크기를 직접 물어봐요. 선택 레이어 바로가기는 현재 선택 항목을 자동으로 사용해요. 이런 일상적인 바로가기는 Target이나 JSON을 묻지 않아요. 일반 플러그인 패널을 열려면 Open TinyImage를 선택하세요.
| 바로가기 | 입력 |
|---|---|
| Compress Selected Layers (Custom Settings…) | Quality (1–100)(선택) |
| Convert Selected Layers (Custom Settings…) | Convert format, Quality (1–100)(선택) |
| Export Selected Layers as PDF | 없음, 바로 실행돼요 |
| Export Selected Figma Motion (Custom Settings…) | Format(선택), Frames per second(선택) |
| Arrange Selected Layers (Custom Settings…) | Layout(선택), Horizontal gap (px)(선택), Vertical gap (px)(선택) |
선택지가 정해진 필드는 읽기 쉬운 레이블을 사용해요. 표시된 레이블이나 실제 값으로 검색할 수 있어요. 에이전트 입력에는 계속 명령 레퍼런스에 나온 값을 사용해요.
컨텍스트 메뉴에서 실행
원하는 레이어를 선택하고 마우스 오른쪽 버튼을 클릭한 다음 Plugins → TinyImage를 선택하세요(개발 중인 플러그인은 Development 아래에 표시돼요). 작업을 고르고 형식이나 프리셋을 선택하세요. 필수 입력이 없는 프리셋은 바로 실행돼요. 저장 대화 상자가 나타나면 완료하세요.
각 프리셋은 이름에 해당하는 옵션을 설정해요. 생략한 호환 옵션은 플러그인에 저장된 설정을 이어받고, 명시적으로 지정한 작업이나 옵션은 충돌하는 저장된 동작보다 우선해요. 직접 입력한 필드나 선택한 메뉴 항목만 해당 실행에서 저장된 설정을 덮어써요. 한 번도 저장한 적이 없는 설정에는 기본 설정이나 문서에 나온 대체값이 적용돼요. 내보내기 재정의는 환경설정에 다시 저장되지 않아요. 저장된 형식을 바로가기로 사용할 수 없다면 지원되는 형식을 직접 선택하거나 일반 패널을 사용하세요. 여러 옵션을 함께 쓰려면 작업 안에서 Custom Settings… 를 선택하고 매개변수를 입력하세요. 텍스트, URL, 이름, 크기가 필요한 작업은 여전히 해당 필수 필드를 물어봐요. Open TinyImage를 선택하면 일반 패널이 열려요.
Compress Selected Layers는 일반 패널에 변환이 저장되어 있어도 항상 원래 내보내기 형식을 유지해요. WebP, AVIF, Tiny SVG를 고르려면 Convert Selected Layers를 사용하세요. 변환에는 형식을 직접 지정해야 하며, 생략한 품질과 그 밖의 압축 환경설정은 계속 저장된 설정을 이어받아요. 품질을 직접 지정하면 해당 실행에서는 저장된 무손실 모드와 목표 크기 모드가 꺼져요. 고급 호출자는 이 모드들을 명시적으로 켤 수 있어요. 내보내기 바로가기는 Figma 원본 레이어의 이미지 채우기를 절대 축소하지 않아요. Arrange Selected Layers는 항상 정렬만 하며, 레이아웃과 간격만 이어받아요. 이름 변경, 정렬 순서 변경, 인스턴스 감싸기, 페이지 번호 텍스트 업데이트는 하지 않아요. 이런 작업이 필요하면 고급 옵션으로 직접 요청하세요. 인쇄용 캔버스 만들기와 인쇄 설정 조정은 일반 패널에서 하세요. Motion 프레임 속도는 Custom Settings에서 계속 설정할 수 있어요.
| 메뉴 선택 | 다음 단계 |
|---|---|
| Compress Selected Layers → Use Saved Settings | 바로 실행돼요 |
| Compress Selected Layers → Compress Selected Layers (Custom Settings…) | Quality (1–100)(선택) 입력 |
| Convert Selected Layers → JPG and PNG to WebP | 바로 실행돼요 |
| Convert Selected Layers → Only JPG to WebP | 바로 실행돼요 |
| Convert Selected Layers → Only PNG to WebP | 바로 실행돼요 |
| Convert Selected Layers → JPG and PNG to AVIF | 바로 실행돼요 |
| Convert Selected Layers → SVG to Tiny 1.2 SVG | 바로 실행돼요 |
| Convert Selected Layers → Convert Selected Layers (Custom Settings…) | Convert format, Quality (1–100)(선택) 입력 |
| Export Selected Layers as PDF | 바로 실행돼요 |
| Export Selected Figma Motion → Use Default Settings | 바로 실행돼요 |
| Export Selected Figma Motion → Animated GIF | 바로 실행돼요 |
| Export Selected Figma Motion → MP4 Video | 바로 실행돼요 |
| Export Selected Figma Motion → WebM Video | 바로 실행돼요 |
| Export Selected Figma Motion → Export Selected Figma Motion (Custom Settings…) | Format(선택), Frames per second(선택) 입력 |
| Arrange Selected Layers → Use Saved Layout and Spacing | 바로 실행돼요 |
| Arrange Selected Layers → Automatic | 바로 실행돼요 |
| Arrange Selected Layers → Rows | 바로 실행돼요 |
| Arrange Selected Layers → Columns | 바로 실행돼요 |
| Arrange Selected Layers → Arrange Selected Layers (Custom Settings…) | Layout(선택), Horizontal gap (px)(선택), Vertical gap (px)(선택) 입력 |
세부 편집
세부 설정, 긴 콘텐츠, 일괄 작성, 컴포넌트나 템플릿 탐색은 일반 플러그인 패널을 사용하세요. 바로가기 메뉴에는 위에 나온 일상적인 명령만 있어요.
붙여 넣는 필드는 각각 150자 미만으로 유지하세요. Figma 데스크톱에서는 붙여 넣은 입력이 이 길이에서 잘릴 수 있어요. 더 긴 내용은 일반 패널에서 입력하세요.
이전 버전의 플러그인에 Action, Target, Options가 대신 표시된다면 이름이 붙은 바로가기를 사용하도록 플러그인을 업데이트하세요. Target 값은 레이어 ID나 선택 항목이며, 새 항목의 이름이 아니에요.
TinyImage 작업
| 작업 | 하는 일 | 대상 |
|---|---|---|
compress | Figma 내보내기 형식을 바꾸지 않고 선택한 레이어 압축 | 조건에 맞는 레이어 하나 이상 |
pdf | 선택한 프레임을 화면용 PDF 하나로 합치기 | 조건에 맞는 레이어 하나 이상 |
motion | 소스 하나에서 기본 Figma Motion 내보내기 | 조건에 맞는 레이어 정확히 하나 |
convert | 선택한 레이어를 직접 고른 출력 형식으로 변환 | 조건에 맞는 레이어 하나 이상 |
tidy | 지정한 형제 레이어 정렬. 정렬 순서 변경, 감싸기, 이름 변경, 페이지 번호 업데이트는 옵션을 직접 지정해야 해요 | 조건에 맞는 레이어 하나 이상 |
compress
Figma 내보내기 형식을 바꾸지 않고 선택한 레이어를 압축해요. 조건에 맞는 레이어를 하나 이상 선택하세요.
| 옵션 | 유형 | 필수 / 기본값 | 의미와 허용되는 값 |
|---|---|---|---|
quality | number | 대체값: 90 | 압축 품질. 최소 1, 최대 100 |
중첩된 필수 필드는 상위 객체나 배열 항목이 주어질 때 적용돼요. 생략한 선택 값은 기본값이 표시되어 있지 않으면 기존 작업의 동작을 따라요.
Compress Selected Layers (Custom Settings…) 를 선택하세요. 다음 일반 필드를 입력하면 되고, JSON은 필요 없어요.
- Quality (1–100):
90
에이전트 호스트 입력
{"command":"shortcut-compress","parameters":{"quality":"90"}}pdf
선택한 프레임을 화면용 PDF 하나로 합쳐요. 조건에 맞는 레이어를 하나 이상 선택하세요.
이 바로가기에는 입력 필드가 없어요.
Export Selected Layers as PDF를 선택하세요. 현재 선택 항목으로 바로 실행돼요.
에이전트 호스트 입력
{"command":"shortcut-pdf","parameters":{}}motion
소스 하나에서 기본 Figma Motion을 내보내요. 조건에 맞는 레이어를 정확히 하나 선택하세요.
| 옵션 | 유형 | 필수 / 기본값 | 의미와 허용되는 값 |
|---|---|---|---|
format | string | 대체값: "GIF" | 애니메이션 형식. GIF, MP4, WEBM |
fps | number | 대체값: 30 | 초당 프레임 수. 기본 플랜 제한은 그대로 적용돼요. 10, 15, 24, 25, 30, 60 |
중첩된 필수 필드는 상위 객체나 배열 항목이 주어질 때 적용돼요. 생략한 선택 값은 기본값이 표시되어 있지 않으면 기존 작업의 동작을 따라요.
Export Selected Figma Motion (Custom Settings…) 를 선택하세요. 다음 일반 필드를 입력하면 되고, JSON은 필요 없어요.
- Format: Animated GIF
- Frames per second: 30 fps
에이전트 호스트 입력
{"command":"shortcut-motion","parameters":{"format":"GIF","fps":"30"}}convert
선택한 레이어를 직접 고른 출력 형식으로 변환해요. 조건에 맞는 레이어를 하나 이상 선택하세요.
| 옵션 | 유형 | 필수 / 기본값 | 의미와 허용되는 값 |
|---|---|---|---|
convert | string | 필수 | 출력 변환. 원래 형식을 유지하려면 compress를 사용하세요. webp, webpjpg, webppng, avif, tinysvg |
quality | number | 대체값: 90 | 압축 품질. 최소 1, 최대 100 |
중첩된 필수 필드는 상위 객체나 배열 항목이 주어질 때 적용돼요. 생략한 선택 값은 기본값이 표시되어 있지 않으면 기존 작업의 동작을 따라요.
Convert Selected Layers (Custom Settings…) 를 선택하세요. 다음 일반 필드를 입력하면 되고, JSON은 필요 없어요.
- Convert format: JPG and PNG to WebP
- Quality (1–100):
90
에이전트 호스트 입력
{"command":"shortcut-convert","parameters":{"convert":"webp","quality":"90"}}tidy
지정한 형제 레이어를 정렬해요. 정렬 순서 변경, 감싸기, 이름 변경, 페이지 번호 업데이트는 옵션을 직접 지정해야 해요. 조건에 맞는 레이어를 하나 이상 선택하세요.
| 옵션 | 유형 | 필수 / 기본값 | 의미와 허용되는 값 |
|---|---|---|---|
layout | string | 대체값: "auto" | 레이아웃 방향. auto, rows, columns |
horizontalSpacing | number | 대체값: 100 | 픽셀 단위 가로 간격. 최소 0, 최대 10000 |
verticalSpacing | number | 대체값: 100 | 픽셀 단위 세로 간격. 최소 0, 최대 10000 |
중첩된 필수 필드는 상위 객체나 배열 항목이 주어질 때 적용돼요. 생략한 선택 값은 기본값이 표시되어 있지 않으면 기존 작업의 동작을 따라요.
Arrange Selected Layers (Custom Settings…) 를 선택하세요. 다음 일반 필드를 입력하면 되고, JSON은 필요 없어요.
- Layout: Automatic
- Horizontal gap (px):
100 - Vertical gap (px):
100
에이전트 호스트 입력
{"command":"shortcut-tidy","parameters":{"layout":"auto","horizontalSpacing":"100","verticalSpacing":"100"}}에이전트와 함께 바로가기 사용
아래 링크된 기계 판독용 레지스트리를 읽고, 설치된 플러그인의 Quick Actions 목록에 있는 작업을 고르세요. 레지스트리는 표준 JSON Schema가 아닌 Hypermatic 옵션 정의를 사용해요. min과 max는 필드 타입에 따라 문자열 길이, 배열 길이, 숫자 값을 제한하고, 중첩 정의에는 fields와 item을 사용해요. 알 수 없는 필드는 거부돼요.
에이전트에는 Figma Quick Actions를 호출하고 일반 플러그인 결과를 확인할 수 있는 호스트가 필요해요. 매개변수가 REST나 MCP 실행기를 추가하지는 않아요. 펼쳐 볼 수 있는 예시는 호환 호스트용 입력 데이터이며, 실행 가능한 API 호출이 아니에요. 바로가기 입력은 숫자와 형식 선택을 포함해 parameters에 일반 문자열로 넣어요. 준비된 입력만으로 바로가기가 실행됐다고 주장하지 마세요.
눈에 보이는 결과를 확인하세요. 변경된 Figma 레이어, 저장된 내보내기 파일, 게시된 페이지가 그 예예요. 일반 성공/오류 알림과 일부만 내보내졌다는 경고가 있는지 읽어 보세요. 필요하면 기본 저장 대화 상자를 완료하세요. 다운로드가 시작됐다고 해서 파일이 저장됐다는 뜻은 아니에요. 사용자가 개발자 도구를 열거나 콘솔을 읽을 필요는 없어요.
문제 해결
| 증상 | 다음 단계 |
|---|---|
| 작업을 사용할 수 없어요 | 플러그인을 업데이트하고 Quick Actions 목록을 확인하세요. 그래도 작업이 없다면 일반 패널을 사용하세요. |
| 옵션이 잘못되었거나 잘렸을 수 있어요 | 해당 바로가기가 받는 필드만, 150자 미만의 개별 일반 필드 값으로 입력하세요. |
| 대상이 없거나 조건에 맞지 않아요 | 올바른 페이지를 열고 작업의 레이어 요건을 확인한 다음 원하는 레이어를 다시 선택하세요. |
| 라이선스나 체험 오류가 표시돼요 | 다시 실행하기 전에 플러그인의 일반 활성화 절차를 완료하세요. |
| 다운로드를 요청했지만 저장된 파일이 보이지 않아요 | 기본 저장 대화 상자와 다운로드 위치를 확인하세요. 실제 파일을 직접 확인하세요. |
| 명령이 실패하거나, 시간이 초과되거나, 취소됐어요 | 다시 시도하기 전에 문서와 원격 대상을 확인하세요. 앞선 변경이나 업로드가 이미 반영됐을 수 있어요. |
명령의 제한 시간은 5분이에요. 오류가 나도 전체가 롤백되지는 않아요. 생성, 교체, 업로드를 자동으로 다시 시도하면 작업이 중복되거나 덮어써질 수 있어요.
기계 판독용 명령 레지스트리에 같은 작업 ID와 옵션 정의가 들어 있어요.
현재 제한 사항
압축은 선택한 레이어의 Figma 내보내기 형식을 사용하고, 변환에는 형식을 골라야 해요. 내보내기 바로가기는 원본 이미지 채우기를 축소하지 않아요. Motion은 소스 하나만 받으며, 프레임 속도는 Custom Settings에서 설정하세요. Arrange는 레이아웃과 간격만 바꿔요. 인쇄용 캔버스, 로고 캔버스, 동영상 일괄 조합, 세부 Tidy 컨트롤은 일반 패널을 사용해요.