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.
-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
| Stikalo | Opis | Privzeto |
|---|---|---|
-p, --password P | Geslo za šifriranje | interaktivno |
--password-stdin | Preberi geslo iz stdin | |
--password-file F | Preberi geslo iz datoteke | |
-t, --ttl DUR | Čas veljavnosti (TTL) | 7d |
-b, --burn | Izbriši po branju (en prenos) | izklopljeno |
-u, --uploader-only | Prenese lahko samo vaš račun: stran vašega računa ali kateri koli njegov ključ API (Orbit; vzdevek --private) | izklopljeno |
--timeout DUR | Časovna omejitev prenosa | brez |
--server URL | Naslov URL strežnika | https://ttl.space |
-h3, --http3 | Poskusi HTTP/3 (QUIC), ob težavah preklopi na TCP | izklopljeno |
--json | Izpiši JSON na stdout (za skripte in agente AI) | izklopljeno |
Stikala za get
| Stikalo | Opis | Privzeto |
|---|---|---|
-p, --password P | Geslo za dešifriranje | interaktivno |
--password-stdin | Preberi geslo iz stdin | |
--password-file F | Preberi geslo iz datoteke | |
-o, --output DIR | Izhodna mapa | trenutna mapa |
--timeout DUR | Časovna omejitev prenosa | brez |
--server URL | Strežnik za goli žeton | https://ttl.space |
-h3, --http3 | Poskusi HTTP/3 (QUIC), ob težavah preklopi na TCP | izklopljeno |
--json | Izpiš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
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
| Stanje | Pomen |
|---|---|
401 | Neveljaven ali potekel ključ API |
403 | Funkcija zahteva paket Orbit |
404 | Datoteka ni bila najdena ali ne pripada temu ključu |
429 | Omejitev števila zahtev presežena |
500 | Notranja napaka strežnika, poskusite pozneje |
502 | Shramba je začasno nedosegljiva, poskusite pozneje |
Omejitve
| Omejitev | Brezplačno | Orbit |
|---|---|---|
| Največja velikost datoteke | 6 GB | 50 GB |
| Največji TTL | 7 dni | 30 dni ali trajno |
| Nalaganj na dan | 4 | Neomejeno |
| Obseg nalaganja na dan (na IP) | 6 GB | Neomejeno |
| Hkratna nalaganja | 2 na IP | 4 na ključ API |
| Kvota shrambe | ✗ | 1 TB |
| Seznam datotek | ✗ | ✓ |
| Predčasen izbris | ✓ | ✓ |
| Datoteke samo za pošiljatelja | ✗ | ✓ |
| Najmanjša dolžina gesla | 8 znakov | |
| Zahteve na IP | 300 na 10 sekund | |
| Povezave na IP | 100 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 del | Algoritem / vrednost |
|---|---|
| Izpeljava ključa | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Šifra | XChaCha20-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.