Skip to content

StreamFlow

Video streaming and upload platform library for Python.

StreamFlow provides unified APIs to work with multiple video streaming platforms including StreamEmbed (SeekStreaming, StreamP2P, Player4Me) and VOE. Get streaming URLs, manage uploads, and handle video operations through a simple, consistent interface.

Features

  • Multi-platform support: StreamEmbed, VOE
  • Master link resolution: Get m3u8 streaming URLs with AES decryption
  • Advance upload: Remote video upload with progress tracking
  • Proxy support: TCP/UDP proxy, local address binding, HTTP version selection
  • Rich CLI: Beautiful terminal output with formatted tables

Quick Example

from streamflow.platforms.streamembed import get_master_link, StreamembedClient

# Get streaming URL from video filecode
result = get_master_link("VIDEO_ID", provider="seekstreaming")
print(f"Streaming: {result.streaming_url}")

# Upload video
client = StreamembedClient(api_key="YOUR_API_KEY")
upload = client.upload("https://example.com/video.mp4", name="My Video")
print(f"Task ID: {upload.id}")

Supported Platforms

Platform Providers Description
StreamEmbed seekstreaming, streamp2p, player4me Master link + upload API
VOE voe.sx Account stats, file management, master link (m3u8)
Byse byse.sx Upload, file management, master link
Anonstream anonstream.co Remote upload, file management
Vidara vidara.so Video upload, HLS streaming

Two URLs per platform (read this once)

Every platform that has both a "play here" page and a JSON API exposes them on two separate hosts (or two separate path prefixes). StreamFlow follows the same naming everywhere — do not confuse them:

Term Meaning Used by
API Base URL (base_url=) Host + prefix where authenticated JSON calls live. E.g. https://voe.sx/api, https://seekstreaming.com/api/v1, https://api.byse.sx. Upload, listing, stats, delete, account methods.
Site URL (site_base_url=) Host that serves the video player, the embed//e/{filecode} page, and the master link that resolves to an m3u8. E.g. https://voe.sx, https://seekstreaming.com, https://vidara.so. get_master_link(), embed_url(filecode), anywhere a viewer would actually watch the video.

Rule of thumb: if it returns an .m3u8 or an /e/... page, it needs the Site URL. If it returns JSON, it needs the API Base URL.

See the Platforms page for the exact defaults of each provider.

Installation

pip install streamflow

For development:

git clone https://github.com/username/streamflow
cd streamflow
pip install -e .

CLI Usage

# Show all platforms
python -m streamflow all

# Show specific platform
python -m streamflow streamembed
python -m streamflow voe

# With provider
python -m streamflow streamembed seekstreaming

License

MIT License