Steampipe

Steampipe is a automation tool that remuxes and uploads Steam gameplay clips to YouTube.
It scans your Steam recording folder, converts new clips to .mp4, and sends them directly to your channel.

Features

• ✅ Syncs clips directory directly to Youtube
• ✅ Remux .m4s + .mpd chunks using gpac/MP4Box
• ✅ Game title + timestamp metadata
• ✅ Uploads to YouTube via OAuth
• ✅ Dry-run support
• ✅ Optional Discord webhook notifications via --discord

Prerequisites

• MP4Box (from the gpac package) must be on your PATH — it's used to remux Steam's .m4s/.mpd clip chunks into .mp4.
  • Arch/EndeavourOS: sudo pacman -S gpac

Installation

git clone https://github.com/onemyndseye/steampipe.git
cd steampipe
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

Alt insallation

wget -O steampipe.sh https://raw.githubusercontent.com/onemyndseye/steampipe/main/steampipe.sh
chmod +x steampipe.sh
./steampipe.sh

GUI (optional)

Steampipe ships an optional PySide6 GUI ("Control Valve") with a system tray icon, as an alternative to the CLI flags below.

pip install -r requirements-gui.txt
steampipe --gui

Usage

steampipe --clips /path/to/clips --privacy unlisted

Options

Option	Description
--clips DIR	Location for new clips (required unless --gui)
--gui	Launch the Control Valve GUI instead of the CLI
--dry-run	Show actions without doing them
--privacy	public, unlisted, or private
--prefix	Add prefix to uploaded video title
--discord URL	Discord webhook to notify
--discord-name	Name for Discord bot (Default: Steampipe)
--discord-desc	Set description for discord post
--force-refresh	Clear the cached Steam game name lookups

Configuration

• Steam clips must be recorded via Steam’s built-in background recorder
• Place your YouTube credentials.json file here:
  ./credentials/credentials.json

License

MIT © onemyndseye