https://github.com/mahinkumar/nano_image_server
A Tiny Image server to serve your images, designed for small, medium and large scale usage. Use for static image delivery network or as a home image storage server.
https://github.com/mahinkumar/nano_image_server
images linux rust tokio-rs
Last synced: 3 months ago
JSON representation
A Tiny Image server to serve your images, designed for small, medium and large scale usage. Use for static image delivery network or as a home image storage server.
- Host: GitHub
- URL: https://github.com/mahinkumar/nano_image_server
- Owner: Mahinkumar
- License: mit
- Created: 2024-09-17T17:50:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-04T05:09:35.000Z (5 months ago)
- Last Synced: 2026-01-08T09:16:00.731Z (5 months ago)
- Topics: images, linux, rust, tokio-rs
- Language: Rust
- Homepage:
- Size: 5.57 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!WARNING]
> This Project is a work in progress and is not suitable to be used at this moment.
> The Processing algorithms are far from optimal and will undergo massive Improvements.
> Star the repository for progress updates.
# Nano Image Server
| Docs | Usage | References |
Nano Image Server is a tiny, blazingly fast service to serve images with support for image operation on fly.
It is truly asynchronous, Memory safe and thread safe. Built upon axum and tokio runtime. The image processing, encoding and decoding are done by the image crate. GPU support and caching are planned before the stable release.
## Available Features
1. Low latency Image delivery
2. Image operation on fly via url queries
3. Caching and Instant Retrieval
4. Support for Linux and Windows
5. Built-in Image browsing and management web dashboard.
## Usage
1. Place Images you need in images folder next to the executable
2. Start the server
```bash
./nano_image_server #Linux
start nano_image_server.exe #Windows
```
3. Access the server from port 8000 in localhost.
4. To get image go to `/.`
### Resizing
1. If needed resizing use queries resx and resy `/Nature.jpg?resx=1920&resy=1080`
2. When resizing use query resfilter `/Nature.jpg?resx=1920&resy=1080&resfilter=lanczos`
3. If specified size is 0 or left unspecified they display original size of the image
4. If resfilter query is unspecified, nearest is chosen by default
5. Choose from several resize algorithms for resizing using the resfilter query.
Availible resize algorithms are,
- Nearest
- Triangle
- Catmullrom
- Gaussian
- Lanczos
- Optimal
6. Optimal choose the best algorithm possible based on the resize request.
### Filters
The availible filters are
1. Blur
2. Grayscale
3. Brighten
4. Contrast
### Transforms
The availible transforms are
1. Flip horizontal
2. Flip Vertical
3. Rotate (90deg, 180deg, 270deg)
4. Hue rotate
### Processing
The availible proccessing are
1. Invert
2. Unsharpen
### Supported Image formats
The following formats are supported via encoders and decoders from the Image-rs Library
| Format | Decoding | Encoding |
| -------- | ----------------------------------------- | --------------------------------------- |
| AVIF | Yes \* | Yes (lossy only) |
| BMP | Yes | Yes |
| Farbfeld | Yes | Yes |
| GIF | Yes | Yes |
| HDR | Yes | Yes |
| ICO | Yes | Yes |
| JPEG | Yes | Yes |
| EXR | Yes | Yes |
| PNG | Yes | Yes |
| PNM | Yes | Yes |
| QOI | Yes | Yes |
| TGA | Yes | Yes |
| TIFF | Yes | Yes |
| WebP | Yes | Yes (lossless only) |