transbeam/README.md
2022-04-27 14:23:27 -04:00

37 lines
1.3 KiB
Markdown

<p align="center">
<img alt="transbeam logo: a laser warning sign in trans flag colors" height="256" src="https://git.xeno.science/xenofem/transbeam/raw/branch/main/static/transbeam.svg">
</p>
<h3 align="center">transbeam</h3>
<p align="center">A low-latency file drop web app</p>
## features
- One-to-many transfer of large files
- Simple web UI for sender and receivers
- Receivers can begin downloading *immediately*, without needing to
wait for the upload to finish
- Receivers can also download after the upload is complete and the
sender has gone offline
- Easy to send multiple files at once - they're bundled into a zip
file for receivers, with zero compression so extraction is quick
- Sanitizes filenames
- Fires a laser beam that turns you trans
## configuration
transbeam is configured with the following environment variables:
- `STORAGE_DIR`: path where uploaded files should be stored (default: `./storage`)
- `STATIC_DIR`: path where the web app's static files live (default: `./static`)
- `PORT`: port to listen on localhost for http requests (default: 8080)
## installation
## todo
- [ ] file downloading
- [ ] upload progress bar
- [ ] uploader auth
- [ ] downloader auth
- [ ] delete uploads after a while
- [ ] configurable maximum file size