Questions and answers
The things people ask most. If something is missing, it probably is not in the program yet.
Which image formats work?
PNG, JPEG, GIF and WebP. Other types are rejected at upload, and the program checks the file's real content, not just its name.
What is the size limit?
10 MB per image by default. Change it with --max-size; see the settings table. Remember to raise your reverse proxy's body limit too.
Does it resize or recompress my image?
No. The original is stored byte for byte, except that EXIF data is removed from JPEGs unless you turn that off. Only thumbnails are resized, and they are separate files.
Where do the files live?
In the data directory you pass with --data: one image file plus a small metadata file each. There is no database to dump or repair.
How does deletion work?
Expired images are removed by a sweep that runs every few minutes. To delete one by hand, remove its two files from the data directory; the link then returns a 404. There is no delete button on the public page, on purpose.
Is there an API?
One endpoint: POST /upload, taking a multipart file and returning the short link as plain text.
curl -F file=@screenshot.png https://img.example.net/upload
https://img.example.net/k7Qp2With an upload password set, add -H "X-Password: your-password".
Can several people have their own accounts?
No. imgdrop is single-user: either uploading is open or it needs one shared password. If you need accounts and quotas, this is the wrong tool.
Are links guessable?
Links are five random characters, so they are hard to stumble on but they are not secret in the cryptographic sense. Treat a link like an unlisted page: anyone who has it can see the image.
Does it phone home or track anything?
No. It makes no outgoing connections and sets no cookies. The only logging is the usual access line, which you can silence in your proxy.
What is the licence?
MIT-style: use it, change it, share it, keep the notice. Details on the licence page.