Gabay sa Paggamit

Filipino

Mabilis na pagsisimula

# magpadala ng file: awtomatikong ginagawa ang password, ipinapakita ang link + password
$ 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

# mag-download: tinatanong nang interactive ang password
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

Ang CLI na ang bahala sa encryption, pag-upload, pag-download, at decryption. Hindi kailanman nakikita ng server ang iyong password o ang plaintext na data.

I-install

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

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

Pre-built na binary

# i-download ang para sa iyong platform mula sa 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/

Go install

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

Mula sa source

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

I-verify

$ ttl version
ttl 1.6.2

Pagpapadala ng mga file

Karaniwang pagpapadala

# awtomatikong gagawa ng password, default na TTL na 7 araw
$ ttl send report.xlsx

Kapag walang ibinigay na password sa terminal, magtatanong ang CLI:

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

Pindutin ang Enter o i-type ang y para awtomatikong gumawa.

Custom na password

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

I-delete pagkatapos basahin

# made-delete kapag na-download; ang download na naputol ay puwedeng ituloy at hindi nito inuubos ang paggamit
$ ttl send -b photo.jpg

Custom na TTL

$ ttl send -t 5m temp-credentials.txt   # mag-e-expire sa loob ng 5 minuto
$ ttl send -t 30m meeting-link.txt      # mag-e-expire sa loob ng 30 minuto
$ ttl send -t 6h backup.tar.gz          # mag-e-expire sa loob ng 6 na oras
$ ttl send -t 1d daily-report.pdf       # mag-e-expire sa loob ng 1 araw
$ ttl send -t 3d project-archive.zip    # mag-e-expire sa loob ng 3 araw
$ ttl send -t 5d design-assets.zip      # mag-e-expire sa loob ng 5 araw
$ ttl send report.xlsx                  # mag-e-expire sa loob ng 7 araw (default)

Malalaking file

Ang file na hanggang 16 MiB ay ipinapadala sa iisang request; ang mas malaki ay sa mga bahaging 16 MiB na puwedeng ituloy, dalawa sa isang pagkakataon. Sinusuri ang bawat request gamit ang SHA-256 digest, at ipinapadalang muli ang request na pumalya sa gitna; nananatili ang mga bahaging naipadala na. Malinis na kinakansela ng Ctrl-C ang pagpapadala.

Pag-download ng mga file

Interactive (terminal)

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

Hindi ipinapakita sa terminal ang password habang tina-type. Pinapanatili ang orihinal na pangalan ng file; kung may ganoong pangalan na sa output directory, ise-save ang file bilang name (1).ext sa halip na i-overwrite.

Token lang

# puwede mong gamitin ang 10-character na token lang sa halip na buong URL
$ ttl get aBcDeFgHiJ

Output directory

$ ttl get -o ~/Downloads aBcDeFgHiJ

Bilang default, ise-save ang mga file sa kasalukuyang directory. Gamitin ang -o / --output para tumukoy ng ibang directory.

Gamit ang password flag

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

Mga download na naputol

Nagpapatuloy mula sa huling byte na natanggap ang download na naputol; may sariling authentication ang bawat 64 KiB na chunk, kaya kapareho ng walang putol na paglilipat ang resulta. Nauubos ang isang one-time na file (burn after reading) kapag buong nakuha ng isang download ang file: ang download na naputol ay nagpapatuloy mula sa pinaghintuan, at nananatili ang file para sa isa pang subok.

Browser

Puwede ka ring mag-download at mag-decrypt ng mga file sa iyong browser sa pamamagitan ng direktang pagbisita sa link. Pareho ang file format at mga algorithm ng web interface (Argon2id, XChaCha20-Poly1305) at hihingin nito ang iyong password. Hindi na kailangang mag-install ng software.

Management key

Bawat upload ay may kasamang management key, na isang beses lang ipinapakita ng ttl send (manage_key sa --json). Hash lang nito ang itinatago ng server. Sa anumang plan, hinahayaan ka nitong subaybayan ang upload o tapusin ito nang maaga; mada-delete ng sinumang may hawak ng key ang upload, kaya ingatan ito gaya ng password.

# estado, mga download, at expiry ng sarili mong upload
$ 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)

# i-delete nang maaga
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

Isa sa active, expired, burned, o deleted ang estado.

Paghawak ng password

Ang password ang pinagmumulan ng encryption key. Hindi ito kailanman umaalis sa iyong device at hindi kailanman ipinapadala sa server. May anim na paraan para ibigay ito:

1. Auto-generate (sa pagpapadala lang)

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

Gumagawa ng cryptographically random na 12-character na password mula sa [0-9A-Za-z]. Available lang sa send (interactive, o awtomatiko sa --json mode).

2. Interactive na prompt

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

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

Hindi ipinapakita ang password habang tina-type. Sa send, ikaw ang pipili kung awtomatikong gagawa; kung magta-type ka ng sarili mo, kukumpirmahin mo ito. Sa get, direkta kang tatanungin.

3. Flag: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
Makikita ang -p / --password sa output ng ps aux at maaaring ma-save sa shell history (~/.bash_history). Iwasan ito sa mga shared na environment at sa mga script. Gamitin na lang ang --password-stdin o --password-file.

4. Stdin: --password-stdin

# i-pipe mula sa echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# i-pipe mula sa password manager
$ pass show ttl/key | ttl send --password-stdin data.zip

# i-pipe mula sa environment variable
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

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

Binabasa ang unang linya mula sa stdin. Kapaki-pakinabang sa mga script, CI/CD pipeline, at automation. Kapag hindi terminal ang stdin at walang ibinigay na pinagmulan ng password, magtatapos ang CLI na may error (maliban kung gagamitin ang --json, na awtomatikong gumagawa ng password).

5. File: --password-file

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

Binabasa ang unang linya ng file (tinatanggal ang trailing newline). Tugma sa Docker secrets (/run/secrets/), mga file ng Vault agent, at mga katulad na pattern.

6. Auto-detected na file: ttl.password

Kung walang tahasang ibinigay na password, hahanapin ng CLI ang ttl.password na file sa tabi ng binary, pagkatapos ay ang ~/.ttl/password. Ang unang linya ang gagamiting password.

Isang tahasang pinagmulan lang ng password ang magagamit sa isang pagkakataon. Error ang pagsasama ng -p / --password, --password-stdin, at --password-file. Sinusuri lang ang auto-detected na ttl.password na file kapag wala sa mga ito ang ibinigay. 8 character ang minimum na haba ng password.

Reference ng mga opsyon

Mga send flag

FlagPaglalarawanDefault
-p, --password PPassword para sa encryptioninteractive
--password-stdinBasahin ang password mula sa stdin
--password-file FBasahin ang password mula sa file
-t, --ttl DURTime to live7d
-b, --burnI-delete pagkatapos basahin (isang download lang)naka-off
-u, --uploader-onlyAng account mo lang ang makaka-download: sa account page o sa alinmang API key ng account (Orbit; alias na --private)naka-off
--timeout DURTimeout ng paglilipatwala
--server URLURL ng serverhttps://ttl.space
-h3, --http3Subukan ang HTTP/3 (QUIC), mag-fall back sa TCPnaka-off
--jsonMag-output ng JSON sa stdout (para sa mga script at AI agent)naka-off

Mga get flag

FlagPaglalarawanDefault
-p, --password PPassword para sa decryptioninteractive
--password-stdinBasahin ang password mula sa stdin
--password-file FBasahin ang password mula sa file
-o, --output DIROutput directorykasalukuyang directory
--timeout DURTimeout ng paglilipatwala
--server URLServer para sa token langhttps://ttl.space
-h3, --http3Subukan ang HTTP/3 (QUIC), mag-fall back sa TCPnaka-off
--jsonMag-output ng JSON sa stdout (para sa mga script at AI agent)naka-off

Mga halaga ng TTL

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

Nagdaragdag ang Orbit ng: 14d 15d 28d 30d permanent

Timeout

Default: wala. Kusang nagpapatuloy ang paglilipat na natigil, at sumusuko kapag hindi na ito makapagpatuloy. Magtakda ng limitasyon gamit ang --timeout 30m o --timeout 2h.

Mga halimbawa

Script: backup at upload

#!/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

I-pipe ang link sa clipboard (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

I-pipe ang link sa clipboard (Linux)

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

Burn: one-time na sikreto

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# gumagana nang isang beses lang ang link, mag-e-expire sa loob ng 5 minuto

JSON mode (mga script & AI agent)

# send: awtomatikong ginagawa ang password sa JSON mode
$ 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"}

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

# status gamit ang management key
$ 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}}

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

Sa --json mode, structured na JSON sa stdout ang lahat ng output. Kung walang ibinigay na password sa pagpapadala, awtomatikong gagawa ng isa at isasama ito sa tugon. 0 ang exit code kapag matagumpay, 1 kapag may error.

Orbit plan

Binubuksan ng Orbit ang mas malalaking file (50 GB), mas mahabang pag-iimbak (30 araw, o permanente kung may subscription), mga file na naka-lock sa account mo (ang account mo lang ang makaka-download) at pamamahala ng file (list & delete). Buong paghahambing: Mga Feature.

Awtomatikong natutukoy ang API key mula sa TTL_API_KEY env, ttl.key sa tabi ng binary, o ~/.ttl/key. Gamitin ang ttl activate para i-save ang key, o isulat ito nang mano-mano sa alinman sa mga lokasyong ito.

# i-activate ang iyong key: tinatanong nang walang echo, kaya hindi ito napupunta sa shell history
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# non-interactive: ttl activate --key-stdin  |  ttl activate --key-file F

# tingnan ang plan at paggamit
$ 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

# magpadala nang may mas mahabang TTL
$ ttl send -t 30d large-backup.tar.gz
# permanenteng file (Orbit lang): walang expiry, itinatago hanggang i-delete mo ito o matapos ang subscription mo
$ ttl send -t permanent archive.tar.gz
# magpadala ng pribadong file: ang account mo lang ang makaka-download (Orbit lang)
$ ttl send -u payroll.xlsx

# ilista ang mga kamakailang upload
$ 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

# i-delete nang maaga ang file (dinadaanan ng ttl list ang bawat page; humihinto ang -n 5 pagkatapos ng limang file)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# o gamit ang management key ng upload, sa anumang plan: ttl delete xK9mQ2vLpA -k KEY

# alisin ang naka-save na key
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Kailangan ng upload at download ang encryption pipeline ng CLI (Argon2id + XChaCha20-Poly1305 + chunked AEAD). Gamitin ang ttl send / ttl get o ang --json mode para sa scripting. Para sa pamamahala ng file sa Orbit ang mga endpoint sa ibaba.

Ilista ang mga file (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}

# susunod na page: kapag true lang ang has_more; ipasa ang next_cursor mula sa nakaraang tugon
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Ibinabalik ang mga file na na-upload gamit ang key na ito, pinakabago muna, 20 bawat page. Kapag true ang has_more, kasama rin sa tugon ang next_cursor; ipasa ito bilang ?cursor= para makuha ang susunod na page. Kailangan ng Orbit plan.

I-delete ang file (Orbit)

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

Nagbabalik ng 204 No Content kapag matagumpay. Kailangan ng Orbit plan. Dapat pagmamay-ari ng ibinigay na key ang file.

Mga tugon sa error

StatusKahulugan
401Di-wasto o nag-expire na API key
403Nangangailangan ng Orbit plan ang feature
404Hindi nahanap ang file o hindi pagmamay-ari ng key na ito
429Lampas sa rate limit
500Internal server error, subukan muli mamaya
502Pansamantalang hindi available ang storage, subukan muli mamaya

Mga limitasyon

LimitasyonLibreOrbit
Max na laki ng file6 GB50 GB
Max na TTL7 araw30 araw o permanente
Mga upload bawat araw4Walang limitasyon
Dami ng upload bawat araw (bawat IP)6 GBWalang limitasyon
Sabay-sabay na upload2 bawat IP4 bawat API key
Storage quota✗1 TB
Pag-list ng file✗✓
Maagang pag-delete✓✓
Mga uploader-only na file✗✓
Min na haba ng password8 character
Mga request bawat IP300 kada 10 segundo
Mga koneksyon bawat IP100 nang sabay-sabay

Encryption

Naka-encrypt na ang mga file sa iyong device bago i-upload. Ciphertext lang ang iniimbak ng server at hindi nito kayang i-decrypt ang iyong mga file.

BahagiAlgorithm / Value
Pagbuo ng keyArgon2id (time=3, memory=64 MiB, parallelism=1)
CipherXChaCha20-Poly1305 AEAD

Magiging sanhi ng pagkabigo ng decryption ang anumang pagbabago sa ciphertext. Tinitiyak ng server na alam ng nagda-download ang tamang password bago ilabas ang ciphertext, gamit ang one-way na token na hinango mula sa encryption key.