https://github.com/dgv/mup
A micro file uploader written in Zig to easily share files over LAN
https://github.com/dgv/mup
download upload upload-file uploader zig ziglang
Last synced: 5 months ago
JSON representation
A micro file uploader written in Zig to easily share files over LAN
- Host: GitHub
- URL: https://github.com/dgv/mup
- Owner: dgv
- License: mit
- Created: 2024-08-30T22:47:51.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-11-15T01:58:41.000Z (8 months ago)
- Last Synced: 2025-02-07T12:44:37.188Z (5 months ago)
- Topics: download, upload, upload-file, uploader, zig, ziglang
- Language: Zig
- Homepage:
- Size: 68.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# μploader - Micro Uploader
[](https://github.com/dgv/mup/blob/main/build.zig.zon)
[](https://github.com/dgv/mup/blob/main/build.zig.zon)
[](https://github.com/dgv/mup/actions/workflows/build.yml)
[](https://opensource.org/licenses/MIT)
Rewritten of [mup](https://github.com/aziis98), a simple file uploader that can be used to easily move and share files across the local network between devices with a web browser.
It only uses [httpz](https://github.com/karlseguin/http.zig) and [zig-clap](https://github.com/Hejsil/zig-clap) as dependencies and provide a statically linked binary.
### Motivation
[@aziis98](https://github.com/aziis98):
_Sometimes I want to move files between my pc and a device I do not own that has an old browser version (that generally means expired https certificates, oh and without any cables). When I try to search for a tool like this I always find random outdated projects that aren't easy to setup. So I made this tool that can be easily installed on all linux systems._
[@dgv](https://github.com/dgv):
_size comparison_
```bash
# go binary striping symbol and debug info..tinygo?
$ go build -ldflags "-s -w"; du mup
16704 mup
...
# zig binary -65x
$ zig build --release=small; du zig-out/bin/mup
256 zig-out/bin/mup
```
### Git
```bash
$ git clone https://github.com/dgv/mup
$ cd mup
# Run the server
$ zig build run
# Build the binary
$ zig build
```
### Dockerfile
I provide this just to easily deploy on a local server. I **do not recomend to expose this publicly** on the web as there is no auth or password and there is no upload limit to the number of files and all files in the `Uploads/` folder are public by default for now.
```bash shell
$ docker build -t mup .
$ docker run -p 5000:5000 -v $PWD/uploads:/uploads mup
```
## Usage
```bash
$ mup --help
-h, --help
Display this help and exit.
-s, --size
Maximum upload size in MB.
-p, --port
Port to run the server on.
-a, --addr
Address to run the server on.
-d, --dir
Upload directory to serve files.
```