---
title: "위젯과 단축어"
description: "홈 화면·잠금 화면 위젯, 제어 센터 토글, 단축어 앱의 potatso:// URL과 자동화로 Potatso를 제어합니다."
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 위젯과 단축어

Potatso를 열지 않고도 위젯, 제어 센터, 단축어로 연결, 연결 해제, 모드 전환, 노드 전환을 할 수 있습니다. 모두 Potatso에서 선택한 프로필에 적용됩니다.

## 홈 화면 위젯 {#widgets}

평소와 같은 방법으로 위젯을 추가합니다. 홈 화면을 길게 누르고 **편집**, **위젯 추가**를 탭한 다음 Potatso를 검색합니다. Potatso에는 위젯이 두 가지 있습니다.

### VPN 연결 {#connection-widget}

연결하고, 모드를 전환하고, 노드를 선택합니다.

| 크기 | 표시 내용 |
| --- | --- |
| 작게 | 프로필, 상태, **연결** 또는 **연결 해제** 버튼. |
| 중간 | 위의 내용에 더해 모드 버튼 **규칙**, **전역**, **스마트**, **직접**. |
| 크게 | 모드 버튼과 기본 아웃바운드의 노드 최대 4개 및 지연 시간. |

모드나 노드를 탭하면 해당 항목으로 전환됩니다. 연결된 상태라면 변경이 바로 적용됩니다. 변경에 앱이 필요하면 위젯에 <strong>이 변경 사항을 적용하려면 Potatso를 여십시오.</strong>가 표시됩니다.

Potatso Pro가 있으면 큰 위젯에 표시된 노드를 테스트하는 **지연 시간 테스트** 버튼도 나타납니다.

일부 프로필에서는 일부 선택을 사용할 수 없습니다. 예를 들어 개인 VPN 프로필에는 모드나 노드 버튼이 없으며, 직접 모드는 노드를 사용하지 않습니다.

### 노드 {#nodes-widget}

연결 버튼과 가장 자주 연결하는 노드 세 개가 있는 중간 크기 위젯입니다. 노드를 탭하면 해당 노드로 전환됩니다.

## 잠금 화면 위젯 {#lock-screen}

**VPN 연결** 위젯은 잠금 화면 크기로도 제공됩니다.

- 원형 위젯은 연결 여부와 연결 시간을 보여 줍니다. 탭하면 연결하거나 연결을 해제합니다.
- 직사각형 위젯은 상태, 프로필, 모드, 경로를 보여 줍니다.
- 인라인 위젯은 상태를 한 줄로 보여 줍니다.

## 제어 센터 {#control-center}

iOS 18 이상에서는 제어 센터에 Potatso 토글을 추가할 수 있습니다.

1. 제어 센터를 열고 빈 영역을 길게 누릅니다.
2. **Add a Control**을 탭하고 Potatso를 검색합니다.
3. **VPN 연결**을 선택합니다.

토글을 탭하면 연결하거나 연결을 해제합니다.

## URL 동작 {#urls}

Potatso는 다음 URL에 반응합니다.

| URL | 동작 |
| --- | --- |
| `potatso://on` | 연결합니다. |
| `potatso://off` | 연결을 해제합니다. |
| `potatso://switch` | 연결이 해제된 상태면 연결하고, 그렇지 않으면 연결을 해제합니다. |

이 URL 중 하나를 열면 Potatso가 열린 다음 연결하거나 연결을 해제합니다.

## 단축어에서 Potatso 사용 {#shortcuts}

연결하는 단축어를 만들려면 다음과 같이 합니다.

1. 단축어 앱에서 새 단축어를 만듭니다.
2. **URL 열기** 동작을 추가합니다.
3. `potatso://on`을 입력합니다.

연결을 해제하려면 `potatso://off`를, 전환하려면 `potatso://switch`를 사용합니다.

### 자동으로 연결 {#automations}

단축어 자동화는 URL 동작을 대신 실행해 줍니다. 예를 들어 집 Wi-Fi를 벗어날 때 연결하려면 다음과 같이 합니다.

1. 단축어 앱에서 **자동화**를 탭한 다음 새 자동화를 만듭니다.
2. **Wi-Fi** 트리거를 선택하고 집 네트워크를 고른 다음 iPhone이 해당 네트워크를 벗어날 때 실행되도록 설정합니다.
3. 즉시 실행하도록 선택합니다.
4. `potatso://on`으로 **URL 열기** 동작을 추가합니다.

집에 돌아오면 다시 연결을 해제하도록 iPhone이 집 Wi-Fi에 연결될 때 실행되는 `potatso://off` 자동화를 하나 더 만드세요.

Source: https://potatso.com/docs/ko/guides/widgets-and-shortcuts/index.mdx