✓ Verified 💻 Development ✓ Enhanced Data

Lan Media Server

Share images, screenshots, and files from the AI workspace to users on the local network via HTTP.

Rating: 4.8 (462 reviews)
Downloads: 2,896 downloads
Version: 1.0.0

Overview

Share images, screenshots, and files from the AI workspace to users on the local network via HTTP.

Complete Documentation

View Source →

LAN Media Server

Lightweight HTTP file server for sharing agent-generated media (screenshots, images, documents) with users on the local network.

Why

Many AI assistant channels (webchat, CLI, SSH) can't display inline images. This skill solves that by serving files over HTTP on your LAN — drop a file, send a link.

Quick Start

bash

bash scripts/setup.sh

This creates the shared directory, installs the server script, creates a systemd user service, and starts it.

Default config:

Port: 18801
Serve directory: $HOME/projects/shared-media
Accessible at: http://:18801/

Override with environment variables:

bash

MEDIA_PORT=9090 MEDIA_ROOT=/tmp/media bash scripts/setup.sh

Usage Pattern

When you need to show an image or file to the user:

Save/copy the file to the shared media directory
Send the user a link: http://:/

Example for browser screenshots:

bash

cp /path/to/screenshot.jpg ~/projects/shared-media/my-screenshot.jpg
# Then send: http://192.168.1.91:18801/my-screenshot.jpg

Use descriptive filenames — the directory is flat and user-visible.

Management

bash

# Check status
systemctl --user status media-server

# Restart
systemctl --user restart media-server

# View logs
journalctl --user -u media-server -f

# Stop and disable
systemctl --user stop media-server
systemctl --user disable media-server

Security Notes

Serves files only on LAN (0.0.0.0 but typically behind NAT)
No authentication — don't put sensitive files in the shared directory
Path traversal is blocked (files must be under MEDIA_ROOT)
No directory listing — must know the exact filename

Installation

Terminal bash


openclaw install lan-media-server

Copied!

💻Code Examples

bash scripts/setup.sh

bash-scriptssetupsh.txt

This creates the shared directory, installs the server script, creates a systemd user service, and starts it.

**Default config:**
- Port: `18801`
- Serve directory: `$HOME/projects/shared-media`
- Accessible at: `http://<LAN_IP>:18801/<filename>`

Override with environment variables:

MEDIA_PORT=9090 MEDIA_ROOT=/tmp/media bash scripts/setup.sh

mediaport9090-mediaroottmpmedia-bash-scriptssetupsh.txt

## Usage Pattern

When you need to show an image or file to the user:

1. Save/copy the file to the shared media directory
2. Send the user a link: `http://<server-LAN-IP>:<port>/<filename>`

Example for browser screenshots:

# Then send: http://192.168.1.91:18801/my-screenshot.jpg

-then-send-http19216819118801my-screenshotjpg.txt

Use descriptive filenames — the directory is flat and user-visible.

## Management

example.sh

# Check status
systemctl --user status media-server

# Restart
systemctl --user restart media-server

# View logs
journalctl --user -u media-server -f

# Stop and disable
systemctl --user stop media-server
systemctl --user disable media-server