aktar CLI 문서

aktar upload

파일을 하나 이상 업로드하고, 각 파일이 끝날 때마다 파일 순서대로 링크를 하나씩 출력합니다.

사용법

$ aktar upload <file>... [options]

옵션

알아 두면 좋은 점

• 업로드를 시작하기 전에 모든 파일을 확인합니다. 존재하지 않는 파일이 하나라도 있으면 아무것도 업로드하지 않고 aktar가 종료 코드 2로 끝납니다.
• 업로드 하나가 실패해도 나머지는 계속 진행됩니다. 실패한 항목은 각각 stderr에 표시되고 종료 코드는 1이 됩니다.
• --folder가 없으면 메뉴 막대에 파일을 끌어다 놓을 때처럼 대상의 경로 템플릿이 파일 이름을 정합니다. --folder를 쓰면 파일이 원래 이름 그대로 그 폴더에 들어갑니다.
• --name은 한 번에 파일 하나에만 쓸 수 있습니다. 슬래시는 제거되고, 이름에 확장자가 없으면 원래 파일의 확장자가 붙습니다. 예를 들어 --name cover를 쓰면 IMG_4021.jpg가 cover.jpg로 업로드됩니다. --folder와 함께 쓰면 폴더 안에서의 이름이 됩니다.
• --expires에는 1, 7, 14, 30(일) 또는 파일을 계속 보관하는 0을 지정합니다. 이 옵션이 없으면 Aktar의 보관 기간 설정과 관계없이 파일이 보관됩니다. 해당 대상에 Aktar의 자동 삭제 규칙이 설정되어 있어야 하며, --folder와 함께 쓸 수 없습니다.
• --qr은 --json과 함께 쓸 수 없고, --png는 aktar qr에서만 동작합니다.
• 터미널에서는 업로드하는 동안 진행 상황이 stderr에 표시됩니다. 파일은 Aktar로 스트리밍되므로 크기는 상관없고 시간 제한도 없습니다.

예시

$ aktar upload screenshot.png
https://files.example.com/2026/10/7f3c2a91.png

$ aktar upload *.png -f markdown
![](https://files.example.com/2026/10/1b9e44d0.png)
![](https://files.example.com/2026/10/c2f71a5e.png)

$ aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpg

$ aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpg

aktar upload --clipboard

Aktar 자체의 클립보드 단축키처럼, 클립보드에 있는 파일이나 이미지를 업로드합니다.

사용법

$ aktar upload --clipboard [options]

옵션

알아 두면 좋은 점

• 파일과 --clipboard 중 하나만 지정하세요. 둘을 함께 쓸 수는 없습니다.
• --name과 --folder는 파일에서만 동작합니다. -d, -f, --expires, --qr, --json은 파일을 업로드할 때와 똑같이 동작합니다.
• --json을 쓰면 항목이 하나인 배열을 출력합니다.

예시

$ aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.png

$ aktar upload --clipboard -f markdown -d Blog
![](https://blog-assets.example.com/2026/10/e5b2c8a4.png)

$ aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.png

aktar replace

업로드된 파일을 새 파일로 덮어써서 키와 링크를 그대로 유지합니다. 링크를 가진 사람은 모두 새 파일을 보게 됩니다.

사용법

$ aktar replace <upload-id|link|key> <file> [options]

옵션

알아 두면 좋은 점

• 첫 번째 인수는 aktar history에 나오는 업로드 ID나 링크(Aktar 기록 항목도 함께 업데이트됨)이고, 그 밖의 값은 -d 대상 버킷의 키로 처리됩니다(생략하면 Aktar에서 선택된 대상). Aktar 기록에 없는 링크는 거부되므로, 그럴 때는 키를 -d와 함께 넘기세요.
• Aktar는 대상 설정에 따라 파일의 메타데이터를 제거하고 크기를 조절하지만, 다른 형식으로 변환하지는 않으므로 키의 확장자는 그대로입니다. tmp/{N}d/ 아래의 파일은 N일이 처음부터 다시 시작됩니다.
• 키에 번호가 붙지 않으며 다른 파일은 업로드되지 않습니다. --folder, --expires, --name, --clipboard는 적용되지 않으며 거부됩니다.
• 이전 파일이 CDN 캐시에 한동안 남을 수 있습니다. 대상의 짧은 캐시 시간이나 Aktar의 Cloudflare 캐시 삭제 기능으로 해결할 수 있습니다.
• Aktar for Mac 0.14.0 또는 Aktar for Windows 0.7.0 이상이 필요합니다.

예시

$ aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar replace docs/guide.pdf guide.pdf -d Blog -f markdown
[guide.pdf](https://blog-assets.example.com/docs/guide.pdf)

aktar qr

링크나 임의의 텍스트를 QR 코드로 터미널에 표시해 휴대폰에서 바로 열 수 있게 합니다. 업로드 ID를 넘기면 해당 업로드의 링크와 QR 코드를 보여 줍니다.

사용법

$ aktar qr <link|text|upload-id> [--png <file>]

옵션

알아 두면 좋은 점

• 인수는 정확히 하나만 넘기고, 공백이 있는 텍스트는 따옴표로 감싸세요.
• 업로드 ID는 aktar history --json이나 aktar upload --json의 id입니다. aktar는 Aktar 기록의 최근 업로드 1,000개에서 이 ID를 찾습니다. 일반 텍스트나 링크라면 Aktar가 전혀 필요 없습니다.
• 터미널에서는 테마와 관계없이 흰 바탕에 검은색으로 코드를 그립니다. 출력이 터미널이 아니거나 NO_COLOR가 설정되어 있으면 색상 없이 그립니다.
• --png를 쓰면 QR 코드를 출력하는 대신 PNG로 저장합니다.

예시

$ aktar qr https://files.example.com/2026/10/demo.mp4

$ aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.png

aktar login

토큰을 Aktar에서 확인한 뒤 저장해 다른 명령어가 연결할 수 있게 합니다.

사용법

$ aktar login [--token <token>] [--port <port>]

옵션

알아 두면 좋은 점

• 터미널에서는 토큰을 입력하라고 묻고, 입력 내용을 숨깁니다. 입력이 파이프로 들어오면 거기서 토큰을 읽습니다.
• --token을 쓰면 프롬프트를 건너뛰지만 토큰이 셸 기록에 남습니다. 파이프로 넘기거나 AKTAR_TOKEN을 쓰면 이를 피할 수 있습니다.
• Aktar가 거부한 토큰은 저장되지 않으며 종료 코드는 3입니다.

예시

$ aktar login
Copy the token from Aktar: Settings > Integrations (turn on Allow local connections first).
Token:
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ pbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ aktar login --token "$AKTAR_SECRET" --port 47920
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

aktar logout

저장된 토큰과 포트를 삭제합니다.

사용법

$ aktar logout

옵션

옵션이 없습니다.

알아 두면 좋은 점

• AKTAR_TOKEN이 설정되어 있다면 aktar logout 후에도 계속 동작합니다.
• 다른 클라이언트의 연결은 끊지 않습니다. 그러려면 Aktar에서 토큰을 다시 생성하세요.

예시

$ aktar logout
Logged out.

$ aktar status
aktar: Not connected to Aktar yet. Run aktar login with the token from Aktar's Settings > Integrations.

aktar status

연결된 Aktar와 포트, Aktar에서 선택된 대상, 설정 파일의 위치를 보여 줍니다.

사용법

$ aktar status [--json]

옵션

알아 두면 좋은 점

• 스크립트에서 연결을 빠르게 확인하는 방법입니다. Aktar에 연결할 수 없거나 토큰이 틀리면 종료 코드 3으로 끝납니다.

예시

$ aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.json

$ aktar status --json
{
  "app": "Aktar",
  "version": "0.10.0",
  "build": "28",
  "apiVersion": 1,
  "defaultDestinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
  "outputFormat": "url",
  "port": 47913
}

aktar destinations

대상 목록을 제공업체, 버킷, ID와 함께 보여 줍니다. *는 Aktar에서 선택된 대상을 나타냅니다.

사용법

$ aktar destinations [--json]

옵션

알아 두면 좋은 점

• -d에는 이름이나 ID를 쓰세요. 이름은 대소문자를 구분하지 않고 찾으며, ID는 이름을 바꾼 뒤에도 항상 동작합니다.
• --json은 각 대상의 id, name, provider, providerName, bucket, publicBaseURL, isDefault를 출력합니다.

예시

$ aktar destinations
* Screenshots  Cloudflare R2  screenshots  5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47
  Builds  Amazon S3  acme-builds  A83F2C10-6D4B-4F7E-9C1A-2B5E8D0F3C66
  Blog  Backblaze B2  blog-assets  E2C7B9A4-1F3D-4A8E-B6C0-9D5F2A7E4B13

$ aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshots

aktar history

최근 업로드를 최신순으로 날짜, 파일 이름, 링크와 함께 보여 줍니다. history 뒤에 단어를 붙이면 기록에서 검색합니다.

사용법

$ aktar history [search] [options]

옵션

알아 두면 좋은 점

• -n을 지정하지 않으면 업로드 20개를 보여 줍니다.
• --json은 aktar upload --json과 같은 필드를 출력하며, aktar qr에 쓸 수 있는 각 업로드의 id도 포함합니다.

예시

$ aktar history -n 3
2026-10-01  screenshot.png  https://files.example.com/2026/10/7f3c2a91.png
2026-10-01  cover.jpg  https://files.example.com/blog/2026/cover.jpg
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar history invoice -d Screenshots
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf
2026-08-29  invoice-august.pdf  https://files.example.com/2026/08/a6c94f20.pdf

$ aktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zip

모든 명령어에 쓸 수 있는 옵션