yeenserve is a web app for serving random photos.

Last update: Nov 30, 2022

Related tags

Overview

yeenserve

yeenserve is a simple web app written in Rust that serves random images from a directory. It was written as the backing application for hyena.photos, as I wanted to replace the NGINX random index module that I had been using up until now.

The backend supports PNG (png extension) and JPEG (jpg and jpeg extensions) files, but support for other files can be easily added if requested.

Configuration

yeenserve supports both file-based and S3-based provider backends, and is controlled by the YEENSERVE_BACKEND environment variable. See all the options below.

Name	Default	Backend	Description
YEENSERVE_BACKEND	file	N/A	Type of backend to get files from. Options are [file, s3].
YEENSERVE_PATH	resources/	file	Path containing files to serve.
YEENSERVE_S3_BUCKET	Required	s3	S3 bucket to pull files from.
YEENSERVE_S3_REGION	Required	s3	S3 region where the bucket is located.
YEENSERVE_S3_ENDPOINT	Required	s3	S3 endpoint used to contact the S3 API. Currently required for all providers, even AWS S3 themselves.
YEENSERVE_S3_ACCESS_KEY	Required	s3	S3 access key used to authenticate with the S3 API.
YEENSERVE_S3_SECRET_KEY	Required	s3	S3 secret key used to authenticate with the S3 API.

You might also like...

Jotsy is a self-hosted, free and open-source note taking app with a goal of simplicity in mind

Jotsy: Just your notes Jotsy is a self-hosted, free and open-source note taking app with a goal of simplicity in mind. It is powered by Skytable. Read

433 Dec 30, 2022

A Rust app for creating RSS Feeds in Notion.

Notion Feed A Rust app for creating RSS Feeds in Notion. Features Manage your RSS sources in a separate Notion page Enable/disable RSS sources Read fe

16 Nov 30, 2022

An occult chat app using Cabal 🧙✨🔮

coven 🧙✨🔮 An occult chat app using Cabal Uses the cable.rs implementation of the new Cable protocol. For now is a desktop app, but with the magic of

7 Nov 2, 2023

A Rust web framework

cargonauts - a Rust web framework Documentation cargonauts is a Rust web framework intended for building maintainable, well-factored web apps. This pr

179 Dec 25, 2022

A Rust library to extract useful data from HTML documents, suitable for web scraping.

select.rs A library to extract useful data from HTML documents, suitable for web scraping. NOTE: The following example only works in the upcoming rele

829 Dec 28, 2022

A Google-like web search engine that provides the user with the most relevant websites in accordance to his/her query, using crawled and indexed textual data and PageRank.

Mini Google Course project for the Architecture of Computer Systems course. Overview: Architecture: We are working on multiple components of the web c

11 Aug 10, 2022

A rust web framework with safety and speed in mind.

darpi A web api framework with speed and safety in mind. One of the big goals is to catch all errors at compile time, if possible. The framework uses

32 Apr 11, 2022

A web framework for Rust.

Rocket Rocket is an async web framework for Rust with a focus on usability, security, extensibility, and speed. #[macro_use] extern crate rocket; #[g

19.4k Jan 4, 2023

Rust / Wasm framework for building client web apps

25.8k Jan 2, 2023

Comments

S3 backend

Rework the code to allow for static file serving, as well as an S3 backend that lists a bucket's contents and picks a random file to proxy through the web server (might support direct links later...).

Depends on #4.
enhancement

opened by kubeliv 0
Static images controller

To allow for caching between Cloudflare or other CDNs, it'd be nice to rewrite the index page to simply slap an <img> tag to a static image path. This would allow caching on the clientside, as well as a CDN like Cloudflare.
enhancement

opened by kubeliv 0
Caching file lists for S3 backend

If an end-user is using an S3 provider, they are likely being charged for API calls, which could get costly since every call to get a random picture will use the list API. It'd be beneficial to cache the file list for a configurable time.
enhancement

opened by kubeliv 0
Extension case breaks filtering

If you try to add a file with the extension "JPG" (or any other assortment of casing that isn't explicitly lowercase), the filtering code will exclude it and never consider that image.
bug

opened by kubeliv 0

Releases(v0.2.0-rc1)

v0.2.0-rc1(Aug 5, 2022)
What's Changed

Fix Code Warnings by @kendfinger in https://github.com/mysticlgbt/yeenserve/pull/3

Static route and S3 Support by @lgorence in https://github.com/mysticlgbt/yeenserve/pull/6

New Contributors

@kendfinger made their first contribution in https://github.com/mysticlgbt/yeenserve/pull/3

Full Changelog: https://github.com/mysticlgbt/yeenserve/compare/v0.1.0...v0.2.0-rc1
Source code(tar.gz)
Source code(zip)
v0.1.0(Jul 15, 2022)
Initial release that provides a simple random image web server with configuration via the YEENSERVE_PATH environment variable.

Deploy via Docker

docker run -it --detach --restart=unless-stopped --name yeenserve -p 8000:8000 -v /path/to/pics:/pics ghcr.io/mysticlgbt/yeenserve:0.1.0
Source code(tar.gz)
Source code(zip)