Navodila za uporabo

Slovenščina

Hiter začetek

# pošiljanje datoteke: geslo se ustvari samodejno, izpiše se povezava + geslo
$ ttl send secret.pdf
No password provided. Generate one? [Y/n]:
Generated password: aB3kL9mXq7Rt
·✧★◉ Thank goodness, secret.pdf is in orbit (1.2 MB, expires 2026-10-08 12:00)
IMPORTANT! Save your password — required to download and decrypt the file.
Password: aB3kL9mXq7Rt
Manage key: k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz (ttl status / ttl delete -k)
https://ttlspaceusercontent.com/aBcDeFgHiJ

# prenos: program interaktivno vpraša za geslo
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

CLI poskrbi za šifriranje, nalaganje, prenos in dešifriranje. Strežnik nikoli ne vidi vašega gesla ali podatkov v nešifrirani obliki.

Namestitev

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl
$ scoop install ttl

Že prevedena binarna datoteka

# prenesite različico za svojo platformo s strani Releases
$ curl -Lo ttl.tar.gz \
  https://github.com/tweenietomatoes/ttl/releases/download/v1.6.2/ttl_1.6.2_linux_amd64.tar.gz
$ tar xzf ttl.tar.gz && sudo mv ttl /usr/local/bin/

Namestitev z Go

$ go install github.com/tweenietomatoes/ttl/cmd/ttl@latest

Iz izvorne kode

$ git clone https://github.com/tweenietomatoes/ttl
$ cd ttl && go build -o ttl ./cmd/ttl/
$ sudo mv ttl /usr/local/bin/

Preverjanje

$ ttl version
ttl 1.6.2

Pošiljanje datotek

Osnovno pošiljanje

# samodejno ustvarjeno geslo, privzeti TTL 7d
$ ttl send report.xlsx

Če v terminalu geslo ni podano, CLI vpraša:

No password provided. Generate one? [Y/n]:

Pritisnite Enter ali vpišite y za samodejno ustvarjanje.

Lastno geslo

$ ttl send -p mySecretPass -t 1h document.pdf

Izbriši po branju

# izbriše se po prenosu; prekinjen prenos se lahko nadaljuje in datoteke ne porabi
$ ttl send -b photo.jpg

Lasten TTL

$ ttl send -t 5m temp-credentials.txt   # poteče čez 5 minut
$ ttl send -t 30m meeting-link.txt      # poteče čez 30 minut
$ ttl send -t 6h backup.tar.gz          # poteče čez 6 ur
$ ttl send -t 1d daily-report.pdf       # poteče čez 1 dan
$ ttl send -t 3d project-archive.zip    # poteče čez 3 dni
$ ttl send -t 5d design-assets.zip      # poteče čez 5 dni
$ ttl send report.xlsx                  # poteče čez 7 dni (privzeto)

Velike datoteke

Datoteka do 16 MiB gre v eni zahtevi; večja v nadaljevalnih delih po 16 MiB, po dva hkrati. Vsaka zahteva se preveri z zgoščeno vrednostjo SHA-256, zahteva, ki na poti odpove, pa se pošlje znova; že poslani deli ostanejo. Ctrl-C nalaganje varno prekliče.

Prenos datotek

Interaktivno (terminal)

$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)

Geslo se v terminalu ne izpisuje. Izvirno ime datoteke se ohrani; če to ime v izhodni mapi že obstaja, se datoteka shrani kot name (1).ext namesto prepisa.

Samo z žetonom

# namesto celotnega naslova URL lahko uporabite samo 10-mestni žeton
$ ttl get aBcDeFgHiJ

Izhodna mapa

$ ttl get -o ~/Downloads aBcDeFgHiJ

Privzeto se datoteke shranijo v trenutno mapo. Drugo mapo določite z -o / --output.

S stikalom za geslo

$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ

Prekinjeni prenosi

Prekinjen prenos se nadaljuje od zadnjega prejetega bajta; vsak kos po 64 KiB se overi sam zase, zato je rezultat enak kot pri neprekinjenem prenosu. Enkratna datoteka (izbriši po branju) se porabi, ko jo prenos prejme v celoti: prekinjen prenos se nadaljuje, kjer se je ustavil, datoteka pa ostane za nov poskus.

Brskalnik

Datoteke lahko prenesete in dešifrirate tudi v brskalniku, če neposredno odprete povezavo. Spletni vmesnik uporablja enako obliko datotek in enake algoritme (Argon2id, XChaCha20-Poly1305) ter vpraša za vaše geslo. Namestitev programske opreme ni potrebna.

Ključ za upravljanje

Vsako nalaganje dobi ključ za upravljanje, ki ga ttl send izpiše samo enkrat (manage_key v --json). Strežnik hrani samo njegovo zgoščeno vrednost. V katerem koli paketu vam omogoča spremljanje nalaganja ali njegov predčasen izbris; kdor ima ključ, lahko nalaganje izbriše, zato ga varujte kot geslo.

# stanje, prenosi in potek vašega nalaganja
$ ttl status aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Token:      aBcDeFgHiJ
State:      active
Size:       4.2 MB
Created:    2026-10-01 12:00
Expires:    2026-10-08 12:00
Downloads:  1 (last 2026-10-02 09:12)

# predčasen izbris
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

Stanje je eno od active, expired, burned ali deleted.

Ravnanje z geslom

Geslo je seme šifrirnega ključa. Nikoli ne zapusti vaše naprave in se nikoli ne pošlje na strežnik. Podate ga lahko na šest načinov:

1. Samodejno ustvarjanje (samo pri pošiljanju)

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: y
Generated password: aB3kL9mXq7Rt

Ustvari kriptografsko naključno 12-mestno geslo iz znakov [0-9A-Za-z]. Na voljo samo pri send (interaktivno ali samodejno v načinu --json).

2. Interaktivni poziv

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: n
Enter password: ********
Confirm password: ********

$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********

Geslo se ne izpisuje. Pri send izberete, ali se ustvari samodejno; če vnesete svoje, ga potrdite. Pri get program vpraša neposredno.

3. Stikalo: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password je vidno v izpisu ps aux in se lahko shrani v zgodovino lupine (~/.bash_history). Izogibajte se mu v skupnih okoljih in skriptah. Namesto tega uporabite --password-stdin ali --password-file.

4. Standardni vhod: --password-stdin

# prek cevi iz echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# prek cevi iz upravljalnika gesel
$ pass show ttl/key | ttl send --password-stdin data.zip

# prek cevi iz spremenljivke okolja
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

# here-string
$ ttl send --password-stdin report.pdf <<<"mySecretPass"

Prebere prvo vrstico iz standardnega vhoda (stdin). Uporabno v skriptah, cevovodih CI/CD in avtomatizaciji. Če stdin ni terminal in vir gesla ni podan, CLI konča z napako (razen če je uporabljen --json, ki geslo ustvari samodejno).

5. Datoteka: --password-file

$ ttl send --password-file /run/secrets/key report.xlsx
$ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ

Prebere prvo vrstico datoteke (končni znak za novo vrstico se odstrani). Združljivo z datotekami Docker secrets (/run/secrets/), datotekami agenta Vault in podobnimi vzorci.

6. Samodejno zaznana datoteka: ttl.password

Če geslo ni izrecno podano, CLI poišče datoteko ttl.password ob izvršljivi datoteki, nato ~/.ttl/password. Kot geslo se uporabi prva vrstica.

Hkrati je mogoče uporabiti samo en izrecen vir gesla. Združevanje -p / --password, --password-stdin in --password-file je napaka. Samodejno zaznana datoteka ttl.password se preveri samo, če ni podan noben od njih. Najmanjša dolžina gesla je 8 znakov.

Pregled možnosti

Stikala za send

StikaloOpisPrivzeto
-p, --password PGeslo za šifriranjeinteraktivno
--password-stdinPreberi geslo iz stdin
--password-file FPreberi geslo iz datoteke
-t, --ttl DURČas veljavnosti (TTL)7d
-b, --burnIzbriši po branju (en prenos)izklopljeno
-u, --uploader-onlyPrenese lahko samo vaš račun: stran vašega računa ali kateri koli njegov ključ API (Orbit; vzdevek --private)izklopljeno
--timeout DURČasovna omejitev prenosabrez
--server URLNaslov URL strežnikahttps://ttl.space
-h3, --http3Poskusi HTTP/3 (QUIC), ob težavah preklopi na TCPizklopljeno
--jsonIzpiši JSON na stdout (za skripte in agente AI)izklopljeno

Stikala za get

StikaloOpisPrivzeto
-p, --password PGeslo za dešifriranjeinteraktivno
--password-stdinPreberi geslo iz stdin
--password-file FPreberi geslo iz datoteke
-o, --output DIRIzhodna mapatrenutna mapa
--timeout DURČasovna omejitev prenosabrez
--server URLStrežnik za goli žetonhttps://ttl.space
-h3, --http3Poskusi HTTP/3 (QUIC), ob težavah preklopi na TCPizklopljeno
--jsonIzpiši JSON na stdout (za skripte in agente AI)izklopljeno

Vrednosti TTL

Brezplačno: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d

Orbit doda: 14d 15d 28d 30d permanent

Časovna omejitev

Privzeto: brez. Zastali prenos se nadaljuje sam in obupa, če ne more naprej. Omejitev nastavite z --timeout 30m ali --timeout 2h.

Primeri

Skripta: varnostna kopija in nalaganje

#!/bin/bash
tar czf /tmp/backup.tar.gz /data
echo "$BACKUP_KEY" | ttl send --password-stdin -t 6h /tmp/backup.tar.gz
rm /tmp/backup.tar.gz

Povezava v odložišče (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Povezava v odložišče (Linux)

$ ttl send -p mypass123 file.pdf | xclip -sel clip

Izbriši po branju: enkratna skrivnost

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# povezava deluje natanko enkrat, poteče čez 5 minut

Način JSON (skripte in agenti AI)

# pošiljanje: v načinu JSON se geslo ustvari samodejno
$ ttl --json send report.pdf
{"ok":true,"link":"https://ttlspaceusercontent.com/xK9mQ2vLpA","token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"ttl":"7d","expires_in":604800,"expires_at":1760011200,"burn":false,"uploader_only":false,"is_permanent":false,"manage_key":"k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz","password":"aB3kL9mXq7Rt"}

# prenos
$ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA
{"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"}

# stanje s ključem za upravljanje
$ ttl --json status xK9mQ2vLpA -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
{"ok":true,"token":"xK9mQ2vLpA","status":{"state":"active","size_bytes":2097152,"created_at":1759406400,"expires_at":1760011200,"permanent":false,"burn":false,"note":false,"uploader_only":false,"downloads":1,"last_download_at":1759492800,"part_reads":0,"last_part_at":0}}

# napake vrnejo ok:false
{"ok":false,"error":"Link not found. The file may have expired, been downloaded already (burn after reading), or be private (uploader-only)"}

V načinu --json je ves izpis strukturiran JSON na stdout. Če pri pošiljanju geslo ni podano, se ustvari samodejno in je vključeno v odgovor. Izhodna koda je 0 ob uspehu in 1 ob napaki.

Paket Orbit

Orbit odklene večje datoteke (50 GB), daljšo hrambo (30 dni, z naročnino pa trajno), datoteke, vezane na vaš račun (prenese jih lahko samo vaš račun), in upravljanje datotek (seznam in brisanje). Popolna primerjava: Funkcije.

Ključ API se samodejno zazna iz spremenljivke okolja TTL_API_KEY, iz datoteke ttl.key ob izvršljivi datoteki ali iz ~/.ttl/key. Ključ shranite s ttl activate ali pa ga ročno zapišete na katero koli od teh mest.

# aktivacija ključa: vnos brez izpisa, zato ne konča v zgodovini lupine
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# neinteraktivno: ttl activate --key-stdin  |  ttl activate --key-file F

# preverjanje paketa in porabe
$ ttl plan
Plan: orbit
Max file size: 50.0 GB
Max TTL: 30 days (or permanent)
Uploads per day: 1000000
Storage quota: 1024.0 GB

Usage:
  Uploads today: 3
  Active storage: 1.2 GB / 1024.0 GB

# pošiljanje s podaljšanim TTL
$ ttl send -t 30d large-backup.tar.gz
# trajna datoteka (samo Orbit): brez poteka, hrani se, dokler je ne izbrišete ali ne poteče naročnina
$ ttl send -t permanent archive.tar.gz
# pošiljanje zasebne datoteke: prenese jo lahko samo vaš račun (samo Orbit)
$ ttl send -u payroll.xlsx

# seznam zadnjih nalaganj
$ ttl list
  xK9mQ2vLpA    4.2 MB  2026-03-16 10:30 → 2026-04-15 10:30  [active]
  https://ttlspaceusercontent.com/xK9mQ2vLpA
  rT7bNw3KpF  912.0 KB  2026-03-15 14:20 → 2026-03-17 14:20  [active (burn)]
  https://ttlspaceusercontent.com/rT7bNw3KpF

# predčasen izbris datoteke (ttl list obišče vse strani; -n 5 se ustavi po petih datotekah)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# ali s ključem za upravljanje nalaganja, v katerem koli paketu: ttl delete xK9mQ2vLpA -k KEY

# odstranitev shranjenega ključa
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Nalaganje in prenos zahtevata postopek šifriranja v CLI (Argon2id + XChaCha20-Poly1305 + AEAD po kosih). Za skriptiranje uporabite ttl send / ttl get ali način --json. Spodnje končne točke so namenjene upravljanju datotek Orbit.

Seznam datotek (Orbit)

$ curl https://ttl.space/v1/files -H "X-API-Key: ttl_orbit_..."
{"files":[{"token":"xK9mQ2vLpA","link":"https://ttlspaceusercontent.com/xK9mQ2vLpA","size_bytes":1048576,"created_at":1711800600,"expires_at":1714392600,"burn":false,"expired":false,"uploader_only":false,"is_permanent":false,"is_note":false,"perm_grace_until":0}],"has_more":false}

# naslednja stran: samo ko je has_more true; podajte next_cursor iz prejšnjega odgovora
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Vrne datoteke, naložene s tem ključem, najnovejše prve, po 20 na stran. Ko je has_more true, odgovor vključuje tudi next_cursor; podajte ga kot ?cursor=, da dobite naslednjo stran. Zahteva paket Orbit.

Brisanje datoteke (Orbit)

$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."

Ob uspehu vrne 204 No Content. Zahteva paket Orbit. Datoteka mora pripadati podanemu ključu.

Odgovori z napako

StanjePomen
401Neveljaven ali potekel ključ API
403Funkcija zahteva paket Orbit
404Datoteka ni bila najdena ali ne pripada temu ključu
429Omejitev števila zahtev presežena
500Notranja napaka strežnika, poskusite pozneje
502Shramba je začasno nedosegljiva, poskusite pozneje

Omejitve

OmejitevBrezplačnoOrbit
Največja velikost datoteke6 GB50 GB
Največji TTL7 dni30 dni ali trajno
Nalaganj na dan4Neomejeno
Obseg nalaganja na dan (na IP)6 GBNeomejeno
Hkratna nalaganja2 na IP4 na ključ API
Kvota shrambe✗1 TB
Seznam datotek✗✓
Predčasen izbris✓✓
Datoteke samo za pošiljatelja✗✓
Najmanjša dolžina gesla8 znakov
Zahteve na IP300 na 10 sekund
Povezave na IP100 hkrati

Šifriranje

Datoteke se šifrirajo v vaši napravi pred nalaganjem. Strežnik hrani samo šifrirano besedilo in vaših datotek ne more dešifrirati.

Sestavni delAlgoritem / vrednost
Izpeljava ključaArgon2id (time=3, memory=64 MiB, parallelism=1)
ŠifraXChaCha20-Poly1305 AEAD

Vsaka sprememba šifriranega besedila povzroči neuspeh dešifriranja. Strežnik pred izdajo šifriranega besedila preveri, ali prenašalec pozna pravilno geslo, in sicer z enosmernim žetonom, izpeljanim iz šifrirnega ključa.