Back to docs
Files & privacy
Uploads · Limits · Data

Share files safely in Termchat

Full breakdown of the file picker, uploads/downloads, limits, and how Termchat handles privacy as described in the user guide.

Back to usageTroubleshooting

Uploading files

Interactive file picker
  1. In a chat room, type /upload with no filename.
  2. Press Enter to open the picker (starts in your home directory).
  3. Navigate with ↑/↓ and press Enter to upload.
  4. Press Esc to cancel.
  • Shows files only (directories are disabled, hidden files are skipped).
  • Displays file sizes to help you choose quickly.
Direct path upload
/upload ~/Documents/report.pdf
  • Supports ~ expansion for home directories.
  • Validates the file exists before uploading.
  • Tab completion works in most terminals if you prefer typing paths.

Downloading files

When someone uploads a file, Termchat shows a message like 📎 alice uploaded: report.pdf (2.4 MB).

/download report.pdf
  • Files save to ~/Downloads by default, or the current directory if Downloads does not exist.
  • Only people present in the room when the file was uploaded can download it.
File size limits
Maximum upload: 10 MB

Larger files are rejected. Compress or split large assets before uploading.

Ephemeral storage
  • Files live only while the room is active.
  • When the last participant leaves, files are automatically deleted.
  • Chat messages and room history are not persisted.
Data handling
  • Stored: usernames, encrypted passwords, friends list, temporary session tokens.
  • Not stored: chat messages, room history, uploaded files after rooms close.

Security practices

  • Use a unique password for Termchat and avoid sharing credentials.
  • Add only people you trust; rooms are ephemeral but not end-to-end encrypted.
  • Avoid uploading sensitive or confidential files—data is removed when rooms close.
  • If you need to force quit a stuck session, use Ctrl+C and restart.

Troubleshooting uploads

File not found
  • Confirm the path is correct; use absolute paths or ~.
  • Ensure the file still exists and you have read permissions.
Upload failed or too large
  • Keep uploads under 10 MB.
  • Test with a small file to confirm connectivity.
  • Check your internet connection if failures persist.