ei

Minimal media server with optional transcoding. Hassle-free streaming of media files to all devices on your LAN.

Run

Grab a standalone ei executable for your operating system from the releases page.

Or install from PyPI if you have Python installed and prefer that:

pip install ei-media
# or
pipx install ei-media
# or
uv tool install ei-media

You also need ffmpeg available on your system.

Then start the server with:

ei . --transcode --no-pin

Configuration

All configuration is via CLI flags (ei --help):

ei [DIR] [options]

Filesystem Options:

DIR                  Media directory to serve.
                     Default: current directory.
--recursive          Also descend into subdirectories.
                     Default: top level only.
--cache-dir DIR      Where probe metadata, segments, and
                     thumbnails are cached.
                     Default: ~/.cache/ei-media on Linux,
                     ~/Library/Caches/ei-media on macOS,
                     %LOCALAPPDATA%/ei-media on Windows.
--cache-size SIZE    max cache size for video segments
                     Accepts suffixes KB/MB/GB, 0 = unlimited.
                     Default: 5GB.

Network and Auth Options:

--host HOST          Interface to listen on.
                     Default: 0.0.0.0 (LAN-wide).
--port PORT          Port to listen on.
                     Default: 8509.
--pin PIN            Require a 4-digit PIN. Default
                     behavior generates a random PIN
                     if not provided.
--no-pin             Disable the PIN (open access).

Video Options:

--transcode          Enable the transcode stack
                     Default: off (direct stream-copy only).
--nvenc              Encode with NVIDIA NVENC instead
                     of CPU. Make sure your ffmpeg and
                     graphics stack supports it.

Contributing

Issues and PRs welcome.

This project uses uv:

# create .venv with dev tools
uv sync --group dev

# run the program
uv run python -m ei . --no-pin

# run lint and tests
uv run pytest
uv run ruff

# test CI locally: ruff + pytest + wheel + vendor + executables
bash scripts/check.sh --check --exe

License

GPLv3.

Project links

Data verified by PyPI on Sep 10, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for takeoischifan from gravatar.com takeoischifan

Credits

Author: takeoischifan

GitHub Statistics

Data verified by PyPI on Sep 10, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU General Public License v3 (GPLv3) (GPL-3.0-only)

Requires

Python >=3.11

Tags

dash lan media-server streaming video

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ei_media-0.1.1.tar.gz (460.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ei_media-0.1.1-py3-none-any.whl (459.6 kB view details)

Uploaded Python 3

File details

Details for the file ei_media-0.1.1.tar.gz.

File metadata

  • Download URL: ei_media-0.1.1.tar.gz
  • Upload date:
  • Size: 460.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ei_media-0.1.1.tar.gz
Algorithm Hash digest
SHA256 6146f5302024aa286dad975d94e1bccfd7af322f4c17192e867dba21b0cbec3f
MD5 cea53ed72d0686ac1722cd6282e985f0
BLAKE2b-256 248f5d6c1ce3278fef33b8d2650154e3af98e25cb7230694bf2892e384ebc8db

See more details on using hashes here.

Provenance

The following attestation bundles were made for ei_media-0.1.1.tar.gz:

Publisher: release.yml on TakeoIschiFan/ei

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ei_media-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: ei_media-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 459.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ei_media-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c691c44206eda2deb4230fece90fb2f7dfca93c535fe45472dcbafb80992d0a5
MD5 98f679b74931bfc62483a0b7c173cf49
BLAKE2b-256 ec0bfa5d28ece469d84838f4c0e56b067e0b912634eb627f95cb072c9962c70e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ei_media-0.1.1-py3-none-any.whl:

Publisher: release.yml on TakeoIschiFan/ei

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.2

2 files

This release

0.1.1 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page