Documentazione della CLI aktar

aktar upload

Carica uno o più file e stampa un link per file, in ordine, man mano che ciascuno finisce.

Uso

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

Opzioni

Buono a sapersi

• Tutti i file vengono controllati prima di caricare qualsiasi cosa: se uno non esiste, non viene caricato nulla e aktar esce con codice 2.
• Se un caricamento non riesce, gli altri vanno comunque a buon fine. Ogni errore viene segnalato su stderr e il codice di uscita è 1.
• Senza --folder, il nome del file lo decide il modello di percorso della destinazione, proprio come quando trascini un file sulla barra dei menu. Con --folder, il file mantiene il suo nome dentro quella cartella.
• --name funziona con un file alla volta. Le barre vengono rimosse e, se il nome non ha estensione, viene aggiunta quella del file: --name cover carica IMG_4021.jpg come cover.jpg. Con --folder, è il nome dentro la cartella.
• --expires accetta 1, 7, 14 o 30 (giorni), oppure 0 per conservare il file. Senza questa opzione il file viene conservato, qualunque sia il valore di Elimina dopo in Aktar. Richiede le regole di eliminazione automatica di Aktar su quella destinazione e non si può combinare con --folder.
• --qr non si può combinare con --json, e --png funziona solo con aktar qr.
• In un terminale, l'avanzamento compare su stderr durante il caricamento. Il file viene inviato ad Aktar in streaming, quindi la dimensione non conta e non c'è limite di tempo.

Esempi

$ 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

Carica il file o l'immagine negli Appunti, come la scorciatoia per gli Appunti di Aktar.

Uso

$ aktar upload --clipboard [options]

Opzioni

Buono a sapersi

• Passa dei file oppure --clipboard, non entrambi.
• --name e --folder funzionano solo con i file. -d, -f, --expires, --qr e --json funzionano come con i file.
• Con --json stampa comunque un array, con una sola voce.

Esempi

$ 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

Scrive un nuovo file al posto di un caricamento, così chiave e link restano gli stessi. Chiunque abbia il link vede il nuovo file.

Uso

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

Opzioni

Buono a sapersi

• Il primo argomento è un ID di caricamento o un link da aktar history (la voce nella cronologia di Aktar viene aggiornata), altrimenti una chiave nel bucket di -d (la destinazione selezionata in Aktar, se lo ometti). Un link che non è nella cronologia di Aktar viene rifiutato: passa invece la sua chiave con -d.
• Aktar rimuove i metadati del file e lo ridimensiona come indicato dalla destinazione, ma non lo converte mai in un altro formato, quindi l'estensione della chiave resta. Un file sotto tmp/{N}d/ ricomincia il conto dei suoi N giorni.
• La chiave non viene mai numerata e non viene caricato nient'altro. --folder, --expires, --name e --clipboard non si applicano e vengono rifiutati.
• Le copie vecchie possono restare per un po' nella cache di una CDN. L'opzione Cache breve di una destinazione o lo svuotamento della cache di Cloudflare in Aktar risolvono il problema.
• Richiede Aktar per Mac 0.14.0 o Aktar per Windows 0.7.0 o successivo.

Esempi

$ 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

Mostra nel terminale il codice QR di un link o di qualsiasi testo, così puoi aprirlo sul telefono. Con un ID di caricamento, mostra il link di quel caricamento e il suo codice QR.

Uso

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

Opzioni

Buono a sapersi

• Passa esattamente un argomento e metti tra virgolette il testo con spazi.
• Un ID di caricamento è l'id di aktar history --json o aktar upload --json. aktar lo cerca tra gli ultimi 1.000 caricamenti nella cronologia di Aktar; per testo semplice o un link, Aktar non serve affatto.
• In un terminale il codice viene disegnato nero su bianco, qualunque sia il tema. Se l'output non è un terminale, o se NO_COLOR è impostata, viene disegnato senza colori.
• --png salva il codice QR come PNG invece di stamparlo.

Esempi

$ 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

Verifica un token con Aktar e lo salva, così gli altri comandi possono connettersi.

Uso

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

Opzioni

Buono a sapersi

• In un terminale chiede il token e nasconde quello che digiti. Se l'input arriva da una pipe, legge il token da lì.
• --token salta il prompt, ma il token finisce nella cronologia della shell. Passarlo con una pipe o usare AKTAR_TOKEN lo evita.
• Un token rifiutato da Aktar non viene salvato e il codice di uscita è 3.

Esempi

$ 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

Elimina il token e la porta salvati.

Uso

$ aktar logout

Opzioni

Nessuna opzione.

Buono a sapersi

• AKTAR_TOKEN, se impostata, continua a funzionare dopo aktar logout.
• Non disconnette gli altri client. Per quello, rigenera il token in Aktar.

Esempi

$ 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

Mostra a quale Aktar sei connesso, su quale porta, la destinazione selezionata in Aktar e dove si trova il file di configurazione.

Uso

$ aktar status [--json]

Opzioni

Buono a sapersi

• Un modo rapido per controllare la connessione in uno script: esce con codice 3 quando Aktar non è raggiungibile o il token è sbagliato.

Esempi

$ 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

Elenca le tue destinazioni con provider, bucket e ID. * indica quella selezionata in Aktar.

Uso

$ aktar destinations [--json]

Opzioni

Buono a sapersi

• Usa un nome o un ID con -d. I nomi vengono confrontati senza distinguere maiuscole e minuscole; un ID funziona sempre, anche dopo una rinomina.
• --json restituisce id, name, provider, providerName, bucket, publicBaseURL e isDefault per ciascuna.

Esempi

$ 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

Elenca i caricamenti recenti, dal più nuovo: data, nome del file e link. Le parole dopo history cercano nella cronologia.

Uso

$ aktar history [search] [options]

Opzioni

Buono a sapersi

• Elenca 20 caricamenti, a meno che tu non passi -n.
• --json restituisce gli stessi campi di aktar upload --json, compreso l'id di ogni caricamento per aktar qr.

Esempi

$ 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

Opzioni valide per ogni comando