Serve images, videos or any file randomly to anyone!
  • JavaScript 100%
Find a file
2025-10-22 21:34:28 +02:00
.env.example Initial commit 2025-10-22 21:34:28 +02:00
.gitignore Initial commit 2025-10-22 21:34:28 +02:00
app.js Initial commit 2025-10-22 21:34:28 +02:00
LICENSE Initial commit 2025-10-22 21:34:28 +02:00
package.json Initial commit 2025-10-22 21:34:28 +02:00
README.md Initial commit 2025-10-22 21:34:28 +02:00

random-file-server

Serve images, videos or any file randomly to anyone!

How to run

  1. Clone the repository with git clone https://github.com/M336G/random-file-server.git, take a look at .env.example and create a .env file if you need to configure your server.
  2. Install Bun.
  3. Start the project with bun run start!

Usage

Simply add files to the directory you've specified in the FILES_PATH environment variable to be able to serve them.

To fetch a random file, use GET / and to list all files available, use GET /list. You may also just use GET /<filename> to get a specific file from the FILES_PATH directory.

Contributing

Pull requests are more than welcome to the project! Feel free to open one if you feel like something needs modification or if there is any problem with the codebase.

Credits

This project is licensed under the MIT license.