Dokumentasi aktar CLI

aktar upload

Mengunggah satu file atau lebih dan mencetak satu tautan per file, berurutan, begitu masing-masing selesai.

Penggunaan

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

Opsi

Perlu diketahui

• Setiap file diperiksa sebelum ada yang diunggah: jika salah satunya tidak ada, tidak ada yang diunggah dan aktar keluar dengan kode 2.
• Jika satu unggahan gagal, yang lain tetap berjalan. Setiap kegagalan dilaporkan di stderr, dan kode keluarnya 1.
• Tanpa --folder, template jalur tujuan yang menamai file, sama seperti saat file dijatuhkan ke bar menu. Dengan --folder, file tetap memakai namanya di dalam folder itu.
• --name bekerja dengan satu file sekaligus. Garis miring dihapus, dan ekstensi file ditambahkan jika nama tidak memilikinya: --name cover mengunggah IMG_4021.jpg sebagai cover.jpg. Dengan --folder, itu adalah nama di dalam folder.
• --expires menerima 1, 7, 14, atau 30 (hari), atau 0 untuk menyimpan file. Tanpa opsi ini, file disimpan, apa pun pengaturan Hapus setelah di Aktar. Opsi ini memerlukan aturan hapus otomatis Aktar di tujuan tersebut, dan tidak bisa digabung dengan --folder.
• --qr tidak bisa digabung dengan --json, dan --png hanya bekerja dengan aktar qr.
• Di terminal, progres ditampilkan di stderr selama file diunggah. File dialirkan ke Aktar, jadi ukurannya tidak masalah, dan tidak ada batas waktu.

Contoh

$ 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

Mengunggah file atau gambar yang ada di papan klip, seperti pintasan papan klip milik Aktar sendiri.

Penggunaan

$ aktar upload --clipboard [options]

Opsi

Perlu diketahui

• Berikan file atau --clipboard, bukan keduanya.
• --name dan --folder hanya bekerja dengan file. -d, -f, --expires, --qr, dan --json bekerja seperti pada file.
• Dengan --json, hasilnya tetap berupa array, dengan satu entri.

Contoh

$ 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

Menulis file baru menimpa sebuah unggahan, sehingga kunci dan tautannya tetap sama. Semua orang yang punya tautannya melihat file baru.

Penggunaan

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

Opsi

Perlu diketahui

• Argumen pertama adalah ID unggahan atau tautan dari aktar history (entri riwayat Aktar ikut diperbarui), atau selain itu sebuah kunci di bucket -d (tujuan yang dipilih di Aktar jika dikosongkan). Tautan yang tidak ada di riwayat Aktar ditolak: berikan kuncinya dengan -d sebagai gantinya.
• Aktar menghapus metadata file dan mengubah ukurannya sesuai pengaturan tujuan, tetapi tidak pernah mengonversinya ke format lain, sehingga ekstensi kunci tetap sama. File di bawah tmp/{N}d/ memulai lagi hitungan N harinya.
• Kunci tidak pernah diberi nomor dan tidak ada yang lain yang diunggah. --folder, --expires, --name, dan --clipboard tidak berlaku dan ditolak.
• Salinan lama bisa tetap ada di cache CDN untuk sementara. Waktu cache singkat pada tujuan atau pembersihan cache Cloudflare di Aktar menangani hal itu.
• Memerlukan Aktar untuk Mac 0.14.0 atau Aktar untuk Windows 0.7.0 atau lebih baru.

Contoh

$ 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

Menampilkan kode QR dari tautan atau teks apa pun di terminal, agar Anda bisa membukanya di ponsel. Jika diberi ID unggahan, perintah ini menampilkan tautan unggahan itu beserta kode QR-nya.

Penggunaan

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

Opsi

Perlu diketahui

• Berikan tepat satu argumen, dan beri tanda kutip pada teks yang berisi spasi.
• ID unggahan adalah id dari aktar history --json atau aktar upload --json. aktar mencarinya di 1.000 unggahan terakhir dalam riwayat Aktar; untuk teks biasa atau tautan, ia sama sekali tidak memerlukan Aktar.
• Kode digambar hitam di atas putih di terminal, apa pun temanya. Jika output bukan terminal, atau NO_COLOR diatur, kode digambar tanpa warna.
• --png menyimpan kode QR sebagai PNG alih-alih mencetaknya.

Contoh

$ 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

Memeriksa token ke Aktar dan menyimpannya, agar perintah lain bisa terhubung.

Penggunaan

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

Opsi

Perlu diketahui

• Di terminal, perintah ini meminta token dan menyembunyikan yang Anda ketik. Jika input dialirkan lewat pipe, token dibaca dari sana.
• --token melewati prompt, tetapi token jadi tercatat di riwayat shell Anda. Mengalirkannya lewat pipe atau memakai AKTAR_TOKEN menghindari hal itu.
• Token yang ditolak Aktar tidak disimpan, dan kode keluarnya 3.

Contoh

$ 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

Menghapus token dan port yang tersimpan.

Penggunaan

$ aktar logout

Opsi

Tanpa opsi.

Perlu diketahui

• AKTAR_TOKEN, jika diatur, tetap berfungsi setelah aktar logout.
• Perintah ini tidak memutus klien lain. Untuk itu, buat ulang token di Aktar.

Contoh

$ 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

Menampilkan Aktar mana yang terhubung dengan Anda, di port berapa, tujuan yang dipilih di Aktar, dan lokasi file konfigurasi.

Penggunaan

$ aktar status [--json]

Opsi

Perlu diketahui

• Cara cepat untuk memeriksa koneksi dalam skrip: perintah ini keluar dengan kode 3 jika Aktar tidak bisa dijangkau atau tokennya salah.

Contoh

$ 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

Menampilkan daftar tujuan Anda beserta penyedia, bucket, dan ID-nya. * menandai tujuan yang dipilih di Aktar.

Penggunaan

$ aktar destinations [--json]

Opsi

Perlu diketahui

• Gunakan nama atau ID dengan -d. Nama dicocokkan tanpa memedulikan huruf besar-kecil; ID selalu berfungsi, bahkan setelah diganti nama.
• --json memberikan id, name, provider, providerName, bucket, publicBaseURL, dan isDefault untuk masing-masing.

Contoh

$ 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

Menampilkan daftar unggahan terbaru, dari yang paling baru: tanggal, nama file, dan tautan. Kata-kata setelah history mencari di riwayat.

Penggunaan

$ aktar history [search] [options]

Opsi

Perlu diketahui

• Menampilkan 20 unggahan kecuali Anda memberikan -n.
• --json memberikan field yang sama dengan aktar upload --json, termasuk id setiap unggahan untuk aktar qr.

Contoh

$ 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

Opsi untuk setiap perintah