rosickytong / HTTPImageServer

A Naive HTTP based image server, aims to show the image in a given folder.

HTTPImageServer

A naive http-based tool to show the image in a given directory.

1. Dependency

• python3
• Pillow

Install pillow via pip install pillow

2. How to use

A simple command would do the job:

python server.py <port> <webroot>

where port is a int number of which port to use (default: 80), and webroot is the directory that containing the images(default: current directory).

3. Mostly asked questions

Q1. KeyError: webp

Ans. We use webp format to encode the image and your system have no libwebp installed.

1. you can change the format to others by modifying the code img = img.save(img_stream, format='webp') in server.py/HTTPImageServer.handle_image(line 165)

2. you can install libwebp-dev and reinstall pillow package for webp support.

4. Structure.

The server.py mainly provides two api.

1. To access filelist under the given directory, please access:

/directory?path=relative/path/to/file

params:

• path: the directory that you want to list. return:

{
    "dirs": ["list", "of", "subdirs"],
    "imgs": ["image", "file", "under", "the", "directory"],
}

2. to access the image:

/img?path=relative/path/to/file&height=100&width=200

params:

• path: the image that you want to access.

• height: image max height.

• width: image max width.

Note: if no height and width are provided, the original image will be returned.

return:

• the image stream.

For more details about the structure, please see the network.py.

5. Ps

1. The http server are written starting from socket, i do not use the http.server module in python. Therefore, there might be some bugs and may cause some problems, be sure not to use in production enviroment.

2. The index.html is gabbage, i have never write javascript before. You can try to re-write it if you are disgusting with that.